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