Whamcloud - gitweb
Update for 1.23-WIP-0722 release.
[tools/e2fsprogs.git] / RELEASE-NOTES
1 E2fsprogs 1.23-WIP (July 20, 2001)  (up to 1.23-WIP-0722)
2 ==================================
3
4 Add initial support for extended attributes (EA); e2fsck will
5 correctly handle a filesystem with EA's and check the EA blocks for
6 corruptions.
7
8 Add initial support for external journals (so long as the external journal
9 only supports a single filesystem).
10
11 Speed up the check of an ext3 filesystems by avoiding a needless flush
12 of all of the superblock and block group descriptors.
13
14 Add support in fsck for the filesystem type "auto".
15
16 E2fsck now gives an explicit warning if there filesystem still has
17 errors at the end of the run. (Addresses Debian bug #104502)
18
19 Some minor man pages updates. (Addresses Debian bug #30833)
20
21
22 E2fsprogs 1.22 (June 22, 2001)
23 ==============================
24
25 Fixed a bug in e2fsck's handling of orphan inodes which are special
26 files (i.e., block/character device files, named FIFO's, etc.).
27
28 Fixed a bug accidentally introduced in e2fsprogs 1.21 which caused
29 tune2fs to fail at adding a journal to a mounted filesystem.
30
31 Fixed a few big-endian bugs in e2fsprogs
32         * The directory block functions were accidentally reporting
33                 some directories as corrupted when they weren't.
34         * If e2fsprogs is compiled --disable-swapfs, the C language 
35                 equivalents weren't being included for big-endian platforms.
36                 (Fixes Debian bug #101686).
37
38 Fixed a Hurd compilation problem.  (Addresses Debian bug #101361)
39
40 Programmer's notes:
41 -------------------
42
43 Use platform independent method of defining the BLKFLSBUF and FDFLUSH
44 ioctls, and allow them to be defined for non-i386 platforms.
45
46 The uuid.h header file is now protected against multiple inclusions.
47
48 E2fsprogs is now being developed using BitKeeper.  Changed the test
49 scripts to deal with BK's stripping CR characgters from text files,
50 and changed the top-level Makefile.in to avoid including BitKeeper
51 files when generating the source tarball.
52
53
54 E2fsprogs 1.21 (June 15, 2001)
55 ==============================
56
57 Added new configure flags which allow a subset e2fsprogs to be built;
58 this is most useful for boot floopies, since the resulting shared
59 libraries and programs are slimmed down by removing features that
60 aren't necessary for a boot floppy.  The new flags that were added
61 are: --disable-swapfs, which removes support for byte swapping old
62 legacy PPC/68k filesystems, --disable-debugfs, which removes support
63 for debugfs from the libext2fs library, --disable-imager, which
64 removes support for the e2image program, and --disable-resizer, which
65 removes support for resize2fs.
66
67 E2fsck now prints the number of mounts or days elapsed since the last
68 check when e2fsck is forced to check an otherwise clean filesystem.
69
70 Tune2fs now prints an informative message about how often a filesystem
71 will be checked when adding a journal to the filesystem, to remind the
72 user that he/she may want to adjust those parameters using tune2fs
73 -c/-i.
74
75 Worked around hurd brain-damage which causes e2fsck to sometimes
76 believe a filesystem is the root filesystem based on device numbers
77 (since Hurd doesn't have dev_t's, which is arguably a POSIX.1
78 violation).
79
80 Fixed a bug introduced in 1.20 which caused e2fsck to abort with an
81 erroneous error with the -F option was specified.
82
83 Fixed a ext3 recovery bug in the revoke handling; synchronized with
84 ext3 0.7a.
85
86 Fixed two bugs in e2fsck's handling of dup block handling, dealing
87 with relatively uncommon edge cases: a directory with an indirect
88 block which is claimed by another file, and when the last inode in the
89 filesystem has blocks claimed by another file.
90
91 E2fsck now checks to see if the i_size field of a fast symlink is too
92 big, and offers to clear the symlink if so.
93
94 E2fsck now checks to see if i_size_high of special files is non-zero,
95 and offers to clear i_size_high.
96
97 Fix e2fsck's handling of incompatible journal flags so that the user
98 has chance to abort, and then has the option to clear out the journal
99 entirely.  (Addresses Debian bug #98527.)
100
101 Fixed a bug in fsck which could cause it to core dump if a mix of
102 standard and non-standard device names are used in /etc/fstab.
103 (Debian bug #100559)
104
105 Fixed a bug in debugfs which caused read errors when copying a file to
106 not be noticed.
107
108 The debugfs set_super_value command can now modify the s_lastcheck field.
109
110 Fixed a bug in lsattr and chattr which was accidentally introduced in
111 1.20 to support > 2GB files; both lsattr and chattr wasn't reading
112 directories correctly because the change modified the layout of struct
113 dirent to be incompatible with the libe2p shared library.
114
115 Cleaned up the mke2fs manual page and included a discussion about why
116 it's good to periodically check the filesystem even when journaling is
117 enabled.
118
119 Programmer's notes:
120 -------------------
121
122 Fix general gcc -Wall complaints.
123
124 The types needed by the ext2 header files are now provided by
125 lib/ext2fs/ext2_types.h, instead of include/asm/types.h.
126
127 Integers are now preferred to longs when trying to find a 32-bit type
128 in ext2_types.h.  Also, if linux/types.h has already been defined,
129 don't try to redefine the types.
130
131 Fixed make depend script so that it automatically corrects the
132 pathname cleanups performed by make -M, so I don't have to fix them up
133 by hand.
134
135 Fixed the d_loaddump test case to be more robust, and not depend on
136 bash'isms.
137
138 Removed debugfs's dependence on pread(), which was accidentally
139 intrudced in e2fsprogs 1.20
140
141 Fixed a performance bug in the libext2fs's icount routine; the size
142 estimate of the icount array was incorrectly being calculated.
143
144 Removed use of the badblocks compatibility functions in the e2fsprogs
145 programs.
146
147 Added paranoia code which protects against strange cases where /etc
148 isn't on the root filesystem, or if /etc/mtab doesn't exist.
149
150 The header file ext2_types.h is now installed.
151
152 Autoconf is used to determine when we are on big-endian machines,
153 instead of doing run-time tests, to save a few bytes of code.
154
155 The ext2fs_mark_generic_bitmap and ext2fs_unmark_generic_bitmap
156 functions are no longer inline functions, which saves space and
157 doesn't really cost any real performance.
158
159 The ext2fs library no longer depends on the e2p library.  (What need
160 there was of it --- namely, fsetflags, was coded in-line).
161
162 Fixed the makefile so that lib/ext2fs/ext2_types.h is generated even
163 when the user is stupid and tries compiling the package using "make
164 install" as root.
165
166 Miscellaneous code cleanups:
167         * Added missing files from Makefile.in's SRCS file, so that 
168                 their dependencies would be properly calculated.
169         * Removed redundant code
170         * Fixed comments in code
171         * Removed no-longer unneeded argsused #pragma.
172
173
174 E2fsprogs 1.20 (May 20, 2001)
175 =============================
176
177 Add support for replaying the ext3 journal purely in user mode,
178 including handling the orphaned inode list.  Used code contributed by
179 Andreas Dilger, with bug fixes and the orphaned inode handling done
180 by Theodore Ts'o.
181
182 The mke2fs and tune2fs programs can create or modify a filesystem to
183 include an ext3 journal.  Tune2fs also can be used to remove an ext3
184 journal from a filesystem.
185
186 E2fsck will now check for the existence of a linked list of orphan
187 inodes in the superblock, and clear those inodes before starting the
188 rest of the filesystem check (but after the journal playback).
189
190 E2fsck now validates the file descriptor passed to the -C option,
191 which saves against the completion bar getting written to an
192 unexpected location, such as the disk being checked.  (Debian
193 bug/wishlist #55220)
194
195 E2fsck will now bump the filesystem revision number from zero to one
196 if any of the compatibility bits are set.
197
198 Fixed a bug where a badly corrupted directory on a big endian system
199 could cause e2fsck to die with a bus error.  The
200 ext2fs_read_dir_block() and ext2fs_process_dir_block() functions in
201 the ext2 library now does alignment sanity checks on the rec_len field
202 of the directory entry before using it.
203
204 The ext2 library has been enhanced to make tune2fs safe to run on
205 mounted filesystems.  (Users could usually get away with using tune2fs
206 on mounted filesystems before, but with the advent of ext3 and
207 journaling, it became important to make tune2fs was *really* safe for
208 use even when the filesystem being modified is mounted.)  E2label is
209 now implemented by tune2fs using an argv[0] dispatch, so that e2label
210 is also now safe for use on mounted filesystems.
211
212 Added a new program, e2image, which creates a backup of critical ext2
213 filesystem data structures.  The generated image file can be examined
214 using dumpe2fs and debugfs.  In the future, e2fsck will be able to use
215 the image file to help recover very badly damaged filesystems.
216
217 Fixed a number of LFS bugs in e2fsck; very, very large (> 2**42) files
218 no longer cause e2fsck to bomb out.  Also treat files > 2GB as being
219 large file when deciding whether or not the filesystem has large files.
220
221 Fixed lsattr and chattr so that they work correctly on large files.
222 (Fixes Debian bug #72690.)
223
224 Removed limitation in get_device_size() which imposed a one terrabyte
225 filesystem limitation.  (Most 2.2 kernels still have a signed int
226 problem which cause 1 TB block device limitation.  Fortunately, the
227 kernel patches to fix this are much easier than fixing the 2TB
228 limitation in the kernel.  :-)
229
230 A max_mount_count of zero is now treated as if no mount count were
231 set.  (Previously, no mount count was indicated by using -1, and a
232 mount count of zero caused e2fsck to always be run.)
233
234 Mke2fs supports two new filesystem types largefile and largefile4.
235
236 Mke2fs now adds some randomness in s_max_mount_count so that multiple
237 filesystems won't be all checked at the same time under normal
238 operations.
239
240 Fixed bug in the progress bar printing code which could cause e2fsck
241 to core dump on an illegal filesystem.
242
243 Fixed bug in fsck which could allow more than one instance of e2fsck
244 to be printing a progress bar.  (Debian bug #65267)
245
246 Fsck using a UUID or a LABEL specifier will work even if devfs is
247 compiled into the kernel and not mounted.  If the pathnames in
248 /proc/partitions are incorrect, fsck will search /dev for the correct
249 device (using the new ext2fs_find_block_device library function).
250 Fsck now also checks the RAID devices first so that they are properly
251 found when they are in use.  Support has also been added to support
252 additional IDE disks and the DAC 960 device names.  (Debian bug #94159)
253
254 Fixed a bug in fsck which caused it not deal properly with 16
255 byte long filesystem labels.
256
257 Fsck's -t option has been made a lot more flexible.  The semantics for
258 what happens if a comma-separated list to fsck has been regularized,
259 and it is now possible to filter what filesystems will get checked
260 based what is in the filesystem's fstab entry's option field.  (Debian
261 bug #89483.)
262
263 The dumpe2fs program can now print out the group description
264 information in hex, and also prints the location of the superblock and
265 block group descriptor for those block groups that have them.
266
267 Mke2fs now clears the ext2 superblock before it starts creating a
268 filesystem, so that the superblock magic number is only written if the
269 filesystem creation process successfully completes.
270
271 The debugfs program's stat command now pretty-prints the blocks used
272 by an inode so that it's more compact and informative.
273
274 The debugfs stats command now uses the same libe2p code (which is used
275 by dumpe2fs) to print the superblock header information.  This is more
276 complete, and it avoids a bit of code duplication.
277
278 Added a new debugfs command, set_super_value (ssv) which allows the
279 user to set arbitrary superblock fields.
280
281 Debugfs was extended to support inode numbers in hex (by prefixing
282 them with 0x), and so that modify_inode can set the inode generation
283 number.  Also, there is now a new function command called logdump
284 which will dump an ext3 journal.
285
286 Fixed a bug in debugfs so that quitting out of the pager doesn't kill
287 debugfs.
288
289 Debugfs's dump command now stops immediately upon reporting a disk
290 read error.  (Fixed a bug in ext2fs_file_read library routine which
291 caused debugfs not to stop.)  (Debian bug #79163)
292
293 On systems with /proc/mounts (mainly Linux systems), /proc/mounts is
294 checked before /etc/mtab is used, since /proc/mounts is more likely to
295 be accurate.
296
297 Added portability fixes for Solaris and Linux/ia64.
298
299 Various manual pages were clarified and cleaned up.  (Fixed debian
300 bugs #63442, #67446, and #87216)
301
302
303 Programmer's notes:
304 -------------------
305
306 The e2fsck message printer now supports %Iu and %Ig, which will print
307 out the inode's user and group owners, respectively.
308
309 E2fsprogs now includes its own version of include/linux/ext2_fs.h, so
310 that no longer dependent on the system having the correct version of
311 the kernel header files.
312
313 Added a new function to libext2, ext2fs_find_block_device(), which
314 searches the system (i.e., /dev, /devfs, /devices) for a pathname to a
315 device given its device number.
316
317 Added a new function to libext2, ext2fs_sync_device, which centralizes
318 all of the places which might try to use the BLKFLSBUF or FDFLUSH
319 ioctls (and usually failing to define them since the system header
320 files don't usually do this for us, and we're trying to avoid usage of
321 kernel include files now).
322
323 Added new utility programs in tests/progs: random_exercise and
324 hold_inode.  They aren't built by default; they're useful for
325 exercising ext3 filesystem code.
326
327 Added a new ext2 filesystem flag, EXT2_FLAG_SUPER_ONLY, which causes
328 the filesystem close functions to only update the superblock, and to
329 not touch the block group descriptors.  Needed by tune2fs when
330 modifying a mounted filesystem.
331
332 Got rid of struct ext2fs_sb and replaced it with the standard struct
333 ext2_super_block from include/linux/ext2_fs.h.  Note: this may break
334 source (but not binary) compatibility of some users of the ext2
335 library.  Those applications should just simply do a global search and
336 replace of struct ext2fs_sb with struct ext2_super_block, and include
337 the new header file <ext2fs/ext2_fs.h> which defines it.
338
339 The ino_t type has been renamed ext2_ino_t to protect applications
340 that attempt to compile -D_FILE_OFFSET_BITS=64, since this
341 inexplicably changes ino_t(!?).  So we use ext2_ino_t to avoid an
342 unexpected ABI change.
343
344 The Makefiles have been reworked so that "make check" can be run from
345 the top-level Makefile.
346
347 Fix general gcc -Wall complaints and removed dead code.
348
349 Remove use of NOARGS, because we assume everyone does ANSI C these
350 days.
351
352 Added build-rpm script from sct.
353
354 New functions ext2fs_image_{inode,super,bitmap}_{read,write} added 
355 to support e2image.
356
357 New function ext2fs_flush_icache which must be called if the
358 application program modifies the inode table blocks without going
359 through ext2fs_write_inode() interface.
360
361 New ext2fs_check_mount_point() function, which will return the mount
362 point of a device if mounted.
363
364 The io_channel abstraction now has an optional interface,
365 io_channel_write_range, which allows specific byte ranges to be
366 written.  
367
368 The unix_io IO channel now supports write-through caching, so that
369 journal creation is more efficient.
370
371 Added x86 assembly language routines to support byte swapping, to
372 reduce executable size.
373
374 Fixed bug in the utility program subst so that it's possible to
375 replace a substitution variable with a zero-length string.
376
377 Fixed numbering e2fsck pass1 problem numbers; an extra zero had
378 slipped into some of the problem number.
379
380 E2fsprogs 1.19 (July 13, 2000)
381 ==============================
382
383 Release the resize2fs program since the timeout before it could
384 be released under the GPL has finally expired.
385
386 Add experimental support needed for the ext2 compression patches.
387 This requires compiling e2fsprogs with the --enable-compression flag
388 to the configure script.
389
390 Added ext3 journalling support.  E2fsck will run the journal (if
391 necessary) by temporarily mounting the filesystem.  /sbin/fsck.ext3 is
392 installed as a symlink to e2fsck.  Fsck has been taught about ext3,
393 and treats it the same as ext2 in terms of the progress bar logic.
394 Dumpe2fs will display the superblock journaling information if the
395 filesystem has a journal.  The ext2 library will now permit opening an
396 ext3 filesystem with the recovery flag set.  This is necessary for
397 on-line dump's to work correctly, but there may be issues with this
398 working well since ext3 is much less agressive about syncing blocks to
399 the filesystem, since they're safe on the journal.
400
401 Tune2fs and e2fsck have been changed to allow the mount_count check to
402 be disabled by setting max_mount_count to -1.  (This was already
403 supported by the kernel.)
404
405 Create a symbolic link for fsck.ext3, since the e2fsprogs utilities
406 are used for ext3 as well.
407
408 Added internationalization support for e2fsprogs; must be enabled
409 by passing --enable-nls to configure.
410
411 Always use the provided ext2fs header files to insulate ourselves from
412 kernel version changes.  Which include files are used by e2fsprogs
413 have also been cleaned up to improve portability.
414
415 Limit the number of times that e2fsck updates the progress bar so that
416 people who are booting using a 9600 baud console don't get swampped by
417 too many updates.
418
419 Improved the loop detection algorithm in e2sck's pass #3 so that it is
420 much, much faster for large filesystems with a large number of
421 directories.
422
423 The memory footprint for e2fsck is now slightly smaller than before.
424
425 E2fsck now checks if special devices have a non-zero size, and offers
426 to clear the size field if it finds such an inode.  
427
428 E2fsck now checks if special devices have the append-only flag set,
429 and offers to clear the inode.
430
431 E2fsck now properly handles some "should never fail" cases during a
432 bitmap copy in pass5.
433
434 E2fsck now properly prints control characters in filenames as ^A .. ^Z.
435
436 E2fsck now calculates the correct location of the backup superblock in
437 the case of filesystem blocksizes > 1k.
438
439 Fixed a bug in e2fsck's calculation of the number of inodes_per_block
440 which normally didn't cause problems under most filesystem parameters,
441 but could cause a valid superblock to be rejected in extreme cases.
442 Other checks for validating superblock values were made more
443 stringent.
444
445 Added non-destructive write testing to the badblocks program, courtesy
446 of David Beattie.  The badblocks also now has an option to input the
447 current set of bad blocks, so that known bad blocks are skipped to
448 speed up the badblocks test.  There is also a persistent rescan
449 feature which causes badblocks to run until it has completed some
450 number of passes without discovering any new bad blocks.
451
452 Badblocks now checks to see if the device is mounted and refuses to do
453 the tests involving writing to the device if it is mounted.  Also,
454 badblocks now allows the number of blocks to be checked to be
455 defaulted to the size of the partition.
456
457 Fixed a bug in fsck which didn't allow non-root users to be able to
458 check filesystems if there were any LABEL= or UUID= entries in
459 /etc/fstab.
460
461 The Hurd doesn't support the filetype filesystem feature.  The mke2fs
462 program now makes sure that for the Hurd, the filestype feature is
463 turned off.  E2fsck will check to see if the filetype feature is
464 turned on for Hurd filesystems, and offer to turn off the feature.
465
466 Mke2fs now has a safety check to make sure the number of blocks do not
467 exceed 32 bits even on a 64 bit platform.
468
469 Really fixed a bug in fsck to allow "fsck -As" to run interactive
470 fsck's.  (For those people who like to do interactive fsck's in the
471 /etc/rc scripts!?!)
472
473 Debugfs has a few new features: the rdump command, which will do a
474 recursive dump of a directory and all of its contents, and the lcd
475 command which does a local chdir (much like the ftp command of the
476 same name).  In addition, the debugfs program and the open_filesystem
477 command now takes three new options: -b and -s, which allows the
478 blocksize and superblock location to be specified, and the -c option
479 which is used in catastrophic situations where the block group
480 descriptors are corrupt.  If the -c option is specified, debugfs will
481 skip trying to read in the block and inode bitmaps.
482
483 Debufs's lsdel command was fixed to handle bad blocks in the inode
484 table.
485
486 A Y2K bug in debugfs's "ls -l" handling was fixed by switching to use
487 4 digit years.
488
489 General improvements in error messages
490
491   - Mke2fs prints a sane error message if the partition size is zero
492         (usually because the partition table wasn't reread by the
493         kernel due to the partition being busy), instead of "invalid
494         argument passed to ext2 library while initializing superblock".
495
496   - Fsck now prints more self-explanatory message if an invalid UUID=
497         or LABEL= specification is passed to it.
498
499 UUID library changed to use the LGPL.
500
501 Fixed a bug in the UUID library where very rapid calls to the
502 time-based UUID generator could cause duplicate UUID's to be returned.
503 This was not a problem for e2fsprogs, but it could be a problem for
504 other users of the library.
505
506 Make the UUID library more robust in the face of missing or an
507 improper /dev/urandom or /dev/random files.
508
509 Added some random portability fixes for Solaris.
510
511 Some minor man page updates.
512
513 Fixed a memory leak in the ss library.
514
515
516 Programmer's notes:
517 -------------------
518
519 We now try to use lseek64 and open64 from the LFS if possible.
520
521 The 3rd parameter in e2p's print_flags is now a flags word, instead of
522 a boolean option.
523
524 The mark and unmark bitmap functions now return the previous state of
525 the bit that was being changed, which is useful for some speed
526 optimizations.
527
528 The following functions have been added to enhance the badblocks list
529 handling in libext2fs: ext2fs_write_bb_FILE, ext2fs_read_bb_FILE2, and
530 ext2fs_badblocks_equal.
531
532 The ext2 header files now have the latest journalling fields to the
533 superblock.
534
535 The ext2fs_mkdir function in libext2fs now properly backs out of error
536 conditions robustly.
537
538 Cleaned up makefiles:
539   - to cleanly  compile with the -j flag.
540   - so distclean removes all generated files.
541   - so in case of an error while installing header files, the make aborts.
542
543 Fix test_script so that it works correctly when compiling in the
544 source directory.
545
546 The random UUID generation routine has been made slightly better in
547 the case where /dev/random doesn't exist.  (Use of randomly-based UUID
548 is still not recommended if /dev/random doesn't exist, however; it's
549 better to use the time/ethernet MAC address UUID in this case.)
550
551 Clean up the build process so it's more friendly in case of missing
552 directories.
553
554 The ext2fs header file can now be #include'd into C++ programs.
555
556 The e2p.h header file is now installed.
557
558 Added workaround to a gawk 3.0.5 bug in lib/ss/mk_cmds.
559
560
561
562 E2fsprogs 1.18 (November 10, 1999)
563 ==================================
564
565 Fix a core dumping bug in e2fsck if an imagic inode is present or
566 (more rarely) if the filesystem is badly corrupted enough that e2fsck
567 has to restart pass 1 processing.  E2fsck now closes the filesystem
568 before freeing a large number of its data structures, so in the case
569 of future memory faults, at least the fixed filesystem will be fully
570 written out.
571
572 If a filesystem doesn't support imagic inodes, and e2fsck discovers an
573 imagic inode, it will offer to clear the imagic flag.
574
575 E2fsck will now offer to clear the immutable flag on special files
576 (device/socket/fifos) when running it in non-preen mode.
577
578 E2fsck will now set the filetype when creating /lost+found, and when
579 connected orphaned inodes to /lost+found.
580
581 Debugfs's ncheck and icheck commands now handles the case where there
582 are bad blocks in the inode table without bombing out.
583
584 The badblocks list processing code has been made more efficiently for
585 appending a large number of (ordered) badblocks to the badblocks list.
586
587 Some minor man page updates.
588
589 Fsck now allows interactive e2fsck's when using fsck -As (not a common
590 mode, but some people like to do this in boot scripts for silly reasons).
591
592 Programmer's notes:
593 -------------------
594
595 The internal e2fsck problem code for PR_2_SPLIT_DOT was fixed to meet
596 with the problem code convention.
597
598 The badblocks list regression test program has been updated to work
599 with previously made API name changes.
600
601 The ext2fs_free() command now uses the new badblocks API to avoid
602 using the compatibility layer.
603
604 Added new regression test cases; the run_e2fsck test script now
605 supports the ability for a test case to run a prepratory command
606 before running e2fsck.
607
608 E2fsprogs 1.17 (October 26, 1999)
609 =================================
610
611 Fixed nasty typo in fsck which caused parallelized fsck's to go into an
612 infinite loop.
613
614 Fixed a bug in fsck where it used strncmp to compare a binary UUID,
615 thus potentially causing problems if a binary UUID contained a NULL
616 character.
617
618 E2fsck now uses stricter checks for directory entries in pass 2:
619 zero-length filenames are not allowed; neither are 8 byte long
620 directory entries.
621
622 The debugfs "dirty" command now clears the filesystem valid bit.
623 (Previously this just set the dirty-as-in-needs-writing-out-to-disk
624 bit in the in-core superblock image.  The new functionality is more
625 what the user expects, and is more useful.)
626
627 Added a debugging hook to test parallel fsck; if the environment
628 variable FSCK_FORCE_ALL_PARALLEL, then filesystems on the same drive
629 will be checked in parallel when they normally would not be.
630
631 Programmer's notes:
632 -------------------
633
634 Fixed some #ifdef's for compilation under the Hurd OS.
635
636 Fixed minor W2K compatibility problems.
637
638 Fixed some miscellaneous GCC warnings.
639
640
641 E2fsprogs 1.16 (October 22, 1999)
642 =================================
643
644 Fixed a race condition bug in fsck; when printing a progress bar, if
645 checking multiple filesystems in parallel, it was possible for fsck to
646 send e2fsck a SIGUSR1 signal before e2fsck had installed its signal
647 handler, which would cause it to terminate with a signal 10.
648
649 E2fsck now properly handles filesystems that have the
650 INCOMPAT_FILETYPE feature turned on.  It can be used to convert a
651 filesystem into using or not using FILETYPE feature.
652
653 E2fsck now properly handles filesystems that have the IMAGIC feature
654 turned on (this is used on Linux AFS servers).
655
656 The mke2fs program now creates filesystems that have the filetype and
657 sparse_superblock features enabled by default, unless it is run on a
658 pre-2.2 kernel.  These features are not supported by a pre-2.2 kernel,
659 so there is now a new flag -O which allows the user to specify with
660 which features she would like to create the filesystem; "mke2fs -O
661 none" will create a filesystsem compatible with 2.0 kernels.
662
663 The tune2fs program now has a -O option which allows the user to set
664 and reset "safe" filesystem features.  Currently, the only ones which
665 allows to be modified are the filetype and sparse_superblock features.
666 Note setting or clearing either feature will require running e2fsck on
667 the filesystem afterwards.  (n.b. Clearing the sparse_superblock feature
668 requires that there is enough free space on the filesystem for the
669 extra superblocks which will be created by e2fsck.)
670
671 Debugfs can now set and print filesystem features in the superblock
672 using the "features" command.  Dumpe2fs will print out the complete
673 set of features when listing the superblock.
674
675 Dumpe2fs has new options -f (force) and -h (header-only).
676
677 Fixed a bug in e2fsck which could cause the PROGRAMMING ERROR/bonehead
678 message to come up.  This could happen when decrementing or
679 incrementing a link count could result in an overflow.
680
681 Fixed a bug in e2fsck where the block count on the lost+found
682 directory would not be properly incremented when the directory was
683 expanded to the point where an indirect block needed to be allocated.
684
685 E2fsck now makes some additional sanity checks on the superblock to
686 avoid crashing or giving a memory allocation error if some of the
687 values in the superblock are unresonable (but the superblock otherwise
688 looks valid).
689
690 Fixed a bug in e2fsck where a very badly corrupted filesystem might
691 require two passes to completely fix the filesystem.  This happened if
692 an inode claimed blocks that was part of the filesystem metadata
693 (typically, when garbage was written into an inode table or indirect
694 block, since this kind of filesystem corruption normally doesn't
695 happen otherwise).
696
697 On the Alpha, glibc declares st_flags although it isn't actually used;
698 the configure script was improved to detect this case so that
699 e2fsprogs can avoid using the non-functional stat field.
700
701 The manual pages were updated to use a more consistent formatting
702 style consistent with standard Unix man pages.  Mke2fs's man page
703 added documentation for a few previously undocumented options.
704
705 Fixed minor display bugs in tune2fs and mke2fs.
706
707 Programmer's notes:
708 -------------------
709
710 Improved portability of e2fsprogs to non-Unix systems (in particular, NT).
711
712 Added features to parse and print feature strings into the e2p library.  
713 (e2p_feature2string, e2p_string2feature, e2p_edit_feature).
714
715 ext2fs_mkdir() and ext2fs_new_dir_block() now creates directories
716 whose directory entries contain proper filetype information if the
717 filesystem supports it.
718
719 ext2fs_link() now uses the low 3 bits of its flags parameter to pass
720 the directory entry filetype information.  This is used to set the
721 directory entry filetype information if the filesystem supports it.
722
723 Fixed a bug in ext2fs_expand_dir() where the block count in a
724 directory's inode would not be properly incremented when the directory
725 was expanded to the point where an indirect block needed to be
726 allocated.
727
728
729 E2fsprogs 1.15 (July 18, 1999)
730 ==============================
731
732 Add configuration checks so that e2fsprogs will compile cleanly on
733 Linux 2.3 kernels that have renamed i_version to i_generation.
734
735 E2fsck now prints a progress/completion bar (and not just a simple
736 spinner) if the -C0 option is requested or if it receives a SIGUSR1
737 signal.  Fsck will automatically manage the (potentially muliple)
738 e2fsck processes to print completion bars if it is given a -C option,
739 with the right thing happening if multiple filesystems are being
740 checked in parallel.
741
742 Mke2fs now has better automatic hueristics to determine the filesystem
743 parameters to be used for a particular filesystem.  Added a new option
744 -T which allows the user to specify how the filesystem is to be used,
745 which helps mke2fs do a better job selecting the filesystem parameters.
746
747 Mke2fs now creates revision 1 filesystems by default, and with the
748 sparse superblock feature enabled.  The sparse superblock feature is
749 not understood by Linux 2.0 kernels, so they will only allow read-only
750 mounts of filesystems with this sparse superblocks.
751
752 Fix bug where if /dev/null couldn't be opened (should never happen),
753 e2fsck would hang in a tight loop.
754
755 Make e2fsck handle the case where /lost+found isn't a directory.
756
757 E2fsck now uses mallinfo if it exists to get accurate statistics about
758 its memory usage.
759
760 Fix bug in e2fsck where it wouldn't check to see if a disconnected
761 inode had any problems before connecting it to /lost+found.
762
763 Add check to e2fsck so it makes sure that total number of inodes in
764 the filesystem is a sane number.
765
766 Fix fencepost error when clearing an the end of the block bitmap which
767 caused the last block in the bitmap not to get cleared.
768
769 Cleaned up a number of messages in e2fsck:
770         * The message "Group's #'s copy of the group descriptor..."
771                 was fixed so that the correct number would be displayed.
772         * Added missing space in the "disk write-protected" error messsage
773         * Cleaned up the error message printed when a non-interactive
774                 e2fsck needs to abort a check because the filesystem
775                 appears to be mounted.
776
777 Added a new command-line utility, uuidgen, which will create and print
778 a UUID.
779
780 Make debugfs's icheck command more robust by checking to make sure an
781 inode has valid blocks before interarting over the inode's blocks.
782
783 UUID generation now uses a random-based scheme whenever possible to
784 prevent potential privacy problems.
785
786 Man pages for all of the UUID functions in the lirbary were added.
787
788 Fixed bug in fsck so it won't coredump if a filesystem not in
789 /etc/fstab is given to it.
790
791 Fsck now understands the UUID=xxxx and LABEL=yyyy forms in /etc/fstab
792 that most of the other mount utilities understands.
793
794 Mke2fs will make a filesystem even if it appears mounted if the force
795 option is given.
796
797 Dumpe2fs has new command-line options which allow a filesystem expert
798 to specify the superblock and blocksize when opening a filesystem.
799 This is mainly useful when examining the remains of a toasted
800 filesystem.
801
802 The badblocks program has been updated to display correctly on disks
803 with large block numbers.
804
805 The badblocks program no longer gives spurious errors when errors
806 occur on non-block boundaries, which is common if the blocksize is
807 larger than 1k.
808
809 Mke2fs will sync the disk device every MKE2FS_SYNC block groups if the
810 MKE2FS_SYNC environment variable is set.  This is to work around a VM
811 bug in the 2.0 kernel.  I've heard a report that a RAID user was able
812 to trigger it even using a 2.2 kernel, but hopefully it will not be
813 needed for most Linux 2.2 users.
814
815 Fixed miscellaneous documentation and man pages.
816
817 Programmer's notes:
818 -------------------
819
820 Cleaned up functions such as pass1_get_blocks, pass1_read_inode which
821 in e2fsck's pass1.c really should have been static.
822
823 The return value of the uuid_compare() function was changed to make it
824 match with the convetions used by strcmp, memcmp, and Paul Leach's
825 UUID sample document.
826
827 The "make depend" process has now been made more automated; it now
828 automatically word-wraps the dependencies, and only replaces source
829 Makefile.in if there has been a change in the dependencies.  Also, a
830 top-level "make depend" now recurses through all the subdirectories
831 automatically.
832
833 The Makefile in .../util has been changed so that subst is built using
834 the native C compiler during a cross-compilation, since the subst
835 program is only used during the build process.  Also add an explicit
836 rule to build util/subst by cd'ing to the correct directory and
837 running Makefile.
838
839 The man directories are defined in terms mandir, so that the configure
840 script can override the location of the manual pages.
841
842 The config files have been updated to recognize new machine types for
843 both the i386 and alpha families.
844
845 Fsck has been modified so that it will accurately create an
846 fsck_instance even when the noexecute flag is set.  This allows for
847 accurate debugging of the fsck pass structure.  Also, when the verbose
848 flag is given twice, fsck will print debugging information about when
849 fsck is waiting for jobs to finish.
850
851
852 E2fsprogs 1.14 (January 9, 1999)
853 ================================
854
855 Fix the fstab parsing code so that it can handle blank lines and
856 comment characters.  Also, missing pass numbers need to be treated as
857 zero.
858
859 Fixed a bug in e2fsck where under some circumstances (when e2fsck
860 needs to restart processing after fixing an egregious inconsistency)
861 it would try to access already freed memory.
862
863 E2fsck now prints non-printable characters in directory entries and
864 pathnames using '^' and 'M-' notation.
865
866 Fixed chattr so that it will ignore symbolic links when doing
867 recursive descent traversals.  For both chattr and lsattr, no longer
868 print the version string unless the -V option is given.
869
870 Allow the system administrator to directly specify the number of
871 inodes desired in the filesystem, for some special cases where this is
872 necessary.
873
874 Fix portability problems so that e2fsprogs can be compiled under Linux
875 1.2 systems and Solaris systems.
876
877 Update the config.guess file with a more recent version that will
878 identify newer Linux platforms.
879
880 Programmer's notes
881 ------------------
882
883 Ext2fs_read_inode and ext2fs_write_inode will now return an error if
884 an inode number of zero is passed to them.
885
886 E2fsprogs 1.13 (December 15, 1998)
887 ==================================
888
889 Fixed a bug in debugfs where an error messages weren't getting printed
890 when the ext2 library routines to read inodes returned errors in the
891 stat, cmri and rm commands.
892
893 Fixed a bug in mke2fs so that if a ridiculous inode ratio parameter is
894 provided, it won't create an inode table smaller than the minimum
895 number of inodes required for a proper ext2 filesystem.
896
897 Fsck now parses the /etc/fstab file directly (instead of using
898 getmntent()), so that it can distinguish between a missing pass number
899 field and pass number field of zero.  This caused problems for
900 diskless workstations where all of the filesystems in /etc/fstab have
901 an explicit pass number of zero, and fsck could not distinguish this
902 from a /etc/fstab file with missing pass numbers.
903
904 E2fsck will create a /lost+found directory if there isn't one in the
905 filesystem, since it's safer to create the lost+found directory before
906 it's needed.
907
908 Fixed e2fsck so that it would detect bogus immutable inodes which
909 happen to be sockets and FIFO files, and offer to clear them.
910
911 If a filesystem has multiple reasons why it needs to be checked, and
912 one of the reasons is that it is uncleanly mounted, e2fsck will print
913 that as the reason why the filesystem is being checked.
914
915 Cleaned up the output routines of mke2fs so that it doesn't overflow
916 an 80 column display when formating really big filesystems.
917
918 Added a sanity check to e2fsck to make sure that file descriptors 0,
919 1, 2 are open before opening the hard disk.  This avoids a problem
920 where a broken program might exec e2fsck with those file descriptors
921 closed, which would cause disastrous results if the kernel returns a
922 file descriptor for the block device which is also used by FILE *
923 stdout.
924
925 Fixed up the e2fsck progress reporting functions so that the values
926 reliably reach 100% at the completion of all of the e2fsck passes.
927
928 Fixed minor documentation bugs in man pages and usage messages.
929
930 Programmer's notes:
931 -------------------
932
933 Fixed a number of lint warnings in the ext2fs library and potential
934 portability problems from other OS's header files that might define
935 CPP macros for names like "max" and "min".
936
937 ext2fs_badblocks_list_add() has been made more efficient when it needs
938 to grow the bad blocks list.
939
940 Fixed a bug in e2fsck which caused it to dereference a freed pointer
941 just before exiting.
942
943 Fixed the substition process for generating the mk_cmds and compile_et
944 scripts so that they will work outside of the build tree.
945
946 Add sanity check to e2fsck so that if an internal routine
947 (ext2fs_get_dir_info) returns NULL, avoid dereferencing the pointer
948 and causing a core dump.  This should never happen, but...
949
950 E2fsprogs 1.12 (July 9, 1998)
951 ==================================
952
953 E2fsprogs now works with glibc (at least with the version shipped wtih
954 RedHat 5.0).  The ext2fs_llseek() function should now work even with
955 i386 ELF shared libraries and if llseek() is not present.  We also
956 explicitly do a configure test to see if (a) llseek is in libc, and
957 (b) if llseek is declared in the system header files.  (See standard
958 complaints about libc developers don't understand the concept of
959 compatibility with previous versions of libc.)
960
961 The ext2fs library now writes out the block group number in each of
962 the superblock copies.  This makes it easier to automatically
963 determine the starting block group of the filesystem when the block
964 group information is trashed.
965
966 Added support for the EXT2_FEATURE_INCOMPAT_FILETYPE feature,
967 which means that e2fsprogs will ignore the high 8 bits of the
968 directory entry's name_len field, so that it can be used for other
969 purposes.
970
971 Added support for the EXT2_FEATURE_RO_COMPAT_LARGE_FILE feature.
972 E2fsprogs will now support filesystems with 64-bit sized files.
973
974 Added support for the EXT2_FEATURE_COMPAT_DIR_PREALLOC feature.
975
976 Added new program "e2label", contributed by Andries Brouwer.  E2label
977 provides an easy-to-use interface to modify the filesystem label.
978
979 Fixed bug so that lsattr -v works instead of producing a core dump.
980
981 Fixed a minor bug in mke2fs so that all groups with bad superblock
982 backup blocks are printed (not just the first one).
983
984 Mke2fs will check the size of the device, and if the user specifies a
985 filesystem size larger than the apparent size of the device it will
986 print a warning message and ask if the user wants to proceed.
987
988 E2fsck has a new option -C, which sends completion information to the
989 specified file descriptor.  For the most part, this is intended for
990 programs to use, although -C 0 will print a spinning character to the
991 stdout device, which may be useful for users who want to see something
992 happening while e2fsck goes about its business.
993
994 Fixed a bug in e2fsck which could cause a core dump when it needs to
995 expand the /lost+found directory, and sometimes the bitmaps haven't
996 been merged in.  Also fixed a related bug where ext2fs_write_dir_block
997 was used to write out a non-directory block.  (Which would be bad on a
998 non-Intel platform with byte swapping going on.)
999
1000 Fixed bug in e2fsck where it would print a "programming error" message
1001 instead of correctly identifying where a bad block was in used when
1002 the bad block was in a non-primary superblock or block group
1003 descriptor.  Also fixed a related bug when sparse superblocks are in
1004 use and there is a bad block where a superblock or block group
1005 descriptor would have been in a group that doesn't include a
1006 superblock.
1007
1008 Fixed a bug in e2fsck (really in libext2fs's dblist function) where if
1009 the block group descriptor table is corrupt, it was possible to try to
1010 allocate a huge array, fail, and then abort e2fsck.
1011 ext2fs_get_num_dirs() now sanity checks the block group descriptor,
1012 and subsitutes reasonable values if the descriptors are obviously bogus.
1013
1014 If e2fsck finds a device file which has the immutable flag set and the
1015 i_blocks beyond the normal device number are non-zero, e2fsck will
1016 offer to remove it, since it's probably caused by garbage in the inode
1017 table.
1018
1019 When opening a filesystem, e2fsck specially checks for the EROFS error
1020 code, and prints a specific error message to the user which is more
1021 user friendly.
1022
1023 If the filesystem revision is too high, change the e2fsck to print
1024 that this is either because e2fsck is out of date, or because the
1025 superblock is corrupt.  
1026
1027 E2fsck now checks for directories that have duplicate '.' and '..'
1028 entries, and fixes this corruption.
1029
1030 E2fsck no longer forces a sync of the filesystem (with attendant sleep
1031 calls) at all times.  The ext2fs_flush() function now performs a sync
1032 only if it needed to write data blocks to disk.
1033
1034 Fixed a minor bug in e2fsck's pass1b's file cloning function, where
1035 certain errors would not be properly reported.
1036
1037 Updated and expanded a few points in the man pages which users
1038 complained wheren't explicit enough.
1039
1040 Added special case byte-swapping code if compiling on the PowerPC, to
1041 accomodate the strange big-endian variant of the ext2 filesystem that
1042 was previously used on the PowerPC port.
1043
1044
1045 Programmer's notes:
1046 -------------------
1047
1048 Removed C++ keywords from the ext2fs libraries so that it could be
1049 compiled with C++.
1050
1051 E2fsck's internal organization has now been massively reorganized so
1052 that pass*.c don't have any printf statements.  Instead, all problems
1053 are reported through the fix_problem() abstraction interface.  E2fsck
1054 has also been revamped so that it can be called as a library from a
1055 application.
1056
1057 Added new fileio primitives in libext2fs for reading and writing
1058 files on an unmounted ext2 filesystem.  This interface is now used by
1059 debugfs.
1060
1061 Added a new libext2fs function for mapping logical block numbers of
1062 a file to a physical block number.
1063
1064 Added a new libext2fs function, ext2fs_alloc_block(), which allocates
1065 a block, zeros it, and updates the filesystem accounting records
1066 appropriately.
1067
1068 Added a new libext2fs function, ext2fs_set_bitmap_padding(), which
1069 sets the padding of the bitmap to be all one's.  Used by e2fsck pass 5.
1070
1071 The libext2fs functions now use a set of memory allocation wrapper
1072 functions: ext2fs_get_mem, ext2fs_free_mem, and ext2fs_resize_mem,
1073 instead of malloc, free, and resize.  This makes it easier for us to
1074 be ported to strange environments where malloc, et. al. aren't
1075 necessarily available.
1076
1077 Change the libext2fs fucntion to return ext2-specific error codes
1078 (EXT2_DIR_EXISTS and EXT2_DB_NOT_FOUND, for example) instead of using
1079 and depending on the existence of system error codes (such as EEXIST
1080 and ENOENT).
1081
1082 Renamed io.h to ext2_io.h to avoid collision with other OS's header
1083 files.
1084
1085 Add protection against ext2_io.h and ext2fs.h being included multiple
1086 times.
1087
1088 The types used for memory lengths, etc. have been made more portable.
1089 In generla, the code has been made 16-bit safe.  Added Mark
1090 Habersack's contributed DOS disk i/o routines.
1091
1092 Miscellaneous portability fixes, including not depending on char's
1093 being signed.
1094
1095 The io_channel structure has a new element, app_data, which is
1096 initialized by the ext2fs routines to contain a copy of the filesystem
1097 handle.
1098
1099 ext2fs_check_directory()'s callback function may now return the error
1100 EXT2_ET_CALLBACK_NOTHANDLED if it wishes ext2fs_check_directory() to
1101 really do the checking, despite the presence of the callback function.
1102
1103
1104 E2fsprosg 1.11 (June 17, 1997)
1105 ==============================
1106
1107 Fixed e2fsck to detect (previously ignored) conflicts between the
1108 superblock or block group descriptors and block bitmaps, inode
1109 bitmaps, and inode tables.
1110
1111 Fixed bug in e2fsck so that when the message printed out when a block
1112 or inode bitmap conflicts with other data, it has the correct group
1113 number.
1114
1115 Fixed bug in e2fsck and mke2fs where the blocksize wasn't being passed
1116 to badblocks.  This meant that not all of the filesystem was being
1117 tested for bad blocks! 
1118
1119 Fixed an array boundary overrun case which cropped up in
1120 ext2fs_badblocks_list_test when a user tried running "mke2fs -c 
1121 -b 4096".
1122
1123 Adjusted the number of columns printed by mke2fs when displaying the
1124 superblock backups to avoid running over 80 columns when making a
1125 really big filesystem.
1126
1127 Fixed up the man pages for e2fsck, debugfs, badblocks, chattr,
1128 dumpe2fs, fsck, mke2fs, and tune2fs (typos and other minor grammar
1129 fixes), thanks to some suggestions from Bill Hawes (whawes@star.net).
1130
1131 Programmer's notes:
1132 -------------------
1133
1134 Fixed install rule in lib/ss so that ss_err.h is actually getting
1135 installed.
1136
1137 Fixed bug in ext2fs_copy_bitmap; the destination bitmap wasn't getting
1138 bassed back to the caller.
1139
1140 Fixed bug in ext2fs_inode_scan_goto_blockgroup; it had not been
1141 setting the current inode number (which meant this function wasn't
1142 working at all).
1143
1144 Fixed bug in ext2fs_resize_generic_bitmap; it had not be zeroing all
1145 blocks in the bitmap when increasing the size of the bitmap.
1146
1147 Changed the initial number of blocks allocated by ext2fs_init_dblist()
1148 to be more realistic.
1149
1150 Added a new function ext2fs_allocate_group_table, which sets up the
1151 group descriptor information (and allocates inode and block bitmaps,
1152 and inode tables for a particular group).  The function was created by
1153 factoring out code form ext2fs_allocate_tables().
1154
1155 Added a new function ext2fs_move_blocks which takes a bitmap of the
1156 blocks to be moved, and moves them to another location on the
1157 boardboard.
1158
1159 Make the unix_io channel's io_channel_flush implementation calls sync()
1160 to to flush the kernel buffers to disk.
1161
1162 Added a new function ext2fs_dblist_count returns the number of
1163 directory blocks in dblist.
1164
1165
1166 E2fsprogs 1.10 (April 24, 1997)
1167 ===============================
1168
1169 Mke2fs once again defaults to creating revision #0 filesystems, since
1170 people were complaining about breaking compatibility with 1.2 kernels.
1171 Warning messages were added to the mke2fs and tune2fs man pages that
1172 the sparse superblock option isn't supported by most kernels yet (1.2
1173 and 2.0 both don't support parse superblocks.)
1174
1175 Added new flag to mke2fs, -R <raid options>, which allows the user to
1176 tell mke2fs about the RAID configuration of the filesystem.  Currently
1177 the only supported raid option is "stride" which specifies the width
1178 of the RAID stripe.
1179
1180 Fixed bug in e2fsck where pass1b would bomb out if there were any
1181 blocks marked bad in the inode table.
1182
1183 Fixed rare bug in mke2fs where if the user had a very unlucky number
1184 of blocks in a filesystem (probability less than .002) the resulting
1185 filesystem would be corrupt in the last block group.
1186
1187 Fixed bug where if e2fsck tried to allocate a block to fix a
1188 filesystem corruption problem and the filesystem had no free blocks,
1189 ext2fs_new_block() would loop forever.
1190
1191 The configure script now checks explicitly to see if "-static" works,
1192 since that can't be assumed to be true --- RedHat doesn't install
1193 libc-static by default.
1194
1195 Fixed bug in libext2's block iterator functions where under some
1196 cirmcustances, file with holes would cause the bcount parameter to the
1197 callback function to be incorrect.  This bug didn't affect any of
1198 e2fsprogs programs, but it was discovered by Paul Mackerras, the
1199 author of the PPC boot loader.
1200
1201 Removed use of static variables to store the inode cache in libext2fs.
1202 This caused problems if more than one filesystem was accessed via
1203 libext2fs (static variables in libraries are generally a bad idea).
1204 Again, this didn't affect e2fsprogs programs, but it was discovered by
1205 Paul Mackerras.
1206
1207 Fixed minor bugs and version code drift to assure that e2fsprogs 1.10
1208 will compile cleanly with 1.2.13 kernels (even with a.out shared
1209 libraries!)
1210
1211 Programmer's notes:
1212 -------------------
1213
1214 Added new functions to duplicate an ext2 filesystem handle, and its
1215 associated substructure.  New functions: ext2fs_dup_handle(),
1216 ext2fs_copy_dblist(), ext2fs_badblocks_copy(), ext2fs_copy_bitmap().
1217 Other structures, such as the io_channel and the inode_cache, now have
1218 a ref count so that they only get freed when they are no longer used
1219 by any filesystem handle.  (These functions were added as part of the
1220 development effort for an ext2 resizer).
1221
1222 E2fsprogs 1.09 (April 14, 1997)
1223 ===============================
1224
1225 Fixed bug in mke2fs (really in lib/ext2fs/initialize.c) which was
1226 accidentally introduced in the 1.08 release.  The overhead calculation
1227 was accidentally removed, which caused ext2fs_initialize() to not
1228 notice when the filesystem size needed to be adjusted down because
1229 there wasn't enough space in the last block group.
1230
1231 Fixed bug in version parsing library routine; it was always parsing
1232 the library version string, instead of using the passed-in string.
1233
1234 Clarified chattr man page.
1235
1236 E2fsprogs 1.08 (April 10, 1997)
1237 ===============================
1238
1239 E2fsck 1.07 was very slow when checking very large filesystems with a
1240 lot of files that had hard links (i.e., news spools).  This was fixed
1241 by seriously revamping the icount abstraction.  Added a formal test
1242 suite for the icount abstraction.
1243
1244 Debugfs now has a "-l" option to the "ls" command, which lists the
1245 inode number, permissions, owner, group, size, and name of the files
1246 in the directory.
1247
1248 Fix a bug in e2fsck where when a directory had its blocks moved to
1249 another location during the pass 1b processing, the directory block
1250 list wasn't updated, so pass 2 wouldn't check (and correct) the
1251 correct directory block.
1252
1253 E2fsck will now treat inodes which contain blocks which are claimed by
1254 the filesystem metadata by treating them as multiply claimed blocks.
1255 This way, the data in those blocks can be copied to a new block during
1256 the pass 1b--1d processing.
1257
1258 E2fsck will attempt to determine the correct superblock number and
1259 display it in the diagnostic and warning messages if possible.
1260
1261 Add support for a new (incompatible) feature, "sparse_super".  This
1262 feature reduces the number of blocks which contain copies of backup
1263 superblocks and block group descriptors.  (It is only an incompatible
1264 feature because of a bug in ext2_free_blocks.)  mke2fs and tune2fs now
1265 support a new -s option; e2fsck will recognize filesystems built with
1266 this feature turned on.
1267
1268 E2fsck now checks the library to make sure is the correct version,
1269 using new library functions.  (This helps to diagnose incorrectly
1270 installed e2fsprogs distributions.)
1271
1272 Dumpe2fs now prints more information; its now prints the the
1273 filesystem revision number, the filesystem sparse_super feature (if
1274 present), the block ranges for each block group, and the offset from
1275 the beginning of the block group.
1276
1277 Mke2fs now distributes the inode and block bitmap blok so that the
1278 won't be concentrated in one or two disks in RAID/striping setups.
1279 Also, if the user chooses a 2k or 4k block group, mke2fs will try to
1280 choose the largest blocks per group that be chosen.  (For 2k blocks,
1281 you can have up to 16384 blocks/group; for 4k blocks, you can have up
1282 to 32768 blocks/group.)  Previously mke2fs would not allow
1283 specification of more than 8192 blocks per group, even if you were
1284 using a 2k or 4k block group.
1285
1286 Programmer's notes:
1287 -------------------
1288
1289 Added a new function ext2fs_create_icount2() which takes a "hint"
1290 argument.  This hint argument presets the icount array with the list
1291 of inodes which actually need to be in the icount array.  This really
1292 helps to speed up e2fsck.
1293
1294 Added a new function ext2fs_icount_validate() which checks the rep
1295 invariant for the icount structure.  This is used mostly for testing.
1296
1297 The error mesasage given when a bad inode number is passed to
1298 test_generic_bitmap to reflect EXT2FS_TEST_ERROR (instead of
1299 EXT2FS_UNMARK_ERROR).
1300
1301 Added a new function ext2fs_set_dir_block which sets the block of a
1302 dblist entry, given the directory inode and blockcnt.
1303
1304 Added a new function ext2fs_get_library_version() which returns the
1305 current library version, and ext2fs_parse_version_string() which
1306 returns a version number based on a e2fsprogs version string.
1307
1308 The icount functions will return EINVAL if the passed in inode number
1309 is out of bounds.
1310
1311 E2fsprogs 1.07 (March 9, 1997)
1312 ==============================
1313
1314 E2fsck is now uses much less memory when checking really large
1315 filesystems (or rather, filesystems with a large number of inodes).
1316 Previously a filesystem with 1 million inodes required 4 megabytes of
1317 memory to store inode count statistics; that storage requirement has
1318 now been reduced to roughly half a megabyte.
1319
1320 E2fsck can now properly deal with bad blocks appearing inside the
1321 inode table.  Instead of trying to relocate the inode table (which
1322 often failed because there wasn't enough space), the inodes in the bad
1323 block are marked as in use.
1324
1325 E2fsck will automatically try to use the backup superblocks if the
1326 primary superblocks have a bad magic number or have missing meta-data
1327 blocks (or meta-data blocks which are out of range).
1328
1329 E2fsck's pass 3 has been made more efficient; most noticeable on
1330 filesystems with a very large number of directories.
1331
1332 Completely revamped e2fsck's system of printing problem reports.  It
1333 is now table driven, to make them more easily customizeable and
1334 extendable.  Error messages which can be printed out during preen mode
1335 are now one line long.
1336
1337 Fixed e2fsck's filesystem swapping code so that it won't try to swap
1338 fast symbolic links or deleted files.
1339
1340 Fixed e2fsck core dumping when fixing a filesystem which has no
1341 directories (not even a root directory).
1342
1343 Added a check to e2fsck to make sure that the length of every
1344 directory entry is a multiple of 4 (since the kernel complains if it
1345 isn't).
1346
1347 Added a check to e2fsck to make sure that a directory entry isn't a
1348 link to the root directory, since that isn't allowed.
1349
1350 Added a check to e2fsk to now make sure the '.' and '..' directory
1351 entries are null terminated, since the 2.0 kernel requires it.
1352
1353 Added check to write_bitmaps() to make sure the superblock doesn't get
1354 trashed if the inode or block bitmap is marked as being block zero.
1355
1356 Added checking of the new feature set fields in the superblock, to
1357 avoid dealing with new filesystem features that this package wasn't
1358 set up to handle.
1359
1360 Fixed a fencepost error in ext2fs_new_block() which would occasionally
1361 try to allocate a block beyond the end of a filesystem.
1362
1363 When the UUID library picks a random IEEE 802 address (because it
1364 can't find one from a network card), it sets the multicast bit, to
1365 avoid conflicting with a legitimate IEEE 802 address.
1366
1367 Mke2fs now sets the root directory's owner to be the real uid of the
1368 user running mke2fs.  If the real uid is non-zero, it also sets
1369 the group ownership of the root directory to be the real group-id of
1370 the user running mke2fs.
1371
1372 Mke2fs now has more intelligent error checking when it is given a
1373 non-existent device.
1374
1375 When badblocks is given the -vv option, it now updates the block that
1376 it is currently testing on every block.
1377
1378 Fixed a bug in fsck where it wouldn't modify the PATH envirnoment
1379 currently correctly if PATH wasn't already set.
1380
1381 Shared libraries now built with dependencies.  This allows the shared
1382 library files to be used with dlopen(); it also makes the transition
1383 to libc 6 easier, since ld.so can tell which libc a particular shared
1384 library expects to use.
1385
1386 Programmer's notes:
1387 -------------------
1388
1389 Added new abstraction (defined in dblist.c) for maintaining a list of
1390 blocks which belongs to directories.  This is used in e2fsck and other
1391 programs which need to iterate over all directories.
1392
1393 Added new functions which test to see if a contiguous range of blocks
1394 (or inodes) are available.  (ext2fs_*_bitmap_range).
1395
1396 Added new function (ext2_inode_has_valid_blocks) which returns true if
1397 an inode has valid blocks.  (moved from e2fsck code).
1398
1399 Added new function (ext2fs_allocate_tables) which allocates the
1400 meta-data blocks as part of initializing a filesystem.  (moved from
1401 mke2fs code).
1402
1403 Added a new I/O manager for testing purposes.  It will either allow a
1404 program to intercept I/O requests, or print debugging messages to
1405 trace the activity of a program using the I/O manager.
1406
1407 The badblocks_list functions now store the bad blocks in a sorted
1408 order, and use a binary search to speed up badblocks_list_test.
1409
1410 The inode scan function ext2fs_get_next_inode() may now return a soft
1411 error returns: MISSING_INODE_TABLE and BAD_BLOCK_IN_INODE_TABLE in
1412 those cases where part of an inode table is missing or there is a bad
1413 block in the inode table.  
1414
1415 Added a new function (ext2fs_block_iterate2) which adds new arguments to
1416 the callback function to return a pointer (block and offset) to the
1417 reference of the block.
1418
1419 Added new function (ext2fs_inode_scan_goto_blockgroup) which allows an
1420 application to jump to a particular block group while doing an inode
1421 scan.
1422
1423 The badblocks list functions were renamed from badblocks_* to
1424 ext2fs_badblocks_*.  Backwards compatibility functions are available
1425 for now, but programs should be modified to use the new interface.
1426
1427 Some of the library functions were reorganized into separate files to
1428 reduce the size of some programs which statically link against the
1429 ext2 library.
1430
1431 Put in some miscellaneous fixes for the Alpha platform.
1432
1433
1434 E2fsprogs 1.06 (October 7, 1996)
1435 ================================
1436
1437 Fixed serious bug in e2fsck: if the block descriptors are bad, don't
1438 smash the backup copies in ext2fs_close().  (The problem was that when
1439 e2fsck -p discovered the problem, while it was closing the filesystem
1440 and exiting, it was also blowing away the backup superblocks on the
1441 disk, which was less than friendly.)  We now make it the case that we
1442 only write out the backup superblock and the back block descriptors if
1443 the filesystem is completely free from problems.
1444
1445 Fixed a bug in block_interate in the lib/ext2fs library which caused
1446 e2fsck to fail on GNU Hurd-created filesystems.
1447
1448 Add support for Linux/FT's bootloader, which actually uses
1449 EXT2_BOOT_LOADER, and sets its mode bits which caused e2fsck to want
1450 to clear the inode.
1451
1452 Add support for the "A" (no atime update) attribute.  (Note: this
1453 attribute is not yet in production kernels.)
1454
1455 The test suite is not automatically run when doing a "make all" from
1456 the top level directory.  Users should manually run "make check" if
1457 they wish to run the test suite.
1458
1459 Upon a preenhalt(), make the printed message more explicit that
1460 running e2fsck "MANAULLY" means without the -p or -a options.
1461
1462 In e2fsck, if a disconnected inode is zero-length, offer to clear it
1463 instead of offering to connect it to lost+found.
1464
1465 In e2fsck, if a filesystem was just unmounted uncleanly, and needs
1466 e2fsck to be run over it, change e2fsck to explicitly display this
1467 fact.
1468
1469 For dumpe2fs and e2fsck, cause the -V option to print out which
1470 version of the ext2fs library is actually getting used.  (This will
1471 help detect mismatches of using a 1.06 utility with a 1.05 library,
1472 etc.)
1473
1474 Programmers' notes:
1475 -------------------
1476
1477 EXT2_SWAP_BYTES was changed to EXT2_FLAG_SWAP_BYTES, which better fits
1478 the naming convention.
1479
1480 In ext2fs_initialize(), make sure the description for the inode bitmap
1481 is correctly initialize.
1482
1483 Fixed minor type typo in ext2fs_allocate_generic_bitmap();
1484
1485 E2fsprogs 1.05 (September 7, 1996)
1486 ==================================
1487
1488 Add support for new fields in the ext2 superblock --- volume name,
1489 volume UUID, and last mounted field.  Dumpe2fs displays these fields,
1490 tune2fs and mke2fs allows you to set them.  E2fsck will automatically
1491 generate a UUID for those volumes that don't have them.  
1492
1493 Put in support for e2fsck to recognize HURD specific ext2 features ---
1494 most notably, the translator block.  The e2fsprogs tools will now use
1495 the creator_os field in the superblock to correctly handle different
1496 OS-specific variants of the ext2 filesystem.
1497
1498 E2fsck now fixes inodes which have a the deletion time set, but which
1499 have a non-zero i_link_count field by offering to clear the deletion
1500 time.  Previously e2fsck assumed that the inode was deleted (per 0.3c
1501 ext2 kernel behavior) and offered to unlink the file.
1502
1503 If e2fsck sets the clean bit, but nothing else, set the exit code
1504 FSCK_NONDESTRUCT.  After all, e2fsck did fix a filesystem error --- it
1505 set the filesystem valid bit when it was previously cleared.  :-) This
1506 was needed to make the HURD fsck driver happy.
1507
1508 If the  user  refuses to attach an  unattached  inode, e2fsck  will no
1509 longer set the inode's link count.  Otherwise, the  inode would end up
1510 getting marked as unused, which might cause loss of data later.
1511
1512 Make the message issued by e2fsck when the superblock is corrupt less
1513 confusing for users.  It now mentions that another reason for the
1514 "corrupt superblock" message might be that the partition might not be
1515 an ext2 filesystem at all (it might swap, msdos filesystem, ufs, etc.)
1516
1517 Make the libext2 library more robuest so that e2fsck won't coredump on
1518 an illegal superblock where the blocksize is zero.  (f_crashdisk is
1519 the test case).
1520
1521 By default, create filesystems where the default checkinterval is 6
1522 months (180 days).  Linux servers can be robust enough that 20 reboots
1523 can be a long, long time.
1524
1525 Added configure flag --enable-old-bitops, which forces the bitops to
1526 use the old (native) bitmask operations.  By default on the sparc
1527 platform, the standard ext2 bit ordering is now used.
1528
1529 Added a new feature to e2fsck to byte-swap filesystems; this can be
1530 used to convert old m68k filesystems to use the standard byte-order
1531 storage for the superblock, inodes, and directory blocks.  This
1532 function is invoked by using the '-s' option to e2fsck.
1533
1534 Debugfs's "dump" command has been enhanced so that it writes out the
1535 exact size of the file so that the nulls at the end of the file are
1536 eliminated.  The command also accept a new "-p" option which will
1537 attempt preserve to preserve the ownernship, permissions, and
1538 file modification/access times.
1539
1540 Debugfs has two new options, -f and -R.  The -R option allows the user
1541 to execute a single debugfs command from the command line.  The -f
1542 option allows the user to specify a "command file" containing debugfs
1543 commands which will get executed.
1544
1545 Dumpe2fs now pretty prints the check interval, instead of just
1546 printing the check interval as a number of seconds.
1547
1548 Fix bugs in debugfs: the params command when no filesystem is opened
1549 no longer causes a core dump.  It is now possible to unlink a file
1550 when a pathame containing a '/' is specified.
1551
1552 Tune2fs has a new -C option which sets the number of times the
1553 filesystem has been mounted.
1554
1555 Fix the chattr '-v' option so that it actually works.  Chattr was
1556 being buggy about the -v option parsing.
1557
1558 Programmers' notes:
1559 -------------------
1560
1561 The directory lib/uuid contains a set of library routines to generate
1562 DCE compatible UUIDs.  
1563
1564 Extended ext2fs_namei() to handle symbolic links.  Added new function
1565 ext2fs_nami_follow() which will follow last symbolic link in the case
1566 where the pathname points to a sym link.
1567
1568 The ext2fs_block_iterate function will now return the HURD translator
1569 block, if present.  The new flag BLOCK_FLAG_DATA_ONLY will cause the
1570 iterator to return data blocks only.  The ext2fs.h file now defines
1571 constants BLOCK_COUNT_IND, BLOCK_COUNT_DIND, BLOCK_COUNT_TIND, and
1572 BLOCK_COUNT_TRANSLATOR, which are the magic values passed in the block
1573 count field of the iterator callback function.
1574
1575 The test script driver now takes an optional second argument, which is
1576 the test case to be run.  This allows you to run a test case without
1577 needing to run the entire test suite.
1578
1579 On Linux ELF systems, install the .so files in the correct places
1580 (/usr/lib).  The .so files must be stored in the same directory as the
1581 .a files.
1582
1583 Fixed miscellaneous HURD compilation issues with header file being
1584 included in the right order.
1585
1586 Fixed debugfs so that it resets optind to zero, not one, since setting
1587 optind to zero is more correct.
1588
1589
1590 E2fsprogs 1.04 (May 16, 1996)
1591 =============================
1592
1593 First "official" (1.03 was a limited release only) to support building
1594 e2fsprogs under Linux 2.0 kernels (as well as late model 1.3 and 1.99
1595 kernels).
1596
1597 This package includes a RPM specs file, that it can be built using the
1598 RedHat Package Manager.
1599
1600 E2fsck now prints a hint that if there are lots of incorrectly located
1601 inode bitmaps, block bitmaps, and inode table blocks, the user might
1602 want to try using e2fsck -b 8193 first, to see if that fares any
1603 better.
1604
1605 For ext2 filesystem written with the hurd, debugfs will now print out
1606 the translator field when printing an inode structure.
1607
1608 Lots of miscellaneous linking/installation cleanups:
1609
1610   Libraries are now linked using a relative pathname, instead of
1611   relying on -L working correct.  It doesn't, in many cases, including
1612   current versions of GNU ld.  This guarantees that the build tree is
1613   linking with the right libraries, instead of the ones installed in
1614   /usr/lib.
1615
1616   Header files, man pages, and the et/ss shell scripts are now
1617   generated using a custom substitution script, instead of relying on
1618   the configure script.  This prevents needless recompilation of
1619   files; in addition, the custom substitution script is much faster.
1620
1621   e2fsck may now be linked dynamically, by using the
1622   --enable-dynamic-e2fsck flag to configure.  This is not recommended,
1623   since it increases e2fsck's dependence on other files, but some
1624   people need to save disk space, and other critical programs on their
1625   systems were being linked dynamically anyway.
1626
1627   Programs such as fsck which didn't need to be linked against
1628   libext2fs (or mke2fs which didn't need to be linked against libe2p)
1629   only link against libraries they actually need.  Otherwise, those
1630   programs would require the presense of libraries that otherwise
1631   could be removed from a rescuse diskette.
1632
1633   The ss include files are now installed correctly so they can
1634   actually be used by another package.
1635
1636   If the profiling libraries are built, they are now installed on a
1637   "make install-libs".
1638
1639
1640 E2fsprogs 1.03 (March 27, 1996)
1641 ===============================
1642
1643 Change the m68k bit numbering for bitmasks to match the bit numbering
1644 used by all other ext2 implementations.  (This change was requested by
1645 the m68k kernel development team.)
1646
1647 Support (in-development) filesystem format revision which supports
1648 (among other things) dynamically sized inodes.
1649
1650 Fixed a bug in the ext2 library so that an intelligent error is
1651 returned if mke2fs is run with a ridiculously small number of blocks
1652 for a partition.
1653
1654 Fixed a bug in the ext2 library which required that the device be
1655 openable in read/write mode in order to determine its size.  This
1656 caused e2fsck -n to require read/write access when it was not
1657 previously necessary.
1658
1659 Fixed a bug in e2fsck which casued it to occasionally fail the test
1660 suite depending on which version of the floating point library it was
1661 using.
1662
1663 Fixed a bug in e2fsck so that it now halts with a fatal error when
1664 certain superblock consistency checks fail.  Previously it continued
1665 running e2fsck, with some potential confusing/damaging consequences.
1666
1667 Added new flag to fsck which allows the root to be checked in parallel
1668 with other filesytems.  This is not the safest thing in the world to
1669 do, but some system administrators really wanted it.
1670
1671 Fixed -Wall flames in lib/ss.
1672
1673
1674 E2fsprogs 1.02 (January 16, 1996)
1675 =================================
1676
1677 Fix to allow e2fsprogs to be compiled on recent 1.3 (pl45+) kernels.
1678
1679 Change e2fsck to print statistics of how many non-contiguous files are
1680 on the system.  Note that a file which is larger than 8k blocks, it is
1681 guaranteed to be non-contiguous.
1682
1683 In mke2fs, print a warning message if a user tries to format a whole
1684 disk (/dev/hda versus /dev/hda1).  If a user really wants to format a
1685 whole disk, the -F (force) option forces mke2fs to format a whole disk
1686 as a filesytem.
1687
1688 Fix a bug in fsck where in some cases it might start checking
1689 partitions in the next pass before it finishes checking partitions in
1690 the current pass.  This still won't cause two partitions on the same
1691 disk will be checked, so it's rarely a problem in real life.
1692
1693 Patch lsattr so that it won't hang when checking a named pipe.
1694
1695 Minor compilation fixes:
1696         * Fix the order of libraries that were linked in debugfs.
1697         * Allow the sources to be compiled with -ansi turned on.