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