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