]> git.wh0rd.org - dump.git/blob - CHANGES
Use only ctime to compare newness (instead of both ctime and mtime)
[dump.git] / CHANGES
1 $Id: CHANGES,v 1.313 2010/06/10 12:17:35 stelian Exp $
2
3 Changes between versions 0.4b42 and 0.4b43 (released ?????????????)
4 ===================================================================
5
6 1. Fix a bug in dump making impossible to handle large toc files
7 (> 2 GB). Thanks to X DUGi <xdugi@users.sourceforge.net> for
8 reporting the bug (Sourceforge bug #2820629)
9
10 2. Fix 'restore -x' in multi-volume mode, which caused files being
11 spanned on the first and second volumes to be incorrectly extracted.
12 Thanks to Adam Tkac <atkac@redhat.com> for reporting the bug.
13 (there may be several bug reports about this issue, including
14 Sourceforge bug #2117008, RedHat bugs #232415 and #444958).
15
16 3. Remove -lselinux -lsepol from the standard libraries list,
17 they shouldn't be needed if selinux is not enabled in dump
18 (this also fixes a build failure when selinux libraries are
19 not installed).
20
21 4. Fix restoration of extended attributes of fifos and device nodes.
22 Thanks to Igor Zhbanov <izh1979@gmail.com> for the bug report.
23
24 5. Don't attempt to set extended attributes on files that were not
25 extracted in 'restore -N' mode. Thanks to Jan Görig
26 <jgorig@users.sourceforge.net> for the patch.
27
28 6. Make the dump man page explicit about ext4 support.
29
30 7. Fix a bug in dump which caused EA entries to be unrecognizable by
31 restore in some corner cases. Add a workaround to restore making
32 it able to properly deal with those corrupted EA entries. Thanks
33 to John Austin <jaustin1@users.sourceforge.net> for reporting
34 the bug.
35
36 8. Fix some issues when restoring a dump which was generated using
37 exclusion patterns (either via -e or via the nodump attribute)
38 (see the Debian bug #574667 for details. Thanks to Frédéric
39 Brière <fbriere@fbriere.net> for the bug report and the associated
40 patch.
41
42 9. Fix progress/estimated blocks display in dump when doing really
43 huge backups. Thanks to Steve Bonds <sbonds@users.sourceforge.net>
44 for the bug report and tests. (Sourceforge bug #2987758)
45
46 10. Improve level 1 dump speed by rearanging the "mapdirs" code.
47 Thanks to Andreas Kies <andikies@t-online.de> for finding the
48 bottleneck and sending a patch (Sourceforge bug #2998119).
49
50 11. Use only ctime in order to compare newness instead of both
51 ctime and mtime. This should both speed up dumping time and
52 correct some side-effect bugs (like dumping files with an mtime
53 in the future in every incremental backup). Thanks to
54 Kieran Clancy <codebeard@users.sourceforge.net> for reporting the
55 bug (Sourceforge bug #2999207).
56
57 Changes between versions 0.4b41 and 0.4b42 (released June 18, 2009)
58 ===================================================================
59
60 1. Fix printout of the 'Connection to' message in dump/restore.
61 Thanks to Dale Wiles <dwiles@users.sourceforge.net> for the
62 bug report and its fix.
63
64 2. Fix dump -w/-W output for filesystems having the last backup
65 level equal to 0. Thanks to Pascal Bouchareine
66 <kalou@users.sourceforge.net> for reporting the bug.
67
68 3. Enable restore to handle restoring onto a different SELinux
69 policy from the dump. Thanks to Tony Nelson
70 <tony_nelson@users.sourceforge.net> for the patch.
71 (see http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=189845
72 for details)
73
74 4. Fix EA set failures when restoring immutable files. Thanks
75 to Andrew Kroeger for the patch.
76
77 5. Fix "mode file too large" errors when restoring huge backups.
78 Thanks to Kenneth Porter <shiva@sewingwitch.com> for the bug
79 report.
80
81 6. Add the ability to link against libtinfo library if present,
82 instead of libtermcap or libncurses libraries. Thanks to
83 Adam Tkac <atkac@redhat.com> for the patch.
84
85 7. When comparing a backup, do not consider to be an error the fact
86 that we encounter files created while dump was in progress.
87 Thanks to Kenneth Porter <shiva@sewingwitch.com> for the bug
88 report.
89
90 8. Force '-a' to be the default value when running 'restore -C'.
91 Thanks to Kenneth Porter <shiva@sewingwitch.com> for the bug
92 report.
93
94 9. Many improvements to the 'cron_dump_to_disk' example.
95 Thanks to Aaron S. Hawley <ashawley@users.sourceforge.net> for
96 the patch.
97
98 10. Fix the QFA generation when extended attributes are backuped
99 along with the inodes. Prior to this fix, the entries for
100 some inodes may get corrupted (duplicated entries or incorrect
101 ones), making the QFA file unusable for repositionning in
102 restore. Many thanks to Kenneth Porter <shiva@sewingwitch.com>
103 for the bug report and the testing of the fix.
104
105 11. Fix EA restoration in debug mode (Sourceforge bug #1986216).
106
107 12. Stefan Auracher <star7@onlinehome.de> noticed that the Tower
108 of Hanoi backup strategy documented in the man page wasn't
109 actually based on the Tower of Hanoi algorithm. The man page
110 was updated accordingly.
111
112 13. Fix missing level information from dump output when using
113 the default level (RedHat bug #493635). Thanks to Adam Tkac
114 <atkac@redhat.com> for the patch.
115
116 14. Fix the dump man page to reflect the fact that the default
117 dump level is 0 not 9 (RedHat bug #356121). Thanks to Adam Tkac
118 <atkac@redhat.com> for the patch.
119
120 15. Fixed a few spelling errors in the man pages (RedHat bug #489853).
121 Thanks to Adam Tkac <atkac@redhat.com> for the patch.
122
123 16. Fixed restore man page and program usage which incorrectly stated
124 that -P and -A were both allowed in the same invocation (RedHat
125 bug #490627). Thanks to Adam Tkac <atkac@redhat.com> for the patch.
126
127 17. Use sys_clone under Linux to share I/O contexts between dump
128 processes, thus drastically increasing the performance of dump
129 under CFQ (which is the default I/O scheduler used in a number of
130 distributions). Thanks to Jeff Moyer <jmoyer@redhat.com> for the
131 patch.
132
133 18. Add (preliminary) ext4 support - thanks to libext2fs which does
134 all the job for us. Thanks to Gertjan van Wingerde
135 <gwingerde@gmail.com> for the patch.
136
137 Changes between versions 0.4b40 and 0.4b41 (released January 2, 2006)
138 =====================================================================
139
140 1. Fix restore of dumped Access Control Lists. The previous
141 code for EA works fine, but ACLs needed conversion from the
142 ext2/3 disk format to posix_acl format before restoring.
143
144 2. Fix some issues with restoration of EA on big endian
145 platforms.
146
147 3. Fix restore when the symtab is over 2GB in size.
148
149 4. Made the directory hash indexing an optional feature,
150 accessible by the '-H' option of restore, and disable it
151 by default.
152
153 5. Fixed dump to not include extended attributes information
154 in the toc (archive) file which confused restore -t.
155
156 Changes between versions 0.4b39 and 0.4b40 (released May 2, 2005)
157 =================================================================
158
159 1. Changed restore to emit warnings (instead of emitting a fatal
160 error) if a file (or a directory) is unavailable for a
161 comparision (if the user doesn't have the necessary permissions
162 to access it for example). Thanks to Kenneth Porter
163 <shiva@sewingwitch.com> for the bug report.
164
165 2. Re-done the 'do not save directory entries to non-dumped inodes
166 (excluded from dump)' feature. The previous implementation
167 worked well for excluded directories but not for regular files.
168 Thanks to Kenneth Porter <shiva@sewingwitch.com> for the bug
169 report.
170
171 3. Fixed a bug in dump where the tape size was miscalculated when
172 the user used -d/-s to specify the tape characteristics. Thanks
173 to Philip Goisman <goisman@physics.arizona.edu> for reporting
174 the bug.
175
176 4. Fixed another bug introduced in restore with the hashtree
177 implementation. This one caused restore to stop saying
178 "removenode: non-empty directory" in some cases.
179
180 5. Added support for dumping and restoring ext2/3 extended
181 attributes (EA), like the access control lists (ACL) or
182 the security labels used by SELinux.
183
184 Changes between versions 0.4b38 and 0.4b39 (released January 21, 2005)
185 ======================================================================
186
187 1. The newly added dump_on_cd_3 example was buggy, replace it
188 with an updated version from Andrew Basterfield
189 <bob@cemetery.homeunix.org>.
190
191 2. Made restore to chdir() back into the initial directory when
192 dumping core while aborting a comparision operation. The
193 previous behaviour was to write the corefile at the root of
194 the directory being compared, which could very well be
195 read only and preventing the corefile generation. Thanks
196 to Kenneth Porter <shiva@sewingwitch.com> for the bug report.
197
198 3. Silenced the failure to call fgetflags() when comparing an
199 entry which has no ext2 attributes (as in lsattr()).
200
201 4. Fix a brown paper bug in restore -C which broke restore and
202 caused modifications on the filesystem being compared
203 (directories containing a file with the same name as the
204 directory get renamed to RSTTMP...). Thanks to Kenneth Porter
205 <shiva@sewingwitch.com> for finding the bug and helping me
206 reproduce it.
207
208 5. Made restore -C force the -N flag (no writing allowed on
209 the disk) in order to prevent more bugs like the above one.
210
211 Changes between versions 0.4b37 and 0.4b38 (released January 7, 2005)
212 =====================================================================
213
214 1. Fix a couple of troff syntax bugs in the man pages.
215 Thanks to Eric Raymond <esr@thyrsus.com> for the patch.
216
217 2. Made restore use either libncurses or libtermcap, depending
218 on which one is available at configure time.
219
220 3. Fixed restore negative size display bug when comparing a
221 dump containing files over 2GB. Thanks to Steve Bonds
222 <sbonds@users.sourceforge.net> for the bug report.
223
224 4. Do not save directory entries to non-dumped inodes
225 (excluded from dump). This will eliminate the 'missing
226 file' warnings when doing 'restore -C'.
227
228 5. Fix dump crash when backuping a huge (2TB) filesystem,
229 due to a bogus calculation on the inode map size.
230 Thanks to Kevin B. Haines <K.B.Haines@rl.ac.uk> for
231 submitting the bug and testing the fix.
232
233 6. Fix a problem in restore where the final \0 in the symbolic
234 link names could have been lost, generating corrupt filenames.
235 Thanks to Kyle Wilson <kyle.wilson@amd.com> for reporting the
236 bug.
237
238 7. Implemented a hash list for the directory names in restore.
239 The linear list used before caused problems in interactive
240 restores when dealing with directories having thousands of
241 entries. Thanks to Brian Ristuccia <bristuccia@starentnetworks.com>
242 for reporting the bug.
243
244 8. Improved restore -C, this time including the directory
245 attributes into the comparision.
246
247 9. Made restore understand tapes containing EA/ACLs (which will
248 be dumped by the next version of dump). In this version
249 extended attributes on the tape are ignored, for full EA/ACL
250 support wait for the next version or try the experimental EA
251 patch.
252
253 Changes between versions 0.4b36 and 0.4b37 (released July 7, 2004)
254 ==================================================================
255
256 1. Added the --enable-staticz configure option which enables
257 dump and restore to be linked with static versions of
258 libz and libbz2 (and dynamic versions of all other libraries).
259 This will make Debian users happy, because libz and libbz2
260 were the only needed libraries living in /usr, all the
261 others live in /lib. In case of system emergency, it is
262 better not to have to rely on an extra filesystem.
263 Thanks to Bdale Garbee <bdale@gag.com> for the suggestion.
264
265 2. Fix compilation on (at least the Linux Debian port to) AMD64.
266 (<ext2fs/ext2_types.h> defines some types (__s64 and __u64)
267 that are also defined by <linux/types.h> (<asm/types.h>) and
268 they conflict).
269
270 3. Make dump's reading of the dumpdates file a bit more robust,
271 preventing dump from crashing when the dumpdates file has
272 been modified by hand.
273
274 4. Fixed some offset calculations in dump code which could
275 lead to "bread lseek errors" on large filesystems. Thanks
276 to Bruce Lowekamp <lowekamp@users.sourceforge.net> for
277 reporting this bug and debugging the issue.
278
279 5. Made dump use the blkid library when searching for devices
280 by label or uuid instead of dump's own routines.
281
282 6. Corrected a bug in dump where a wrong LABEL=... line in
283 /etc/fstab could prevent dump from dumping unrelated
284 filesystems. Thanks to Bruce Lowekamp
285 <lowekamp@users.sourceforge.net> for reporting the bug.
286
287 Changes between versions 0.4b35 and 0.4b36 (released April 21, 2004)
288 ====================================================================
289
290 1. Fixed dump compilation with old gcc versions. Thanks to
291 Mike Castle <dalgoda@users.sourceforge.net> for the patch.
292
293 2. Fixed some warnings (howmany, roundup, powerof2 redefined)
294 when compiling against a recent glibc version.
295
296 3. Fixed a bug in restore preventing the read of a dump tape
297 written with Solaris 7 ufsdump. Thanks to Patrick Higgins
298 <phiggins@transzap.com> for reporting the bug and providing
299 the test case.
300
301 4. Changed dump to enable the creation of volumes of different
302 sizes in a single run (make -B accept a list of values).
303 Patch contributed by Florian Zumbiehl <florz@gmx.de>.
304
305 5. Use the glibc provided minor() and major() macros instead
306 of our own bitmask implementation. This should be safe for
307 when the major/minor namespace will migrate to 32 bits.
308 Thanks to Zhang Jun <zhangjun@nanjing-fnst.com> for reporting
309 the bug.
310
311 6. Made explicit in the dump man page that dump will not create
312 a remote file, it will only write to an already existing one.
313
314 7. Another try at making size estimates better again.
315
316 8. Put back the inconditional running of the end-of-tape
317 script which was changed in 0.434 to be run only when -M
318 or multiple -f were NOT specified. Some users rely on this
319 feature even when it is combined with -M/-f.
320
321 9. Fixed restore when restoring huge backups (where rstdir...
322 temporary files are over 2GB). Thanks to
323 Raphael Jaffey <rjaffey@artic.edu> for reporting this,
324 debugging the issue and making the patch.
325
326 10. Made restore understand FreeBSD UFS2 tapes. Thanks to
327 David <vrtin@users.sourceforge.net> for submitting the bug
328 and providing a test case.
329
330 11. Made dump work with an arbitrary integer level (no more 10
331 levels only limitation). Thanks to Matthew
332 <msvincen@midway.uchicago.edu> for the patch.
333
334 Changes between versions 0.4b34 and 0.4b35 (released December 21, 2003)
335 =======================================================================
336
337 1. Added a note in the dump man page saying that the default
338 blocksize can be 32 if -d is used with a high density argument.
339 Thanks to Antonios Christofides <A.Christofides@itia.ntua.gr>
340 for the patch.
341
342 2. Fixed configure to correctly understand CPPFLAGS, CFLAGS,
343 LDFLAGS environment variables. Thanks to Arcady Genkin
344 <antipode@users.sourceforge.net> for reporting the bug.
345
346 3. Made -e/-E options of dump accept an unlimited number of inodes
347 to be excluded, rather than a hardcoded maximum. Thanks to
348 Dietrich Rothe <d-rothe@users.sourceforge.net> for the patch.
349
350 4. Updated the autoconf system to 2.50. Forced the -D_BSD_SOURCE
351 and -D_USE_BSD_SIGNAL defines in configure in order to solve
352 64bit build problems because quad_t is redifined with a
353 different signature. Thanks to Mike Harris <mharris@redhat.com>
354 for reporting this bug.
355
356 5. Made restore build on Solaris, making possible to
357 restore Linux's "enhanced" tapes. Thanks to Uwe Gohlke
358 <uwe@ugsoft.de> for the patch.
359
360 6. Made an extension in the dump tape format capable of saving
361 MacOSX specific inode extensions. Uwe Gohlke <uwe@ugsoft.de>
362 wrote the extension and contributed the restore code back
363 into this codebase. The same extension mechanism will be
364 used in the future to save ACLs...
365
366 7. Made rmt work correctly with regard to QFA and local/remote
367 files and tapes. The remote access will however work only
368 when the dump provided rmt version is used. If you want to
369 use another rmt server, please do not use the QFA feature.
370 Thanks to Uwe Gohlke <uwe@ugsoft.de> for the patch.
371
372 Changes between versions 0.4b33 and 0.4b34 (released April 18, 2003)
373 ====================================================================
374
375 1. Fixed the INSTALL file to reflect the actual install paths.
376 Thanks to David Ronis <ronis@ronispc.chem.mcgill.ca> for
377 reporting the bug.
378
379 2. Fixed the configure script to only check for headers presence
380 instead of trying to compile them. This should fix issues
381 with old build environments. Thanks to Kari Lempiainen
382 <kari@funky.pp.fi> for reporting the bug.
383
384 3. Fixed restore to correctly ignore sockets when comparing
385 a dump (as socket cannot be properly restored anyway). Thanks
386 to Gunther Reiszig <gunther@mit.edu> for reporting the bug.
387
388 4. Fixed restore to correctly access the archive file (-A argument)
389 even when using a remote tape. Thanks to Fabrice Bellet
390 <fabrice@bellet.info> for reporting the bug.
391
392 5. Fixed (again) handling of long (largefile) seeks in rmt.
393 Thanks to Fabrice Bellet <fabrice@bellet.info> for reporting
394 the bug.
395
396 6. Fixed restore corner case when dealing with large block sizes
397 dump is able to write now (-b 1024). Thanks to Fabrice Bellet
398 <fabrice@bellet.info> for reporting the bug.
399
400 7. Fixed a bug preventing dump to access a filesystem having
401 a label exactly 16 bytes in length. Thanks to <minduni@ti-edu.ch>
402 for reporting the bug.
403
404 8. Made dump store dump dates using explicit timezones, fixing a
405 problem with incremental dumps if the timezone is modified
406 between the dumps. Thanks to Philippe Troin <phil@fifi.org> for
407 the bug report and the patch.
408
409 9. Fixed a bug encountered when dumping individual files (not full
410 filesystems or directories) and dangling symbolic links happen
411 to be in the list of files. For as far as dump is concerned,
412 dangling symbolic links are allowed, and are dumped as is.
413 Thanks to Jin-su Ahn <jsahn@ee.snu.ac.kr> for reporting the
414 bug and providing the fix.
415
416 10. Fixed open and creation modes and permissions for QFA and
417 table-of-contents files in dump and restore. Thanks to
418 Philippe Troin <phil@fifi.org> for the patch.
419
420 11. Fixed the archive file descriptor handling enabling it to be 0.
421 This can happen in some cases when shell redirections are used.
422 Thanks to Philippe Troin <phil@fifi.org> for the patch.
423
424 12. Delayed the opening of archive file until after suid had been
425 dropped (fixing a possible security issue if dump is suid).
426 Thanks to Philippe Troin <phil@fifi.org> for the patch.
427
428 13. Fixed the 'S' command handling in the rmt client part.
429 Thanks to Philippe Troin <phil@fifi.org> for the patch.
430
431 14. Modified the end-of-tape script handling to print out statistics
432 (and stop the timer) before launching the eot script. Also, the eot
433 script does not get run anymore when using -M (which makes sense) or
434 when multiple tapes are listed on the command line
435 (-f tape0,tape1,tapen) (which also makes sense).
436 Thanks to Philippe Troin <phil@fifi.org> for the patch.
437
438 15. Relicensed dump/restore under the 'revised' BSD license, as per
439 ftp://ftp.cs.berkeley.edu/ucb/4bsd/README.Impt.License.Change.
440
441 16. Added LZO compression to dump. This new compression method has
442 the advantage of being super fast, thus not killing tape streaming
443 on slow machines. Thanks to Helmut Jarausch
444 <jarausch@igpm.rwth-aachen.de> for the patch and to
445 Markus Oberhumer <markus@oberhumer.com> for giving special permission
446 to include his miniLZO project (GPL licensed) in dump/restore.
447
448 17. Some small buffer overruns fixes in rmt. Thanks to Antonomasia
449 <ant@notatla.demon.co.uk> for reporting the bugs.
450
451 18. Added a special rmt version which can do encryption when writing
452 to tape. Read examples/encrypted_rmt/README for details on
453 how to enable and configure it. Thanks to Ken Lalonde
454 <ken@globalremit.com> for the patch.
455
456 19. Made dump work with 2.5 kernel end of tape early warning semantics.
457 Thanks to Kai Makisara <Kai.Makisara@kolumbus.fi> for the patch.
458
459 20. Fixed a bug which caused dump -w|-W not to work anymore, because
460 the fs_freq and fs_passno fields in /etc/mtab are always set
461 to 0 0. Thanks to Trent Piepho <xyzzy@speakeasy.org> for
462 reporting the bug.
463
464 Changes between versions 0.4b32 and 0.4b33 (released February 10, 2003)
465 =======================================================================
466
467 1. Added a note in the restore man page clarifying the question
468 'set the permissions on the current directory ?' asked by
469 restore at the end of treatment in -i and -x modes.
470
471 2. Fixed the endianess issues when reading compressed tapes.
472 Thanks to Dark Force <daq4th@users.sourceforge.net> for
473 reporting this bug and providing test cases.
474
475 3. Fixed the "ACL won't be dumped" warning message (which showed
476 an extra, unrelated error message). Thanks to Dragan Krnic
477 <dkrnic@lycos.com> for reporting this bug.
478
479 4. Made dump look first into /etc/mtab, then into /etc/fstab
480 when searching for filesystem paths. Also fixed some problems
481 caused by binding mounts or multiple block device mounts.
482 Thanks to Matus Uhlar <uhlar@fantomas.sk>, Elliott Mitchell
483 <ehem@m5p.com>, Greg Edwards <gedwards@users.sourceforge.net>,
484 Brian Hoy <brian.hoy@opus.co.nz>. (fixes Debian bugs #147086
485 and #160305, Sourceforge bugs #618699 and #679832).
486
487 5. Made dump's -I option accept the value '0' meaning all the
488 read errors will be ignored. This can be useful when running
489 dump from unattended sessions (like cron jobs). Thanks to
490 John I Wang <jiwang@users.sourceforge.net> for the suggestion.
491
492 6. Fixed the output of dump to indicate 'blocks' instead of
493 'tape blocks' in the various messages (blocks are always
494 1 Kilobyte, tape blocks are 1 BK * '-b' argument), and
495 made it clearly print the current blocksize at the start of
496 a dump. Thanks to Michal Szymanski <msz@astrouw.edu.pl> for
497 the suggestions.
498
499 7. Made rmt understand long (largefiles) seeks.
500
501 8. Fixed build with very old versions of libext2fs, where
502 EXT2_FT_* constants were undefined.
503
504 9. Made dump accept the dumpdates path on the command line
505 (-D file option) instead of using only the hardcoded one.
506 Thanks to Piete Brooks <pb22@users.sourceforge.net> for the
507 suggestion.
508
509 10. Enabled rmt, LFS, readline, QFA options by default in
510 ./configure. Updated the configure process (new versions
511 of config.guess, config.sub etc).
512
513 Changes between versions 0.4b31 and 0.4b32 (released November 15, 2002)
514 =======================================================================
515
516 1. Changed dump to use fcntl(F_SETLK) style locking instead
517 of flock() when locking the dumpdates file. With the old
518 locking scheme, a local user having read rights on the
519 dumpdates file could be able to do a Denial of Service attack
520 on dump. In order to lock the dumpdates file with the new
521 scheme, the user would need to have write access on the file.
522 Thanks to Richard Johnson <Richard.Johnson3@ey.com> for
523 reporting the bug (originally a bugtraq post).
524
525 2. Fixed interactive 'ls' which caused spurious errors warnings
526 about 'undefined filetypes' detected. Thanks to Jorgen Ostling
527 <jorgen_ostling@users.sourceforge.net> for reporting this
528 bug.
529
530 3. Fixed dump's estimate when dealing with sparse inodes.
531
532 4. Modified dump to allow setting a blocksize bigger than 32kB
533 (raised the limit to 1024kB), because newer hardware needs
534 this for proper operation. Thanks to Dirk Traenapp
535 <dtraenapp@users.sourceforge.net> for reporting this.
536
537 5. Fixed a bug causing Dump to stop and report an error if an
538 inode number in the exclude file was followed by some amount
539 of whitespace. Thanks to Jeffrey Sofferin
540 <sofferin@users.sourceforge.net> for reporting this bug.
541
542 6. Fixed a bug which caused restore, in some particular cases,
543 to ask some 'scary' questions and leave a bunch of RSTTMP
544 directories behind when restoring incremental tapes. Thanks
545 to Philippe Troin <phil@fifi.org> for reporting this bug and
546 providing the test cases.
547
548 7. Changed the wording when inodes are excluded from dump:
549 replaced 'Added inode 7 to exclude list' with
550 'Excluding inode 7 (resize inode) from dump', as suggested
551 by Elliott Mitchell <ehem@m5p.com> in a Debian bug report.
552
553 Changes between versions 0.4b30 and 0.4b31 (released July 30, 2002)
554 ===================================================================
555
556 1. Fixed rmt open flags transmission (GNU's symbolic syntax over
557 rmt) which I broke in 0.4b29. Thanks to Eros Albertazzi
558 <eros@lamel.bo.cnr.it> for reporting the bug.
559
560 Changes between versions 0.4b29 and 0.4b30 (released July 25, 2002)
561 ===================================================================
562
563 1. Made dump print out the ext2 logical block number in case of a read
564 error, which can be given as an argument to debugfs' ncheck command,
565 in order to find out the affected inode. Added note about this
566 usage in dump's man page.
567
568 2. Fixed a problem in restore when reading tapes written on big
569 endian machines with very old versions of dump. The patch was
570 contributed by George Helffrich <george@geology.bristol.ac.uk>.
571
572 3. Fixed the tape length calculation when using large tapes
573 and compression. Thanks to Georg Lippold
574 <g_lippold@sourceforge.net> for reporting the bug.
575
576 4. Added a new set of examples in dump_on_cd_2 directory, based
577 on dump_on_cd examples but somewhat enhanced, supporting DVD
578 media, and localized in english and german. Thanks to
579 Georg Lippold <g_lippold@sourceforge.net> for the new scripts.
580
581 5. Made dump save 32 bit UID/GID. Internally, this was achieved
582 by switching from the old BSD inode format to the new BSD
583 inode format, which means that the tape format was changed.
584 However, since all restore versions out there should
585 transparently support both inode formats, the change should
586 have no side effects. Thanks to John Yu <jky@cs.bu.edu> for
587 reporting the bug.
588
589 6. Fixed a lot of warnings in the code shown when compiling
590 with 'gcc -W'. Thanks to Matthias Andree
591 <matthias.andree@stud.uni-dortmund.de> for reporting this.
592
593 7. Fixed a small markup bug in the dump man page. Thanks to
594 Eric S. Raymond <esr@minx.thyrsus.com> for submitting the
595 patch.
596
597 8. Rewrote entirely the man pages using the tmac.an macro
598 package (Linux man page format) instead of the original BSD
599 format. They should be now cleaner and easier to modify.
600
601 Changes between versions 0.4b28 and 0.4b29 (released June 8, 2002)
602 ==================================================================
603
604 1. Fixed a problem in the rmt ioctl command, where ioctl's issued from
605 non Linux clients were misinterpreted. The description of the problem
606 (incompatible numbering in Linux mtio opcodes) is documented at
607 ftp://ftp.fokus.gmd.de/pub/unix/star/README.mtio . Thanks to
608 Jörg Schilling <schilling@fokus.gmd.de> for reporting this bug and
609 providing an excellent, cross-platform replacement for rmt in his
610 star package.
611
612 2. Fixed a bug reported by Andy Mentges <amentges@jumpline.com>
613 which caused restore to fail when the inode maps were not entirely
614 contained on the first volume (when using really small volumes or
615 when dumping a huge number of inodes).
616
617 3. Fixed a problem in dump, where files in subdirectories of directories
618 that have the nodump flag set (or being excluded with -e/-E) were
619 sometimes incorrectly dumped (instead of being excluded). The original
620 fix is from David C Lawrence <tale@dd.org> in the FreeBSD version
621 of dump: http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32414
622 Thanks to Ted Grzesik <tedgyz@roostme.com> for reporting the bug and
623 help testing the patch.
624
625 4. Added some example scripts from Gerd Bavendiek <bav@epost.de>
626 which makes one able to pipe the output of dump, by the net, to
627 a remote CD-burner server.
628
629 5. Made dump use O_CREAT|O_TRUNC both locally and remotely (over rmt),
630 and use GNU's symbolic syntax over rmt instead of numerical values
631 to assure multiple platform compatibility.
632
633 6. Documented the -d option in restore.
634
635 7. Added a -v (verbose) mode to dump. For now it just prints the number
636 of the inode being dumped, but this could evolve in future versions
637 to include interesting debugging output.
638
639 8. Added a -o flag to restore, which automatically restores the current
640 directory permissions in -i or -x mode, without asking the operator
641 whether to do so. Patch submitted by Tony Clayton <tonyc@e-smith.com>
642 and Peter Samuel <peters@e-smith.com>.
643
644 Changes between versions 0.4b27 and 0.4b28 (released April 12, 2002)
645 ====================================================================
646
647 1. Fixed a bug in the QFA feature which could have caused
648 a bad tape positionning on restore (causing extra delays in
649 restore). Credits go to Uwe Gohlke <uwe@ugsoft.de>.
650
651 2. Added a small note in the dump man page specifying that
652 there should be no white space between the option letter and
653 the -j or -z parameter, thanks to Kenneth Porter <shiva@well.com>
654
655 3. Made restore work with older versions of the readline library,
656 by checking in configure for several extended symbols. Restore
657 can now be compiled with a readline as old as the 2.0 release
658 (though it may be a good idea to upgrade it to a more recent
659 version...). Thanks to Andrew Donkin <ard@waikato.ac.nz> for
660 reporting the build failures.
661
662 4. Fixed a performance problem with the QFA file creation in
663 dump, which made unnecessary seeks on the tape slowing down
664 the dump. Thanks to Andrew Donkin <ard@waikato.ac.nz> for
665 reporting this issue.
666
667 5. Removed the inclusion of some kernel headers in the dump
668 source, which prevented the compile in some kernel/glibc
669 headers/architecture combination. Thanks to Bdale Garbee
670 <bdale@gag.com> for reporting the bug.
671
672 6. Added the appropriate error message when dump fails to
673 open the output file for writing. Thanks to Amith Varghese
674 <amithv@yahoo.com> for reporting this bug.
675
676 7. Made restore able to understand large Solaris ufsdump tapes
677 (containing inodes bigger than 4194304). Sun have introduced
678 an "extension" to the dump tape format when dealing with
679 those inodes, which was uncorrectly handled by Linux restore.
680 Thanks to Uwe Gohlke <uwe@ugsoft.de> for reporting the bug and
681 providing a test case.
682
683 8. Added the -m parameter to dump which optimises the output for
684 inodes having been changed but not modified since the last dump
685 ('changed' and 'modified' have the meaning defined in stat(2)).
686 For those inodes, dump will save only the metadata, instead of
687 saving the entire inode contents. Inodes which are either
688 directories or have been modified since the last dump are saved
689 in a regular way. Uses of this flag must be consistent, meaning
690 that either every dump in an incremental dump set have the flag,
691 or no one has it.
692
693 Changes between versions 0.4b26 and 0.4b27 (released February 15, 2002)
694 =======================================================================
695
696 1. Fixed behaviour of dump when exceeding resource limits
697 (SIGXFSZ treatment).
698
699 2. Added the -L flag to restore to allow the user to specify a
700 maximal allowed number of miscompares when using restore
701 with the -C option to check the backup.
702
703 3. Detailed the manual entry for the -N option of restore.
704
705 4. Added the -a flag to restore to make able doing unattended
706 restores in -i or -x mode (automatically walks through the
707 multiple dump volumes).
708
709 5. Extended the QFA mode to work with local files and/or
710 remote tapes and files. This way, restore can know in advance
711 the tape number and the offset for the inodes to extract and
712 can minimize the extraction time by seeking directly to the
713 good tape/offset.
714
715 6. Added the -A <archive> option to both dump and restore,
716 which makes dump to archive a dump table-of-contents in
717 the specified file to be used by restore to determine
718 whether a file is in the dump file that is being restored.
719 (the archive file syntax is also compatible with the
720 Solaris ufsdump generated one).
721
722 7. Small fix in restore making it able to read some (broken ?)
723 Solaris ufsdump tapes.
724
725 8. Fixed dump to correctly recognise the root filesystem when using
726 ext2 disk labels (LABEL=/). Thanks to John Yu <jky@it.bu.edu>
727 for reporting this bug.
728
729 9. Added the -P <file> option to restore to create a
730 Quick File Access file from an already made dump. Patch
731 contributed by Uwe Gohlke <uwe@ugsoft.de>.
732
733 10. Made restore compile and run on Solaris, making it a
734 possible replacement for the standard ufsrestore. Port was
735 contributed by Uwe Gohlke <uwe@ugsoft.de>.
736
737 Changes between versions 0.4b25 and 0.4b26 (released January 7, 2002)
738 =====================================================================
739
740 1. Added a set of backup scripts from Eugenio Diaz
741 <getnito@yahoo.com> in the examples section. It features
742 automatic (cron based) full and incremental dumping of
743 several filesystems on a separate filesystem.
744
745 2. Fixed a off-by-one miscalculation which disabled dumping
746 a one letter subdirectory. Thanks to Chris Siebenmann
747 <cks@utcc.utoronto.ca> for reporting the bug.
748
749 3. Fixed several restore bugs occuring when trying to
750 restore some missing files on the tape. Thanks to Chris
751 Siebenmann <cks@utcc.utoronto.ca> for reporting the bug.
752
753 4. Fixed --with-ldopts configure argument passing, installing from
754 a separate object directory, makefile cleanups contributed
755 by <splite@purdue.edu>.
756
757 5. Fix a bug which could caused, in some conditions, the highest
758 number inode of a filesystem, to not be dumped. Many thanks
759 to Chris Siebenmann <cks@utcc.utoronto.ca> for helping me
760 chase this bug.
761
762 Changes between versions 0.4b24 and 0.4b25 (released November 17, 2001)
763 =======================================================================
764
765 1. Added a mini howto from Patrick Walsh in the examples
766 directory.
767
768 2. Minor man pages syntax corrections. Thanks to
769 Chris Danis <screechco@home.com> for reporting the bugs.
770
771 3. Added a script from David B. Peterson <dave@toppledwagon.com>
772 to the examples section. It features dumping several
773 filesystems to a remote tape drive upon ssh.
774
775 4. Added a patch provided by Richard Jones <rich@annexia.org>
776 which allows BRADEMAX (number of read errors tolerated by
777 dump) to be adjusted using the -I option.
778
779 5. Fixed a bug which disabled doing "restore -C -f -". Thanks
780 to Clemens Stiglechner <a9401816@unet.univie.ac.at> for the
781 patch.
782
783 6. Add the -l option to restore to specify if, when doing a
784 remote restore, the file used to access the backup is a
785 regular file (the defaults being a tape drive). Restore needs
786 to know this information when reading a remote compressed
787 dump. Previously, this information was autodetected, but
788 the autodetection code fails (with ioctl: Inappropriate ioctl
789 for device) when using a non Linux remote box. Thanks to
790 many users and especially to Eros Albertazzi
791 <eros@lamel.bo.cnr.it> for reporting this.
792
793 7. Found a workaroung for the dump deadlock problem (3 childs
794 stuck in pause(), father in read()). The workaround seems
795 to work for me and several beta-testers. If it doesn't work
796 for you, please report back.
797
798 8. Updated the RPM spec file (BuildPrereq, URL etc).
799
800 Changes between versions 0.4b23 and 0.4b24 (released September 12, 2001)
801 ========================================================================
802
803 1. Fixed the permissions of a newly created QFA file by dump.
804
805 2. Cleaned up the source of dump (the external variables
806 definition was a complete mess, making possible to have
807 objects overlap).
808
809 3. Fixed restore to use the full tape volume path when doing
810 a compare (since it changes the working directory to the
811 filesystem being compared in the process).
812
813 4. Added the -q option to dump which makes dump abort
814 whenever it needs operator attention. It should be
815 easier to use dump in scripts with this option.
816
817 5. Detect the use of incompatible options to dump and
818 refuse them (like -a and -B options together).
819
820 6. Added bzip2 compression to dump/restore (use option -j level
821 to select it). Note that you will need a restore version
822 >= 0.4b24 in order to restore a bzip2 compressed dump.
823 The same warning as for the zlib compression applies:
824 the tape format of a bzip2 dump is not compatible with the
825 original BSD tape format.
826
827 7. Fixed a overflow problem in dump corrupting the dump when
828 very large files were encountered. Thanks to Vladimir Nadvornik
829 for the bug report.
830
831 8. Added a ioctl(BLKFLSBUF) in dump which should flush the
832 kernel buffer/page cache before starting the dump, helping
833 a bit those who use dump on mounted filesystems. Thanks to
834 John Yu <jky@it.bu.edu> and to Theodore T'so <tytso@mit.edu>
835 for this suggestion.
836
837 9. Updated the RPM spec file following the RedHat changes
838 (dynamically linked binaries now in /usr/sbin etc).
839
840 10. Added a patch from Helmut Jarausch <jarausch@igpm.rwth-aachen.de>
841 which enables restore to recognise multi volume compressed dumps
842 done on CD. Included his scripts for dump (which pipe the dump
843 output directly into cdrecord) and restore. There is now
844 possible to to backups to CD on the fly!
845
846 Changes between versions 0.4b22 and 0.4b23 (released July 20, 2001)
847 ===================================================================
848
849 1. Fixed a buffer overflow in restore/tape.c. Patch provided by
850 Marcus Meissner (Caldera International Security Dept.).
851
852 2. Implement the Sun rmt extended protocol. Patch submitted
853 by Ian Gordon <iangordon@users.sourceforge.net>.
854
855 3. Check for the e2fsprogs header <ext2fs/ext2_fs.h> instead of
856 the linux kernel header. This ensures that dump always has the
857 latest version of this file. Patch submitted by
858 Andreas Dilger <adilger@turbolinux.com>.
859
860 4. Report any filesystem present in either /etc/fstab with a
861 positive passno or /etc/dumpdates in dump -w output.
862 Patch submitted by Andreas Dilger <adilger@turbolinux.com>.
863
864 5. Fixed the looping problem in dump introduced in the
865 previous version.
866
867 6. Changed the -B option of dump to limit the size of
868 _compressed_ output per volume if compression is on.
869 Patch contributed by Helmut Jarausch
870 <jarausch@igpm.rwth-aachen.de>. Note however that, since
871 it is impossible to predict the size of the compressed
872 data before doing the compression, the -B limit is a bit
873 conservative.
874
875 7. Fixed a bug in reading the operator typed file/tape path for
876 the next volume in restore.
877
878 8. Implemented a "-F script" option to restore which permits the
879 user to specify a script which will be launched at the
880 beginning of each tape, useful for automatic programming of
881 tape changers for example. See the restore man page for the
882 script parameters and return codes.
883
884 9. Small fix for the QFA routines provided by Uwe Gohlke
885 <uwe@ugsoft.de>, and some recommendations for QFA uses in
886 the man pages.
887
888 10. Fixed the multivolume restoring where making a mistake
889 to the 'Mount next tape' prompt caused several blocks to
890 be lost.
891
892 11. Enhanced the -e option of dump to take as a parameter a
893 comma separated list of inode numbers.
894
895 12. Added the -E option to dump which specify a file containing
896 inode numbers to exclude from the dump.
897
898 13. Fixed the compressed multi-volume dump + restore.
899
900 Changes between versions 0.4b21 and 0.4b22 (released May 12, 2001)
901 ==================================================================
902
903 1. Made dump report the number of blocks dumped per volume.
904 Thanks to Kenneth Porter <shiva@well.com> for the suggestion.
905
906 2. Fix a bug in dump where waiting too much at the 'change volumes'
907 question caused the volume to be rewritten. Thanks to
908 Graham Reed <greed@users.sourceforge.net> for reporting the
909 bug and providing a patch.
910
911 3. Added a compression option to dump, contributed by Jerry
912 Peters <gapeters@worldnet.att.net>.
913
914 WARNING: the compression works only on files/pipes and
915 drives supporting variable block size.
916
917 WARNING2: tapes created using the compression feature are
918 incompatible with the standard dump tape format, and a
919 version of restore >= 0.4b22 will be needed for extraction.
920
921 4. Fixed some compilation problems for glibc 2.2.2 and 64 bit
922 architectures. Thanks to Paul Slootman <paul@debian.org> for
923 the patch and to Bdale Garbee <bdale@gag.com> for forwarding
924 it upstream.
925
926 5. Many cleanups (CPP defines, const char warnings, check of
927 ext2fs COMPAT flags, time_t cleanups, added libext2 version
928 in dump usage text) by Andreas Dilger <adilger@turbolinux.com>.
929
930 6. Made --prefix option work in configure. All the install path
931 are now based on the configure parameters.
932
933 7. Added the Quick File Access mode in dump/restore, contributed
934 by Uwe Gohlke <uwe@ugsoft.de>. In this mode, dump stores in
935 a file tape position for each inode, and this file is used by
936 restore (if called with parameter Q and the filename)
937 to directly position the tape at the file restore is currently
938 working on. This saves hours when restoring single files from
939 large backups, saves the tapes and the drive's head. Use
940 --enable-qfa option of configure to compile in the QFA support.
941
942 8. Added the possibility to dump several files and directories
943 in a single invocation of dump. Thanks to Uwe Gohlke
944 <uwe@ugsoft.de> for implementing this option.
945
946 9. Fixed the dumping and restoring of files with holes
947 (files ending with holes didn't get dumped or restored
948 correctly).
949
950 10. Fixed a socket descriptor leak in dump, which leaved opened
951 3 file descriptors per dump process (and there is one dump
952 process per tape).
953
954 11. Fixed dump large file system support, by explicit use of
955 open64/lseek64/etc functions (explicit use needed because
956 e2fsprogs libraries don't behave well when compiled with
957 FILE_OFFSET_BITS=64).
958
959 Changes between versions 0.4b20 and 0.4b21 (released January 13, 2001)
960 ======================================================================
961
962 1. Fixed some bugs in the dump -w|-W logic introduced by
963 the previous version. Thanks to Andreas Dilger
964 <adilger@turbolinux.com> for his help on this one.
965
966 2. Fixed again a compilation problem when using old e2fs
967 headers (filesystem label related). Thanks to many users
968 who reported this stupid error.
969
970 3. Fixed a build problem on old lib5 based systems dealing with
971 _PATH_MNTTAB being undefined. Thanks to John Adams
972 <johna@onevista.com> for reporting the bug.
973
974 4. Improved the error detection in restore when creating
975 the temporary files in TMPDIR. Now restore will corectly
976 report a 'no space left on device' error instead of
977 strange errors which could imply an archive corruption.
978 Thanks to Gabriel Somlo <somlo@cs.colostate.edu> and
979 bgjenero <bgjenero@sympatico.ca> for reporting the bug.
980
981 5. Added the throughput information in dump's progression
982 messages. Thanks to Andreas Dilger <adilger@turbolinux.com>
983 for the patch.
984
985 6. Use libext2fs's inode scanning routines, which are particularly
986 robust when dealing with errors (especially when having some
987 bad blocks on the filesystem). Many thanks to Colin
988 <colin@horizon.com> for reporting the bug, investigating
989 the issues, finding a workaround, writing the patch and
990 fully testing it... (of course, if this patch will break
991 anything, he is to blame for :-)).
992
993 7. Made dump and restore LFS aware. Dump can dump a filesystem
994 containing large files, generate a large file on output and
995 restore can restore them. This feature is not enabled by
996 default, use --enable-largefile option of configure to enable
997 it (you need to have a LFS aware glibc though). Thanks to
998 Andrea Arcangeli <andrea@suse.de> for submitting the patch,
999 and to Theodore T'so <tytso@valinux.com> for his always
1000 useful thoughts.
1001
1002 8. Made dump ask upon a tape write error if it should rewrite
1003 the current volume (assume this is a bad tape) or if it should
1004 assume an end-of-tape condition (useful for tape drives which
1005 behaves badly at the end of the tape). Thanks to Andreas
1006 Dilger <adilger@turbolinux.com> for the suggestion.
1007
1008 Changes between versions 0.4b19 and 0.4b20 (released November 10, 2000)
1009 =======================================================================
1010
1011 1. Fixed a small compilation problem due to a change
1012 in the definintion of the struct sigaction in
1013 glibc 2.0 / libc5. Thanks to Gunther Schlegel
1014 <schlegel@riege.de> for reporting the bug and to
1015 Dave Platt <dplatt@snulbug.mtview.ca.us> for suggesting
1016 a fix.
1017
1018 2. Modified the label and uuid analysis in order to be
1019 self-contained (independant of kernel/libc headers). This
1020 should fix the compile with older kernel/libc headers and
1021 will preserve the functionality. Thanks to Bernhard Erdmann
1022 <bernhard.erdmann@gmx.de> for reporting the bug.
1023
1024 3. The 'exclude inode' option, if applied to a directory
1025 inode, excludes now correctly all the leaves of this
1026 directory. Thanks to John R. Dennison
1027 <gerdesas@users.sourceforge.net> for reporting the bug.
1028
1029 4. Fixed the '-e' option to disable the possibility
1030 to exclude the root inode (which causes the dumps to
1031 be unreadable by restore). Prevented array overflow
1032 when multiple -e options are used.
1033
1034 5. Fixed dump to correctly interpret a filesystem argument
1035 which is a mountpoint and it is not an absolute path
1036 (as specified in the fstab). Thanks to Bernhard R. Erdmann
1037 <be@berdmann.de> for reporting the bug.
1038
1039 6. Made dump able to backup files larger than 2 GB. Note that
1040 dump still doesn't cope with files larger than 4 GB.
1041
1042 7. Restore the real uid and gid before invoking an external
1043 RSH program (big hole when dump or restore is suid root!).
1044
1045 8. Get the values for the default tape device and the location
1046 of fstab file from the system headers. Thanks to
1047 Andreas Dilger <adilger@turbolinux.com> for the patch.
1048
1049 9. Made dump -w|-W report all recognized filesystems
1050 present in either /etc/fstab or /etc/dumpdates, and present
1051 the list in the same order as in fstab file. Thanks
1052 to Andreas Dilger <adilger@turbolinux.com> for the patch.
1053
1054 10. Made dump's -a (automatic end of tape detection) the
1055 default. Specifying one of -B, -c, -d or -s options will
1056 override the EOM detection. Thanks to Andreas Dilger
1057 <adilger@turbolinux.com> for the patch.
1058
1059 11. Save the ext2 filesystem label into the dump volume label.
1060 Specifying a volume label on the command line (-L option)
1061 will override this feature. Thanks to Andreas Dilger
1062 <adilger@turbolinux.com> for the patch.
1063
1064 Changes between versions 0.4b18 and 0.4b19 (released August 20, 2000)
1065 =====================================================================
1066
1067 1. Fixed the signal handling in dump (which I broke in 0.4b17)
1068 which was causing several strange dump failures (dump
1069 hanged or segmentation faults etc).
1070
1071 2. Specified the default blocksize in the dump man page.
1072
1073 3. Changed two info messages of restore to be written on stdout
1074 instead of stderr in order to leave stderr only for errors
1075 or warnings. Thanks to Stephen Atwell
1076 <satwell@urbana.css.mot.com> for the suggestion.
1077
1078 4. Corrected an off by one calculation which prevented
1079 dumping a directory having a 1 character name length.
1080 Thanks to Bernhard Erdmann <bernhard.erdmann@gmx.de>
1081 for reporting the bug.
1082
1083 5. Reinforce dump in order to allow only level 0 and no
1084 -u option when dumping a subdirectory, and document
1085 this in the man page. Thanks to Bernhard Erdmann
1086 <bernhard.erdmann@gmx.de> for reporting the bug.
1087
1088 6. Fixed a small harmless bug in restore which caused
1089 in some conditions hard links to be restored several
1090 times (therefore generation some warning messages).
1091 Thanks to Kenneth Porter <shiva@well.com> for
1092 reporting the bug.
1093
1094 7. Updated the RPM spec file to the latest RedHat version,
1095 providing FHS packaging and other cosmetic changes.
1096 You will need RPM version >= 3.0.5 in order to build the RPM.
1097
1098 8. Updated the configure script to check for libtermcap
1099 before checking for libreadline, because we need this
1100 library in order to compile the readline support.
1101
1102 9. Made dump understand the LABEL= and UUID= notation
1103 both in /etc/fstab and on the command line. Note that
1104 you will need the /proc filesystem in order to use
1105 these notations. Thanks to Erik Troan <ewt@redhat.com>
1106 for providing the patch.
1107
1108 Changes between versions 0.4b17 and 0.4b18 (released June 30, 2000)
1109 ===================================================================
1110
1111 1. Fixed a potential buffer overflow in restore. Thanks
1112 to Stan Bubrouski <satan@fastdial.net> for reporting
1113 the bug.
1114
1115 2. Fixed a readline-related bug which prevented
1116 'cat DUMPFILE | restore -i -f -' from working. Thanks
1117 to Charles Karney <karney@users.sourceforge.net>
1118 for the bug report.
1119
1120 3. Changed a few "panic" into "exit", causing restore to
1121 be more stable against some attacks (like the last one
1122 reported on Bugtraq, although the last version of restore
1123 was not vulnerable - just dumped core). Thanks to
1124 Andreas Hasenack <andreas@conectiva.com.br> for reporting
1125 the bugs to me.
1126
1127 4. Removed the suid-root bit on dump and restore in the
1128 default build (and generated RPMs). It should be safer
1129 now. Users who need the suid-root capabilities in order
1130 to make network backups should read first the man page
1131 of dump and enable the suid bit manually.
1132
1133 5. Added -ltermcap to the compile parameters for restore
1134 when using readline support, in order to make the compile
1135 process work on some systems (SuSE ?). Thanks to
1136 Patrik Schindler <poc@pocnet.net> for reporting the bug.
1137
1138 Changes between versions 0.4b16 and 0.4b17 (released June 1st, 2000)
1139 ====================================================================
1140
1141 1. The -F script is called now *only* at the end of a tape,
1142 not at the end of the dump. Thanks to Christian Haul
1143 <haul@informatik.tu-darmstadt.de> for the bug report.
1144
1145 Normally, the device name and the current volume number
1146 are passed on the command line of the script. However,
1147 if you want the old style script (with no arguments
1148 passed on the command line), you can enable it in
1149 configure with the --enable-oldstylefscript.
1150
1151 2. Use posix signal handling to preserve dump functionality
1152 with libc5. Thanks to Jeff Johnson <jbj@redhat.com> for
1153 the patch.
1154
1155 3. Made the exit code of restore in case of a 'C'ompare
1156 command reflect the result of the compare. An exit status
1157 of 0 means the dump archive is correct, 1 means tape errors,
1158 2 means that some files were modified. Thanks to Kenneth Porter
1159 <shiva@well.com> for the suggestion.
1160
1161 4. Made (finally) quotes work in interactive restore.
1162
1163 5. Small fixes in order to allow dump to compile with a
1164 really old e2fsprogs version. Thanks to Ian Zimmerman
1165 <itz@speakeasy.org> for the bug report.
1166
1167 6. Add GNU readline capabilities to interactive restore.
1168 Use configure's --enable-readline flag to enable this feature.
1169 Thanks to Patrik Schindler <poc@pocnet.net> for the
1170 suggestion.
1171
1172 7. Do the compare on the fly in restore 'C' mode (this will
1173 allow not to exhaust the available /tmp space when
1174 ccmparing large files). Thanks to Kenneth Porter
1175 <shiva@well.com> for the suggestion.
1176
1177 Changes between versions 0.4b15 and 0.4b16 (released March 11, 2000)
1178 ====================================================================
1179
1180 1. Fixed some several duplicate 'DUMP: DUMP:' in the
1181 output of dump.
1182
1183 2. Corrected the estimation of blocks to dump. Note that
1184 this is still wrong for large directory inodes, due
1185 to the size of a BSD directory entry on the tape
1186 (estimation is based on the size of the ext2 directory,
1187 which is smaller because it doesn't contain the null
1188 character at the end).
1189
1190 3. Made dump report the total number of MB written to
1191 tape at the end of run. Thanks to W. Reilly Cooley
1192 <wcooley@nakedape.cc> for the patch.
1193
1194 4. Added the -X option to restore giving the possibility
1195 to read the names of the files to be extracted/listed
1196 from a text file (in addition of the command line).
1197 Thanks to Dejan Muhamedagic <dejan@quant-x.com> for the
1198 patch.
1199
1200 5. Added the device name and the current volume number
1201 as arguments to the end of tape script (dump -F option).
1202
1203 6. Made the multi-volume dump work again (after having
1204 broken it in 0.4b15).
1205
1206 Changes between versions 0.4b14 and 0.4b15 (released March 2, 2000)
1207 ===================================================================
1208
1209 1. Added a prompt command in interactive restore mode. Thanks
1210 to Andreas Dilger <adilger@home.com> for the patch.
1211
1212 2. Fixed a buffer overflow problem in dump (caused by
1213 not checking the size of the filesystem parameter).
1214 Thanks to Kim Yong-jun <loveyou@hackerslab.org> for
1215 reporting this on Bugtraq (and to several dump users
1216 who forwarded me his mail).
1217
1218 3. Added the '-F script' option to dump in order to
1219 launch a script at the end of each tape (to be used
1220 with a tape changer, or to notify the sysadmin by
1221 pager etc.).
1222
1223 4. Fixed a bug in restore compare code caused by the changes
1224 I made in 0.4b14.
1225
1226 5. Fixed the treatment of options using the old BSD syntax
1227 in both dump and restore.
1228
1229 Changes between versions 0.4b13 and 0.4b14 (released February 10, 2000)
1230 =======================================================================
1231
1232 1. Fixed a bug in dump which may have caused invalid deleted
1233 directories to be dumped out if they were deleted after the
1234 mapping pass. This could occure on active filesystem and lead
1235 to heap corruption (causing dump malfunction in many possible ways).
1236 Thanks to Jan Sanislo <oystr@cs.washington.edu> for finding this
1237 bug and submitting the patch.
1238
1239 2. Fixed the handling of the filesystem parameter in dump. A
1240 '/mnt/disk' parameter caused the disk contents to be dumped,
1241 but a '/mnt/disk/' parameter caused the mountpoint directory
1242 to be dumped (generally an empty directory).
1243
1244 3. Improved the output of dump in order to tell which directory
1245 it is currently dumping (when dumping a subtree).
1246
1247 4. Added the '-e' exclude inode option to dump. Thanks to
1248 Isaac Chuang <ike@isl.stanford.edu> for contributing with the patch.
1249
1250 5. Added a REPORTING-BUGS file in order to provide a guide
1251 on how to correctly report a bug in dump/restore.
1252
1253 6. Fixed a restore problem when restoring a hard link to an inode
1254 having the immutable or append-only attribute set. Thanks to
1255 Ambrose Li <acli@mingpaoxpress.com> for submitting the patch.
1256
1257 7. Fixed a compatibility problem between dumps made on little
1258 endian machines (the format was correct) and big endian
1259 machines (the format was incorrect). This fix break the
1260 compatibility with the older dumps made on big endian
1261 machines (sparc, m86k, ppc etc). For the first time in
1262 linux dump's history (I believe), the dumps made by *BSD,
1263 Linux/alpha, Linux/sparc and Linux/x86 are compatible,
1264 so interchangeable. Thanks to Rob Cermak
1265 <cermak@ahab.rutgers.edu> for submitting the bug and
1266 helping me test the fix.
1267
1268 8. Fixed the way dump reports the remaining percent/time, if
1269 the number of blocks actually dumped exceeds the estimated
1270 number of blocks. Thanks to Jean-Paul van der Jagt
1271 <jeanpaul@dutepp0.et.tudelft.nl> for reporting the bug.
1272
1273 Changes between versions 0.4b12 and 0.4b13 (released January 21, 2000)
1274 ======================================================================
1275
1276 1. Small Y2K fix in the man pages :). Thanks to Bernhard Sadlowski
1277 <sadlowsk@Mathematik.Uni-Bielefeld.DE> for reporting the bug.
1278
1279 2. Removed the requirement to build the RPM as root from the
1280 spec file. Thanks to Christian Weisgerber
1281 <naddy@mips.rhein-neckar.de> for submitting this.
1282
1283 3. Fixed a bug in dump related to the 'filetype' feature of ext2fs,
1284 causing dump to block when dumping really huge filesystems.
1285 Many thanks to Patrik Schindler <poc@pocnet.net> for
1286 helping me find this bug.
1287
1288 4. Fixed the treatment for an interrupt signal when dump access
1289 the remote tape through RSH. Thanks to Christian Weisgerber
1290 <naddy@mips.rhein-neckar.de> for providing the patch.
1291
1292 5. Fixed a bug which was causing dump/restore to display
1293 garbage characters instead of the remote host name.
1294
1295 Changes between versions 0.4b11 and 0.4b12 (released January 8, 2000)
1296 =====================================================================
1297
1298 1. Small fix in the dump man page. Thanks to Thorsten Kukuk
1299 <kukuk@suse.de> for submitting the patch.
1300
1301 2. Fix for the exit code when using the size estimate option of
1302 dump. Thanks to Matti Taskinen <mkt@rni.helsinki.fi> for
1303 submitting the patch.
1304
1305 3. Handle EINTR in atomical reads/writes in dump, which was causing
1306 dump to fail on some systems. Thanks to Eric Jergensen
1307 <eric@dvns.com> for reporting the bug and submitting the patch.
1308
1309 4. Handle more than 16 characters for the device names in dumpdates.
1310 (up to 255 now). Thanks to Rainer Clasen <bj@ncc.cicely.de> for
1311 tracking down the problem and proposing the solution.
1312
1313 5. Fixed a bug in dump which prevented the creation of the
1314 dumpdates file when doing a 0-level dump without already
1315 having a dumpdates file. Thanks to Patrik Schindler
1316 <poc@pocnet.net> for reporting the bug.
1317
1318 6. Changed the way dump 'S' flag reports the size estimate
1319 from number of blocks into bytes (making it compatible
1320 with the Solaris version, and simplifying things for
1321 amanda users). Thanks to Jason L Tibbitts III
1322 <tibbs@math.uh.edu> for reporting the bug.
1323
1324 7. Fixed a compatibility problem in linux/alpha dump tape format.
1325 Now the linux/alpha dump are (again) compatible with the
1326 other dump formats. But this breaks compatibility with
1327 older dumps made on alpha. Thanks to Mike Tibor
1328 <tibor@lib.uaa.alaska.edu> for helping me in finding this bug.
1329
1330 Changes between versions 0.4b10 and 0.4b11 (released December 5, 1999)
1331 ======================================================================
1332
1333 1. Added a '--enable-kerberos' to configure.
1334
1335 2. Added a 'S' option to dump which determines the amount of space
1336 that is needed to perform the dump without actually doing it, similar
1337 to the Sun's ufsdump 'S' option. Patch contributed by Rob Cermak
1338 <cermak@ahab.rutgers.edu>.
1339
1340 3. Added a 'M' multi-volume option to dump and restore which enables
1341 dumping to multiple files (useful when dumping to an ext2
1342 partition to make several dump files in order to bypass the 2GB
1343 file size limitation). The 'f' argument is treated as a prefix and
1344 the output files will be named <prefix>001, <prefix>002 etc. With
1345 the 'M' flag, restore automatically selects the right file without
1346 asking to enter a new tape each time.
1347
1348 4. Fixed a memory leak which was causing dump to grow very big
1349 (270MB when dumping a 10GB filesystem...). Thanks to Jason
1350 Fearon <jasonf@netrider.org.au> for reporting the bug.
1351
1352 Changes between versions 0.4b9 and 0.4b10 (released November 21, 1999)
1353 ======================================================================
1354
1355 1. Make configure test if the system glob routines support
1356 extended syntax (ALTDIRFUNC). If not, use the internal glob
1357 routines instead of system ones. Thanks to Bernhard Sadlowski
1358 <sadlowsk@Mathematik.Uni-Bielefeld.DE> for reporting the bug
1359 and helping me resolve this and other minor libc5 compiling
1360 glitches.
1361
1362 2. Fix a problem when dumping a ext2fs with the 'filetype'
1363 feature enabled. Thanks to Patrick J. LoPresti
1364 <patl@cag.lcs.mit.edu> for reporting the bug and to
1365 Theodore Y. Ts'o <tytso@mit.edu> for providing the patch.
1366
1367 3. Made the nodump flag work on directories. A directory which
1368 has the nodump flag gets never dumped, regardless of its
1369 contents.
1370
1371 4. Integrate a patch from Jeremy Fitzhardinge <jeremy@goop.org>
1372 which allows dump on an active ext3 filesystem. However, this
1373 is a "quick and dirty" patch which enables backup of an ext3
1374 filesystem through the ext2 compatibility (by ignoring the
1375 NEEDS_RECOVERY bit). The journal file is not recognized and
1376 it is dumped (it should not).
1377
1378 5. Test the superblock compatibility flags when dumping, in order
1379 to be sure that we know how to deal with specific features.
1380
1381 Changes between versions 0.4b8 and 0.4b9 (released November 5, 1999)
1382 ====================================================================
1383
1384 1. Use lchown instead of chown, fixing a possible security problem
1385 when restoring symlinks (a malicious user could use this
1386 to deliberately corrupt the ownership of important system files).
1387 Thanks to Chris Siebenmann <cks@utcc.utoronto.ca> for detecting
1388 this and providing the patch.
1389
1390 Changes between versions 0.4b7 and 0.4b8 (released November 3, 1999)
1391 ====================================================================
1392
1393 1. Put dump sources under CVS, added Id tags in all files so
1394 one can use 'ident' on binary files.
1395
1396 2. Added the dump/restore version in the usage text so one can
1397 easily verify the version he is using.
1398
1399 3. Small patch from Nuno Oliveira <nuno@eq.uc.pt> which fixes
1400 a va_start/va_end problem on linux-ppc (always call va_start
1401 va_end in pairs each time we use a vararg function).
1402
1403 4. Added again the DT_* constants because old libc does not
1404 contain them :(. Thanks to Eric Maisonobe <virnet@nat.fr>
1405 for submitting the bug report.
1406
1407 5. Use ext2fs_llseek instead of llseek. With recent e2fsprogs
1408 this should enable dumping big (huge) filesystems.
1409
1410 6. Added the RSH environment variable in order to be able to
1411 use a rsh replacement like ssh when doing remote backups (and
1412 bypass the security limitations of rcmd). Now you can do remote
1413 backups without being root (or making dump setuid root).
1414
1415 7. Modified again the way dumpdates works. For incremental dumps,
1416 we need to read dumpdates even if we are not using 'u' option.
1417 Thanks to Bdale Garbee <bdale@gag.com> for his ideas on how
1418 this should work.
1419
1420 Changes between versions 0.4b6 and 0.4b7 (released October 8, 1999)
1421 ===================================================================
1422
1423 1. Removed the 'k' flag from the restore 'about' text if kerberos
1424 was not compiled in.
1425
1426 2. Prototyped (f)setflags from e2fsprogs and corrected the calls
1427 to them (fsetflags takes a char*, setflags an open fd!).
1428
1429 3. (f)setflags is called only if the flags aren't empty. If the
1430 file is a special file, a warning is printed, because changing
1431 flags implies opening the device. Normally, a special file
1432 should not have any flag... (Debian bug #29775, patch provided
1433 by Abhijit Dasgupta <abhijit@ans.net>).
1434
1435 4. Made possible to dump a file system not mentioned in /etc/fstab.
1436 (Debian bug #11904, patch provided by Eirik Fuller <eirik@netcom.com>).
1437
1438 5. Changed the default behaviour to not create dumpdates
1439 unless 'u' option is specified. Removed the old "debian-patch"
1440 which provided the same thing. (Debian bug #38136, #33818).
1441
1442 6. Removed all those dump*announce, since they were getting old...
1443
1444 7. Added warning messages if dumpdates does not exist and
1445 when an inferior level dump does not exist (except for a level 0
1446 dump).
1447
1448 8. Debugged the glob calls in interactive mode: restore used a
1449 dirent struct which was different from the /usr/include/dirent.h
1450 one (this used to work, is it a glibc2 change?), so none of the
1451 compat glob (which used /usr/include/dirent.h) or the system glob
1452 worked. Restore use now the system dirent (and the system
1453 DT_* constants), which are compatible with BSD ones.
1454
1455 9. Added a configure flag (--with-dumpdatespath) to specify
1456 the location of dumpdates file. By default, it is
1457 /etc/dumpdates.
1458
1459 10. Added the "AUTHOR" and "AVAILABILITY" sections and
1460 included the current date/version in man pages.
1461
1462 11. Corrected the estimation of remaining time when
1463 the operator doesn't change the tapes quickly enough. This
1464 was an old bug, I thought I corrected it, and discovered
1465 that in fact it was corrected in two different places, so
1466 the results canceled each other...
1467
1468 Changes between versions 0.4b5 and 0.4b6 (released October 1, 1999)
1469 ===================================================================
1470
1471 1. Integrated multiple patches from RedHat, Debian and SuSE:
1472
1473 - tweak dump/itime.c to not try to read dumpdates if the 'u' option
1474 isn't specified.
1475 - several fixes in the man pages.
1476 - update the default tape device to /dev/st0.
1477 - many updates for Linux Alpha (byte ordering, size_t etc).
1478 - buffer overruns.
1479 - use environment variable for TMPDIR (instead of /tmp).
1480 - use sigjmp_buf instead of jmp_buf (RedHat bug #3260).
1481 - workaround egcs bug (RedHat bugs #4281 and #2989).
1482 - wire $(OPT) throughout Makefile's.
1483
1484 2. Upgrade the dump revision to 1, making possible to dump filesystems
1485 made with e2fsprogs-1.15 or newer. Nothing seems to break...
1486
1487 3. Fix some compile warnings, prototype all functions.
1488
1489 4. Use glibc err/glob instead of internal compatibility
1490 routines (only if available).
1491
1492 5. Fix a compile error on Linux 2.2.7 / libc5 (5.4.44) (patch provided
1493 by Bernhard Sadlowski <sadlowsk@mathematik.uni-bielefeld.de>).
1494
1495 Changes between versions 0.4b4 and 0.4b5 (released September 22, 1999)
1496 ======================================================================
1497
1498 1. Integrated the changes from FreeBSD-3.1-RELEASE
1499 (mostly bug fixes, buffer overruns, dump has now an "automatic
1500 tape length calculation" flag, dump/restore can use kerberos now
1501 (this is NOT tested), use environment variables for TAPE and
1502 RMT etc.).
1503
1504 2. Integrated three RedHat patches ("glibc", "kernel" and "bread" patches)
1505
1506 3. Corrected a bug in restore when using 'C' option with multi-volumes
1507 tapes (files splited accros two tapes give "size changed" errors
1508 when comparing).
1509
1510 4. Corrected the long standing bug when dumping multiple tapes.
1511 This works for me, needs further testing.
1512
1513 Changes between versions 0.4b3 and 0.4b4 (released January 17, 1997)
1514 ====================================================================
1515
1516 1. Dump now runs correctly on kernels 2.1.x
1517 Fix made by Gerald Peters <gapeters@worldnet.att.net>
1518
1519 Changes between versions 0.4b2 and 0.4b3
1520 ========================================
1521
1522 1. Use realpath() if available
1523
1524 2. Report statistics
1525
1526 Changes between versions 0.4b1 and 0.4b2
1527 ========================================
1528
1529 1. Fixed the bug fix from Greg Lutz (I had made a mistake when integrating
1530 the patch)
1531
1532 2. Fixed restore to make it able to read FreeBSD 2.x dumps again
1533
1534 3. Fixed configure.in to correctly handle --enable-rmt
1535
1536 Changes between versions 0.3 and 0.4b1
1537 ======================================
1538
1539 1. Integrated the changes from 4.4BSD-Lite2
1540
1541 2. Integrated the patches from Debian and Red Hat
1542
1543 3. Portability changes: use the __u32, __u16, __s32, and __s16 types
1544
1545 4. Changed dump to use the Ext2fs library to get block addresses. This
1546 should solve the endianness problem on SparcLinux.
1547
1548 5. Created a configure.in file (shamelessly stolen from the e2fsprogs
1549 distribution's one) to use autoconf
1550
1551 6. Fixed a few minor bugs
1552
1553 Changes between versions 0.2e and 0.2f
1554 ======================================
1555
1556 1. Added the creation of named pipes (fifos) in restore.
1557
1558 2. Added the -N flag in the restore manual page.
1559
1560 3. Added the file kernel.patch which contains the llseek() optimization
1561 patch for 1.2.x kernels.
1562
1563 4. Fixed a bug in the restoration of symbolic links: owner and group were
1564 not restored.
1565
1566 5. Integrated some changes from FreeBSD 2.2.
1567
1568 6. Added a call to ftruncate() after restoring each file to restore
1569 correctly files ending by a hole.
1570
1571 Changes between versions 0.2d and 0.2e
1572 ======================================
1573
1574 1. Fixed a bug in the "set owner/mode" process. Every file was restored
1575 with owner = root (0) and group = root/wheel/whatever (0).
1576
1577 Changes between versions 0.2c and 0.2d
1578 ======================================
1579
1580 1. Dump is now able to backup 2GB+ filesystems.
1581
1582 2. Dump and restore can now be linked as static binaries.
1583
1584 Changes between versions 0.2b and 0.2c
1585 ======================================
1586
1587 1. Fixed a bug when dumping ``slow'' (i.e. normal) symbolic links.
1588
1589 Changes between versions 0.2a and 0.2b
1590 ======================================
1591
1592 1. Really fixed the bug that I should have corrected in 0.2a.
1593
1594 2. Enabled optimization again.
1595
1596 Changes between versions 0.2 and 0.2a
1597 =====================================
1598
1599 1. Disabled the optimization during compilation.
1600
1601 Changes between versions 0.1 and 0.2
1602 ====================================
1603
1604 1. Fixed a bug in fstab.c which caused a null pointer to be stored in
1605 the fs_type field (actually, I modified the file fstab.c to make it
1606 use the mntent functions).
1607
1608 2. Dump and restore now use a 4.3 BSD compatible dump format. Backups
1609 made by dump should be readable by the BSD restore and backups made
1610 by the BSD dump should be readable by restore. Unfortunately, this
1611 means that the dump format has changed between version 0.1 and version
1612 0.2 :-(
1613
1614 3. Dump is now able to backup a subtree, it is no longer limited to whole
1615 filesystems like the BSD version.
1616
1617 4. Dump now uses ext2_llseek() so it is able to backup filesystems bigger
1618 than 2 GB.
1619
1620 Changes between versions 0.0 and 0.1
1621 ====================================
1622
1623 1. Now create links rdump and rrestore during the `make install' step.
1624
1625 2. Linux port specific bugs added to the manual pages
1626
1627 3. Incorrect estimation of the number of tapes blocks fixed when doing
1628 incremental backups.
1629
1630 4. Better ls-like format in restore in interactive mode.