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