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