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