]> git.ipfire.org Git - thirdparty/e2fsprogs.git/blob - RELEASE-NOTES
Update release notes, et. al. for 1.30-WIP release.
[thirdparty/e2fsprogs.git] / RELEASE-NOTES
1 E2fsprogs 1.30-WIP (September 30, 2002)
2 =======================================
3
4 E2fsck now uses a more sophisticated algorithm to salvage corrupted
5 directories that recovers more information in the corrupted directory
6 block.
7
8 E2fsck now performs additional consistency checks on indexed (HTREE)
9 directories.
10
11 Fix bug where efsck might get confused about whether a completely
12 empty directory block is an empty leaf block or an interior htree
13 node. This could cause e2fsck to get confused into think that a valid
14 indexed directory was corrupted.
15
16 E2fsck no longer creates an empty directory entry at the end of a
17 directory block when optimizing a directory. This would cause some
18 earlier versions of the dxdir kernel code to corrupt the directory
19 when attempting to split a node containing an empty directory entry.
20
21 E2fsck could sometimes in rare circumstances leave the indexed flag
22 set after a small directory was optimized by compressing it instead of
23 indexing it. (This should never happen in real life, since
24 directories that small wouldn't have been indexed, but better safe
25 than sorry.)
26
27 E2fsck now only updates the master superblock in all cases. This
28 slightly shortens its run time.
29
30 Ext2ed can deal with directory entries of length 0; previously it
31 would get stuck in an infinite loop.
32
33 Fsck now has support for reiserfs volumes when parsing LABEL= and UUID=
34 specifiers. (Sourceforge patch #613447)
35
36 Badblocks will now work correctly on read-only devices such as
37 CD-ROM's. (Sourceforge patch #600451)
38
39 Updated and clarified man pages.
40
41
42 E2fsprogs 1.29 (September 24, 2002)
43 ===================================
44
45 Fixed a bug in e2fsck which could corrupt a directory when optimizing
46 it (via the -D option) or rebuiliding the hash tree index with a 1 in
47 512 probability, due to a fence post error.
48
49 Fixed a bug in the LVM support code which caused LABEL='xxx' not to
50 work correctly.
51
52 Mke2fs now enables the directory indexing flag by default. (Since
53 this is a compatible feature flag, it's safe to do so.)
54
55 Tune2fs will support setting the directory indexing feature flag. It
56 will automatically set up the default hash algorithm and hash seed
57 fields in the superblock.
58
59 If the bone-headed user enters the root filesystem twice in
60 /etc/fstab, the -R option which skips the root filesystem will skip
61 all of them. (Addresses Debian bug #159423). Note! This is not a
62 precedent for dealing intelligently with any other kind of doubled
63 entry in /etc/fstab!
64
65
66 Programmer's notes:
67 -------------------
68
69 Removed perror declaration in lib/et/internal.h. All modern systems
70 can be expected to define perror() these days. Besides, the lib/et
71 code wasn't using perror at all anyway. :-)
72
73
74 E2fsprogs 1.28 (August 31, 2002)
75 ================================
76
77 Add support for the Hashed-Tree Directory Indexing to e2fsck. Support
78 for setting the htree flag is not included yet, although it can be
79 manually turned on via the debugfs program.
80
81 Clarified e2fsck error message which is printed when it cannot find
82 sufficient contiguous block when relcating filesystem metadata.
83
84 Added support for building an EVMS plugin module for ext2/3. This
85 module is substantially the same as the EVMS module shipping with EVMS
86 1.1, with one or two bugfixes. E2fsprogs can also build this plugin
87 for use with EVMS 1.0 (which did not include the ext2 plugin module),
88 if the configure --enable-old-evms flag is given.
89
90 Fsck will search through EVMS volumes when trying to resolve
91 filesystem specifications such as LABEL=xxx or UUID=xxx.
92
93 Added a new utility program, /sbin/findfs, which will return
94 filesystem specifications such as LABEL=xxx or UUID=xxx, and prints
95 the device name.
96
97 Update and clarified various man pages. (addresses Debian Bug #145044,
98 #146437, #131350, #151990, #144621, #141938)
99
100 If there are no filesystems specified on fsck's command line, fsck now
101 treat that as if the -As options were given. Previously it would
102 simply do nothing. (Addresses Debian Bug #153102)
103
104 Mke2fs no longer treats a failure to be able to clear the MD signature
105 at the end of the filesystem as a fatal error. (Addresses Debian Bug
106 #155007)
107
108 The e2p library functions (which are used by lsattr and chattr) now
109 double check to make sure the file is a regular file or directory
110 before attempting to use the ext2 ioctls. Some device drivers
111 unfortunately respond to the ext2 ioctl's with unknown behaviour.
112 (Addresses Debian Bug #152029).
113
114 The extended attribute handling has been updated to correspond with
115 the latest V2 bestbits ACL code.
116
117 Fixed bug in e2fsck which caused it to not clear the dtime field when
118 processing truncated inodes on the orphan list. This could cause data
119 loss(!) if a filesystem is rebooted before a truncate has been
120 committed.
121
122 E2fsck now uses red/black trees in pass1b, which removes some O(n**2)
123 algorithms. This makes e2fsck much faster in the case of severely
124 corrupted filesystems where a large number of blocks are claimed by a
125 large number of inodes. (Thanks to the 2.5 IDE device driver for
126 inspiring this work.)
127
128 Resize2fs has been significantly sped up when shrinking and expanding
129 a filesystem by a very small number of blocks (for example, when EVMS
130 is converting a partition to be an EVMS legacy volume).
131
132 Added a new option to e2fsck, -D, which will optimize or compress all
133 of the directories in the filesystem.
134
135 E2fsck now catches SIGINT and SIGTERM to make sure it will can
136 properly clean up and only exit at safe points. Fsck will pass
137 SIGINT/SIGTERM to its child processes, and wait until they have all
138 exited before it exits.
139
140 The uuid parsing code in the uuid library now properly complains when
141 an illegally formated uuid is presented to it. (Addresses Debian bug
142 #152891)
143
144 Restrict use of the 2.4 setrlimit ABI f*ckup to kernels between 2.4.10
145 and 2.4.17, since the workaround can cause problems when using a 2.4
146 kernel with an old version of glibc built with the 2.2 headers.
147
148 Fixed a bug in mke2fs where it wasn't properly clearing the initial
149 superblock used by other filesystems. (Addresses Debian bug #147256.)
150
151 Added support for the synchronous directory feature written by Andrew
152 Morton.
153
154 The debugfs program can delete directories using the rmdir command.
155
156 Add support for 8k and 16k filesystems (for systems with page sizes
157 that are greater or equal to 8k or 16k, respectively). Note that
158 these filesystems can not be mounted on x86 systems, or other systems
159 with only 4k page sizes, due to limitations in the current Linux VM
160 code.
161
162 Resize2fs requires that the filesystem state be valid and have no
163 errors; otherwise, e2fsck -f must be run first. (Previously it simply
164 required that the last fsck time be greater than the last mount time.)
165
166 Configure now defaults the man pages directory to /usr/share/man on
167 Linux systems.
168
169 E2fsck now offers to truncate inodes which contain too many blocks (so
170 that i_blocks would overflow. Also fixed handling of large sparse
171 files.
172
173 E2fsck now more completely checks for symlink validity, including
174 requiring NULL termination and length checks.
175
176 E2fsck will offer to try forcing a disk write to remap a bad block
177 after finding a read error when reading a filesystem metadata block.
178
179 Fixed a bug in debugfs which caused the -b and -s options to crash
180 debugfs, as well as breaking the testb, setb, and clearb functions.
181
182 Added a bmap command to debugfs which calculates the logical to
183 physical block mapping for a particular inode.
184
185 Fixed a bug in code which checked to see if a device was mounted which
186 sometimes (rarely) failed in the case of a plain file.
187
188 Fixed a bug in resize2fs where when it reported an error, it would
189 print a message erroneously indicating that the filesystem had been
190 resized before it aborted.
191
192 When resizing a plain file which is smaller than the requested size,
193 resize2fs will attempt to extended the file so that programs like
194 e2fsck will not complain that the file is too small.
195
196 Resize2fs will print the actual new size of the filesystem when it is
197 finished resizing.
198
199 Fixed a bug in debugfs where "ls -l" would report incorrectl file type
200 information on big-endian systems.
201
202
203 Programmer's notes:
204 -------------------
205
206 Fixed collisions with C++ reserved words.
207
208 Added portability fixes for building e2fsprogs on the HURD and AIX.
209
210 Added the ext2ed program for creation of test cases. (ext2ed has many
211 limitations and bugs which make it unsuitable for production use.)
212
213 The ext2fs_read_dir_block2 and ext2fs_write_dir_block now take a new
214 flag, EXT2_DIRBLOCK_V2_STRUCT, which will will reverse when the
215 name_len field is byte swampped on big-endian machines, since in the
216 V2 structure, name_len is a char field which is doesn't need to be
217 byte swapped --- except if an old-style kernel had byte-swapped the
218 name_len field as part of the V1 structure.
219
220
221 E2fsprogs 1.27 (March 8, 2002)
222 ==============================
223
224 The warning messages for mke2fs now go to standard error.
225
226 Fixed to make sure "make check" runs all of the test programs with
227 LD_LIBRARY_PATH set, so that we test the libraries in the build tree.
228
229 The mke2fs program checks the boot sector for the BSD disk label, and
230 avoids erasing it if it is there.
231
232 Fixed a bug in e2fsck which caused it to core dump if the journal
233 inode was missing when it was supposed to be there.
234
235 E2fsck now prints ranges in pass 5 when printing deltas for the block
236 and inode bitmaps.
237
238 Debugfs's "ls -l" command now will print out the file type information
239 in the directory entry.
240
241 Create man pages and hard links for fsck.ext3 and mkfs.ext3. If
242 mke2fs is invoked as mkfs.ext3, create the filesystem with a journal.
243
244 Debugfs can now examine the experimental directory indexing
245 information.
246
247 Fixed bug in debugfs which caused it to core dump if modify_inode is
248 called without an open filesystem.
249
250 The debugfs lsdel command now runs its output through a pager first.
251
252 When installing manual pages, remove the compressed manual pages first.
253
254 Synchronized with Debian's packaging information for e2fsprogs-1.26-1.
255
256 Fix the 2.4 resource limitation workaround introduced in 1.26 which
257 actually broke things on mips32, sparc32, and Alpha platforms.
258
259 Updated the I18N code so that calls to setlocate(LC_CTYPE, 0) are made
260 (which is required by the newer libintl libraries).
261
262 Programmer's notes:
263 -------------------
264
265 Fixed various gcc -Wall complaints.
266
267 Fixed a few memory leaks in the e2fsck journaling code, and in the
268 ismounted code checking for a swap device.
269
270 Add new inode I/O abstraction interface which exports an inode as
271 an I/O object.
272
273 Exported ext2_file_flush as a public interface.
274
275 In ext2_file_write, we now mark the buffer void * argument as a const, since ext2_file_write doesn't modify the buffer.
276
277 Lots of small random portability fixes to make e2fsprogs build under
278 AIX --- even without the 5L compatibility toolkit, and even using the
279 uber-crippled AIX native C compiler.
280
281
282 E2fsprogs 1.26 (February 3, 2002)
283 =================================
284
285 Dumpe2fs will keep going now if the bad block inode can't be read.
286 (Previously it stopped with a fatal error.)
287
288 E2fsck will now give an opportunity to run the journal even if the
289 recovery flag is not set. This is the default behaviour if e2fsck is
290 using a backup superblock, since the needs_recovery flag will never be
291 set in the backup superblock copies.
292
293 E2fsck now automatically finds the backup superblock/group descriptors
294 even when the primary superblock is completely destroyed for 2k and 4k
295 filesystems. (Previously it just guessed/assumed that we were dealing
296 with a 1k filesystem in that case, and users had to manually specify
297 the backup superblock number.)
298
299 Fixed a bug in e2fsck where it dereferences a null pointer when there
300 is a problem opening a filesystem in preen mode.
301
302 E2fsck now handles external journals correctly; previously it trashed
303 the external journal device if the journal needed to be replayed.
304
305 Work around ulimit incompatibility problem caused by recent 2.4
306 kernels; the unix IO module will automatically try to set any resource
307 limits to be infinite on startup.
308
309 Fixed a bug in e2fsck where it wasn't allocating a new block or inode
310 bitmap if it wasn't present and the blocksize was 2k or 4k.
311 (Addresses Debian Bug #116975)
312
313 E2fsck will check and fix botched ext3 V1 to V2 superblock updates by
314 clearing the new V2 fields if they do not make sense or if the ext3
315 superblock is version 1 superblock.
316
317 E2fsck will automatically relocate the ext3 journal from a visible
318 file (i.e., /.journal) to an hidden inode if the filesystem has been
319 opened read/write. This allows the users to add a journal while the
320 filesystem is mounted, but the next time the system is rebooted, the
321 journal file will disappear. This avoids problems with backups,
322 stupid operators with superuser bits, etc.
323
324 Fix a bug in fsck where it would not support a filesystem type of
325 "auto" if the device was specified in terms of LABEL=xxx or UUID=xxx.
326
327 Fsck now supports fstab entries of the form "ext3,ext2". It will also
328 automatically identify reiserfs filesystems.
329
330 The number of processes spawned by fsck can now be limited using the
331 FSCK_MAX_INST environment variable.
332
333 Fsck now searchs the LVM proc hierarchy to find logical volumes which
334 should be searched for UUID and label information.
335
336 Work around a bug in 2.4.10+ kernels by trying to unset the filesize
337 limit if at all possible, when opening a block device. (The filesize
338 limit shouldn't be applied against writes to a block device.)
339
340 In mke2fs and e2fsck, specifying the -c option twice will now do
341 a read/write test on the disk. Update the man pages to encourage
342 using the -c option, and to discouraging running badblocks separately,
343 since users tend to forget to set the blocksize when running
344 badblocks.
345
346 Mke2fs now automatically clears the immutable attribute on a
347 pre-existing .journal file left over from a previous failed attempt to
348 add a journal to an alreadyy-mounted filesystem.
349
350 Fixed mke2fs's exit codes to consistently indicate when the mke2fs
351 operation failed.
352
353 Mke2fs now creates the lost+found directory with permissions of 0700,
354 so that files that had previously lived in protected directory are
355 safe if they get dropped in lost+found and the system administrator
356 doesn't deal with immediately. (Addresses Debian #bug 118443)
357
358 Mke2fs and e2fsck (and all programs that use the
359 ext2fs_check_if_mounted function) will now properly identify that a
360 device is mounted, even in cases where devfs has confused things with
361 multiple devices names with the same identity, or if a dim-witted
362 system administrator has done something stupid like creating device
363 file aliases in their home directory. Also now checks for swap devices
364 by using /proc/swaps. (Addresses Debian bug #106622)
365
366 Added a new option (-T) to tune2fs which sets the time a filesystem
367 was last checked.
368
369 Speed up e2image when creating sparse raw image files by optimizing
370 away excess lseek() system calls.
371
372 Fix support of large (> 2GB) files when used as a filesystem in
373 mke2fs, tune2fs, debugfs, and findsuper.
374
375 Debugfs's stat and icheck commands now properly deals with large (>
376 2GB) files.
377
378 Debugfs's set_super_value command now prints out the list of valid
379 superblock fields which can be set using the command.
380
381 Debugfs's rm and kill_file command now updates the superblock free block
382 and inode counts, thus keeping the filesystem consistent.
383
384 Debugfs's lsdel command now takes an optional argument which allows
385 the user to only see the most recently deleted files.
386
387 A new command (undel) was added to debugfs which automates
388 undeleting a deleted inode and linking it back to a directory.
389
390 Debugfs's ls command now takes a new option, -d, which lists
391 deleted directory entries.
392
393 Debugfs's testb, freeb, setb, and find_free_block commands now take an
394 optional count argument.
395
396 Add support for a new ext2 file attribute, EXT2_NOTAIL_FL, which will
397 be used to signal that a particular inode should not be eligible for
398 tail-merging --- this is needed for programs like LILO.
399
400 The findsuper (an unreleased, uninstalled utility program) has been
401 improved to add extra validity checks and to add a progress meter.
402 (It is still an unsupported program; the officially supported way to
403 recover from a trashed partition table is to use gpart; findsuper is
404 for wizards only. :-)
405
406 Debugfs was fixed to compile with "configure --disable-swapfs".
407
408 Cleaned up various manual pages. (Addresses Debian bug #119624, #120171)
409
410 Added new translation file for Turkish.
411
412 Programmer's notes:
413 -------------------
414
415 Fix general gcc -Wall complaints.
416
417 E2fsprogs (mostly) works with the dietlibc.
418
419 The programming texinfo file has been expanded to include description
420 of additional libext2fs functions. (Still not compeltely done, but a
421 lot of the more important functions have been documented.)
422
423 Added a umask structure to struct_ext2_filsys, which currently only
424 modifies the behaviour of ext2fs_mkdir(), but if we add any file
425 creation functions to libext2fs, we should also make sure they respect
426 the umask setting.
427
428 The build-rpm script was fixed to be a bit more safe.
429
430 The tests' Makefile now has a way of automating test case creation
431 for e2fsck, using "make testnew".
432
433 Created a new function, ext2fs_dir_iterate2 which passes more
434 information to the callback function (identical to the one used by
435 ext2fs_dblist_dir_iterate). The directory iterator functions take a
436 new flag, DIRENT_FLAG_INCLUDE_REMOVED, which will return deleted
437 directory entries. If the directory entry is deleted, the callback
438 function will be called with the entry paraemter set to
439 DIRENT_DELETED_FILE.
440
441 Added new functions, ext2fs_inode_alloc_stats and
442 ext2fs_block_alloc_stats, which takes updates block/inode allocation
443 statistics in the bitmaps, block group descriptors, and superblock
444 when inodes or blocks are allocated or deallocated.
445
446
447 E2fsprogs 1.25 (September 20, 2001)
448 ===================================
449
450 This is primarily a bug-fix release; no new features were added, but
451 there are a number of embarassing bug fixes and cleanups applied.
452
453 Fix a bug mke2fs which causes stack garbage to be written to disk when
454 zapping disk sectors. (This bug could cause mke2fs to core dump for
455 some kernels, I suspect with security enhancement patches.)
456
457 Remove unneeded #include of <linux/config.h> which was breaking
458 building e2fsprogs on the Hurd. (Addresses Debian bug #112414.)
459
460 Updated tune2fs man page to reflect the fact that adding or removing a
461 journal doesn't require running e2fsck.
462
463 Remove use of AC_REQUIRE from autoconf which had been used to prevent
464 AC_CANONICAL_HOST from being called twice; unfortunately this causes
465 recent autoconf to bomb out since they don't allow AC_REQUIRE to be
466 used outside of autoconf macros. Fortunately, it doesn't seem to be
467 necessary any more, anyway.
468
469 E2fsck will now not fall back to an alternate superblock if the user
470 specifies the superblock location explicitly on the command-line.
471 This allows easier recovery from a situation where the primary
472 superblock and block groups are slightly corrupted, but the backup
473 superblocks are completely broken.
474
475 Fix problem which caused compile_et and mk_cmds to blow up if
476 e2fsprogs was in a directory with a pathname that contained spaces.
477
478 We are now more paranoid about checking the entry in /etc/mtab to make
479 sure the filesystem is really mounted, since some broken distributions
480 (read: Slackware) don't initialize /etc/mtab before checking non-root
481 filesystems. (Slackware also doesn't check the root filesystem
482 separately, and reboot if the root filesystem had changes applied to
483 it, which is dangerous and broken, but there's nothing I can do about
484 that.)
485
486 Make UUID library C++ friendly by adding appropriate extern "C"
487 declarations and using const in the function declarations.
488
489 Fix up the com_err texinfo file so that it can product a valid info
490 file (previously, it could only be used to generate paper
491 documentation using texinfo.tex).
492
493
494 E2fsprogs 1.24a (September 2, 2001)
495 ===================================
496
497 Fix brown-paper bug in mke2fs which caused it to segfault when
498 printing the version string.
499
500
501 E2fsprogs 1.24 (August 30, 2001)
502 ================================
503
504 Revert the BLKGETSIZE64 support, since for some distributions, this
505 ioctl has been used by an unofficial kernel patch to update the last
506 sector on the disk, and this was causing disk corruption problems as a
507 result.
508
509 Mke2fs is now more careful about zapping swap space signatures and
510 other filesystem/raid superblock magic values so that programs like
511 mount who try to use hueristics to determine the filesystem type of a
512 partition are less likely to be confused.
513
514 E2fsck will no longer complain if the the mode of EXT2_RESIZE_INO is a
515 regular file (since Andreas Dilger's on-line resizing tools will set
516 its mode bits).
517
518 Fixed some minor texinfo, man pages nits for spelling errors,
519 texinfo warnings, etc. (Addresses Debian bug #110621.)
520
521 E2fsprogs program no longer print the filesystem version number
522 (i.e. 0.5b), since it only confuses people and doesn't serve any real
523 purpose.
524
525 E2fsck will once again compile under libc5, since it will supply its
526 own version of strnlen if necesssary.
527
528 mke2fs and tune2fs will allow the use of UUID= or LABEL= specifiers
529 when specifying the external journal device. tune2fs will also search
530 devices looking for the externla journal debice when removing.
531
532 E2fsprogs 1.23 (August 15, 2001)
533 ================================
534
535 Add initial support for extended attributes (EA); e2fsck will
536 correctly handle a filesystem with EA's and check the EA blocks for
537 corruptions.
538
539 E2fsck's symlink sanity checking has been cleaned up. It now checks
540 the i_size value of fast symlinks, and checks for immutable flags
541 being set of symlinks, etc.
542
543 E2fsck now offers to clear inodes which are special files that have a
544 non-zero i_blocks or i_size field. (The i_size field check was in the
545 previous version of the code, but due to a bug it didn't offer to
546 clear the inode unless i_size and i_size_high were both non-zero.)
547
548 E2image can now create "raw" image files, which only contain the
549 filesystem metadata placed in a spare file so that e2fsck, dumpe2fs,
550 debugfs, etc., can be run directly on the raw image file.
551
552 Add support for the 64-bit block device patches.
553
554 Fixed bugs in creating external journals with a 1k blocksize.
555
556 Add initial support for external journals (so long as the external
557 journal only supports a single filesystem) in e2fsck.
558
559 Remove requirement for needing to run fsck on a filesystem after
560 removing a journal (either internal or external).
561
562 The man pages now document how to create and manage external journals.
563
564 Speed up the check of an ext3 filesystems by avoiding a needless flush
565 of all of the superblock and block group descriptors.
566
567 Speed up creating an internal journal using tune2fs in the case where
568 the filesystem has a lot blocks already allocated.
569
570 Tune2fs has been fixed to make sure that only error messages go to
571 stderr, and normal message go to stdout. (Addresses Debian bug #108555)
572
573 Fixed a minor bug in mke2fs; if -O none is passed to mke2fs, it will
574 now not set the sparse_super feature. (Addresses Debian bug #108165)
575
576 Add support in fsck for the filesystem type "auto".
577
578 Fsck -A will not try to interpret device names for filesystems which
579 have a pass number is 0. (Addresses Debian bug #106696).
580
581 Fsck prints a warning message if now valid filesystems are passed to
582 it. (Addresses Debian Bug #107458.)
583
584 E2fsck now gives an explicit warning if there filesystem still has
585 errors at the end of the run. (Addresses Debian bug #104502)
586
587 E2fsck will set the EXT2_ERROR_FS flag if the journal superblock
588 reflects an error. E2fsck will also not run the orphan list if the
589 filesystem contains errors, since the orphan list might be corrupted.
590
591 E2fsck now prints the number of large files when given the -v option.
592
593 Fixed minor memory leaks in e2fsck.
594
595 Some minor man pages updates. (Addresses Debian bug #30833, #108174)
596
597
598 E2fsprogs 1.22 (June 22, 2001)
599 ==============================
600
601 Fixed a bug in e2fsck's handling of orphan inodes which are special
602 files (i.e., block/character device files, named FIFO's, etc.).
603
604 Fixed a bug accidentally introduced in e2fsprogs 1.21 which caused
605 tune2fs to fail at adding a journal to a mounted filesystem.
606
607 Fixed a few big-endian bugs in e2fsprogs
608 * The directory block functions were accidentally reporting
609 some directories as corrupted when they weren't.
610 * If e2fsprogs is compiled --disable-swapfs, the C language
611 equivalents weren't being included for big-endian platforms.
612 (Fixes Debian bug #101686).
613
614 Fixed a Hurd compilation problem. (Addresses Debian bug #101361)
615
616 Programmer's notes:
617 -------------------
618
619 Use platform independent method of defining the BLKFLSBUF and FDFLUSH
620 ioctls, and allow them to be defined for non-i386 platforms.
621
622 The uuid.h header file is now protected against multiple inclusions.
623
624 E2fsprogs is now being developed using BitKeeper. Changed the test
625 scripts to deal with BK's stripping CR characgters from text files,
626 and changed the top-level Makefile.in to avoid including BitKeeper
627 files when generating the source tarball.
628
629
630 E2fsprogs 1.21 (June 15, 2001)
631 ==============================
632
633 Added new configure flags which allow a subset e2fsprogs to be built;
634 this is most useful for boot floopies, since the resulting shared
635 libraries and programs are slimmed down by removing features that
636 aren't necessary for a boot floppy. The new flags that were added
637 are: --disable-swapfs, which removes support for byte swapping old
638 legacy PPC/68k filesystems, --disable-debugfs, which removes support
639 for debugfs from the libext2fs library, --disable-imager, which
640 removes support for the e2image program, and --disable-resizer, which
641 removes support for resize2fs.
642
643 E2fsck now prints the number of mounts or days elapsed since the last
644 check when e2fsck is forced to check an otherwise clean filesystem.
645
646 Tune2fs now prints an informative message about how often a filesystem
647 will be checked when adding a journal to the filesystem, to remind the
648 user that he/she may want to adjust those parameters using tune2fs
649 -c/-i.
650
651 Worked around hurd brain-damage which causes e2fsck to sometimes
652 believe a filesystem is the root filesystem based on device numbers
653 (since Hurd doesn't have dev_t's, which is arguably a POSIX.1
654 violation).
655
656 Fixed a bug introduced in 1.20 which caused e2fsck to abort with an
657 erroneous error with the -F option was specified.
658
659 Fixed a ext3 recovery bug in the revoke handling; synchronized with
660 ext3 0.7a.
661
662 Fixed two bugs in e2fsck's handling of dup block handling, dealing
663 with relatively uncommon edge cases: a directory with an indirect
664 block which is claimed by another file, and when the last inode in the
665 filesystem has blocks claimed by another file.
666
667 E2fsck now checks to see if the i_size field of a fast symlink is too
668 big, and offers to clear the symlink if so.
669
670 E2fsck now checks to see if i_size_high of special files is non-zero,
671 and offers to clear i_size_high.
672
673 Fix e2fsck's handling of incompatible journal flags so that the user
674 has chance to abort, and then has the option to clear out the journal
675 entirely. (Addresses Debian bug #98527.)
676
677 Fixed a bug in fsck which could cause it to core dump if a mix of
678 standard and non-standard device names are used in /etc/fstab.
679 (Debian bug #100559)
680
681 Fixed a bug in debugfs which caused read errors when copying a file to
682 not be noticed.
683
684 The debugfs set_super_value command can now modify the s_lastcheck field.
685
686 Fixed a bug in lsattr and chattr which was accidentally introduced in
687 1.20 to support > 2GB files; both lsattr and chattr wasn't reading
688 directories correctly because the change modified the layout of struct
689 dirent to be incompatible with the libe2p shared library.
690
691 Cleaned up the mke2fs manual page and included a discussion about why
692 it's good to periodically check the filesystem even when journaling is
693 enabled.
694
695 Programmer's notes:
696 -------------------
697
698 Fix general gcc -Wall complaints.
699
700 The types needed by the ext2 header files are now provided by
701 lib/ext2fs/ext2_types.h, instead of include/asm/types.h.
702
703 Integers are now preferred to longs when trying to find a 32-bit type
704 in ext2_types.h. Also, if linux/types.h has already been defined,
705 don't try to redefine the types.
706
707 Fixed make depend script so that it automatically corrects the
708 pathname cleanups performed by make -M, so I don't have to fix them up
709 by hand.
710
711 Fixed the d_loaddump test case to be more robust, and not depend on
712 bash'isms.
713
714 Removed debugfs's dependence on pread(), which was accidentally
715 intrudced in e2fsprogs 1.20
716
717 Fixed a performance bug in the libext2fs's icount routine; the size
718 estimate of the icount array was incorrectly being calculated.
719
720 Removed use of the badblocks compatibility functions in the e2fsprogs
721 programs.
722
723 Added paranoia code which protects against strange cases where /etc
724 isn't on the root filesystem, or if /etc/mtab doesn't exist.
725
726 The header file ext2_types.h is now installed.
727
728 Autoconf is used to determine when we are on big-endian machines,
729 instead of doing run-time tests, to save a few bytes of code.
730
731 The ext2fs_mark_generic_bitmap and ext2fs_unmark_generic_bitmap
732 functions are no longer inline functions, which saves space and
733 doesn't really cost any real performance.
734
735 The ext2fs library no longer depends on the e2p library. (What need
736 there was of it --- namely, fsetflags, was coded in-line).
737
738 Fixed the makefile so that lib/ext2fs/ext2_types.h is generated even
739 when the user is stupid and tries compiling the package using "make
740 install" as root.
741
742 Miscellaneous code cleanups:
743 * Added missing files from Makefile.in's SRCS file, so that
744 their dependencies would be properly calculated.
745 * Removed redundant code
746 * Fixed comments in code
747 * Removed no-longer unneeded argsused #pragma.
748
749
750 E2fsprogs 1.20 (May 20, 2001)
751 =============================
752
753 Add support for replaying the ext3 journal purely in user mode,
754 including handling the orphaned inode list. Used code contributed by
755 Andreas Dilger, with bug fixes and the orphaned inode handling done
756 by Theodore Ts'o.
757
758 The mke2fs and tune2fs programs can create or modify a filesystem to
759 include an ext3 journal. Tune2fs also can be used to remove an ext3
760 journal from a filesystem.
761
762 E2fsck will now check for the existence of a linked list of orphan
763 inodes in the superblock, and clear those inodes before starting the
764 rest of the filesystem check (but after the journal playback).
765
766 E2fsck now validates the file descriptor passed to the -C option,
767 which saves against the completion bar getting written to an
768 unexpected location, such as the disk being checked. (Debian
769 bug/wishlist #55220)
770
771 E2fsck will now bump the filesystem revision number from zero to one
772 if any of the compatibility bits are set.
773
774 Fixed a bug where a badly corrupted directory on a big endian system
775 could cause e2fsck to die with a bus error. The
776 ext2fs_read_dir_block() and ext2fs_process_dir_block() functions in
777 the ext2 library now does alignment sanity checks on the rec_len field
778 of the directory entry before using it.
779
780 The ext2 library has been enhanced to make tune2fs safe to run on
781 mounted filesystems. (Users could usually get away with using tune2fs
782 on mounted filesystems before, but with the advent of ext3 and
783 journaling, it became important to make tune2fs was *really* safe for
784 use even when the filesystem being modified is mounted.) E2label is
785 now implemented by tune2fs using an argv[0] dispatch, so that e2label
786 is also now safe for use on mounted filesystems.
787
788 Added a new program, e2image, which creates a backup of critical ext2
789 filesystem data structures. The generated image file can be examined
790 using dumpe2fs and debugfs. In the future, e2fsck will be able to use
791 the image file to help recover very badly damaged filesystems.
792
793 Fixed a number of LFS bugs in e2fsck; very, very large (> 2**42) files
794 no longer cause e2fsck to bomb out. Also treat files > 2GB as being
795 large file when deciding whether or not the filesystem has large files.
796
797 Fixed lsattr and chattr so that they work correctly on large files.
798 (Fixes Debian bug #72690.)
799
800 Removed limitation in get_device_size() which imposed a one terrabyte
801 filesystem limitation. (Most 2.2 kernels still have a signed int
802 problem which cause 1 TB block device limitation. Fortunately, the
803 kernel patches to fix this are much easier than fixing the 2TB
804 limitation in the kernel. :-)
805
806 A max_mount_count of zero is now treated as if no mount count were
807 set. (Previously, no mount count was indicated by using -1, and a
808 mount count of zero caused e2fsck to always be run.)
809
810 Mke2fs supports two new filesystem types largefile and largefile4.
811
812 Mke2fs now adds some randomness in s_max_mount_count so that multiple
813 filesystems won't be all checked at the same time under normal
814 operations.
815
816 Fixed bug in the progress bar printing code which could cause e2fsck
817 to core dump on an illegal filesystem.
818
819 Fixed bug in fsck which could allow more than one instance of e2fsck
820 to be printing a progress bar. (Debian bug #65267)
821
822 Fsck using a UUID or a LABEL specifier will work even if devfs is
823 compiled into the kernel and not mounted. If the pathnames in
824 /proc/partitions are incorrect, fsck will search /dev for the correct
825 device (using the new ext2fs_find_block_device library function).
826 Fsck now also checks the RAID devices first so that they are properly
827 found when they are in use. Support has also been added to support
828 additional IDE disks and the DAC 960 device names. (Debian bug #94159)
829
830 Fixed a bug in fsck which caused it not deal properly with 16
831 byte long filesystem labels.
832
833 Fsck's -t option has been made a lot more flexible. The semantics for
834 what happens if a comma-separated list to fsck has been regularized,
835 and it is now possible to filter what filesystems will get checked
836 based what is in the filesystem's fstab entry's option field. (Debian
837 bug #89483.)
838
839 The dumpe2fs program can now print out the group description
840 information in hex, and also prints the location of the superblock and
841 block group descriptor for those block groups that have them.
842
843 Mke2fs now clears the ext2 superblock before it starts creating a
844 filesystem, so that the superblock magic number is only written if the
845 filesystem creation process successfully completes.
846
847 The debugfs program's stat command now pretty-prints the blocks used
848 by an inode so that it's more compact and informative.
849
850 The debugfs stats command now uses the same libe2p code (which is used
851 by dumpe2fs) to print the superblock header information. This is more
852 complete, and it avoids a bit of code duplication.
853
854 Added a new debugfs command, set_super_value (ssv) which allows the
855 user to set arbitrary superblock fields.
856
857 Debugfs was extended to support inode numbers in hex (by prefixing
858 them with 0x), and so that modify_inode can set the inode generation
859 number. Also, there is now a new function command called logdump
860 which will dump an ext3 journal.
861
862 Fixed a bug in debugfs so that quitting out of the pager doesn't kill
863 debugfs.
864
865 Debugfs's dump command now stops immediately upon reporting a disk
866 read error. (Fixed a bug in ext2fs_file_read library routine which
867 caused debugfs not to stop.) (Debian bug #79163)
868
869 On systems with /proc/mounts (mainly Linux systems), /proc/mounts is
870 checked before /etc/mtab is used, since /proc/mounts is more likely to
871 be accurate.
872
873 Added portability fixes for Solaris and Linux/ia64.
874
875 Various manual pages were clarified and cleaned up. (Fixed debian
876 bugs #63442, #67446, and #87216)
877
878
879 Programmer's notes:
880 -------------------
881
882 The e2fsck message printer now supports %Iu and %Ig, which will print
883 out the inode's user and group owners, respectively.
884
885 E2fsprogs now includes its own version of include/linux/ext2_fs.h, so
886 that no longer dependent on the system having the correct version of
887 the kernel header files.
888
889 Added a new function to libext2, ext2fs_find_block_device(), which
890 searches the system (i.e., /dev, /devfs, /devices) for a pathname to a
891 device given its device number.
892
893 Added a new function to libext2, ext2fs_sync_device, which centralizes
894 all of the places which might try to use the BLKFLSBUF or FDFLUSH
895 ioctls (and usually failing to define them since the system header
896 files don't usually do this for us, and we're trying to avoid usage of
897 kernel include files now).
898
899 Added new utility programs in tests/progs: random_exercise and
900 hold_inode. They aren't built by default; they're useful for
901 exercising ext3 filesystem code.
902
903 Added a new ext2 filesystem flag, EXT2_FLAG_SUPER_ONLY, which causes
904 the filesystem close functions to only update the superblock, and to
905 not touch the block group descriptors. Needed by tune2fs when
906 modifying a mounted filesystem.
907
908 Got rid of struct ext2fs_sb and replaced it with the standard struct
909 ext2_super_block from include/linux/ext2_fs.h. Note: this may break
910 source (but not binary) compatibility of some users of the ext2
911 library. Those applications should just simply do a global search and
912 replace of struct ext2fs_sb with struct ext2_super_block, and include
913 the new header file <ext2fs/ext2_fs.h> which defines it.
914
915 The ino_t type has been renamed ext2_ino_t to protect applications
916 that attempt to compile -D_FILE_OFFSET_BITS=64, since this
917 inexplicably changes ino_t(!?). So we use ext2_ino_t to avoid an
918 unexpected ABI change.
919
920 The Makefiles have been reworked so that "make check" can be run from
921 the top-level Makefile.
922
923 Fix general gcc -Wall complaints and removed dead code.
924
925 Remove use of NOARGS, because we assume everyone does ANSI C these
926 days.
927
928 Added build-rpm script from sct.
929
930 New functions ext2fs_image_{inode,super,bitmap}_{read,write} added
931 to support e2image.
932
933 New function ext2fs_flush_icache which must be called if the
934 application program modifies the inode table blocks without going
935 through ext2fs_write_inode() interface.
936
937 New ext2fs_check_mount_point() function, which will return the mount
938 point of a device if mounted.
939
940 The io_channel abstraction now has an optional interface,
941 io_channel_write_range, which allows specific byte ranges to be
942 written.
943
944 The unix_io IO channel now supports write-through caching, so that
945 journal creation is more efficient.
946
947 Added x86 assembly language routines to support byte swapping, to
948 reduce executable size.
949
950 Fixed bug in the utility program subst so that it's possible to
951 replace a substitution variable with a zero-length string.
952
953 Fixed numbering e2fsck pass1 problem numbers; an extra zero had
954 slipped into some of the problem number.
955
956 E2fsprogs 1.19 (July 13, 2000)
957 ==============================
958
959 Release the resize2fs program since the timeout before it could
960 be released under the GPL has finally expired.
961
962 Add experimental support needed for the ext2 compression patches.
963 This requires compiling e2fsprogs with the --enable-compression flag
964 to the configure script.
965
966 Added ext3 journalling support. E2fsck will run the journal (if
967 necessary) by temporarily mounting the filesystem. /sbin/fsck.ext3 is
968 installed as a symlink to e2fsck. Fsck has been taught about ext3,
969 and treats it the same as ext2 in terms of the progress bar logic.
970 Dumpe2fs will display the superblock journaling information if the
971 filesystem has a journal. The ext2 library will now permit opening an
972 ext3 filesystem with the recovery flag set. This is necessary for
973 on-line dump's to work correctly, but there may be issues with this
974 working well since ext3 is much less agressive about syncing blocks to
975 the filesystem, since they're safe on the journal.
976
977 Tune2fs and e2fsck have been changed to allow the mount_count check to
978 be disabled by setting max_mount_count to -1. (This was already
979 supported by the kernel.)
980
981 Create a symbolic link for fsck.ext3, since the e2fsprogs utilities
982 are used for ext3 as well.
983
984 Added internationalization support for e2fsprogs; must be enabled
985 by passing --enable-nls to configure.
986
987 Always use the provided ext2fs header files to insulate ourselves from
988 kernel version changes. Which include files are used by e2fsprogs
989 have also been cleaned up to improve portability.
990
991 Limit the number of times that e2fsck updates the progress bar so that
992 people who are booting using a 9600 baud console don't get swampped by
993 too many updates.
994
995 Improved the loop detection algorithm in e2sck's pass #3 so that it is
996 much, much faster for large filesystems with a large number of
997 directories.
998
999 The memory footprint for e2fsck is now slightly smaller than before.
1000
1001 E2fsck now checks if special devices have a non-zero size, and offers
1002 to clear the size field if it finds such an inode.
1003
1004 E2fsck now checks if special devices have the append-only flag set,
1005 and offers to clear the inode.
1006
1007 E2fsck now properly handles some "should never fail" cases during a
1008 bitmap copy in pass5.
1009
1010 E2fsck now properly prints control characters in filenames as ^A .. ^Z.
1011
1012 E2fsck now calculates the correct location of the backup superblock in
1013 the case of filesystem blocksizes > 1k.
1014
1015 Fixed a bug in e2fsck's calculation of the number of inodes_per_block
1016 which normally didn't cause problems under most filesystem parameters,
1017 but could cause a valid superblock to be rejected in extreme cases.
1018 Other checks for validating superblock values were made more
1019 stringent.
1020
1021 Added non-destructive write testing to the badblocks program, courtesy
1022 of David Beattie. The badblocks also now has an option to input the
1023 current set of bad blocks, so that known bad blocks are skipped to
1024 speed up the badblocks test. There is also a persistent rescan
1025 feature which causes badblocks to run until it has completed some
1026 number of passes without discovering any new bad blocks.
1027
1028 Badblocks now checks to see if the device is mounted and refuses to do
1029 the tests involving writing to the device if it is mounted. Also,
1030 badblocks now allows the number of blocks to be checked to be
1031 defaulted to the size of the partition.
1032
1033 Fixed a bug in fsck which didn't allow non-root users to be able to
1034 check filesystems if there were any LABEL= or UUID= entries in
1035 /etc/fstab.
1036
1037 The Hurd doesn't support the filetype filesystem feature. The mke2fs
1038 program now makes sure that for the Hurd, the filestype feature is
1039 turned off. E2fsck will check to see if the filetype feature is
1040 turned on for Hurd filesystems, and offer to turn off the feature.
1041
1042 Mke2fs now has a safety check to make sure the number of blocks do not
1043 exceed 32 bits even on a 64 bit platform.
1044
1045 Really fixed a bug in fsck to allow "fsck -As" to run interactive
1046 fsck's. (For those people who like to do interactive fsck's in the
1047 /etc/rc scripts!?!)
1048
1049 Debugfs has a few new features: the rdump command, which will do a
1050 recursive dump of a directory and all of its contents, and the lcd
1051 command which does a local chdir (much like the ftp command of the
1052 same name). In addition, the debugfs program and the open_filesystem
1053 command now takes three new options: -b and -s, which allows the
1054 blocksize and superblock location to be specified, and the -c option
1055 which is used in catastrophic situations where the block group
1056 descriptors are corrupt. If the -c option is specified, debugfs will
1057 skip trying to read in the block and inode bitmaps.
1058
1059 Debufs's lsdel command was fixed to handle bad blocks in the inode
1060 table.
1061
1062 A Y2K bug in debugfs's "ls -l" handling was fixed by switching to use
1063 4 digit years.
1064
1065 General improvements in error messages
1066
1067 - Mke2fs prints a sane error message if the partition size is zero
1068 (usually because the partition table wasn't reread by the
1069 kernel due to the partition being busy), instead of "invalid
1070 argument passed to ext2 library while initializing superblock".
1071
1072 - Fsck now prints more self-explanatory message if an invalid UUID=
1073 or LABEL= specification is passed to it.
1074
1075 UUID library changed to use the LGPL.
1076
1077 Fixed a bug in the UUID library where very rapid calls to the
1078 time-based UUID generator could cause duplicate UUID's to be returned.
1079 This was not a problem for e2fsprogs, but it could be a problem for
1080 other users of the library.
1081
1082 Make the UUID library more robust in the face of missing or an
1083 improper /dev/urandom or /dev/random files.
1084
1085 Added some random portability fixes for Solaris.
1086
1087 Some minor man page updates.
1088
1089 Fixed a memory leak in the ss library.
1090
1091
1092 Programmer's notes:
1093 -------------------
1094
1095 We now try to use lseek64 and open64 from the LFS if possible.
1096
1097 The 3rd parameter in e2p's print_flags is now a flags word, instead of
1098 a boolean option.
1099
1100 The mark and unmark bitmap functions now return the previous state of
1101 the bit that was being changed, which is useful for some speed
1102 optimizations.
1103
1104 The following functions have been added to enhance the badblocks list
1105 handling in libext2fs: ext2fs_write_bb_FILE, ext2fs_read_bb_FILE2, and
1106 ext2fs_badblocks_equal.
1107
1108 The ext2 header files now have the latest journalling fields to the
1109 superblock.
1110
1111 The ext2fs_mkdir function in libext2fs now properly backs out of error
1112 conditions robustly.
1113
1114 Cleaned up makefiles:
1115 - to cleanly compile with the -j flag.
1116 - so distclean removes all generated files.
1117 - so in case of an error while installing header files, the make aborts.
1118
1119 Fix test_script so that it works correctly when compiling in the
1120 source directory.
1121
1122 The random UUID generation routine has been made slightly better in
1123 the case where /dev/random doesn't exist. (Use of randomly-based UUID
1124 is still not recommended if /dev/random doesn't exist, however; it's
1125 better to use the time/ethernet MAC address UUID in this case.)
1126
1127 Clean up the build process so it's more friendly in case of missing
1128 directories.
1129
1130 The ext2fs header file can now be #include'd into C++ programs.
1131
1132 The e2p.h header file is now installed.
1133
1134 Added workaround to a gawk 3.0.5 bug in lib/ss/mk_cmds.
1135
1136
1137
1138 E2fsprogs 1.18 (November 10, 1999)
1139 ==================================
1140
1141 Fix a core dumping bug in e2fsck if an imagic inode is present or
1142 (more rarely) if the filesystem is badly corrupted enough that e2fsck
1143 has to restart pass 1 processing. E2fsck now closes the filesystem
1144 before freeing a large number of its data structures, so in the case
1145 of future memory faults, at least the fixed filesystem will be fully
1146 written out.
1147
1148 If a filesystem doesn't support imagic inodes, and e2fsck discovers an
1149 imagic inode, it will offer to clear the imagic flag.
1150
1151 E2fsck will now offer to clear the immutable flag on special files
1152 (device/socket/fifos) when running it in non-preen mode.
1153
1154 E2fsck will now set the filetype when creating /lost+found, and when
1155 connected orphaned inodes to /lost+found.
1156
1157 Debugfs's ncheck and icheck commands now handles the case where there
1158 are bad blocks in the inode table without bombing out.
1159
1160 The badblocks list processing code has been made more efficiently for
1161 appending a large number of (ordered) badblocks to the badblocks list.
1162
1163 Some minor man page updates.
1164
1165 Fsck now allows interactive e2fsck's when using fsck -As (not a common
1166 mode, but some people like to do this in boot scripts for silly reasons).
1167
1168 Programmer's notes:
1169 -------------------
1170
1171 The internal e2fsck problem code for PR_2_SPLIT_DOT was fixed to meet
1172 with the problem code convention.
1173
1174 The badblocks list regression test program has been updated to work
1175 with previously made API name changes.
1176
1177 The ext2fs_free() command now uses the new badblocks API to avoid
1178 using the compatibility layer.
1179
1180 Added new regression test cases; the run_e2fsck test script now
1181 supports the ability for a test case to run a prepratory command
1182 before running e2fsck.
1183
1184 E2fsprogs 1.17 (October 26, 1999)
1185 =================================
1186
1187 Fixed nasty typo in fsck which caused parallelized fsck's to go into an
1188 infinite loop.
1189
1190 Fixed a bug in fsck where it used strncmp to compare a binary UUID,
1191 thus potentially causing problems if a binary UUID contained a NULL
1192 character.
1193
1194 E2fsck now uses stricter checks for directory entries in pass 2:
1195 zero-length filenames are not allowed; neither are 8 byte long
1196 directory entries.
1197
1198 The debugfs "dirty" command now clears the filesystem valid bit.
1199 (Previously this just set the dirty-as-in-needs-writing-out-to-disk
1200 bit in the in-core superblock image. The new functionality is more
1201 what the user expects, and is more useful.)
1202
1203 Added a debugging hook to test parallel fsck; if the environment
1204 variable FSCK_FORCE_ALL_PARALLEL, then filesystems on the same drive
1205 will be checked in parallel when they normally would not be.
1206
1207 Programmer's notes:
1208 -------------------
1209
1210 Fixed some #ifdef's for compilation under the Hurd OS.
1211
1212 Fixed minor W2K compatibility problems.
1213
1214 Fixed some miscellaneous GCC warnings.
1215
1216
1217 E2fsprogs 1.16 (October 22, 1999)
1218 =================================
1219
1220 Fixed a race condition bug in fsck; when printing a progress bar, if
1221 checking multiple filesystems in parallel, it was possible for fsck to
1222 send e2fsck a SIGUSR1 signal before e2fsck had installed its signal
1223 handler, which would cause it to terminate with a signal 10.
1224
1225 E2fsck now properly handles filesystems that have the
1226 INCOMPAT_FILETYPE feature turned on. It can be used to convert a
1227 filesystem into using or not using FILETYPE feature.
1228
1229 E2fsck now properly handles filesystems that have the IMAGIC feature
1230 turned on (this is used on Linux AFS servers).
1231
1232 The mke2fs program now creates filesystems that have the filetype and
1233 sparse_superblock features enabled by default, unless it is run on a
1234 pre-2.2 kernel. These features are not supported by a pre-2.2 kernel,
1235 so there is now a new flag -O which allows the user to specify with
1236 which features she would like to create the filesystem; "mke2fs -O
1237 none" will create a filesystsem compatible with 2.0 kernels.
1238
1239 The tune2fs program now has a -O option which allows the user to set
1240 and reset "safe" filesystem features. Currently, the only ones which
1241 allows to be modified are the filetype and sparse_superblock features.
1242 Note setting or clearing either feature will require running e2fsck on
1243 the filesystem afterwards. (n.b. Clearing the sparse_superblock feature
1244 requires that there is enough free space on the filesystem for the
1245 extra superblocks which will be created by e2fsck.)
1246
1247 Debugfs can now set and print filesystem features in the superblock
1248 using the "features" command. Dumpe2fs will print out the complete
1249 set of features when listing the superblock.
1250
1251 Dumpe2fs has new options -f (force) and -h (header-only).
1252
1253 Fixed a bug in e2fsck which could cause the PROGRAMMING ERROR/bonehead
1254 message to come up. This could happen when decrementing or
1255 incrementing a link count could result in an overflow.
1256
1257 Fixed a bug in e2fsck where the block count on the lost+found
1258 directory would not be properly incremented when the directory was
1259 expanded to the point where an indirect block needed to be allocated.
1260
1261 E2fsck now makes some additional sanity checks on the superblock to
1262 avoid crashing or giving a memory allocation error if some of the
1263 values in the superblock are unresonable (but the superblock otherwise
1264 looks valid).
1265
1266 Fixed a bug in e2fsck where a very badly corrupted filesystem might
1267 require two passes to completely fix the filesystem. This happened if
1268 an inode claimed blocks that was part of the filesystem metadata
1269 (typically, when garbage was written into an inode table or indirect
1270 block, since this kind of filesystem corruption normally doesn't
1271 happen otherwise).
1272
1273 On the Alpha, glibc declares st_flags although it isn't actually used;
1274 the configure script was improved to detect this case so that
1275 e2fsprogs can avoid using the non-functional stat field.
1276
1277 The manual pages were updated to use a more consistent formatting
1278 style consistent with standard Unix man pages. Mke2fs's man page
1279 added documentation for a few previously undocumented options.
1280
1281 Fixed minor display bugs in tune2fs and mke2fs.
1282
1283 Programmer's notes:
1284 -------------------
1285
1286 Improved portability of e2fsprogs to non-Unix systems (in particular, NT).
1287
1288 Added features to parse and print feature strings into the e2p library.
1289 (e2p_feature2string, e2p_string2feature, e2p_edit_feature).
1290
1291 ext2fs_mkdir() and ext2fs_new_dir_block() now creates directories
1292 whose directory entries contain proper filetype information if the
1293 filesystem supports it.
1294
1295 ext2fs_link() now uses the low 3 bits of its flags parameter to pass
1296 the directory entry filetype information. This is used to set the
1297 directory entry filetype information if the filesystem supports it.
1298
1299 Fixed a bug in ext2fs_expand_dir() where the block count in a
1300 directory's inode would not be properly incremented when the directory
1301 was expanded to the point where an indirect block needed to be
1302 allocated.
1303
1304
1305 E2fsprogs 1.15 (July 18, 1999)
1306 ==============================
1307
1308 Add configuration checks so that e2fsprogs will compile cleanly on
1309 Linux 2.3 kernels that have renamed i_version to i_generation.
1310
1311 E2fsck now prints a progress/completion bar (and not just a simple
1312 spinner) if the -C0 option is requested or if it receives a SIGUSR1
1313 signal. Fsck will automatically manage the (potentially muliple)
1314 e2fsck processes to print completion bars if it is given a -C option,
1315 with the right thing happening if multiple filesystems are being
1316 checked in parallel.
1317
1318 Mke2fs now has better automatic hueristics to determine the filesystem
1319 parameters to be used for a particular filesystem. Added a new option
1320 -T which allows the user to specify how the filesystem is to be used,
1321 which helps mke2fs do a better job selecting the filesystem parameters.
1322
1323 Mke2fs now creates revision 1 filesystems by default, and with the
1324 sparse superblock feature enabled. The sparse superblock feature is
1325 not understood by Linux 2.0 kernels, so they will only allow read-only
1326 mounts of filesystems with this sparse superblocks.
1327
1328 Fix bug where if /dev/null couldn't be opened (should never happen),
1329 e2fsck would hang in a tight loop.
1330
1331 Make e2fsck handle the case where /lost+found isn't a directory.
1332
1333 E2fsck now uses mallinfo if it exists to get accurate statistics about
1334 its memory usage.
1335
1336 Fix bug in e2fsck where it wouldn't check to see if a disconnected
1337 inode had any problems before connecting it to /lost+found.
1338
1339 Add check to e2fsck so it makes sure that total number of inodes in
1340 the filesystem is a sane number.
1341
1342 Fix fencepost error when clearing an the end of the block bitmap which
1343 caused the last block in the bitmap not to get cleared.
1344
1345 Cleaned up a number of messages in e2fsck:
1346 * The message "Group's #'s copy of the group descriptor..."
1347 was fixed so that the correct number would be displayed.
1348 * Added missing space in the "disk write-protected" error messsage
1349 * Cleaned up the error message printed when a non-interactive
1350 e2fsck needs to abort a check because the filesystem
1351 appears to be mounted.
1352
1353 Added a new command-line utility, uuidgen, which will create and print
1354 a UUID.
1355
1356 Make debugfs's icheck command more robust by checking to make sure an
1357 inode has valid blocks before interarting over the inode's blocks.
1358
1359 UUID generation now uses a random-based scheme whenever possible to
1360 prevent potential privacy problems.
1361
1362 Man pages for all of the UUID functions in the lirbary were added.
1363
1364 Fixed bug in fsck so it won't coredump if a filesystem not in
1365 /etc/fstab is given to it.
1366
1367 Fsck now understands the UUID=xxxx and LABEL=yyyy forms in /etc/fstab
1368 that most of the other mount utilities understands.
1369
1370 Mke2fs will make a filesystem even if it appears mounted if the force
1371 option is given.
1372
1373 Dumpe2fs has new command-line options which allow a filesystem expert
1374 to specify the superblock and blocksize when opening a filesystem.
1375 This is mainly useful when examining the remains of a toasted
1376 filesystem.
1377
1378 The badblocks program has been updated to display correctly on disks
1379 with large block numbers.
1380
1381 The badblocks program no longer gives spurious errors when errors
1382 occur on non-block boundaries, which is common if the blocksize is
1383 larger than 1k.
1384
1385 Mke2fs will sync the disk device every MKE2FS_SYNC block groups if the
1386 MKE2FS_SYNC environment variable is set. This is to work around a VM
1387 bug in the 2.0 kernel. I've heard a report that a RAID user was able
1388 to trigger it even using a 2.2 kernel, but hopefully it will not be
1389 needed for most Linux 2.2 users.
1390
1391 Fixed miscellaneous documentation and man pages.
1392
1393 Programmer's notes:
1394 -------------------
1395
1396 Cleaned up functions such as pass1_get_blocks, pass1_read_inode which
1397 in e2fsck's pass1.c really should have been static.
1398
1399 The return value of the uuid_compare() function was changed to make it
1400 match with the convetions used by strcmp, memcmp, and Paul Leach's
1401 UUID sample document.
1402
1403 The "make depend" process has now been made more automated; it now
1404 automatically word-wraps the dependencies, and only replaces source
1405 Makefile.in if there has been a change in the dependencies. Also, a
1406 top-level "make depend" now recurses through all the subdirectories
1407 automatically.
1408
1409 The Makefile in .../util has been changed so that subst is built using
1410 the native C compiler during a cross-compilation, since the subst
1411 program is only used during the build process. Also add an explicit
1412 rule to build util/subst by cd'ing to the correct directory and
1413 running Makefile.
1414
1415 The man directories are defined in terms mandir, so that the configure
1416 script can override the location of the manual pages.
1417
1418 The config files have been updated to recognize new machine types for
1419 both the i386 and alpha families.
1420
1421 Fsck has been modified so that it will accurately create an
1422 fsck_instance even when the noexecute flag is set. This allows for
1423 accurate debugging of the fsck pass structure. Also, when the verbose
1424 flag is given twice, fsck will print debugging information about when
1425 fsck is waiting for jobs to finish.
1426
1427
1428 E2fsprogs 1.14 (January 9, 1999)
1429 ================================
1430
1431 Fix the fstab parsing code so that it can handle blank lines and
1432 comment characters. Also, missing pass numbers need to be treated as
1433 zero.
1434
1435 Fixed a bug in e2fsck where under some circumstances (when e2fsck
1436 needs to restart processing after fixing an egregious inconsistency)
1437 it would try to access already freed memory.
1438
1439 E2fsck now prints non-printable characters in directory entries and
1440 pathnames using '^' and 'M-' notation.
1441
1442 Fixed chattr so that it will ignore symbolic links when doing
1443 recursive descent traversals. For both chattr and lsattr, no longer
1444 print the version string unless the -V option is given.
1445
1446 Allow the system administrator to directly specify the number of
1447 inodes desired in the filesystem, for some special cases where this is
1448 necessary.
1449
1450 Fix portability problems so that e2fsprogs can be compiled under Linux
1451 1.2 systems and Solaris systems.
1452
1453 Update the config.guess file with a more recent version that will
1454 identify newer Linux platforms.
1455
1456 Programmer's notes
1457 ------------------
1458
1459 Ext2fs_read_inode and ext2fs_write_inode will now return an error if
1460 an inode number of zero is passed to them.
1461
1462 E2fsprogs 1.13 (December 15, 1998)
1463 ==================================
1464
1465 Fixed a bug in debugfs where an error messages weren't getting printed
1466 when the ext2 library routines to read inodes returned errors in the
1467 stat, cmri and rm commands.
1468
1469 Fixed a bug in mke2fs so that if a ridiculous inode ratio parameter is
1470 provided, it won't create an inode table smaller than the minimum
1471 number of inodes required for a proper ext2 filesystem.
1472
1473 Fsck now parses the /etc/fstab file directly (instead of using
1474 getmntent()), so that it can distinguish between a missing pass number
1475 field and pass number field of zero. This caused problems for
1476 diskless workstations where all of the filesystems in /etc/fstab have
1477 an explicit pass number of zero, and fsck could not distinguish this
1478 from a /etc/fstab file with missing pass numbers.
1479
1480 E2fsck will create a /lost+found directory if there isn't one in the
1481 filesystem, since it's safer to create the lost+found directory before
1482 it's needed.
1483
1484 Fixed e2fsck so that it would detect bogus immutable inodes which
1485 happen to be sockets and FIFO files, and offer to clear them.
1486
1487 If a filesystem has multiple reasons why it needs to be checked, and
1488 one of the reasons is that it is uncleanly mounted, e2fsck will print
1489 that as the reason why the filesystem is being checked.
1490
1491 Cleaned up the output routines of mke2fs so that it doesn't overflow
1492 an 80 column display when formating really big filesystems.
1493
1494 Added a sanity check to e2fsck to make sure that file descriptors 0,
1495 1, 2 are open before opening the hard disk. This avoids a problem
1496 where a broken program might exec e2fsck with those file descriptors
1497 closed, which would cause disastrous results if the kernel returns a
1498 file descriptor for the block device which is also used by FILE *
1499 stdout.
1500
1501 Fixed up the e2fsck progress reporting functions so that the values
1502 reliably reach 100% at the completion of all of the e2fsck passes.
1503
1504 Fixed minor documentation bugs in man pages and usage messages.
1505
1506 Programmer's notes:
1507 -------------------
1508
1509 Fixed a number of lint warnings in the ext2fs library and potential
1510 portability problems from other OS's header files that might define
1511 CPP macros for names like "max" and "min".
1512
1513 ext2fs_badblocks_list_add() has been made more efficient when it needs
1514 to grow the bad blocks list.
1515
1516 Fixed a bug in e2fsck which caused it to dereference a freed pointer
1517 just before exiting.
1518
1519 Fixed the substition process for generating the mk_cmds and compile_et
1520 scripts so that they will work outside of the build tree.
1521
1522 Add sanity check to e2fsck so that if an internal routine
1523 (ext2fs_get_dir_info) returns NULL, avoid dereferencing the pointer
1524 and causing a core dump. This should never happen, but...
1525
1526 E2fsprogs 1.12 (July 9, 1998)
1527 ==================================
1528
1529 E2fsprogs now works with glibc (at least with the version shipped wtih
1530 RedHat 5.0). The ext2fs_llseek() function should now work even with
1531 i386 ELF shared libraries and if llseek() is not present. We also
1532 explicitly do a configure test to see if (a) llseek is in libc, and
1533 (b) if llseek is declared in the system header files. (See standard
1534 complaints about libc developers don't understand the concept of
1535 compatibility with previous versions of libc.)
1536
1537 The ext2fs library now writes out the block group number in each of
1538 the superblock copies. This makes it easier to automatically
1539 determine the starting block group of the filesystem when the block
1540 group information is trashed.
1541
1542 Added support for the EXT2_FEATURE_INCOMPAT_FILETYPE feature,
1543 which means that e2fsprogs will ignore the high 8 bits of the
1544 directory entry's name_len field, so that it can be used for other
1545 purposes.
1546
1547 Added support for the EXT2_FEATURE_RO_COMPAT_LARGE_FILE feature.
1548 E2fsprogs will now support filesystems with 64-bit sized files.
1549
1550 Added support for the EXT2_FEATURE_COMPAT_DIR_PREALLOC feature.
1551
1552 Added new program "e2label", contributed by Andries Brouwer. E2label
1553 provides an easy-to-use interface to modify the filesystem label.
1554
1555 Fixed bug so that lsattr -v works instead of producing a core dump.
1556
1557 Fixed a minor bug in mke2fs so that all groups with bad superblock
1558 backup blocks are printed (not just the first one).
1559
1560 Mke2fs will check the size of the device, and if the user specifies a
1561 filesystem size larger than the apparent size of the device it will
1562 print a warning message and ask if the user wants to proceed.
1563
1564 E2fsck has a new option -C, which sends completion information to the
1565 specified file descriptor. For the most part, this is intended for
1566 programs to use, although -C 0 will print a spinning character to the
1567 stdout device, which may be useful for users who want to see something
1568 happening while e2fsck goes about its business.
1569
1570 Fixed a bug in e2fsck which could cause a core dump when it needs to
1571 expand the /lost+found directory, and sometimes the bitmaps haven't
1572 been merged in. Also fixed a related bug where ext2fs_write_dir_block
1573 was used to write out a non-directory block. (Which would be bad on a
1574 non-Intel platform with byte swapping going on.)
1575
1576 Fixed bug in e2fsck where it would print a "programming error" message
1577 instead of correctly identifying where a bad block was in used when
1578 the bad block was in a non-primary superblock or block group
1579 descriptor. Also fixed a related bug when sparse superblocks are in
1580 use and there is a bad block where a superblock or block group
1581 descriptor would have been in a group that doesn't include a
1582 superblock.
1583
1584 Fixed a bug in e2fsck (really in libext2fs's dblist function) where if
1585 the block group descriptor table is corrupt, it was possible to try to
1586 allocate a huge array, fail, and then abort e2fsck.
1587 ext2fs_get_num_dirs() now sanity checks the block group descriptor,
1588 and subsitutes reasonable values if the descriptors are obviously bogus.
1589
1590 If e2fsck finds a device file which has the immutable flag set and the
1591 i_blocks beyond the normal device number are non-zero, e2fsck will
1592 offer to remove it, since it's probably caused by garbage in the inode
1593 table.
1594
1595 When opening a filesystem, e2fsck specially checks for the EROFS error
1596 code, and prints a specific error message to the user which is more
1597 user friendly.
1598
1599 If the filesystem revision is too high, change the e2fsck to print
1600 that this is either because e2fsck is out of date, or because the
1601 superblock is corrupt.
1602
1603 E2fsck now checks for directories that have duplicate '.' and '..'
1604 entries, and fixes this corruption.
1605
1606 E2fsck no longer forces a sync of the filesystem (with attendant sleep
1607 calls) at all times. The ext2fs_flush() function now performs a sync
1608 only if it needed to write data blocks to disk.
1609
1610 Fixed a minor bug in e2fsck's pass1b's file cloning function, where
1611 certain errors would not be properly reported.
1612
1613 Updated and expanded a few points in the man pages which users
1614 complained wheren't explicit enough.
1615
1616 Added special case byte-swapping code if compiling on the PowerPC, to
1617 accomodate the strange big-endian variant of the ext2 filesystem that
1618 was previously used on the PowerPC port.
1619
1620
1621 Programmer's notes:
1622 -------------------
1623
1624 Removed C++ keywords from the ext2fs libraries so that it could be
1625 compiled with C++.
1626
1627 E2fsck's internal organization has now been massively reorganized so
1628 that pass*.c don't have any printf statements. Instead, all problems
1629 are reported through the fix_problem() abstraction interface. E2fsck
1630 has also been revamped so that it can be called as a library from a
1631 application.
1632
1633 Added new fileio primitives in libext2fs for reading and writing
1634 files on an unmounted ext2 filesystem. This interface is now used by
1635 debugfs.
1636
1637 Added a new libext2fs function for mapping logical block numbers of
1638 a file to a physical block number.
1639
1640 Added a new libext2fs function, ext2fs_alloc_block(), which allocates
1641 a block, zeros it, and updates the filesystem accounting records
1642 appropriately.
1643
1644 Added a new libext2fs function, ext2fs_set_bitmap_padding(), which
1645 sets the padding of the bitmap to be all one's. Used by e2fsck pass 5.
1646
1647 The libext2fs functions now use a set of memory allocation wrapper
1648 functions: ext2fs_get_mem, ext2fs_free_mem, and ext2fs_resize_mem,
1649 instead of malloc, free, and resize. This makes it easier for us to
1650 be ported to strange environments where malloc, et. al. aren't
1651 necessarily available.
1652
1653 Change the libext2fs fucntion to return ext2-specific error codes
1654 (EXT2_DIR_EXISTS and EXT2_DB_NOT_FOUND, for example) instead of using
1655 and depending on the existence of system error codes (such as EEXIST
1656 and ENOENT).
1657
1658 Renamed io.h to ext2_io.h to avoid collision with other OS's header
1659 files.
1660
1661 Add protection against ext2_io.h and ext2fs.h being included multiple
1662 times.
1663
1664 The types used for memory lengths, etc. have been made more portable.
1665 In generla, the code has been made 16-bit safe. Added Mark
1666 Habersack's contributed DOS disk i/o routines.
1667
1668 Miscellaneous portability fixes, including not depending on char's
1669 being signed.
1670
1671 The io_channel structure has a new element, app_data, which is
1672 initialized by the ext2fs routines to contain a copy of the filesystem
1673 handle.
1674
1675 ext2fs_check_directory()'s callback function may now return the error
1676 EXT2_ET_CALLBACK_NOTHANDLED if it wishes ext2fs_check_directory() to
1677 really do the checking, despite the presence of the callback function.
1678
1679
1680 E2fsprosg 1.11 (June 17, 1997)
1681 ==============================
1682
1683 Fixed e2fsck to detect (previously ignored) conflicts between the
1684 superblock or block group descriptors and block bitmaps, inode
1685 bitmaps, and inode tables.
1686
1687 Fixed bug in e2fsck so that when the message printed out when a block
1688 or inode bitmap conflicts with other data, it has the correct group
1689 number.
1690
1691 Fixed bug in e2fsck and mke2fs where the blocksize wasn't being passed
1692 to badblocks. This meant that not all of the filesystem was being
1693 tested for bad blocks!
1694
1695 Fixed an array boundary overrun case which cropped up in
1696 ext2fs_badblocks_list_test when a user tried running "mke2fs -c
1697 -b 4096".
1698
1699 Adjusted the number of columns printed by mke2fs when displaying the
1700 superblock backups to avoid running over 80 columns when making a
1701 really big filesystem.
1702
1703 Fixed up the man pages for e2fsck, debugfs, badblocks, chattr,
1704 dumpe2fs, fsck, mke2fs, and tune2fs (typos and other minor grammar
1705 fixes), thanks to some suggestions from Bill Hawes (whawes@star.net).
1706
1707 Programmer's notes:
1708 -------------------
1709
1710 Fixed install rule in lib/ss so that ss_err.h is actually getting
1711 installed.
1712
1713 Fixed bug in ext2fs_copy_bitmap; the destination bitmap wasn't getting
1714 bassed back to the caller.
1715
1716 Fixed bug in ext2fs_inode_scan_goto_blockgroup; it had not been
1717 setting the current inode number (which meant this function wasn't
1718 working at all).
1719
1720 Fixed bug in ext2fs_resize_generic_bitmap; it had not be zeroing all
1721 blocks in the bitmap when increasing the size of the bitmap.
1722
1723 Changed the initial number of blocks allocated by ext2fs_init_dblist()
1724 to be more realistic.
1725
1726 Added a new function ext2fs_allocate_group_table, which sets up the
1727 group descriptor information (and allocates inode and block bitmaps,
1728 and inode tables for a particular group). The function was created by
1729 factoring out code form ext2fs_allocate_tables().
1730
1731 Added a new function ext2fs_move_blocks which takes a bitmap of the
1732 blocks to be moved, and moves them to another location on the
1733 boardboard.
1734
1735 Make the unix_io channel's io_channel_flush implementation calls sync()
1736 to to flush the kernel buffers to disk.
1737
1738 Added a new function ext2fs_dblist_count returns the number of
1739 directory blocks in dblist.
1740
1741
1742 E2fsprogs 1.10 (April 24, 1997)
1743 ===============================
1744
1745 Mke2fs once again defaults to creating revision #0 filesystems, since
1746 people were complaining about breaking compatibility with 1.2 kernels.
1747 Warning messages were added to the mke2fs and tune2fs man pages that
1748 the sparse superblock option isn't supported by most kernels yet (1.2
1749 and 2.0 both don't support parse superblocks.)
1750
1751 Added new flag to mke2fs, -R <raid options>, which allows the user to
1752 tell mke2fs about the RAID configuration of the filesystem. Currently
1753 the only supported raid option is "stride" which specifies the width
1754 of the RAID stripe.
1755
1756 Fixed bug in e2fsck where pass1b would bomb out if there were any
1757 blocks marked bad in the inode table.
1758
1759 Fixed rare bug in mke2fs where if the user had a very unlucky number
1760 of blocks in a filesystem (probability less than .002) the resulting
1761 filesystem would be corrupt in the last block group.
1762
1763 Fixed bug where if e2fsck tried to allocate a block to fix a
1764 filesystem corruption problem and the filesystem had no free blocks,
1765 ext2fs_new_block() would loop forever.
1766
1767 The configure script now checks explicitly to see if "-static" works,
1768 since that can't be assumed to be true --- RedHat doesn't install
1769 libc-static by default.
1770
1771 Fixed bug in libext2's block iterator functions where under some
1772 cirmcustances, file with holes would cause the bcount parameter to the
1773 callback function to be incorrect. This bug didn't affect any of
1774 e2fsprogs programs, but it was discovered by Paul Mackerras, the
1775 author of the PPC boot loader.
1776
1777 Removed use of static variables to store the inode cache in libext2fs.
1778 This caused problems if more than one filesystem was accessed via
1779 libext2fs (static variables in libraries are generally a bad idea).
1780 Again, this didn't affect e2fsprogs programs, but it was discovered by
1781 Paul Mackerras.
1782
1783 Fixed minor bugs and version code drift to assure that e2fsprogs 1.10
1784 will compile cleanly with 1.2.13 kernels (even with a.out shared
1785 libraries!)
1786
1787 Programmer's notes:
1788 -------------------
1789
1790 Added new functions to duplicate an ext2 filesystem handle, and its
1791 associated substructure. New functions: ext2fs_dup_handle(),
1792 ext2fs_copy_dblist(), ext2fs_badblocks_copy(), ext2fs_copy_bitmap().
1793 Other structures, such as the io_channel and the inode_cache, now have
1794 a ref count so that they only get freed when they are no longer used
1795 by any filesystem handle. (These functions were added as part of the
1796 development effort for an ext2 resizer).
1797
1798 E2fsprogs 1.09 (April 14, 1997)
1799 ===============================
1800
1801 Fixed bug in mke2fs (really in lib/ext2fs/initialize.c) which was
1802 accidentally introduced in the 1.08 release. The overhead calculation
1803 was accidentally removed, which caused ext2fs_initialize() to not
1804 notice when the filesystem size needed to be adjusted down because
1805 there wasn't enough space in the last block group.
1806
1807 Fixed bug in version parsing library routine; it was always parsing
1808 the library version string, instead of using the passed-in string.
1809
1810 Clarified chattr man page.
1811
1812 E2fsprogs 1.08 (April 10, 1997)
1813 ===============================
1814
1815 E2fsck 1.07 was very slow when checking very large filesystems with a
1816 lot of files that had hard links (i.e., news spools). This was fixed
1817 by seriously revamping the icount abstraction. Added a formal test
1818 suite for the icount abstraction.
1819
1820 Debugfs now has a "-l" option to the "ls" command, which lists the
1821 inode number, permissions, owner, group, size, and name of the files
1822 in the directory.
1823
1824 Fix a bug in e2fsck where when a directory had its blocks moved to
1825 another location during the pass 1b processing, the directory block
1826 list wasn't updated, so pass 2 wouldn't check (and correct) the
1827 correct directory block.
1828
1829 E2fsck will now treat inodes which contain blocks which are claimed by
1830 the filesystem metadata by treating them as multiply claimed blocks.
1831 This way, the data in those blocks can be copied to a new block during
1832 the pass 1b--1d processing.
1833
1834 E2fsck will attempt to determine the correct superblock number and
1835 display it in the diagnostic and warning messages if possible.
1836
1837 Add support for a new (incompatible) feature, "sparse_super". This
1838 feature reduces the number of blocks which contain copies of backup
1839 superblocks and block group descriptors. (It is only an incompatible
1840 feature because of a bug in ext2_free_blocks.) mke2fs and tune2fs now
1841 support a new -s option; e2fsck will recognize filesystems built with
1842 this feature turned on.
1843
1844 E2fsck now checks the library to make sure is the correct version,
1845 using new library functions. (This helps to diagnose incorrectly
1846 installed e2fsprogs distributions.)
1847
1848 Dumpe2fs now prints more information; its now prints the the
1849 filesystem revision number, the filesystem sparse_super feature (if
1850 present), the block ranges for each block group, and the offset from
1851 the beginning of the block group.
1852
1853 Mke2fs now distributes the inode and block bitmap blok so that the
1854 won't be concentrated in one or two disks in RAID/striping setups.
1855 Also, if the user chooses a 2k or 4k block group, mke2fs will try to
1856 choose the largest blocks per group that be chosen. (For 2k blocks,
1857 you can have up to 16384 blocks/group; for 4k blocks, you can have up
1858 to 32768 blocks/group.) Previously mke2fs would not allow
1859 specification of more than 8192 blocks per group, even if you were
1860 using a 2k or 4k block group.
1861
1862 Programmer's notes:
1863 -------------------
1864
1865 Added a new function ext2fs_create_icount2() which takes a "hint"
1866 argument. This hint argument presets the icount array with the list
1867 of inodes which actually need to be in the icount array. This really
1868 helps to speed up e2fsck.
1869
1870 Added a new function ext2fs_icount_validate() which checks the rep
1871 invariant for the icount structure. This is used mostly for testing.
1872
1873 The error mesasage given when a bad inode number is passed to
1874 test_generic_bitmap to reflect EXT2FS_TEST_ERROR (instead of
1875 EXT2FS_UNMARK_ERROR).
1876
1877 Added a new function ext2fs_set_dir_block which sets the block of a
1878 dblist entry, given the directory inode and blockcnt.
1879
1880 Added a new function ext2fs_get_library_version() which returns the
1881 current library version, and ext2fs_parse_version_string() which
1882 returns a version number based on a e2fsprogs version string.
1883
1884 The icount functions will return EINVAL if the passed in inode number
1885 is out of bounds.
1886
1887 E2fsprogs 1.07 (March 9, 1997)
1888 ==============================
1889
1890 E2fsck is now uses much less memory when checking really large
1891 filesystems (or rather, filesystems with a large number of inodes).
1892 Previously a filesystem with 1 million inodes required 4 megabytes of
1893 memory to store inode count statistics; that storage requirement has
1894 now been reduced to roughly half a megabyte.
1895
1896 E2fsck can now properly deal with bad blocks appearing inside the
1897 inode table. Instead of trying to relocate the inode table (which
1898 often failed because there wasn't enough space), the inodes in the bad
1899 block are marked as in use.
1900
1901 E2fsck will automatically try to use the backup superblocks if the
1902 primary superblocks have a bad magic number or have missing meta-data
1903 blocks (or meta-data blocks which are out of range).
1904
1905 E2fsck's pass 3 has been made more efficient; most noticeable on
1906 filesystems with a very large number of directories.
1907
1908 Completely revamped e2fsck's system of printing problem reports. It
1909 is now table driven, to make them more easily customizeable and
1910 extendable. Error messages which can be printed out during preen mode
1911 are now one line long.
1912
1913 Fixed e2fsck's filesystem swapping code so that it won't try to swap
1914 fast symbolic links or deleted files.
1915
1916 Fixed e2fsck core dumping when fixing a filesystem which has no
1917 directories (not even a root directory).
1918
1919 Added a check to e2fsck to make sure that the length of every
1920 directory entry is a multiple of 4 (since the kernel complains if it
1921 isn't).
1922
1923 Added a check to e2fsck to make sure that a directory entry isn't a
1924 link to the root directory, since that isn't allowed.
1925
1926 Added a check to e2fsk to now make sure the '.' and '..' directory
1927 entries are null terminated, since the 2.0 kernel requires it.
1928
1929 Added check to write_bitmaps() to make sure the superblock doesn't get
1930 trashed if the inode or block bitmap is marked as being block zero.
1931
1932 Added checking of the new feature set fields in the superblock, to
1933 avoid dealing with new filesystem features that this package wasn't
1934 set up to handle.
1935
1936 Fixed a fencepost error in ext2fs_new_block() which would occasionally
1937 try to allocate a block beyond the end of a filesystem.
1938
1939 When the UUID library picks a random IEEE 802 address (because it
1940 can't find one from a network card), it sets the multicast bit, to
1941 avoid conflicting with a legitimate IEEE 802 address.
1942
1943 Mke2fs now sets the root directory's owner to be the real uid of the
1944 user running mke2fs. If the real uid is non-zero, it also sets
1945 the group ownership of the root directory to be the real group-id of
1946 the user running mke2fs.
1947
1948 Mke2fs now has more intelligent error checking when it is given a
1949 non-existent device.
1950
1951 When badblocks is given the -vv option, it now updates the block that
1952 it is currently testing on every block.
1953
1954 Fixed a bug in fsck where it wouldn't modify the PATH envirnoment
1955 currently correctly if PATH wasn't already set.
1956
1957 Shared libraries now built with dependencies. This allows the shared
1958 library files to be used with dlopen(); it also makes the transition
1959 to libc 6 easier, since ld.so can tell which libc a particular shared
1960 library expects to use.
1961
1962 Programmer's notes:
1963 -------------------
1964
1965 Added new abstraction (defined in dblist.c) for maintaining a list of
1966 blocks which belongs to directories. This is used in e2fsck and other
1967 programs which need to iterate over all directories.
1968
1969 Added new functions which test to see if a contiguous range of blocks
1970 (or inodes) are available. (ext2fs_*_bitmap_range).
1971
1972 Added new function (ext2_inode_has_valid_blocks) which returns true if
1973 an inode has valid blocks. (moved from e2fsck code).
1974
1975 Added new function (ext2fs_allocate_tables) which allocates the
1976 meta-data blocks as part of initializing a filesystem. (moved from
1977 mke2fs code).
1978
1979 Added a new I/O manager for testing purposes. It will either allow a
1980 program to intercept I/O requests, or print debugging messages to
1981 trace the activity of a program using the I/O manager.
1982
1983 The badblocks_list functions now store the bad blocks in a sorted
1984 order, and use a binary search to speed up badblocks_list_test.
1985
1986 The inode scan function ext2fs_get_next_inode() may now return a soft
1987 error returns: MISSING_INODE_TABLE and BAD_BLOCK_IN_INODE_TABLE in
1988 those cases where part of an inode table is missing or there is a bad
1989 block in the inode table.
1990
1991 Added a new function (ext2fs_block_iterate2) which adds new arguments to
1992 the callback function to return a pointer (block and offset) to the
1993 reference of the block.
1994
1995 Added new function (ext2fs_inode_scan_goto_blockgroup) which allows an
1996 application to jump to a particular block group while doing an inode
1997 scan.
1998
1999 The badblocks list functions were renamed from badblocks_* to
2000 ext2fs_badblocks_*. Backwards compatibility functions are available
2001 for now, but programs should be modified to use the new interface.
2002
2003 Some of the library functions were reorganized into separate files to
2004 reduce the size of some programs which statically link against the
2005 ext2 library.
2006
2007 Put in some miscellaneous fixes for the Alpha platform.
2008
2009
2010 E2fsprogs 1.06 (October 7, 1996)
2011 ================================
2012
2013 Fixed serious bug in e2fsck: if the block descriptors are bad, don't
2014 smash the backup copies in ext2fs_close(). (The problem was that when
2015 e2fsck -p discovered the problem, while it was closing the filesystem
2016 and exiting, it was also blowing away the backup superblocks on the
2017 disk, which was less than friendly.) We now make it the case that we
2018 only write out the backup superblock and the back block descriptors if
2019 the filesystem is completely free from problems.
2020
2021 Fixed a bug in block_interate in the lib/ext2fs library which caused
2022 e2fsck to fail on GNU Hurd-created filesystems.
2023
2024 Add support for Linux/FT's bootloader, which actually uses
2025 EXT2_BOOT_LOADER, and sets its mode bits which caused e2fsck to want
2026 to clear the inode.
2027
2028 Add support for the "A" (no atime update) attribute. (Note: this
2029 attribute is not yet in production kernels.)
2030
2031 The test suite is not automatically run when doing a "make all" from
2032 the top level directory. Users should manually run "make check" if
2033 they wish to run the test suite.
2034
2035 Upon a preenhalt(), make the printed message more explicit that
2036 running e2fsck "MANAULLY" means without the -p or -a options.
2037
2038 In e2fsck, if a disconnected inode is zero-length, offer to clear it
2039 instead of offering to connect it to lost+found.
2040
2041 In e2fsck, if a filesystem was just unmounted uncleanly, and needs
2042 e2fsck to be run over it, change e2fsck to explicitly display this
2043 fact.
2044
2045 For dumpe2fs and e2fsck, cause the -V option to print out which
2046 version of the ext2fs library is actually getting used. (This will
2047 help detect mismatches of using a 1.06 utility with a 1.05 library,
2048 etc.)
2049
2050 Programmers' notes:
2051 -------------------
2052
2053 EXT2_SWAP_BYTES was changed to EXT2_FLAG_SWAP_BYTES, which better fits
2054 the naming convention.
2055
2056 In ext2fs_initialize(), make sure the description for the inode bitmap
2057 is correctly initialize.
2058
2059 Fixed minor type typo in ext2fs_allocate_generic_bitmap();
2060
2061 E2fsprogs 1.05 (September 7, 1996)
2062 ==================================
2063
2064 Add support for new fields in the ext2 superblock --- volume name,
2065 volume UUID, and last mounted field. Dumpe2fs displays these fields,
2066 tune2fs and mke2fs allows you to set them. E2fsck will automatically
2067 generate a UUID for those volumes that don't have them.
2068
2069 Put in support for e2fsck to recognize HURD specific ext2 features ---
2070 most notably, the translator block. The e2fsprogs tools will now use
2071 the creator_os field in the superblock to correctly handle different
2072 OS-specific variants of the ext2 filesystem.
2073
2074 E2fsck now fixes inodes which have a the deletion time set, but which
2075 have a non-zero i_link_count field by offering to clear the deletion
2076 time. Previously e2fsck assumed that the inode was deleted (per 0.3c
2077 ext2 kernel behavior) and offered to unlink the file.
2078
2079 If e2fsck sets the clean bit, but nothing else, set the exit code
2080 FSCK_NONDESTRUCT. After all, e2fsck did fix a filesystem error --- it
2081 set the filesystem valid bit when it was previously cleared. :-) This
2082 was needed to make the HURD fsck driver happy.
2083
2084 If the user refuses to attach an unattached inode, e2fsck will no
2085 longer set the inode's link count. Otherwise, the inode would end up
2086 getting marked as unused, which might cause loss of data later.
2087
2088 Make the message issued by e2fsck when the superblock is corrupt less
2089 confusing for users. It now mentions that another reason for the
2090 "corrupt superblock" message might be that the partition might not be
2091 an ext2 filesystem at all (it might swap, msdos filesystem, ufs, etc.)
2092
2093 Make the libext2 library more robuest so that e2fsck won't coredump on
2094 an illegal superblock where the blocksize is zero. (f_crashdisk is
2095 the test case).
2096
2097 By default, create filesystems where the default checkinterval is 6
2098 months (180 days). Linux servers can be robust enough that 20 reboots
2099 can be a long, long time.
2100
2101 Added configure flag --enable-old-bitops, which forces the bitops to
2102 use the old (native) bitmask operations. By default on the sparc
2103 platform, the standard ext2 bit ordering is now used.
2104
2105 Added a new feature to e2fsck to byte-swap filesystems; this can be
2106 used to convert old m68k filesystems to use the standard byte-order
2107 storage for the superblock, inodes, and directory blocks. This
2108 function is invoked by using the '-s' option to e2fsck.
2109
2110 Debugfs's "dump" command has been enhanced so that it writes out the
2111 exact size of the file so that the nulls at the end of the file are
2112 eliminated. The command also accept a new "-p" option which will
2113 attempt preserve to preserve the ownernship, permissions, and
2114 file modification/access times.
2115
2116 Debugfs has two new options, -f and -R. The -R option allows the user
2117 to execute a single debugfs command from the command line. The -f
2118 option allows the user to specify a "command file" containing debugfs
2119 commands which will get executed.
2120
2121 Dumpe2fs now pretty prints the check interval, instead of just
2122 printing the check interval as a number of seconds.
2123
2124 Fix bugs in debugfs: the params command when no filesystem is opened
2125 no longer causes a core dump. It is now possible to unlink a file
2126 when a pathame containing a '/' is specified.
2127
2128 Tune2fs has a new -C option which sets the number of times the
2129 filesystem has been mounted.
2130
2131 Fix the chattr '-v' option so that it actually works. Chattr was
2132 being buggy about the -v option parsing.
2133
2134 Programmers' notes:
2135 -------------------
2136
2137 The directory lib/uuid contains a set of library routines to generate
2138 DCE compatible UUIDs.
2139
2140 Extended ext2fs_namei() to handle symbolic links. Added new function
2141 ext2fs_nami_follow() which will follow last symbolic link in the case
2142 where the pathname points to a sym link.
2143
2144 The ext2fs_block_iterate function will now return the HURD translator
2145 block, if present. The new flag BLOCK_FLAG_DATA_ONLY will cause the
2146 iterator to return data blocks only. The ext2fs.h file now defines
2147 constants BLOCK_COUNT_IND, BLOCK_COUNT_DIND, BLOCK_COUNT_TIND, and
2148 BLOCK_COUNT_TRANSLATOR, which are the magic values passed in the block
2149 count field of the iterator callback function.
2150
2151 The test script driver now takes an optional second argument, which is
2152 the test case to be run. This allows you to run a test case without
2153 needing to run the entire test suite.
2154
2155 On Linux ELF systems, install the .so files in the correct places
2156 (/usr/lib). The .so files must be stored in the same directory as the
2157 .a files.
2158
2159 Fixed miscellaneous HURD compilation issues with header file being
2160 included in the right order.
2161
2162 Fixed debugfs so that it resets optind to zero, not one, since setting
2163 optind to zero is more correct.
2164
2165
2166 E2fsprogs 1.04 (May 16, 1996)
2167 =============================
2168
2169 First "official" (1.03 was a limited release only) to support building
2170 e2fsprogs under Linux 2.0 kernels (as well as late model 1.3 and 1.99
2171 kernels).
2172
2173 This package includes a RPM specs file, that it can be built using the
2174 RedHat Package Manager.
2175
2176 E2fsck now prints a hint that if there are lots of incorrectly located
2177 inode bitmaps, block bitmaps, and inode table blocks, the user might
2178 want to try using e2fsck -b 8193 first, to see if that fares any
2179 better.
2180
2181 For ext2 filesystem written with the hurd, debugfs will now print out
2182 the translator field when printing an inode structure.
2183
2184 Lots of miscellaneous linking/installation cleanups:
2185
2186 Libraries are now linked using a relative pathname, instead of
2187 relying on -L working correct. It doesn't, in many cases, including
2188 current versions of GNU ld. This guarantees that the build tree is
2189 linking with the right libraries, instead of the ones installed in
2190 /usr/lib.
2191
2192 Header files, man pages, and the et/ss shell scripts are now
2193 generated using a custom substitution script, instead of relying on
2194 the configure script. This prevents needless recompilation of
2195 files; in addition, the custom substitution script is much faster.
2196
2197 e2fsck may now be linked dynamically, by using the
2198 --enable-dynamic-e2fsck flag to configure. This is not recommended,
2199 since it increases e2fsck's dependence on other files, but some
2200 people need to save disk space, and other critical programs on their
2201 systems were being linked dynamically anyway.
2202
2203 Programs such as fsck which didn't need to be linked against
2204 libext2fs (or mke2fs which didn't need to be linked against libe2p)
2205 only link against libraries they actually need. Otherwise, those
2206 programs would require the presense of libraries that otherwise
2207 could be removed from a rescuse diskette.
2208
2209 The ss include files are now installed correctly so they can
2210 actually be used by another package.
2211
2212 If the profiling libraries are built, they are now installed on a
2213 "make install-libs".
2214
2215
2216 E2fsprogs 1.03 (March 27, 1996)
2217 ===============================
2218
2219 Change the m68k bit numbering for bitmasks to match the bit numbering
2220 used by all other ext2 implementations. (This change was requested by
2221 the m68k kernel development team.)
2222
2223 Support (in-development) filesystem format revision which supports
2224 (among other things) dynamically sized inodes.
2225
2226 Fixed a bug in the ext2 library so that an intelligent error is
2227 returned if mke2fs is run with a ridiculously small number of blocks
2228 for a partition.
2229
2230 Fixed a bug in the ext2 library which required that the device be
2231 openable in read/write mode in order to determine its size. This
2232 caused e2fsck -n to require read/write access when it was not
2233 previously necessary.
2234
2235 Fixed a bug in e2fsck which casued it to occasionally fail the test
2236 suite depending on which version of the floating point library it was
2237 using.
2238
2239 Fixed a bug in e2fsck so that it now halts with a fatal error when
2240 certain superblock consistency checks fail. Previously it continued
2241 running e2fsck, with some potential confusing/damaging consequences.
2242
2243 Added new flag to fsck which allows the root to be checked in parallel
2244 with other filesytems. This is not the safest thing in the world to
2245 do, but some system administrators really wanted it.
2246
2247 Fixed -Wall flames in lib/ss.
2248
2249
2250 E2fsprogs 1.02 (January 16, 1996)
2251 =================================
2252
2253 Fix to allow e2fsprogs to be compiled on recent 1.3 (pl45+) kernels.
2254
2255 Change e2fsck to print statistics of how many non-contiguous files are
2256 on the system. Note that a file which is larger than 8k blocks, it is
2257 guaranteed to be non-contiguous.
2258
2259 In mke2fs, print a warning message if a user tries to format a whole
2260 disk (/dev/hda versus /dev/hda1). If a user really wants to format a
2261 whole disk, the -F (force) option forces mke2fs to format a whole disk
2262 as a filesytem.
2263
2264 Fix a bug in fsck where in some cases it might start checking
2265 partitions in the next pass before it finishes checking partitions in
2266 the current pass. This still won't cause two partitions on the same
2267 disk will be checked, so it's rarely a problem in real life.
2268
2269 Patch lsattr so that it won't hang when checking a named pipe.
2270
2271 Minor compilation fixes:
2272 * Fix the order of libraries that were linked in debugfs.
2273 * Allow the sources to be compiled with -ansi turned on.