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