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