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