]> git.wh0rd.org - dump.git/blob - CHANGES
Fixed a lot of warnings in the code thanks to 'gcc -W'
[dump.git] / CHANGES
1 $Id: CHANGES,v 1.186 2002/07/19 14:57:38 stelian Exp $
2
3 Changes between versions 0.4b29 and 0.4b30 (released ????????????????)
4 ======================================================================
5
6 1. Made dump print out the ext2 logical block number in case of a read
7 error, which can be given as an argument to debugfs' ncheck command,
8 in order to find out the affected inode. Added note about this
9 usage in dump's man page.
10
11 2. Fixed a problem in restore when reading tapes written on big
12 endian machines with very old versions of dump. The patch was
13 contributed by George Helffrich <george@geology.bristol.ac.uk>.
14
15 3. Fixed the tape length calculation when using large tapes
16 and compression. Thanks to Georg Lippold
17 <g_lippold@sourceforge.net> for reporting the bug.
18
19 4. Added a new set of examples in dump_on_cd_2 directory, based
20 on dump_on_cd examples but somewhat enhanced, supporting DVD
21 media, and localized in english and german. Thanks to
22 Georg Lippold <g_lippold@sourceforge.net> for the new scripts.
23
24 5. Made dump save 32 bit UID/GID. Internally, this was achieved
25 by switching from the old BSD inode format to the new BSD
26 inode format, which means that the tape format was changed.
27 However, since all restore versions out there should
28 transparently support both inode formats, the change should
29 have no side effects. Thanks to John Yu <jky@cs.bu.edu> for
30 reporting the bug.
31
32 6. Fixed a lot of warnings in the code shown when compiling
33 with 'gcc -W'. Thanks to Matthias Andree
34 <matthias.andree@stud.uni-dortmund.de> for reporting this.
35
36 Changes between versions 0.4b28 and 0.4b29 (released June 8, 2002)
37 ==================================================================
38
39 1. Fixed a problem in the rmt ioctl command, where ioctl's issued from
40 non Linux clients were misinterpreted. The description of the problem
41 (incompatible numbering in Linux mtio opcodes) is documented at
42 ftp://ftp.fokus.gmd.de/pub/unix/star/README.mtio . Thanks to
43 Jörg Schilling <schilling@fokus.gmd.de> for reporting this bug and
44 providing an excellent, cross-platform replacement for rmt in his
45 star package.
46
47 2. Fixed a bug reported by Andy Mentges <amentges@jumpline.com>
48 which caused restore to fail when the inode maps were not entirely
49 contained on the first volume (when using really small volumes or
50 when dumping a huge number of inodes).
51
52 3. Fixed a problem in dump, where files in subdirectories of directories
53 that have the nodump flag set (or being excluded with -e/-E) were
54 sometimes incorrectly dumped (instead of being excluded). The original
55 fix is from David C Lawrence <tale@dd.org> in the FreeBSD version
56 of dump: http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32414
57 Thanks to Ted Grzesik <tedgyz@roostme.com> for reporting the bug and
58 help testing the patch.
59
60 4. Added some example scripts from Gerd Bavendiek <bav@epost.de>
61 which makes one able to pipe the output of dump, by the net, to
62 a remote CD-burner server.
63
64 5. Made dump use O_CREAT|O_TRUNC both locally and remotely (over rmt),
65 and use GNU's symbolic syntax over rmt instead of numerical values
66 to assure multiple platform compatibility.
67
68 6. Documented the -d option in restore.
69
70 7. Added a -v (verbose) mode to dump. For now it just prints the number
71 of the inode being dumped, but this could evolve in future versions
72 to include interesting debugging output.
73
74 8. Added a -o flag to restore, which automatically restores the current
75 directory permissions in -i or -x mode, without asking the operator
76 whether to do so. Patch submitted by Tony Clayton <tonyc@e-smith.com>
77 and Peter Samuel <peters@e-smith.com>.
78
79 Changes between versions 0.4b27 and 0.4b28 (released April 12, 2002)
80 ====================================================================
81
82 1. Fixed a bug in the QFA feature which could have caused
83 a bad tape positionning on restore (causing extra delays in
84 restore). Credits go to Uwe Gohlke <uwe@ugsoft.de>.
85
86 2. Added a small note in the dump man page specifying that
87 there should be no white space between the option letter and
88 the -j or -z parameter, thanks to Kenneth Porter <shiva@well.com>
89
90 3. Made restore work with older versions of the readline library,
91 by checking in configure for several extended symbols. Restore
92 can now be compiled with a readline as old as the 2.0 release
93 (though it may be a good idea to upgrade it to a more recent
94 version...). Thanks to Andrew Donkin <ard@waikato.ac.nz> for
95 reporting the build failures.
96
97 4. Fixed a performance problem with the QFA file creation in
98 dump, which made unnecessary seeks on the tape slowing down
99 the dump. Thanks to Andrew Donkin <ard@waikato.ac.nz> for
100 reporting this issue.
101
102 5. Removed the inclusion of some kernel headers in the dump
103 source, which prevented the compile in some kernel/glibc
104 headers/architecture combination. Thanks to Bdale Garbee
105 <bdale@gag.com> for reporting the bug.
106
107 6. Added the appropriate error message when dump fails to
108 open the output file for writing. Thanks to Amith Varghese
109 <amithv@yahoo.com> for reporting this bug.
110
111 7. Made restore able to understand large Solaris ufsdump tapes
112 (containing inodes bigger than 4194304). Sun have introduced
113 an "extension" to the dump tape format when dealing with
114 those inodes, which was uncorrectly handled by Linux restore.
115 Thanks to Uwe Gohlke <uwe@ugsoft.de> for reporting the bug and
116 providing a test case.
117
118 8. Added the -m parameter to dump which optimises the output for
119 inodes having been changed but not modified since the last dump
120 ('changed' and 'modified' have the meaning defined in stat(2)).
121 For those inodes, dump will save only the metadata, instead of
122 saving the entire inode contents. Inodes which are either
123 directories or have been modified since the last dump are saved
124 in a regular way. Uses of this flag must be consistent, meaning
125 that either every dump in an incremental dump set have the flag,
126 or no one has it.
127
128 Changes between versions 0.4b26 and 0.4b27 (released February 15, 2002)
129 =======================================================================
130
131 1. Fixed behaviour of dump when exceeding resource limits
132 (SIGXFSZ treatment).
133
134 2. Added the -L flag to restore to allow the user to specify a
135 maximal allowed number of miscompares when using restore
136 with the -C option to check the backup.
137
138 3. Detailed the manual entry for the -N option of restore.
139
140 4. Added the -a flag to restore to make able doing unattended
141 restores in -i or -x mode (automatically walks through the
142 multiple dump volumes).
143
144 5. Extended the QFA mode to work with local files and/or
145 remote tapes and files. This way, restore can know in advance
146 the tape number and the offset for the inodes to extract and
147 can minimize the extraction time by seeking directly to the
148 good tape/offset.
149
150 6. Added the -A <archive> option to both dump and restore,
151 which makes dump to archive a dump table-of-contents in
152 the specified file to be used by restore to determine
153 whether a file is in the dump file that is being restored.
154 (the archive file syntax is also compatible with the
155 Solaris ufsdump generated one).
156
157 7. Small fix in restore making it able to read some (broken ?)
158 Solaris ufsdump tapes.
159
160 8. Fixed dump to correctly recognise the root filesystem when using
161 ext2 disk labels (LABEL=/). Thanks to John Yu <jky@it.bu.edu>
162 for reporting this bug.
163
164 9. Added the -P <file> option to restore to create a
165 Quick File Access file from an already made dump. Patch
166 contributed by Uwe Gohlke <uwe@ugsoft.de>.
167
168 10. Made restore compile and run on Solaris, making it a
169 possible replacement for the standard ufsrestore. Port was
170 contributed by Uwe Gohlke <uwe@ugsoft.de>.
171
172 Changes between versions 0.4b25 and 0.4b26 (released January 7, 2002)
173 =====================================================================
174
175 1. Added a set of backup scripts from Eugenio Diaz
176 <getnito@yahoo.com> in the examples section. It features
177 automatic (cron based) full and incremental dumping of
178 several filesystems on a separate filesystem.
179
180 2. Fixed a off-by-one miscalculation which disabled dumping
181 a one letter subdirectory. Thanks to Chris Siebenmann
182 <cks@utcc.utoronto.ca> for reporting the bug.
183
184 3. Fixed several restore bugs occuring when trying to
185 restore some missing files on the tape. Thanks to Chris
186 Siebenmann <cks@utcc.utoronto.ca> for reporting the bug.
187
188 4. Fixed --with-ldopts configure argument passing, installing from
189 a separate object directory, makefile cleanups contributed
190 by <splite@purdue.edu>.
191
192 5. Fix a bug which could caused, in some conditions, the highest
193 number inode of a filesystem, to not be dumped. Many thanks
194 to Chris Siebenmann <cks@utcc.utoronto.ca> for helping me
195 chase this bug.
196
197 Changes between versions 0.4b24 and 0.4b25 (released November 17, 2001)
198 =======================================================================
199
200 1. Added a mini howto from Patrick Walsh in the examples
201 directory.
202
203 2. Minor man pages syntax corrections. Thanks to
204 Chris Danis <screechco@home.com> for reporting the bugs.
205
206 3. Added a script from David B. Peterson <dave@toppledwagon.com>
207 to the examples section. It features dumping several
208 filesystems to a remote tape drive upon ssh.
209
210 4. Added a patch provided by Richard Jones <rich@annexia.org>
211 which allows BRADEMAX (number of read errors tolerated by
212 dump) to be adjusted using the -I option.
213
214 5. Fixed a bug which disabled doing "restore -C -f -". Thanks
215 to Clemens Stiglechner <a9401816@unet.univie.ac.at> for the
216 patch.
217
218 6. Add the -l option to restore to specify if, when doing a
219 remote restore, the file used to access the backup is a
220 regular file (the defaults being a tape drive). Restore needs
221 to know this information when reading a remote compressed
222 dump. Previously, this information was autodetected, but
223 the autodetection code fails (with ioctl: Inappropriate ioctl
224 for device) when using a non Linux remote box. Thanks to
225 many users and especially to Eros Albertazzi
226 <eros@lamel.bo.cnr.it> for reporting this.
227
228 7. Found a workaroung for the dump deadlock problem (3 childs
229 stuck in pause(), father in read()). The workaround seems
230 to work for me and several beta-testers. If it doesn't work
231 for you, please report back.
232
233 8. Updated the RPM spec file (BuildPrereq, URL etc).
234
235 Changes between versions 0.4b23 and 0.4b24 (released September 12, 2001)
236 ========================================================================
237
238 1. Fixed the permissions of a newly created QFA file by dump.
239
240 2. Cleaned up the source of dump (the external variables
241 definition was a complete mess, making possible to have
242 objects overlap).
243
244 3. Fixed restore to use the full tape volume path when doing
245 a compare (since it changes the working directory to the
246 filesystem being compared in the process).
247
248 4. Added the -q option to dump which makes dump abort
249 whenever it needs operator attention. It should be
250 easier to use dump in scripts with this option.
251
252 5. Detect the use of incompatible options to dump and
253 refuse them (like -a and -B options together).
254
255 6. Added bzip2 compression to dump/restore (use option -j level
256 to select it). Note that you will need a restore version
257 >= 0.4b24 in order to restore a bzip2 compressed dump.
258 The same warning as for the zlib compression applies:
259 the tape format of a bzip2 dump is not compatible with the
260 original BSD tape format.
261
262 7. Fixed a overflow problem in dump corrupting the dump when
263 very large files were encountered. Thanks to Vladimir Nadvornik
264 for the bug report.
265
266 8. Added a ioctl(BLKFLSBUF) in dump which should flush the
267 kernel buffer/page cache before starting the dump, helping
268 a bit those who use dump on mounted filesystems. Thanks to
269 John Yu <jky@it.bu.edu> and to Theodore T'so <tytso@mit.edu>
270 for this suggestion.
271
272 9. Updated the RPM spec file following the RedHat changes
273 (dynamically linked binaries now in /usr/sbin etc).
274
275 10. Added a patch from Helmut Jarausch <jarausch@igpm.rwth-aachen.de>
276 which enables restore to recognise multi volume compressed dumps
277 done on CD. Included his scripts for dump (which pipe the dump
278 output directly into cdrecord) and restore. There is now
279 possible to to backups to CD on the fly!
280
281 Changes between versions 0.4b22 and 0.4b23 (released July 20, 2001)
282 ===================================================================
283
284 1. Fixed a buffer overflow in restore/tape.c. Patch provided by
285 Marcus Meissner (Caldera International Security Dept.).
286
287 2. Implement the Sun rmt extended protocol. Patch submitted
288 by Ian Gordon <iangordon@users.sourceforge.net>.
289
290 3. Check for the e2fsprogs header <ext2fs/ext2_fs.h> instead of
291 the linux kernel header. This ensures that dump always has the
292 latest version of this file. Patch submitted by
293 Andreas Dilger <adilger@turbolinux.com>.
294
295 4. Report any filesystem present in either /etc/fstab with a
296 positive passno or /etc/dumpdates in dump -w output.
297 Patch submitted by Andreas Dilger <adilger@turbolinux.com>.
298
299 5. Fixed the looping problem in dump introduced in the
300 previous version.
301
302 6. Changed the -B option of dump to limit the size of
303 _compressed_ output per volume if compression is on.
304 Patch contributed by Helmut Jarausch
305 <jarausch@igpm.rwth-aachen.de>. Note however that, since
306 it is impossible to predict the size of the compressed
307 data before doing the compression, the -B limit is a bit
308 conservative.
309
310 7. Fixed a bug in reading the operator typed file/tape path for
311 the next volume in restore.
312
313 8. Implemented a "-F script" option to restore which permits the
314 user to specify a script which will be launched at the
315 beginning of each tape, useful for automatic programming of
316 tape changers for example. See the restore man page for the
317 script parameters and return codes.
318
319 9. Small fix for the QFA routines provided by Uwe Gohlke
320 <uwe@ugsoft.de>, and some recommendations for QFA uses in
321 the man pages.
322
323 10. Fixed the multivolume restoring where making a mistake
324 to the 'Mount next tape' prompt caused several blocks to
325 be lost.
326
327 11. Enhanced the -e option of dump to take as a parameter a
328 comma separated list of inode numbers.
329
330 12. Added the -E option to dump which specify a file containing
331 inode numbers to exclude from the dump.
332
333 13. Fixed the compressed multi-volume dump + restore.
334
335 Changes between versions 0.4b21 and 0.4b22 (released May 12, 2001)
336 ==================================================================
337
338 1. Made dump report the number of blocks dumped per volume.
339 Thanks to Kenneth Porter <shiva@well.com> for the suggestion.
340
341 2. Fix a bug in dump where waiting too much at the 'change volumes'
342 question caused the volume to be rewritten. Thanks to
343 Graham Reed <greed@users.sourceforge.net> for reporting the
344 bug and providing a patch.
345
346 3. Added a compression option to dump, contributed by Jerry
347 Peters <gapeters@worldnet.att.net>.
348
349 WARNING: the compression works only on files/pipes and
350 drives supporting variable block size.
351
352 WARNING2: tapes created using the compression feature are
353 incompatible with the standard dump tape format, and a
354 version of restore >= 0.4b22 will be needed for extraction.
355
356 4. Fixed some compilation problems for glibc 2.2.2 and 64 bit
357 architectures. Thanks to Paul Slootman <paul@debian.org> for
358 the patch and to Bdale Garbee <bdale@gag.com> for forwarding
359 it upstream.
360
361 5. Many cleanups (CPP defines, const char warnings, check of
362 ext2fs COMPAT flags, time_t cleanups, added libext2 version
363 in dump usage text) by Andreas Dilger <adilger@turbolinux.com>.
364
365 6. Made --prefix option work in configure. All the install path
366 are now based on the configure parameters.
367
368 7. Added the Quick File Access mode in dump/restore, contributed
369 by Uwe Gohlke <uwe@ugsoft.de>. In this mode, dump stores in
370 a file tape position for each inode, and this file is used by
371 restore (if called with parameter Q and the filename)
372 to directly position the tape at the file restore is currently
373 working on. This saves hours when restoring single files from
374 large backups, saves the tapes and the drive's head. Use
375 --enable-qfa option of configure to compile in the QFA support.
376
377 8. Added the possibility to dump several files and directories
378 in a single invocation of dump. Thanks to Uwe Gohlke
379 <uwe@ugsoft.de> for implementing this option.
380
381 9. Fixed the dumping and restoring of files with holes
382 (files ending with holes didn't get dumped or restored
383 correctly).
384
385 10. Fixed a socket descriptor leak in dump, which leaved opened
386 3 file descriptors per dump process (and there is one dump
387 process per tape).
388
389 11. Fixed dump large file system support, by explicit use of
390 open64/lseek64/etc functions (explicit use needed because
391 e2fsprogs libraries don't behave well when compiled with
392 FILE_OFFSET_BITS=64).
393
394 Changes between versions 0.4b20 and 0.4b21 (released January 13, 2001)
395 ======================================================================
396
397 1. Fixed some bugs in the dump -w|-W logic introduced by
398 the previous version. Thanks to Andreas Dilger
399 <adilger@turbolinux.com> for his help on this one.
400
401 2. Fixed again a compilation problem when using old e2fs
402 headers (filesystem label related). Thanks to many users
403 who reported this stupid error.
404
405 3. Fixed a build problem on old lib5 based systems dealing with
406 _PATH_MNTTAB being undefined. Thanks to John Adams
407 <johna@onevista.com> for reporting the bug.
408
409 4. Improved the error detection in restore when creating
410 the temporary files in TMPDIR. Now restore will corectly
411 report a 'no space left on device' error instead of
412 strange errors which could imply an archive corruption.
413 Thanks to Gabriel Somlo <somlo@cs.colostate.edu> and
414 bgjenero <bgjenero@sympatico.ca> for reporting the bug.
415
416 5. Added the throughput information in dump's progression
417 messages. Thanks to Andreas Dilger <adilger@turbolinux.com>
418 for the patch.
419
420 6. Use libext2fs's inode scanning routines, which are particularly
421 robust when dealing with errors (especially when having some
422 bad blocks on the filesystem). Many thanks to Colin
423 <colin@horizon.com> for reporting the bug, investigating
424 the issues, finding a workaround, writing the patch and
425 fully testing it... (of course, if this patch will break
426 anything, he is to blame for :-)).
427
428 7. Made dump and restore LFS aware. Dump can dump a filesystem
429 containing large files, generate a large file on output and
430 restore can restore them. This feature is not enabled by
431 default, use --enable-largefile option of configure to enable
432 it (you need to have a LFS aware glibc though). Thanks to
433 Andrea Arcangeli <andrea@suse.de> for submitting the patch,
434 and to Theodore T'so <tytso@valinux.com> for his always
435 useful thoughts.
436
437 8. Made dump ask upon a tape write error if it should rewrite
438 the current volume (assume this is a bad tape) or if it should
439 assume an end-of-tape condition (useful for tape drives which
440 behaves badly at the end of the tape). Thanks to Andreas
441 Dilger <adilger@turbolinux.com> for the suggestion.
442
443 Changes between versions 0.4b19 and 0.4b20 (released November 10, 2000)
444 =======================================================================
445
446 1. Fixed a small compilation problem due to a change
447 in the definintion of the struct sigaction in
448 glibc 2.0 / libc5. Thanks to Gunther Schlegel
449 <schlegel@riege.de> for reporting the bug and to
450 Dave Platt <dplatt@snulbug.mtview.ca.us> for suggesting
451 a fix.
452
453 2. Modified the label and uuid analysis in order to be
454 self-contained (independant of kernel/libc headers). This
455 should fix the compile with older kernel/libc headers and
456 will preserve the functionality. Thanks to Bernhard Erdmann
457 <bernhard.erdmann@gmx.de> for reporting the bug.
458
459 3. The 'exclude inode' option, if applied to a directory
460 inode, excludes now correctly all the leaves of this
461 directory. Thanks to John R. Dennison
462 <gerdesas@users.sourceforge.net> for reporting the bug.
463
464 4. Fixed the '-e' option to disable the possibility
465 to exclude the root inode (which causes the dumps to
466 be unreadable by restore). Prevented array overflow
467 when multiple -e options are used.
468
469 5. Fixed dump to correctly interpret a filesystem argument
470 which is a mountpoint and it is not an absolute path
471 (as specified in the fstab). Thanks to Bernhard R. Erdmann
472 <be@berdmann.de> for reporting the bug.
473
474 6. Made dump able to backup files larger than 2 GB. Note that
475 dump still doesn't cope with files larger than 4 GB.
476
477 7. Restore the real uid and gid before invoking an external
478 RSH program (big hole when dump or restore is suid root!).
479
480 8. Get the values for the default tape device and the location
481 of fstab file from the system headers. Thanks to
482 Andreas Dilger <adilger@turbolinux.com> for the patch.
483
484 9. Made dump -w|-W report all recognized filesystems
485 present in either /etc/fstab or /etc/dumpdates, and present
486 the list in the same order as in fstab file. Thanks
487 to Andreas Dilger <adilger@turbolinux.com> for the patch.
488
489 10. Made dump's -a (automatic end of tape detection) the
490 default. Specifying one of -B, -c, -d or -s options will
491 override the EOM detection. Thanks to Andreas Dilger
492 <adilger@turbolinux.com> for the patch.
493
494 11. Save the ext2 filesystem label into the dump volume label.
495 Specifying a volume label on the command line (-L option)
496 will override this feature. Thanks to Andreas Dilger
497 <adilger@turbolinux.com> for the patch.
498
499 Changes between versions 0.4b18 and 0.4b19 (released August 20, 2000)
500 =====================================================================
501
502 1. Fixed the signal handling in dump (which I broke in 0.4b17)
503 which was causing several strange dump failures (dump
504 hanged or segmentation faults etc).
505
506 2. Specified the default blocksize in the dump man page.
507
508 3. Changed two info messages of restore to be written on stdout
509 instead of stderr in order to leave stderr only for errors
510 or warnings. Thanks to Stephen Atwell
511 <satwell@urbana.css.mot.com> for the suggestion.
512
513 4. Corrected an off by one calculation which prevented
514 dumping a directory having a 1 character name length.
515 Thanks to Bernhard Erdmann <bernhard.erdmann@gmx.de>
516 for reporting the bug.
517
518 5. Reinforce dump in order to allow only level 0 and no
519 -u option when dumping a subdirectory, and document
520 this in the man page. Thanks to Bernhard Erdmann
521 <bernhard.erdmann@gmx.de> for reporting the bug.
522
523 6. Fixed a small harmless bug in restore which caused
524 in some conditions hard links to be restored several
525 times (therefore generation some warning messages).
526 Thanks to Kenneth Porter <shiva@well.com> for
527 reporting the bug.
528
529 7. Updated the RPM spec file to the latest RedHat version,
530 providing FHS packaging and other cosmetic changes.
531 You will need RPM version >= 3.0.5 in order to build the RPM.
532
533 8. Updated the configure script to check for libtermcap
534 before checking for libreadline, because we need this
535 library in order to compile the readline support.
536
537 9. Made dump understand the LABEL= and UUID= notation
538 both in /etc/fstab and on the command line. Note that
539 you will need the /proc filesystem in order to use
540 these notations. Thanks to Erik Troan <ewt@redhat.com>
541 for providing the patch.
542
543 Changes between versions 0.4b17 and 0.4b18 (released June 30, 2000)
544 ===================================================================
545
546 1. Fixed a potential buffer overflow in restore. Thanks
547 to Stan Bubrouski <satan@fastdial.net> for reporting
548 the bug.
549
550 2. Fixed a readline-related bug which prevented
551 'cat DUMPFILE | restore -i -f -' from working. Thanks
552 to Charles Karney <karney@users.sourceforge.net>
553 for the bug report.
554
555 3. Changed a few "panic" into "exit", causing restore to
556 be more stable against some attacks (like the last one
557 reported on Bugtraq, although the last version of restore
558 was not vulnerable - just dumped core). Thanks to
559 Andreas Hasenack <andreas@conectiva.com.br> for reporting
560 the bugs to me.
561
562 4. Removed the suid-root bit on dump and restore in the
563 default build (and generated RPMs). It should be safer
564 now. Users who need the suid-root capabilities in order
565 to make network backups should read first the man page
566 of dump and enable the suid bit manually.
567
568 5. Added -ltermcap to the compile parameters for restore
569 when using readline support, in order to make the compile
570 process work on some systems (SuSE ?). Thanks to
571 Patrik Schindler <poc@pocnet.net> for reporting the bug.
572
573 Changes between versions 0.4b16 and 0.4b17 (released June 1st, 2000)
574 ====================================================================
575
576 1. The -F script is called now *only* at the end of a tape,
577 not at the end of the dump. Thanks to Christian Haul
578 <haul@informatik.tu-darmstadt.de> for the bug report.
579
580 Normally, the device name and the current volume number
581 are passed on the command line of the script. However,
582 if you want the old style script (with no arguments
583 passed on the command line), you can enable it in
584 configure with the --enable-oldstylefscript.
585
586 2. Use posix signal handling to preserve dump functionality
587 with libc5. Thanks to Jeff Johnson <jbj@redhat.com> for
588 the patch.
589
590 3. Made the exit code of restore in case of a 'C'ompare
591 command reflect the result of the compare. An exit status
592 of 0 means the dump archive is correct, 1 means tape errors,
593 2 means that some files were modified. Thanks to Kenneth Porter
594 <shiva@well.com> for the suggestion.
595
596 4. Made (finally) quotes work in interactive restore.
597
598 5. Small fixes in order to allow dump to compile with a
599 really old e2fsprogs version. Thanks to Ian Zimmerman
600 <itz@speakeasy.org> for the bug report.
601
602 6. Add GNU readline capabilities to interactive restore.
603 Use configure's --enable-readline flag to enable this feature.
604 Thanks to Patrik Schindler <poc@pocnet.net> for the
605 suggestion.
606
607 7. Do the compare on the fly in restore 'C' mode (this will
608 allow not to exhaust the available /tmp space when
609 ccmparing large files). Thanks to Kenneth Porter
610 <shiva@well.com> for the suggestion.
611
612 Changes between versions 0.4b15 and 0.4b16 (released March 11, 2000)
613 ====================================================================
614
615 1. Fixed some several duplicate 'DUMP: DUMP:' in the
616 output of dump.
617
618 2. Corrected the estimation of blocks to dump. Note that
619 this is still wrong for large directory inodes, due
620 to the size of a BSD directory entry on the tape
621 (estimation is based on the size of the ext2 directory,
622 which is smaller because it doesn't contain the null
623 character at the end).
624
625 3. Made dump report the total number of MB written to
626 tape at the end of run. Thanks to W. Reilly Cooley
627 <wcooley@nakedape.cc> for the patch.
628
629 4. Added the -X option to restore giving the possibility
630 to read the names of the files to be extracted/listed
631 from a text file (in addition of the command line).
632 Thanks to Dejan Muhamedagic <dejan@quant-x.com> for the
633 patch.
634
635 5. Added the device name and the current volume number
636 as arguments to the end of tape script (dump -F option).
637
638 6. Made the multi-volume dump work again (after having
639 broken it in 0.4b15).
640
641 Changes between versions 0.4b14 and 0.4b15 (released March 2, 2000)
642 ===================================================================
643
644 1. Added a prompt command in interactive restore mode. Thanks
645 to Andreas Dilger <adilger@home.com> for the patch.
646
647 2. Fixed a buffer overflow problem in dump (caused by
648 not checking the size of the filesystem parameter).
649 Thanks to Kim Yong-jun <loveyou@hackerslab.org> for
650 reporting this on Bugtraq (and to several dump users
651 who forwarded me his mail).
652
653 3. Added the '-F script' option to dump in order to
654 launch a script at the end of each tape (to be used
655 with a tape changer, or to notify the sysadmin by
656 pager etc.).
657
658 4. Fixed a bug in restore compare code caused by the changes
659 I made in 0.4b14.
660
661 5. Fixed the treatment of options using the old BSD syntax
662 in both dump and restore.
663
664 Changes between versions 0.4b13 and 0.4b14 (released February 10, 2000)
665 =======================================================================
666
667 1. Fixed a bug in dump which may have caused invalid deleted
668 directories to be dumped out if they were deleted after the
669 mapping pass. This could occure on active filesystem and lead
670 to heap corruption (causing dump malfunction in many possible ways).
671 Thanks to Jan Sanislo <oystr@cs.washington.edu> for finding this
672 bug and submitting the patch.
673
674 2. Fixed the handling of the filesystem parameter in dump. A
675 '/mnt/disk' parameter caused the disk contents to be dumped,
676 but a '/mnt/disk/' parameter caused the mountpoint directory
677 to be dumped (generally an empty directory).
678
679 3. Improved the output of dump in order to tell which directory
680 it is currently dumping (when dumping a subtree).
681
682 4. Added the '-e' exclude inode option to dump. Thanks to
683 Isaac Chuang <ike@isl.stanford.edu> for contributing with the patch.
684
685 5. Added a REPORTING-BUGS file in order to provide a guide
686 on how to correctly report a bug in dump/restore.
687
688 6. Fixed a restore problem when restoring a hard link to an inode
689 having the immutable or append-only attribute set. Thanks to
690 Ambrose Li <acli@mingpaoxpress.com> for submitting the patch.
691
692 7. Fixed a compatibility problem between dumps made on little
693 endian machines (the format was correct) and big endian
694 machines (the format was incorrect). This fix break the
695 compatibility with the older dumps made on big endian
696 machines (sparc, m86k, ppc etc). For the first time in
697 linux dump's history (I believe), the dumps made by *BSD,
698 Linux/alpha, Linux/sparc and Linux/x86 are compatible,
699 so interchangeable. Thanks to Rob Cermak
700 <cermak@ahab.rutgers.edu> for submitting the bug and
701 helping me test the fix.
702
703 8. Fixed the way dump reports the remaining percent/time, if
704 the number of blocks actually dumped exceeds the estimated
705 number of blocks. Thanks to Jean-Paul van der Jagt
706 <jeanpaul@dutepp0.et.tudelft.nl> for reporting the bug.
707
708 Changes between versions 0.4b12 and 0.4b13 (released January 21, 2000)
709 ======================================================================
710
711 1. Small Y2K fix in the man pages :). Thanks to Bernhard Sadlowski
712 <sadlowsk@Mathematik.Uni-Bielefeld.DE> for reporting the bug.
713
714 2. Removed the requirement to build the RPM as root from the
715 spec file. Thanks to Christian Weisgerber
716 <naddy@mips.rhein-neckar.de> for submitting this.
717
718 3. Fixed a bug in dump related to the 'filetype' feature of ext2fs,
719 causing dump to block when dumping really huge filesystems.
720 Many thanks to Patrik Schindler <poc@pocnet.net> for
721 helping me find this bug.
722
723 4. Fixed the treatment for an interrupt signal when dump access
724 the remote tape through RSH. Thanks to Christian Weisgerber
725 <naddy@mips.rhein-neckar.de> for providing the patch.
726
727 5. Fixed a bug which was causing dump/restore to display
728 garbage characters instead of the remote host name.
729
730 Changes between versions 0.4b11 and 0.4b12 (released January 8, 2000)
731 =====================================================================
732
733 1. Small fix in the dump man page. Thanks to Thorsten Kukuk
734 <kukuk@suse.de> for submitting the patch.
735
736 2. Fix for the exit code when using the size estimate option of
737 dump. Thanks to Matti Taskinen <mkt@rni.helsinki.fi> for
738 submitting the patch.
739
740 3. Handle EINTR in atomical reads/writes in dump, which was causing
741 dump to fail on some systems. Thanks to Eric Jergensen
742 <eric@dvns.com> for reporting the bug and submitting the patch.
743
744 4. Handle more than 16 characters for the device names in dumpdates.
745 (up to 255 now). Thanks to Rainer Clasen <bj@ncc.cicely.de> for
746 tracking down the problem and proposing the solution.
747
748 5. Fixed a bug in dump which prevented the creation of the
749 dumpdates file when doing a 0-level dump without already
750 having a dumpdates file. Thanks to Patrik Schindler
751 <poc@pocnet.net> for reporting the bug.
752
753 6. Changed the way dump 'S' flag reports the size estimate
754 from number of blocks into bytes (making it compatible
755 with the Solaris version, and simplifying things for
756 amanda users). Thanks to Jason L Tibbitts III
757 <tibbs@math.uh.edu> for reporting the bug.
758
759 7. Fixed a compatibility problem in linux/alpha dump tape format.
760 Now the linux/alpha dump are (again) compatible with the
761 other dump formats. But this breaks compatibility with
762 older dumps made on alpha. Thanks to Mike Tibor
763 <tibor@lib.uaa.alaska.edu> for helping me in finding this bug.
764
765 Changes between versions 0.4b10 and 0.4b11 (released December 5, 1999)
766 ======================================================================
767
768 1. Added a '--enable-kerberos' to configure.
769
770 2. Added a 'S' option to dump which determines the amount of space
771 that is needed to perform the dump without actually doing it, similar
772 to the Sun's ufsdump 'S' option. Patch contributed by Rob Cermak
773 <cermak@ahab.rutgers.edu>.
774
775 3. Added a 'M' multi-volume option to dump and restore which enables
776 dumping to multiple files (useful when dumping to an ext2
777 partition to make several dump files in order to bypass the 2GB
778 file size limitation). The 'f' argument is treated as a prefix and
779 the output files will be named <prefix>001, <prefix>002 etc. With
780 the 'M' flag, restore automatically selects the right file without
781 asking to enter a new tape each time.
782
783 4. Fixed a memory leak which was causing dump to grow very big
784 (270MB when dumping a 10GB filesystem...). Thanks to Jason
785 Fearon <jasonf@netrider.org.au> for reporting the bug.
786
787 Changes between versions 0.4b9 and 0.4b10 (released November 21, 1999)
788 ======================================================================
789
790 1. Make configure test if the system glob routines support
791 extended syntax (ALTDIRFUNC). If not, use the internal glob
792 routines instead of system ones. Thanks to Bernhard Sadlowski
793 <sadlowsk@Mathematik.Uni-Bielefeld.DE> for reporting the bug
794 and helping me resolve this and other minor libc5 compiling
795 glitches.
796
797 2. Fix a problem when dumping a ext2fs with the 'filetype'
798 feature enabled. Thanks to Patrick J. LoPresti
799 <patl@cag.lcs.mit.edu> for reporting the bug and to
800 Theodore Y. Ts'o <tytso@mit.edu> for providing the patch.
801
802 3. Made the nodump flag work on directories. A directory which
803 has the nodump flag gets never dumped, regardless of its
804 contents.
805
806 4. Integrate a patch from Jeremy Fitzhardinge <jeremy@goop.org>
807 which allows dump on an active ext3 filesystem. However, this
808 is a "quick and dirty" patch which enables backup of an ext3
809 filesystem through the ext2 compatibility (by ignoring the
810 NEEDS_RECOVERY bit). The journal file is not recognized and
811 it is dumped (it should not).
812
813 5. Test the superblock compatibility flags when dumping, in order
814 to be sure that we know how to deal with specific features.
815
816 Changes between versions 0.4b8 and 0.4b9 (released November 5, 1999)
817 ====================================================================
818
819 1. Use lchown instead of chown, fixing a possible security problem
820 when restoring symlinks (a malicious user could use this
821 to deliberately corrupt the ownership of important system files).
822 Thanks to Chris Siebenmann <cks@utcc.utoronto.ca> for detecting
823 this and providing the patch.
824
825 Changes between versions 0.4b7 and 0.4b8 (released November 3, 1999)
826 ====================================================================
827
828 1. Put dump sources under CVS, added Id tags in all files so
829 one can use 'ident' on binary files.
830
831 2. Added the dump/restore version in the usage text so one can
832 easily verify the version he is using.
833
834 3. Small patch from Nuno Oliveira <nuno@eq.uc.pt> which fixes
835 a va_start/va_end problem on linux-ppc (always call va_start
836 va_end in pairs each time we use a vararg function).
837
838 4. Added again the DT_* constants because old libc does not
839 contain them :(. Thanks to Eric Maisonobe <virnet@nat.fr>
840 for submitting the bug report.
841
842 5. Use ext2fs_llseek instead of llseek. With recent e2fsprogs
843 this should enable dumping big (huge) filesystems.
844
845 6. Added the RSH environment variable in order to be able to
846 use a rsh replacement like ssh when doing remote backups (and
847 bypass the security limitations of rcmd). Now you can do remote
848 backups without being root (or making dump setuid root).
849
850 7. Modified again the way dumpdates works. For incremental dumps,
851 we need to read dumpdates even if we are not using 'u' option.
852 Thanks to Bdale Garbee <bdale@gag.com> for his ideas on how
853 this should work.
854
855 Changes between versions 0.4b6 and 0.4b7 (released October 8, 1999)
856 ===================================================================
857
858 1. Removed the 'k' flag from the restore 'about' text if kerberos
859 was not compiled in.
860
861 2. Prototyped (f)setflags from e2fsprogs and corrected the calls
862 to them (fsetflags takes a char*, setflags an open fd!).
863
864 3. (f)setflags is called only if the flags aren't empty. If the
865 file is a special file, a warning is printed, because changing
866 flags implies opening the device. Normally, a special file
867 should not have any flag... (Debian bug #29775, patch provided
868 by Abhijit Dasgupta <abhijit@ans.net>).
869
870 4. Made possible to dump a file system not mentioned in /etc/fstab.
871 (Debian bug #11904, patch provided by Eirik Fuller <eirik@netcom.com>).
872
873 5. Changed the default behaviour to not create dumpdates
874 unless 'u' option is specified. Removed the old "debian-patch"
875 which provided the same thing. (Debian bug #38136, #33818).
876
877 6. Removed all those dump*announce, since they were getting old...
878
879 7. Added warning messages if dumpdates does not exist and
880 when an inferior level dump does not exist (except for a level 0
881 dump).
882
883 8. Debugged the glob calls in interactive mode: restore used a
884 dirent struct which was different from the /usr/include/dirent.h
885 one (this used to work, is it a glibc2 change?), so none of the
886 compat glob (which used /usr/include/dirent.h) or the system glob
887 worked. Restore use now the system dirent (and the system
888 DT_* constants), which are compatible with BSD ones.
889
890 9. Added a configure flag (--with-dumpdatespath) to specify
891 the location of dumpdates file. By default, it is
892 /etc/dumpdates.
893
894 10. Added the "AUTHOR" and "AVAILABILITY" sections and
895 included the current date/version in man pages.
896
897 11. Corrected the estimation of remaining time when
898 the operator doesn't change the tapes quickly enough. This
899 was an old bug, I thought I corrected it, and discovered
900 that in fact it was corrected in two different places, so
901 the results canceled each other...
902
903 Changes between versions 0.4b5 and 0.4b6 (released October 1, 1999)
904 ===================================================================
905
906 1. Integrated multiple patches from RedHat, Debian and SuSE:
907
908 - tweak dump/itime.c to not try to read dumpdates if the 'u' option
909 isn't specified.
910 - several fixes in the man pages.
911 - update the default tape device to /dev/st0.
912 - many updates for Linux Alpha (byte ordering, size_t etc).
913 - buffer overruns.
914 - use environment variable for TMPDIR (instead of /tmp).
915 - use sigjmp_buf instead of jmp_buf (RedHat bug #3260).
916 - workaround egcs bug (RedHat bugs #4281 and #2989).
917 - wire $(OPT) throughout Makefile's.
918
919 2. Upgrade the dump revision to 1, making possible to dump filesystems
920 made with e2fsprogs-1.15 or newer. Nothing seems to break...
921
922 3. Fix some compile warnings, prototype all functions.
923
924 4. Use glibc err/glob instead of internal compatibility
925 routines (only if available).
926
927 5. Fix a compile error on Linux 2.2.7 / libc5 (5.4.44) (patch provided
928 by Bernhard Sadlowski <sadlowsk@mathematik.uni-bielefeld.de>).
929
930 Changes between versions 0.4b4 and 0.4b5 (released September 22, 1999)
931 ======================================================================
932
933 1. Integrated the changes from FreeBSD-3.1-RELEASE
934 (mostly bug fixes, buffer overruns, dump has now an "automatic
935 tape length calculation" flag, dump/restore can use kerberos now
936 (this is NOT tested), use environment variables for TAPE and
937 RMT etc.).
938
939 2. Integrated three RedHat patches ("glibc", "kernel" and "bread" patches)
940
941 3. Corrected a bug in restore when using 'C' option with multi-volumes
942 tapes (files splited accros two tapes give "size changed" errors
943 when comparing).
944
945 4. Corrected the long standing bug when dumping multiple tapes.
946 This works for me, needs further testing.
947
948 Changes between versions 0.4b3 and 0.4b4 (released January 17, 1997)
949 ====================================================================
950
951 1. Dump now runs correctly on kernels 2.1.x
952 Fix made by Gerald Peters <gapeters@worldnet.att.net>
953
954 Changes between versions 0.4b2 and 0.4b3
955 ========================================
956
957 1. Use realpath() if available
958
959 2. Report statistics
960
961 Changes between versions 0.4b1 and 0.4b2
962 ========================================
963
964 1. Fixed the bug fix from Greg Lutz (I had made a mistake when integrating
965 the patch)
966
967 2. Fixed restore to make it able to read FreeBSD 2.x dumps again
968
969 3. Fixed configure.in to correctly handle --enable-rmt
970
971 Changes between versions 0.3 and 0.4b1
972 ======================================
973
974 1. Integrated the changes from 4.4BSD-Lite2
975
976 2. Integrated the patches from Debian and Red Hat
977
978 3. Portability changes: use the __u32, __u16, __s32, and __s16 types
979
980 4. Changed dump to use the Ext2fs library to get block addresses. This
981 should solve the endianness problem on SparcLinux.
982
983 5. Created a configure.in file (shamelessly stolen from the e2fsprogs
984 distribution's one) to use autoconf
985
986 6. Fixed a few minor bugs
987
988 Changes between versions 0.2e and 0.2f
989 ======================================
990
991 1. Added the creation of named pipes (fifos) in restore.
992
993 2. Added the -N flag in the restore manual page.
994
995 3. Added the file kernel.patch which contains the llseek() optimization
996 patch for 1.2.x kernels.
997
998 4. Fixed a bug in the restoration of symbolic links: owner and group were
999 not restored.
1000
1001 5. Integrated some changes from FreeBSD 2.2.
1002
1003 6. Added a call to ftruncate() after restoring each file to restore
1004 correctly files ending by a hole.
1005
1006 Changes between versions 0.2d and 0.2e
1007 ======================================
1008
1009 1. Fixed a bug in the "set owner/mode" process. Every file was restored
1010 with owner = root (0) and group = root/wheel/whatever (0).
1011
1012 Changes between versions 0.2c and 0.2d
1013 ======================================
1014
1015 1. Dump is now able to backup 2GB+ filesystems.
1016
1017 2. Dump and restore can now be linked as static binaries.
1018
1019 Changes between versions 0.2b and 0.2c
1020 ======================================
1021
1022 1. Fixed a bug when dumping ``slow'' (i.e. normal) symbolic links.
1023
1024 Changes between versions 0.2a and 0.2b
1025 ======================================
1026
1027 1. Really fixed the bug that I should have corrected in 0.2a.
1028
1029 2. Enabled optimization again.
1030
1031 Changes between versions 0.2 and 0.2a
1032 =====================================
1033
1034 1. Disabled the optimization during compilation.
1035
1036 Changes between versions 0.1 and 0.2
1037 ====================================
1038
1039 1. Fixed a bug in fstab.c which caused a null pointer to be stored in
1040 the fs_type field (actually, I modified the file fstab.c to make it
1041 use the mntent functions).
1042
1043 2. Dump and restore now use a 4.3 BSD compatible dump format. Backups
1044 made by dump should be readable by the BSD restore and backups made
1045 by the BSD dump should be readable by restore. Unfortunately, this
1046 means that the dump format has changed between version 0.1 and version
1047 0.2 :-(
1048
1049 3. Dump is now able to backup a subtree, it is no longer limited to whole
1050 filesystems like the BSD version.
1051
1052 4. Dump now uses ext2_llseek() so it is able to backup filesystems bigger
1053 than 2 GB.
1054
1055 Changes between versions 0.0 and 0.1
1056 ====================================
1057
1058 1. Now create links rdump and rrestore during the `make install' step.
1059
1060 2. Linux port specific bugs added to the manual pages
1061
1062 3. Incorrect estimation of the number of tapes blocks fixed when doing
1063 incremental backups.
1064
1065 4. Better ls-like format in restore in interactive mode.