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