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