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