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