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