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