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