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