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