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