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