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