Whamcloud - gitweb
Update release notes, changelog, etc., for e2fsprogs 1.41.1 release
[tools/e2fsprogs.git] / RELEASE-NOTES
1 E2fsprogs 1.41.1 (September 1, 2008)
2 ====================================
3
4 Many people are forgetting to update their mke2fs.conf file, and this
5 causes ext3, ext4, and ext4dev filesystems won't get created with the
6 proper features enabled.  We address this in two ways.  First, mke2fs
7 will issue a warning if there is not definition for an ext3, ext4, or
8 ext4dev filesystem and the user is trying to create such a filesystem
9 type.  Secondly, when installing from a source build, "make install"
10 will provide basic configuration file handling for /etc/mke2fs.conf.
11 If it exists, and does not mention ext4dev, it will be moved aside to
12 /etc/mke2fs.conf.e2fpsrogs-old and the new /etc/mke2fs.conf file will
13 be installed.  If the existing /etc/mke2fs.conf file does mention
14 ext4dev, then "make install" will install official mke2fs.conf file as
15 /etc/mke2fs.conf.e2fsprogs-new and issue a message to the user that
16 they should look to see if any changes need to be merged.
17
18 The mke2fs program will now create the journal in the middle of the
19 filesystem, since this minimizes seek times on average for fsync-heavy
20 workloads.  In addition, mke2fs will now create journals using extents
21 for filesystems that support them.  This results in a more efficient
22 encoding for the journal since it eliminates the need for using
23 indirect blocks.
24
25 The mke2fs program will avoid allocating an extra block to the
26 journal.  (Addresses Sourceforge Bug: #1483791)
27
28 Mke2fs will correctly enforce the prohibition against features
29 (specifically read-only features) in revision 0 filesystems.  (Thanks
30 to Benno Schulenberg for noticing this problem.)
31
32 Mke2fs previously would occasionaly create some slightly non-optimally
33 placed inode tables; this bug has been fixed.
34
35 The mke2fs and tune2fs programs now print the correct usage message
36 describing the maximum journal size.  (Addresses Debian Bug: #491620)
37
38 Add support for setting the default hash algorithm used in b-tree
39 directories in tune2fs (from a command-line option) or mke2fs (via
40 mke2fs.conf).  In addition, change the default hash algorithm to
41 half_md4, since it is faster and better.
42
43 The blkid library will now recognize MacOS hfsx filesystems, and
44 correctly extract the label and uuid for hfs, hfsx, and hfsplus
45 filesystems.  (Addresses Sourceforge Feature Requests: #2060292)
46
47 The blkid library has improved detection of JFS and HPFS filesystems.
48 (Addresses Launchpad Bug: #255255)
49
50 The blkid library is now much more efficiently handling devicemapper
51 devices, mainly by no longer using the devicemapper library.  This can
52 speed up access for systems with a large number of device mapper
53 devices.
54
55 Blkid had a number of cache validation bugs in libblkid that have been
56 fixed.   (Addresses Debian Bug: #493216)
57
58 Resize2fs will now properly close out the "updating inode references"
59 progress bar so there is a newline printed before printing the final
60 "resize is successful" message.
61
62 Resize2fs will now correctly handle filesystems with extents and/o
63 uninitialized block groups correctly when file/directory blocks need
64 to relocated (i.e., when shrinking a filesystem or if the resize_inode
65 is not present).  To support this, the ext2fs library now supports
66 initializing inode and block bitmaps that are not yet initialized when
67 allocating them using ext2fs_new_block() and ext2fs_new_inode().  In
68 addition, e2fs_block_iterate2() can now support changing the location
69 of interior nodes of an extent tree, and ext2fs_extent_set_bmap() has
70 been optimized to avoid creating unnecessary new extents when updating
71 the location of blocks in the extent tree.  This will also help out
72 e2fsck's recovery of obscurely corrupted filesystems with extents,
73 when blocks are claimed by multiple inodes.
74
75 Add support for on-line resizing ext4 filesystem with the flex_bg
76 filesystem feature.  The method for doing so is not optimal, but to do
77 a better job will require kernel support.
78
79 E2fsprogs 1.41.0 intrduced a bug in libext2fs which casued e2image and
80 debugfs programs to not be able to read e2image files; the signed
81 vs. unsigned bug in the code which read bitmaps from the e2image has
82 been fixed.   (Addresses Debian Bug: #495830)
83
84 Resize2fs is now correctly managing the directory in-use counts when
85 shrinking filesystems and directory inodes needed to be moved from one
86 block group to another.  This bug has been around since e2fsprogs
87 1.26, and is largely harmless, but does cause a filesystem corruption
88 which will be flagged by e2fsck after the filesystem has been shrunk.
89  
90 E2fsck will no longer issue spurious complaints about the inode size
91 caused by very large extent-based files, and by blocks reallocated
92 using fallocate() with the FALLOC_FL_KEEP_SIZE option.  (Addresses
93 Kernel Bugzilla: #11341)
94
95 Mke2fs will now set the creation timestamp on the lost+found directory
96 and the root directory.  (More generally, all new inodes created using
97 the ext2fs library will correctly set the creation timestamp.)
98
99 E2fsck now correctly calculates ind/dind/tind statistics in the
100 presence of extent-based files.  In addition, "e2fsck -v" will report
101 statistics of the depth of extent trees in the filesystem.  E2fsck can
102 also give an inode fragmentation report using "e2fsck -E fragcheck"
103 which can be useful when debugging the kernel block allocation
104 routines.
105
106 Fix support for empty directory blocks in ext4 filesystems with 64k
107 blocksize filesystems.
108
109 E2fsck will now print the depth of corrupt htree directories.
110
111 Debugfs's htree command now correctly understands extent-based
112 directories.  It will also print out the minor hash as well as the
113 major hash.
114
115 Debugfs has a new command which will print the supported features of
116 e2fsprogs, to enable scripts to know whether the installed version of
117 e2fsprogs can support a specific feature.
118
119 Debugfs will now write files using extents for filesystems that
120 support them.
121
122 The error message printed by "tune2fs -I" if the inode size was too
123 small was rather confusing, so it has been improved.  Also, we won't
124 try to create an undo log until we know that command-line-specified
125 parameters such as "tune2fs -I <inode size>" are valid.
126
127 Given some filesystems found "in the wild" that had non-zero block
128 group checksums even though the uninit_bg/gdt_sum feature was not
129 enabled, e2fsck would issue spurious error messages.  Teach
130 ext2fs_group_desc_csum_verify() to ignore the block group checksum
131 entirely if the feature flag is not set.  (Addresses Debian Bug:
132 #490637)
133
134 The blkid program will now print out a user-friendly listing of all of
135 the block devices in the system and what they contain when given the
136 -L option.  (Addresses Debian Bug: #490527)
137
138 The filefrag program now has a more accurate calculation for the
139 number of ideal extents.  (Addresses Debian Bug: #458306)
140
141 The test I/O manager is now enabled by default, but its overhead is
142 only incurred when it would be enabled via the TEST_IO_FLAGS or
143 TEST_IO_BLOCK environment variables.
144
145 Typographical errors in various program strings and usage messages
146 have been fixed; most of these were pointed out by the e2fsprogs
147 message catalog translators.  (Thanks, translators!)
148
149 Update and clarified various man pages, as well as some typographical
150 errors in the libext2fs texinfo file.
151
152 Fixed various Debian packaging issues --- see debian/changelog for
153 details.
154
155 Add Indonesian and update French, Polish, Dutch, German, Sweedish,
156 Czech, and Vietnamese Translations.  (Addresses Debian Bugs: #313697,
157 #401092)
158
159 Programmer's Notes
160 ------------------
161
162 Fix portability problem with the badblocks group; for systems that
163 don't have nanosleep(), try using usleep() instead.
164
165 The "make check" target in the e2fsck directory now sets
166 LD_LIBRARY_PATH before running the various e2fsck internal library
167 regression tests.
168
169 The crc32 regression test in the e2fsck library is now portable to
170 greater varienty of environments, including big-endian systems and
171 when cross-building e2fsprogs for embedded systems.  (Addresses
172 Sourceforge Bug: #2019287)
173
174 The ext2fs_extent_set_bmap() had some bugs when setting the first
175 block in a file, or when replacing a single block extent.  Those cases
176 fortunately were came up relatively rarely when e2fsck was checking
177 files, but caused some problems when resize2fs was shrinking
178 extent-based files.
179
180 Fix a potential core-dumping bug in libe2p's iterate_on_dir()
181 function.
182
183 Various ext2fs library functions --- ext2fs_block_iterate2(),
184 ext2fs_initialize() and ext2fs_extent_open() --- now correctly free
185 allocated memory to avoid memory leaks in all of their error return
186 paths.
187
188 Ext2ed was failing to build because masix support had been removed in
189 the rest of e2fsprogs, so ext2ed no longer has masix support, either.
190
191 The configure script now respects the LDFLAGS environment variable if
192 it is set when configure is called.  (Addresses Sourceforge Feature
193 Request: #1937287)
194
195 Libuuid is now more portable to the Windows platform.  (Addresses
196 Sourceforge Feature Request: #1937287)
197
198 The configure script now uses AC_MSG_{RESULT,WARN,ERROR} instead of
199 bare echo commands so that configure flags such as --quiet work
200 correctly.  (Addresses Sourceforge Patches: #2058794)
201
202 A few uses of sprintf have been removed from the ext2fs library to
203 make life easier for bootloaders with a limited libc environment.
204 (Addresses Sourceforge Bug: #2049120)
205
206 The ext2fs_read_inode() checks the validity of the inode number passed
207 to it earlier, to avoid doing some needless work when it would fail
208 anyway.
209
210 The ext2fs_open() checks the validity of the blocksize parameter
211 passed to it earlier, to avoid doing some needless work when it would
212 fail anyway.
213
214 Disable a very annoying automatic "%.sh -> %" GNU make rule in the
215 top-level Makefile.  That automatic rule is used to better support
216 SCCS, but it caused problems for a particular niche distribution which
217 likes to use configure.sh files to store the configure options used to
218 build a package.  Unfortuntaely GNU make will use the configure.sh to
219 replace the configure script, resulting in a self-inflicted fork bomb
220 leading to an out-of-memory crash.
221
222 To support old GNU C compilers don't use C99/C++ comments, but only
223 K&R style comments, and don't try to use __builtin_expect if __GNUC__
224 is less than 3.  (__builtin_expect is only supported for gcc versions
225 2.96 and up, and it's tricky to check for gcc 2.95 vs gcc 2.96; since
226 this is an optimization, we only try to use __builtin_expect for gcc 3
227 and up.)
228
229 In e2fsck's crc routines, make sure we use WORDS_BIGENDIAN instead of
230 __LITTLE_ENDIAN, which are only defined by glibc's header files and
231 hence isn't portable.
232
233 For the convenience for some distributions that need a static tune2fs,
234 the Makefile for misc/ now has a tune2fs.static target.
235
236 The ext2fs_block_iterate2() function now supports BLOCK_FLAG_APPEND
237 for extent-based files
238
239 The ext2fs_bmap() function now supports BMAP_ALLOC for extent-based
240 files.
241
242 All source files no longer have any trailing white space.
243
244 The io_channel_read_blk64() and io_channel_write_blk64() functions are
245 now functions instead of C preprocessor macros to provide better
246 forward compatibility.
247
248 The e2fpsrogs translation template now expands the @x abbrevation.
249
250 Various namespace leackages in libblkid, libe2p, and libext2fs have
251 been fixed.
252
253 Fix a parallel build problem in e2fsprogs.
254
255 E2fsprogs is now more portable to Solaris.
256   * blkid no longer assumes that the TIOCGSIZE and TIOCGWINSZ ioctl's
257     are always present.
258   * Scripts do not assume that /bin/true is always in /bin
259   * Don't use __FUNCTION__ since Solaris's C99 doesn't support it.
260   * Flush stdio handles before calling setbuf(), since Solaris will
261     discard any pending output to the stream.
262   * Define _XOPEN_SOURCE to 600 since Solaris's header files are very
263     picky about which C compiler can beused for SUSv3 conformance.
264     Use of C99 is not compatible with SUSv2 (_XOPEN_SOURCE=500),
265     and C89 is not compatible with SUSv3 (_XOPEN_SOURCE=600).
266     Since we need some SUSv3 functions, consistently use SUSv3 so
267     that e2fsprogs will build on Solaris using c99.
268   * Solaris C99 does not support varargs C preprocessor macros
269   * Solaris header files pollute the C namespace if in/netinet.h
270     is included, which conflicts with e2fsprogs' use of the kmem_cache_t
271     typedef.
272   * Solaris ships with a pathetically ancient shell in /bin/sh so we
273     avoid the use of various more avanced shell constructs such as $().
274
275 The "make rpm" command will now take some extra configure optiosn from
276 the build environment without needing to patch the source tree.
277
278 The ext2fs_add_dir_block() function will now grow the dblist more
279 aggressively as an optimization to avoid copying the array too often.
280
281 The e2fsck_write_bitmaps() will write the block and inode bitmaps
282 together instead of in two passes.
283
284
285 E2fsprogs 1.41 (July 10, 2008)
286 ==============================
287
288 Add support for ext4 filesystem features, in particular extents,
289 uninit_bg, flex_bg, huge_file, and dir_nlink features.  Also add
290 support for checking journal checksums.  Debugfs will print new
291 superblock and inode fields that were defined for ext4.  For example,
292 the nanosecond and i_version fields of an inode, and the
293 s_min_extra_isize and s_wanted_extra_isize fields from the superblock.
294 Note: Resize2fs doesn't currently support the combination of flex_bg
295 and !resize_inode.  (Addresses Debian Bug: #388452, #425477)
296
297 Tune2fs can support migrating a filesystem from using 128 byte inodes
298 to 256 byte inodes, so it can take advantage of the full features of
299 ext4.
300
301 Add support for "undo" support.  E2fsck and mke2fs can optionally
302 record an undo log which can replayed by the program e2undo.
303
304 E2fsck could damage a filesystem by trying to relocate inode tables
305 due to corrupted block group descriptors, where the attempted inode
306 table relocation would do far more harm than good.  E2fsck has been
307 fixed to detect this these sorts of corrupted block group descriptors
308 much earlier in e2fsck processing, so it can try to use the backup
309 superblock and block group descriptors first.  This should be a much
310 better strategy for recovering these types of corrupted filesystems.
311 (Addresses Sourceforge Bug: #1840291)
312
313 E2fsck will display a more understandable message when the last check
314 field in the superblock is in the future.  (Addresses Debian Bug:
315 #446005).
316
317 E2fsck now performs more extensive and careful checks of extended
318 attributes stored in the inode.
319
320 Enhance mke2fs to print a more explanatory error message when
321 ext2fs_get_device_size() returns EFBIG.  (Addresses Debian Bug:
322 #488663)
323
324 Fix mke2fs to use a default block size of 4k when formatting an
325 external journal device.  This is done by using a fixed filesystem
326 type list that consists only of the single filesystem type "journal"
327 when looking up configuration keys in /etc/mke2fs.conf.  (Addresses
328 Debian Bug: #488663)
329
330 Speed up how mke2fs writes the journal data blocks by writing the disk
331 blocks in larger chunks.
332
333 Fix blkid handling of stale devices.  Fix a bug which could cause a
334 core dump while garbage collecting the blkid cache, and assure that
335 blkid_find_dev_with_tag() never returns a non-existent device.  Also,
336 if a filesystem is found at a new /dev location, eliminate any
337 duplicate stale entries which can not be verified.
338 (Addresses-Debian-Bugs: #487758, #487783)
339     
340 Add more paranoid checks for LVM volumes and swap partitions in
341 blkid's probe function, to reduce the chances of false positives.
342
343 The mke2fs program now has a much more sophisticated system for
344 controlling configuration parameters of a newly created filesystem
345 based on a split filesystem and usage type system.  The -t option to
346 mke2fs was a deprecated alias to -c; it now specifies a filesystem
347 type (ext2, ext3, ext4, etc.), while the -T option can now be a comma
348 separated usage list.  The filesystem type information and type
349 information is used to extract configuration parameters from the
350 /etc/mke2fs.conf file.
351
352 The mke2fs program will no longer complain and request the -f option
353 when the user tries to create a filesystem with greater than 2**31
354 blocks.
355
356 When creating a filesystem for the GNU Hurd use a fs-type of Hurd and
357 adjust the mke2fs.conf file so filesystems for the Hurd are created
358 with a blocksize of 4096 and inode size of 128, which is all it knows
359 how to handle.  (Addresses Debian Bug: #471977)
360     
361 Mke2fs will always make sure that lost+found always has at least 2
362 blocks, even for filesystems with very large blocksizes (i.e., 64kb).
363
364 Resize2fs will now print the minimum needed filesystem size if given
365 the -P option, and will resize the filesystem to the smallest possible
366 size if given the -M option.
367
368 Fix resize2fs to clean up the resize_inode if all of the reserved gdt
369 blocks are consumed during an off-line resize.
370
371 The "ls" command in debugfs now supports the -p option, which causes
372 it to quote the filenames so that spaces or tabs in directory entries
373 are easily visible.  (Addresses Red Hat Bugzilla: #149480; Addresses
374 Sourceforge Feature Request: #1201667)
375
376 Fix a potential off-by-one buffer oveflow in the fs_device_name in an
377 e2image file.
378
379 The chattr program will return a non-zero exit code in case of
380 failures, and error messages can be suppressed with the -f option.
381 (Addresses Red Hat Bugzilla: #180596)
382
383 Fix a bug in badblocks which caused it to overrun an array and likely
384 crash if more than 8 test patterns are specified using the -t option.
385 (Addresses Debian Bug: #487298)
386     
387 Add support to badblocks to limit how quickly it reads from the disk
388 drive (so it can be used for background scrubbing), and so it will
389 abort after finding a given number of errors.
390
391 Remove support for the legacy big-endian filesystem format which only
392 existed on extremely long-dead PowerPC kernels almost a decade ago.
393
394 Remove MASIX support from e2fsprogs.
395
396 Add I/O statistics reporting to e2fsck.
397
398 Update Vietnamese, Polish, French, Spanish, German, Catalan, Dutch,
399 Czech translations.
400
401 Fixed various Debian packaging issues --- see debian/changelog for
402 details.  (Addresses Debian Bugs: #487443, #487675, #490003)
403
404 Fixed spelling mistakes, typos, and otherwise clarified man pages.
405 (Addresses Debian Bugs: #393313, #487849, #440983, #440981)
406
407 Programmer's Notes
408 ------------------
409
410 Factor out bitmap code in preparation for adding 64-bit new-style
411 bitmaps.
412
413 Fix gcc -Wall warnings
414
415 Fix the pkg-config files so that private librares are specified in
416 "Libs.private:".
417
418 Fix the libext2fs.texinfo manual so it builds with modern versions of
419 texinfo.
420
421 Silence the makefile from showing the awk command used to build the
422
423 Clean up the badblocks group so to make it more portable and robust.
424
425 Avoid using predictable filenames in /tmp in blkid's regression test
426 suite.  Also remove bashism's in the regression test script.
427
428 If the configure script is given --with-diet-libc, don't use thread
429 local storage, since diet libc doesn't support TLS.  (Addresses
430 Sourceforge Bug: #2000654)
431     
432 Fix the blkid regression test suite to tolerate older versions of
433 mkswap that don't support the -U option.
434
435 A few library routines have been converted to support 64-bit block
436 numbers; in particular, the I/O manager functions, the test_io,
437 inode_io, and unix_io managers have all be converted to support 64-bit
438 operation.
439
440 Debugfs can now be extended for use by test programs.  See
441 lib/ext2fs/extents.c for an example for how it can be used.  The test
442 program links against the debugfs object files, and provides
443 additional commands by defining an auxiliary libss command table.
444
445 The lazy_bg filesystem feature, which was only used by developer's
446 testing, has been removed since it has been largely supplanted by
447 uninit_bg.  This also simplifies the code.
448
449
450 E2fsprogs 1.40.11 (June 17, 2008)
451 =================================
452
453 Mke2fs, tune2fs, and resize2fs now use floating point to calculate the
454 percentage of reserved blocks.  (Addresses Debian Bug: #452639)
455
456 Updated Spanish and Catalan translations.
457
458 Fixed various Debian packaging issues --- see debian/changelog for
459 details.  (Addresses Debian Bugs: #483962, #483023)
460
461 Add detection for ZFS volumes to the libblkid library.
462
463 Fixed spelling mistakes, typos, and otherwise clarified man pages.
464 (Addresses Debian Bug: #486463)
465
466 Programmer's notes:
467 -------------------
468
469 Fix marginal C code in probe_lvm2() function to the blkid library more
470 portable for older compilers.
471
472 Fix build problems on MacOS X.  (Addresses Sourceforge Bug: #1972473)
473
474 Fix ext2fs_swap{16,32,64} functions so they can be used by external
475 applications on big-endian machines.  (Addresses Debian Bug: #484879)
476     
477
478 E2fsprogs 1.40.10 (May 21, 2008)
479 ================================
480
481 When deciding whether or not to revalidate a blkid cache entry, if the
482 device's mtime is newer than the last time the cached entry was
483 validated, force a revalidation.
484
485 Fix a potential data corruption bug in e2fsck in the journal replay.
486 The chances of this is happening is extremely remote, especially the
487 default data=ordered or data=writeback modes.  However, if a block
488 which has been journalled starts with the first four bytes 0xc03b3998,
489 when e2fsck replays the journal, those four bytes will be replaced
490 with zero's.  Fortunately, it is highly, highly unlikely for e2fsck
491 metadata to begin with those fatal 4 byte sequence, and unless
492 data=ordered mode is in use, data blocks are never journaled.
493
494 Updated German, Dutch, Sweedish, and Vietnamese translations.
495
496 Programmer's notes:
497 -------------------
498
499 Fixed various Debian packaging issues --- see debian/changelog for
500 details.
501
502 Remove default sizes of types when cross compiling, since autoconf
503 2.50 can figure this out automatically now.
504
505
506 E2fsprogs 1.40.9 (April 27, 2008)
507 =================================
508
509 SuSE's security team audited uuidd and came up with a few minor
510 issues.  None of them are serious given that uuidd runs setuid as a
511 unprivileged user which has no special access other than libuuid
512 directory, but it's good to get them fixed.
513
514 One additional fix in ext2fs_swap_inode_full() needed for resize2fs to
515 work correctly with in-inode extended attributes.
516
517 Updated German, Czech, Dutch, French, Polish, Sweedish, and Vietnamese
518 translations.
519
520 Debugfs will avoid using a pager if the standard output is not a tty.
521
522 Fix debugfs and tune2fs to correctly handle daylight savings time when
523 parsing a time string.
524
525 Fixed spelling mistakes, typos, and otherwise clarified man pages.
526
527 Fix fsck completion bars when multiple filesystems were being checked
528 in parallel.  (Addresses Debian Bug: #432865, Addresses Launchpad Bug:
529 #203323, Addresses Sourceforge Bug: #1926023)
530
531 Fix fsck so that progress information is sent back correctly when
532 multiple filesystems are being check and the output of fsck is being
533 redirected to a file descriptor.  Also, include the device name (w/o
534 spaces) in the progress information sent back via a file descriptor.
535 (Addresses Launchpad Bug: #203323, Addresses Sourceforge Bug:
536 #1926023)
537
538 Teach fsck to treat "ext4" and "ext4dev" as ext* filesystems.
539
540 If logsave receives a SIGTERM or SIGINT signal, it will now pass that
541 signal to its child process.
542
543 Fix mke2fs's creation of are resize inode when there is a non-standard
544 s_first_data_block setting.
545
546 Fix bug in blkid when run by an unprivileged user; most devices were
547 not reported correctly.  9Addresses Launchpad Bug: #220275)
548
549 Mke2fs will not allow the logically incorect combination of
550 resize_inode and meta_bg, which had previously caused mke2fs to create
551 a corrupt fileystem.
552
553 Fix fsck in German locales so that a 'j' means yes.
554 (Addresses Sourceforge Bug: #1947683)
555
556
557 Programmer's notes:
558 -------------------
559
560 Fixed various Debian packaging issues --- see debian/changelog for
561 details.
562
563 Update valgrind options in test_script to work with valgrind 3.2.3
564
565 Update texinfo.tex to a much newer version from the FSF.
566
567 Remove bashism for configure script and from the lib/ss Makefile.
568 Addresses Sourceforge Bug: 1921969
569
570 Fix some silently broken tests: m_no_opt, m_meta_bg, and m_raid_opt.
571
572 Fix build system so that if texinfo is not installed, it won't print a
573 (harmless) error message.
574
575
576 E2fsprogs 1.40.8 (March 13, 2008)
577 =================================
578
579 Fixed e2image -I so it works on image files which are larger than 2GB.
580
581 Fixed e2fsck's handling of directory inodes with a corrupt size field.  If
582 the size is larger than the number of blocks found in the inode, don't
583 try to allocate extra empty blocks at the end of the directory to make
584 up the difference; there's no point to doing that.  In addition, if
585 the size is not a multiple of a blocksize, always fix it.
586
587 E2fsck handled a pass 2 "should never happen error" by not giving
588 enough information and then core dumping.  Unfortunately, it was all
589 too easy to trigger the "should never happen" situation if a
590 directory's inode size was not correct.  This has been fixed, but
591 e2fsck has also been taught how to handle this situation more
592 gracefully, by simply removing the inode hash tree information, so
593 that it can be rebuilt again after e2fsck's pass 3.  (Addresses
594 Launchpad Bug: #129395)
595
596 Resize2fs had a bug resizing large inodes with extended attributes
597 that was fixed in 1.40.6; unfortunately, it turned out it wasn't fixed
598 completely on big-endian systems such as PowerPC.  The bug should be
599 completely fixed now.  Yay for regression test suites.  (Addresses Red
600 Hat Bugzilla: #434893)
601     
602 Updated German, Czech, Dutch, Polish, Sweedish, and Vietnamese
603 translations.  Many thanks to Philipp Thomas from Novell for stepping
604 up to become the new German translation maintainer!  (Addresses Debian
605 Bugs: #302512, #370247, #401092, #412882).
606
607 When e2fsck is clearing a corrupt inode's HTREE directory information,
608 make it clear that it is just clearing the HTREE information, not the
609 entire inode.
610
611 Fixed spelling mistakes, typos, and otherwise clarified man pages.  
612
613 Programmer's notes
614 ------------------
615
616 Add new functions, ext2fs_dblist_get_last() and
617 ext2fs_dblist_drop_last(), which allows the caller to examine the last
618 directory block entry added to the list, and to drop if it necessary.
619
620 Fixed a portability problem in libblkid with DJGPP.
621
622 Fix an obvious typo in an "internal error" message in e2fsck.  Thanks
623 to Philipp Thomas for pointing this out.
624
625 If the info files are not built, change "make install" so it doesn't
626 fail with an error code.
627
628
629 E2fsprogs 1.40.7 (February 28, 2008)
630 ====================================
631
632 Remove support for clearing the SPARSE_SUPER feature from tune2fs, and
633 depreciate the -s option, since it can result in filesystems which
634 e2fsck can't fix easily.  There are very good reasons for wanting to
635 disable sparse_super; users who wants to turn off sparse_super can use
636 debugfs.  (Addresses Sourceforge Bug: #1840286)
637     
638 Add missing options to mke2fs's usage message.  (Addresses Sourceforge
639 Bug: #1751393)
640     
641 Fix bug in resize2fs when large (greater than 128 byte) inodes are
642 moved when a filesystem is shrunk; it was only moving the first 128
643 bytes, so extended attributes were not getting moved.  (Addresses Red
644 Hat Bugzilla: #434893)
645
646 E2fsck now prints an explicit message when the bad block inode is
647 updated, to avoid confusion about why the filesystem was modified.
648 (Addresses Sourceforge Bug: #756460)
649     
650 Allow mke2fs and tune2fs manipulate the large_file feature.
651 Previously we just let the kernel and e2fsck do this automatically,
652 but e2fsck will no longer automatically clear the large_file feature.
653 It still isn't really necessary to worry about this feature flag
654 explicitly, but some users seem to care.  (Addresses Red Hat Bugzilla:
655 #258381)
656     
657 Suppress message about an old-style fstab if the fstab file is empty.
658 (Addresses Debian Bug: #468176)
659     
660 Fix (really minor) bug in debugfs's find_free_block so it avoids
661 reporting a free block more than once if there are too few free blocks
662 in the filesystem.  (Addresses Sourceforge Bug: #1096315)
663     
664 Change e2fsck to no longer clear the LARGE_FILES feature flag
665 automatically, when there are no more > 2GB files in the filesystem.
666 It's been almost a decade since there have been kernels that don't
667 support this flag, and e2fsck clears it quietly without telling the
668 user why the filesystem has been changed.
669     
670 Fix bug which could cause libblkid to seg fault if a device mapper
671 volume disappears while it is being probed.  (Addresses RedHat
672 Bugzilla: #433857)
673     
674 Inhance e2fsck's reporting of unsupported filesystem feature flags.
675 (Addresses Sourceforge Feature Request: #1175808)
676     
677 Fix option syntax in dumpe2fs for explicit superblock and blocksize
678 parameters.  What was currently documented in the man page has been
679 broken for some time, due to getopt() implementation changes.  The
680 option sytax has been changed to one which is can be more portable
681 supported and which is consistent with the format for extended options
682 in mke2fs and tune2fs.  (Addresses Sourceforge Bug: #1830994)
683     
684 Add support to tune2fs to clear the resize_inode feature.  This
685 requires an fsck afterwards.  (Addresses Red Hat Bugzilla: #167816)
686
687 Teach blkid to detect LVM2 physical volumes.  (Addresses Red Hat
688 Bugzilla: #409321)
689
690 Add support for setting RAID stride and stripe-width via mke2fs and
691 tune2fs.  Teach dumpe2fs to print the RAID parameters.
692
693 Add support for setting new superblock fields to debugfs's
694 set_super_value.
695
696 Add support for printing "mostly-printable" extended attributes in
697 Debugfs.
698
699 Add support for the -M option to fsck, which causes it to ignore
700 mounted filesystem.
701
702 Fix uuidd so that it creates the pid file with the correct pid number.
703 (Addresses Sourceforge Bug: #1893244)
704
705 Fix various gcc -Wall warnings.
706
707 Update Czech, Dutch, Polish, Sweedish, and Vietnamese translations
708
709 Fixed spelling mistakes, typos, and otherwise clarified man pages.  
710 (Addresses Sourceforge Patch: #1399325)
711
712
713 Programmer's notes:
714 -------------------
715
716 Fixed various Debian packaging issues --- see debian/changelog for
717 details.  (Addresses Debian Bug: #466929)
718
719 Add new flag EXT2_FLAG_NONFREE_ON_ERROR ext2fs_open2() which returns a
720 partially filled-in filesystem object on an error, so that e2fsck can
721 print more intelligent error messages.
722     
723 Add a new function e2p_edit_feature2() which allows the caller to
724 specify which feature flags are OK to set or clear, and which returns
725 more specific information about feature flags which are not allowed to
726 be set/cleared.
727     
728 Set the C locale in the test_script driver since it uses [A-Za-z].
729 (Addresses Sourceforge Bug: #1890526)
730
731 Use fcntl locking instead of lockf in libuuid since Cygwin doesn't
732 support lockf().
733
734 Change configure.in to avoid using the 'dc' command unless it is
735 absolutely needed. (i.e., when using parsing a WIP-style version
736 number)  (Addresses Sourceforge Bug: #1893024)
737
738 Add portability checks to support compilation under DJGPP.
739
740 Update to the latest samba tdb code before the LGPLv3 change, which
741 fixes a realloc() leak on failure.
742
743 Fix memory leak in ext2fs_alloc_block().
744
745 Fix makefile dependency issues for various install targets.
746 (Addresses-Sourceforge-Patches: #1903484, #1903466, #1903456)
747     
748 Improve descriptions for the r_move_itable and r_resize_inode tests.
749
750
751 E2fsprogs 1.40.6 (February 9, 2008)
752 ===================================
753
754 Add support for returning labels for UDF filesystems in the blkid
755 library.
756
757 Fix bug in the blkid library where cached filesystems was not being
758 flushed when opening USB devices returned the error ENOMEDIUM.
759 (Addresses Debian Bug: #463787)
760
761 Added logic to the blkid library to automatically choose whether a
762 filesystem should be mounted as ext4 or ext4dev, as appropriate.
763
764 Allow tune2fs to set and clear the test_fs flag on ext4 filesystems.
765
766 Fix a bug in e2fsck which caused it to core dump if e2fsprogs had been
767 configured with --enable-jbd-debug.
768
769 Document the BLKID_FILE environment variable in the libblkid man page
770
771 Programmer's Notes:
772 -------------------
773
774 Update e2fsprogs translation template and Vietnamese and Czech translations
775
776 Fixed various Debian packaging issues --- see debian/changelog for
777 details.  (Addresses Debian Bugs: #436058)
778
779 Don't try to create $DESTDIR/etc/init.d as part of make install as we
780 don't install the init.d script (and it's not the recommended way to
781 start uuidd anyway).  (Addresses Sourceforge Bug: #1885085)
782
783 Use thread local storage to fix a theoretical race condition if two
784 threads try to format an unknown error code at the same time in the
785 com_err library.
786
787
788 E2fsprogs 1.40.5 (January 27, 2008)
789 ===================================
790
791 Fix a potential overflow big in e2image if the device name is too
792 long.
793
794 Mke2fs will now create new filesystems with 256 byte inodes and the
795 ext_attr feature flag by default.  This allows for much better future
796 compatibity with ext4 and speeds up extended attributes even on ext3
797 filesystems.
798
799 Teach e2fsck to ignore certain "safe" filesystem features which are
800 set automatically by the kernel.  Having the kernel set features
801 automagically behind the user's back is a bad idea, and we should try
802 to break the kernel of this habit, especially for the newer ext4
803 feature flags.  But for now, we will try to avoid needless full checks
804 which can annoy users who are doing fresh installs.
805
806 Add support in tune2fs and mke2fs for making a filesystem as being "ok
807 to be used with test kernel code".  This will be needed for using test
808 filesystems with the latest ext4 kernel code.
809
810 Change e2fsck -fD so that it sorts non-htree directories by inode
811 numbers instead of by name, since that optimizes performances much
812 more significantly.  (Addresses-Sourceforge-Feature-Request: #532439)
813
814 If e2image fills the disk, fix it so it exits right away instead of
815 spewing large numbers of error messages.
816 (Addresses-Sourceforge-Feature-Request: #606508)
817
818 If ftruncate64() is not available for resize2fs, let it use ftrucate()
819 instead, but have it check to see if the size would get truncated, and
820 skip calling ftruncate in that case.
821
822 Add support for detecting HFS+ filesystems in the blkid library.
823
824 Add supprt in the blkid library for ext4/ext4dev filesystems.
825
826 Fix a bug in blkid where it could die on a floating point exception
827 when presented with a corrupt reiserfs image.
828
829 Fix blkid's handling of ntfs UUID's so that leading zeros are printed
830 such that UUID string is a fixed length.
831
832 Add sample python bindings for the uuid library to the contrib
833 directory.  (Addresses-Sourceforge-Patches: #778817)
834
835 Fix debugfs's 'lsdel' command so it uses ext2fs_block_iterate2 so it
836 will work with large files.  (Addresses Sourceforge Feature Request:
837 #1257500 and Sourceforge Support Request: #1253511)
838     
839 Allow the debugfs 'undel' command to undelete an inode without linking
840 it to a specific destination directory, since this might require
841 allocating blocks that could overwrite some yet-to-be-recovered
842 deleted files.  (Addresses-Sourceforge-Feature-Request: #967141)
843
844 Update Swedish translations from the Translation Project.
845
846 Programmer's Notes:
847 -------------------
848
849 Fix configure handling of --sbindir (which should rarely be used, but
850 someone did complain, so let's fix it).  (Addresses Sourceforge Bug:
851 #498381)
852
853 Updated e2fsprogs.spec file to include a new uuidd package
854
855 Use pkg-config to determine where to find the devmapper library so we
856 can find out where it is located on different distributions.
857
858 Fix Makefile race so that "make -j3 distclean" works correctly
859
860 Fix portability problems on non-Linux/non-Hurd/non-Masix systems,
861 especially on MacOS X systems.  (Addresses Sourceforge Bugs: #1861633,
862 #1819034, #1863819)
863
864 Fixed spelling mistakes, typos, and otherwise clarified man pages.
865
866 Fixed various Debian packaging issues --- see debian/changelog for
867 details.  (Addresses Debian Bugs: #459403, #459475, #459614)
868
869 Remove the --enable-dynamic-static configure option, and build e2fsck
870 dynamically by default.  If the user wants e2fsck.static, he/she will
871 need to build it via "make -C e2fsck e2fsck.static"
872
873 Fix various build warnings due to missing prototypes.
874 (Addresses Sourceforge Patch: #1861663, #1861659)
875
876
877 E2fsprogs 1.40.4 (December 31, 2007)
878 ====================================
879
880 Improve time-based UUID generation.  A new daemon uuidd, is started
881 automatically by libuuid if necessary.  This daemon is setuid to allow
882 updates to /var/lib/libuuid, so the clock sequence number can be
883 stored and so if the clock is set backwards, it can be detected.
884 (Addresses Sourceforge Bug: #1529672, Addresses Red Hat Bugzilla:
885 #233471)
886
887 Filter out the NEEDS_RECOVERY feature flag when writing out the backup
888 superblocks.  This avoids e2fsck from concluding that a full
889 filesystem check is required before backing up the superblock due to
890 changes in the feature flags.  (Addresses Debian Bug: #454926)
891
892 Fix fsck to only treat the '#' character as a comment at the beginning
893 of the line in /etc/fstab.  Otherwise fstabs for the fuse filesystem
894 will cause fsck to issue an bogus warning message.
895 (Addresses Gentoo bug: #195405, Addresses Sourceforge bug: #1826147)
896
897 Format control characters and characters with the high eighth bit set
898 when printing the contents of the blkid cache, to prevent filesystems
899 with garbage labels from sending escape sequences to the user's screen
900 that might, for example place it in graphics mode.  (Addresses Ubuntu
901 Bug: #78087)
902
903 Fix sign-extension problem on 64-bit systems in in the com_err
904 library.  (Addresses Sourceforge Bug: #1809658)
905
906 Avoid division by zero error when probing an invalid FAT filesystem in
907 the blkid library.  (Addresses Sourceforge Bug: #1831627)
908
909 Update Dutch, Polish, and Vietnamese translations from the Translation
910 Project.  Remove the Rwandan translation upon advice of the
911 Translation Project.
912
913 Programmer's Notes:
914 -------------------
915
916 Fix the libss "make check" regression test so that it works if the
917 current directory is not in the user's path or if the libss shared
918 library is not installed.  (Addresses Sourceforge Bug: #1848974)
919
920 Fixed spelling mistakes, typos, and otherwise clarified man pages.
921 (Addresses Debian Bugs: #444883, #441872)
922
923 Fixed various Debian packaging issues --- see debian/changelog for
924 details.  (Addresses Debian Bugs: #437720, #451172, #458017)
925
926 Fix build failure on non-Linux/non-Hurd/non-Masix systems.
927 (Addresses Sourceforge Bug: #1859778)
928
929 Fix Hurd portability issues.  (Addresses Debian Bug: #437720)
930
931
932 E2fsprogs 1.40.3 (December 5, 2007)
933 ===================================
934
935 Fix a potential security vulnerability where an untrusted filesystem
936 can be corrupted in such a way that a program using libext2fs will
937 allocate a buffer which is far too small.  This can lead to either a
938 crash or potentially a heap-based buffer overflow crash.  No known
939 exploits exist, but main concern is where an untrusted user who
940 possesses privileged access in a guest Xen environment could corrupt a
941 filesystem which is then accessed by the pygrub program, running as
942 root in the dom0 host environment, thus allowing the untrusted user to
943 gain privileged access in the host OS.  Thanks to the McAfee AVERT
944 Research group for reporting this issue.  (Addresses CVE-2007-5497.)
945
946 Fix hueristics in blkid which could cause a disk without partitions to
947 be incorrectly skipped when a loopback device is present.  (Addresses
948 Red Hat Bugzilla #400321.)
949
950 Fix e2image so that in raw mode it does not create an image file which
951 is one byte too large.
952
953 Change mke2fs's usage message so it recommends the preferred -E option
954 instead of the deprecated -R option.
955
956 Enhance the blkid library so it will recognize squashfs filesystems.
957 (Addresses Red Hat Bugzilla #305151.)
958
959 Enhance e2fsck so it will force the backup superblocks to be backed up
960 if the filesystem is consistent and key constants have been changed
961 (i.e., by an on-line resize) or by e2fsck in the course of its
962 operations.
963
964 Enhance blkid's detection of FAT filesystems; so that USB disks with
965 only a single bootable partition will not get missed.
966
967 E2fsck will no longer mark a filesystem as invalid if it has time
968 errors (i.e., if superblock mount time or last write time is in the
969 future) and the user refuses to fix the problem.
970
971 The Ubuntu init scripts don't properly set the system time correctly
972 from hardware clock if the hardware clock is configured to tick local
973 time instead of GMT time.  Work around this as best as we can by
974 providing an option, buggy_init_scripts, in /etc/e2fsck.conf which can
975 be set on Ubuntu systems.  (Addresses Debian Bug #441093, and Ubuntu
976 Bug #131201.)
977
978 Fix fsck to ignore /etc/fstab entries for bind mounts.  (Addresses Red
979 Hat Bugzilla #151533.)
980
981 Fix e2fsck so that if the superblock is corrupt, but still looks
982 vaguely like an ext2/3/4 superblock, that it automatically tries to
983 fall back to the backup superblock, instead of failing with a hard
984 error.
985
986 Make the e2fsprogs program more robust so that they will not crash
987 when opening a corrupt filesystem where s_inode_size is zero.
988
989 Change e2fsck so it uses sscanf() instead of atoi() so it non-numeric
990 arguments are detected as such and the parse error is reported to the
991 user.   (Addresses Debian Bug #435381.)
992
993 Change e2fsck so it will not complain if a file has blocks reallocated
994 up to the next multiple of a system's page size.
995
996 Fix bug in ext2fs_check_desc() which will cause e2fsck to complain
997 about (valid) filesystems where the inode table extends to the last
998 block of the block group.  (Addresses Red Hat Bugzilla #214765.)
999
1000 Fix a bug in ext2fs_initialize() which causes mke2fs to fail while
1001 allocating inode tables for some relatively rare odd disk sizes.
1002 (Addresses Red Hat Bugzilla #241767.)
1003
1004 Add Catalan translation and update Dutch and Swedish translations
1005 from the Translation Project.
1006
1007 Fix big-endian byte-swapping bug in ext2fs_swap_inode_full().  We
1008 still had an issue when trying to figure out whether we need to
1009 byte-swap fast symlinks that contained extended attributes.
1010
1011 Fixed spelling mistakes, typos, and otherwise clarified man pages.
1012 (Addresses SourceForge Bug #1821333.)
1013
1014
1015 Programmer's Notes:
1016 -------------------
1017
1018 Fix mke2fs tests to avoid needing any significant ^M (CR) characters
1019
1020 Add "make check" to the RPM spec file
1021
1022 Fix "make install" and 'make unstall" in misc/Makefile.in so that it
1023 works correctly when the prefix is not the root directory.
1024
1025 Fix the resize2fs tests, r_move_itable and r_resize_inode, so they
1026 clena up after themselves by deleting the test.img temporary file
1027 after completing the test.
1028
1029 Fixed a corner case bug ext2fs_unlink() when trying to delete the
1030 first directory entry in a directory block and the last directory
1031 entry in the previous directory block is not in use.  Fortunately
1032 ext2fs_unlink() is only used by debugfs and e2fsck, and in e2fsck in
1033 places where it is extremely unlikely to run into this corner case.
1034
1035 Fix missing dependency which would cuase parallel builds to fail.
1036 (Addresses Sourceforge Bug #1842331.)
1037
1038 Fix a build error on newer gcc caused by lib/ext2fs/ismounted.c
1039 calling open(O_CREATE) with a missing mode parameter.
1040
1041 Fix the test_ss.c in lib/ss so it can be used as an example
1042 application program for the library as well as a regression test
1043 suite.
1044
1045 Fix ext2fs_dblist_dir_iterate() so that error codes and abort codes
1046 are properly passed back up through the call stack.
1047
1048 E2fsprogs 1.40.2 (July 12, 2007)
1049 ================================
1050
1051 A recent change to e2fsck_add_dir_info() to use tdb files to check
1052 filesystems with a very large number of filesystems had a typo which
1053 caused us to resize the wrong data structure.  This would cause a
1054 array overrun leading to malloc pointer corruptions and segfaults.
1055 Since we normally can very accurately predict how big the the dirinfo
1056 array needs to be, this bug only got triggered on very badly corrupted
1057 filesystems.
1058
1059 Fix a bug in e2fsck which caused it to incorrectly salvange
1060 directories when the last entry's rec_len is bogusly too big.  This
1061 resulted in a nonsense filesystem corruption to be reported, and
1062 required a second run of e2fsck to fully fix up the directory.
1063
1064 Update tune2fs man page to include more discussion of reserved blocks
1065 (Addresses Launchpad bug #47817)
1066
1067 Update Turkish, Polish, Dutch, and Vietnamese PO files from the
1068 Translation Project
1069     
1070
1071 E2fsprogs 1.40.1 (July 7, 2007)
1072 ===============================
1073
1074 Fix bug which could cause libblkid to loop forever.  When revalidating
1075 a partition where there is obsolete information in /etc/blkid.tab, we
1076 end up freeing a the type tag without clearing dev->bid_type, causing
1077 blkid_verify() to loop forever.  (Addresses Debian Bug: #432052)
1078     
1079 The Turkish translation has a bug in it where it has the translation
1080 of "E@e '%Dn' in %p (%i)" to "E@E".  This causes @E to be expanded at
1081 @E, recursively, forever, until the stack fills up and e2fsck core
1082 dumps.  We fix this by making e2fsck stop @-expansions after a
1083 recursive depth of 10, which is far more than we need.
1084 (Addresses Sourceforge Bug: #1646081)
1085     
1086 Compile the default mke2fs.conf into mke2fs program.  People are
1087 getting surprised by mke2fs creating filesystems with different
1088 defaults than earlier versions of mke2fs if mke2fs.conf is not
1089 present.  So we now create a built in version of mke2fs.conf file
1090 which is used by mke2fs if the /etc/mke2fs.conf is not present.
1091 (Addresses SourceforgeBug: #1745818)
1092
1093 Improve the config/parse_types.sh helper script.  Fix a potential
1094 security problem if e2fsprogs is built as root (as Gentoo does!).  In
1095 addition fix the script and how it is called from the configure script
1096 so that it does the right thing when cross-compiling.  (Fixes Gentoo
1097 bug: #146903)
1098     
1099 Update Vietnamese, French, and Dutch PO files from the Translation
1100 Project.  Also created a new e2fsprogs.pot file for translator.
1101     
1102 Fix bogus strip permission errors when building under Debian.  When
1103 building the e2fsprogs dpkg's, the dh_strip command emits a large
1104 number of error messages caused by the permissions not being right.
1105 So run dh_fixperms before running dh_strip.
1106
1107 Programmer's Notes:
1108 -------------------
1109
1110 Add new function: profile_set_default().  This function sets the value
1111 of the pseudo file "<default>".  If the file "<default>" had
1112 previously been passed to profile_init(), then def_string parameter
1113 will be parsed and used as the profile information for the "<default>"
1114 file.
1115     
1116 Fix mk_cmds's error reporting so that it is unambiguous that it is the
1117 mk_cmds script which is generating the error.  (Obviates Gentoo patch:
1118 e2fsprogs-1.32-mk_cmds-cosmetic.patch)
1119     
1120 Fix the test suite to use LC_ALL instead of LANG.  LC_ALL is the "high
1121 priority" environment variable that overrides all others, where as
1122 LANG is the lowest priorty environment variable.  If LC_ALL is set, it
1123 doesn't matter whether LANG, LANGUAGE, LC_COLLATE, LC_MESSAGES, and
1124 the all the rest are set.  This will assure that the locale when
1125 running the test suites is the "C" locale.  (Obviates Gentoo patch:
1126 e2fsprogs-1.38-tests-locale.patch)
1127     
1128
1129 E2fsprogs 1.40 (June 29, 2007)
1130 ==============================
1131
1132 Fix divide by zero error in blkid's NTFS probing logic.
1133
1134 Add new blkid -g option which causes the blkid cache to be garbage
1135 collected.
1136
1137 Fix a bug in libblkid which could cause the internal field bid_type to
1138 become corrupted.  Fortunately bid_type isn't used much, and bid_label
1139 and bid_uuid is only used by debugging code, so the impact of this bug
1140 was very minor.
1141
1142 Mke2fs will now store the RAID stride value when a filesystem is
1143 created with a requested RAID stride, and then use it automatically in
1144 resize2fs.
1145
1146 Mke2fs has a sanity check added to make sure (inode_size * num_inodes)
1147 isn't too big.  In some cases Lustre users have tried specifying an
1148 inode size of 4096 bytes, while keeping an inode ratio of one inode
1149 per 4096 bytes.  
1150
1151 Improve sanity check in e2fsck's algorithm for finding a backup
1152 superblock, so that it won't accidentally find a superblock that was
1153 located in the journal, and then later reject it as being not a valid
1154 backup superblock.
1155
1156 Fix e2fsck get_size logic so that it will work with the Linux floppy
1157 driver.  The Linux floppy driver is a bit different from the other
1158 block device drivers, in that if the device has been opened with
1159 O_EXCL, it disallows another open(), even if the second open() does
1160 not have the O_EXCL flag.  (Addresses Debian Bug: #410569)
1161
1162 Fix error checking of badblock's last-block and start-block arguments.
1163 (Addresses Debian Bug: #416477)
1164
1165 Fix e2fsck so that it doesn't overwrite the backup superblocks when
1166 recovering a journal until the master superblock has been confirmed as
1167 being sane.
1168
1169 Change the blkid library to be much more paranoid about concluding
1170 that a partition contains an NTFS filesystem, and fetch the UUID and
1171 LABEL information from NTFS filesystems.  (Addresses Launchpad Bug:
1172 #110138)
1173
1174 Factor out the code which sets the default journal size and move it
1175 into libext2fs.
1176
1177 Enhance e2fsck so it will recreate the ext3 journal if the original
1178 journal inode was cleared to due it being corrupt after finishing the
1179 filesystem check.
1180
1181 Fix e2fsck so that it updates the journal inode if it is corrupted and
1182 the backup journal information from the superblock was successfully
1183 used to recover the filesystem.
1184
1185 Fix e2fsck so that it checks all of the blocks in the journal inode
1186 for validity.  The original code only checked the direct blocks to
1187 make sure the journal inode was sane.  Unfortunately, if some or all
1188 of the indirect or doubly indirect blocks were corrupted, this would
1189 not be caught.
1190
1191 Add support in blkid to detect LUKS encrypted partitions.
1192
1193 Add extra sanity checks for extended attributes in the case where the
1194 size is zero but the offset is very large.
1195
1196 Fix byte-swapping issues for large inodes in ext2fs_read_inode_full()
1197 and ext2fs_get_next_inode_full().
1198
1199 Clarify the copyright licenses used by the various libraries in
1200 the top-level COPYING  file (Red Hat Bugzilla: 166058)
1201
1202 Make mke2fs's defaults when /etc/mke2fs.conf doesn't exist more sane.
1203
1204 Fix mke2fs and debugfs to support large (> 16 bit) uid's and gid's.
1205
1206 Remove check in e2fsck which requires EA's in inodes to be sorted;
1207 they don't need to be sorted, and e2fsck was previously wrongly
1208 clearing unsorted EA's stored in the inode structure.
1209
1210 Allow mke2fs or tune2fs to create a substantially larger journal (up
1211 to 10,240,000 blocks).
1212
1213 Fix MD superblock detection, and make sure the correct UUID is
1214 reported from the MD superblock.
1215
1216 Fix a signed vs. unsigned bug in debugfs.
1217
1218 Enhance debugfs's date parser so that it accepts integer values.
1219
1220 Fix e2fsck's pass1c accounting so it doesn't terminate too early if a
1221 file with multiply claimed blocks is hard linked. or not at all if the
1222 root directory contains shared blocks
1223
1224 Enhance debugfs so it can modify the block group descriptors using the
1225 command set_block_group_descriptor.
1226
1227 Improve e2fsck's reporting of I/O errors so it's clearer what it was
1228 trying to do when an error happens
1229
1230 Fix a bug in in how e2fsprogs byte swaps inodes containing fast
1231 symlinks that have extended attributes.  (Addresses Red Hat Bugzilla:
1232 #232663 and LTC Bugzilla: #27634)
1233
1234 Fix potential file descriptor leak in ext2fs_get_device_size() in an
1235 error case.
1236
1237 Add libreadline.so.5 support to libss.
1238
1239 Impove badblocks -n/-w exclusive usage message.
1240
1241 Fix dump_unused segfault in debugfs when a filesystem is not open
1242
1243 Fix memory leak in blkid library.  (Addresses Debian Bug: #413661)
1244
1245 Allow the debugfs lcd command to work w/o a filesystem being open.
1246 (Addresses LTC Bugzilla #27513)
1247
1248 Fix e2fsck to clear i_size for special devices with a bogus i_blocks
1249 field on the first pass.
1250
1251 Fix e2fsck to set the file type of the '..' entry when connecting
1252 a directory to lost+found.  (Addresses Lustre Bug: #11645)
1253
1254 Enhance e2fsck to recover directories whose modes field were corrupted
1255 to look like special files.  This is probably only useful in
1256 artificial test cases, but it will be useful if we ever do the "inodes
1257 in directory" idea for ext4.
1258
1259 Allow debugfs to dump (and rdump) > 2GB files.  (Addresses Debian Bug:
1260 #412614)
1261
1262 Fix resize2fs parsing of size parameter (in sector units).  This was
1263 actually a bug in libe2p's parse_num_blocks() function.  When handling
1264 the 's' suffix, it was ignoring the blocksize information passed in
1265 from the caller and always interpreting the number in terms of a 1k
1266 blocksize.  (Addresses Debian Bug: #408298)
1267
1268 There was a floating point precision error which could cause e2fsck to
1269 loop forever on really big filesystems with a large inode count.
1270 (Addresses Debian Bug: #411838)
1271
1272 Fix memory leak in ext2fs_write_new_inode()
1273
1274 Add support for using a scratch files directory to reduce e2fsck's
1275 emory utilization on really big filesystems.  This uses the TDB
1276 library.  See the [scratch_files] section of the e2fsck.conf man page
1277 for more details.
1278
1279 Fixed type-punning bug which caused dumpe2fs to crash on the Arm
1280 platform (Addresses Debian Bug: #397044)
1281
1282 Add explanatory message to badblocks that -n and -w are mutually exclusive
1283 (Addresses Debian Bug: #371869)
1284
1285 Allow debugfs and dumpe2fs to support fs features under development.
1286
1287 Add support for the new flag EXT2_FLAG_SOFTSUPP_FEATURES flag to
1288 ext2fs_open() , which allows application to open filesystes with features
1289 which are currently only partially supported by e2fsprogs.
1290
1291 Allow unix_io to support offsets greater than 2G (Addresses
1292 SourceForge Bug: #1547922)
1293
1294 Fixed overflow and signed/unsigned problems caused by the number of
1295 blocks or inodes exceeding 2**31 or being close to 2**32-1.
1296
1297 Add support for unsigned directory hash calculations with hints in the
1298 superblock to fix cross-architectural portability for htree
1299 directories with filenames where the high 8th bit is set.  (Addresses
1300 Debian: #389772)
1301
1302 Fix resize2fs so that it gives user-intelligible error messages if the
1303 filesystem or the kernel does not support on-line resizing.
1304 (Addresses Debian Bug: #380548)
1305
1306 Require mke2fs -F -F for really dangerous operations, since -F is
1307 needed for less dangerous operations such as creating filesystems
1308 images in regular files, or creating filesystems on whole block
1309 devices.  These relatively innocuous usages should NOT be confused
1310 with running mke2fs on an apparently-mounted or in-use filesystem.
1311
1312 Allow the default inode size to be specified into the mke2fs.conf
1313 file.
1314
1315 Make the smallest default journal size is big enough so that on-line
1316 resizing should always work.
1317
1318 Fix silly spelling error in e2fsck.  (Addresses SourceForge bug:
1319 #1531372)
1320
1321 Fix debugfs coredump when lsdel is run without an open filesystem
1322 (Addresses Debian Bug: #378335)
1323
1324 Fix debugfs display bug us that bytes that have the high bit set are
1325 displayed as "ec" instead of "ffffffec".
1326
1327 Add support in lsattr so it will display the EXT4_EXTENTS_FL flag.
1328
1329 Device mapper scanning wasn't working in the blkid library because the
1330 pathnames had an extra "/dev" when they were being probed.
1331
1332 Add GFS/GFS2 support to the blkid library.
1333
1334 Fix blkid support of empty FAT filesystem labels.
1335
1336 Avoid recursing forever (or for a long time) when the blkid library
1337 searches for a device and there are symlinks to directories in /dev.
1338
1339 Avoid unaligned halfword access in blkid when accessing FAT
1340 superblocks, as this will cause Sparc/Solaris systems to throw a
1341 SIGBUS error.
1342
1343 The latest devmapper libraries requires pthreads, add -lpthreads to
1344 the static link libraries for e2fsck.static if devmapper is enabled.
1345 (Addresses Debian bug: #388718)
1346
1347 Improve the (non-installed, for experts only) findsuper program by
1348 printing the uuid and label from the superblocks, as well as the
1349 starting and ending offsets of the filesystem given the information in
1350 the superblock.  Omit by default printing superblocks that are likely
1351 found in located in an ext3 journal unless an explicit -j option is
1352 given.
1353
1354 Updated Spanish, French and Dutch translations and added Catalan
1355 translation.  (Addresses Debian bug: #411562)
1356
1357 Use FreeBSD's DIOCGMEDIASIZE and DIOCGDINFO ioctls if available when
1358 determining a partition's size, since binary searching to determine
1359 the device doesn't work on FreeBSD.
1360
1361 Documentation about UUID's is available in enough places, and it's
1362 awkward to deal with debian-legal's insanities.  So I'm caving in the
1363 "more-lunatic-than-RMS" wing of Debian by removing RFC-4122 so we
1364 don't have do the dfsg tarball.  Also remove the rule that only tried
1365 to install RFC-4122 on Ubuntu, since Ubuntu seems to want to fetch
1366 e2fsprogs exclusively from Debian.  (Addresses Debian Bug: #407107)
1367
1368 Fix the info-dir line so that the menu name does not contain a .info
1369 prefix.  First of all, it's ugly, secondly, it causes the install-info
1370 command to fail to remove the com_err info file from the
1371 /usr/share/info/dir file when the comerr-dev package is removed and
1372 purged.  (Addresses Debian Bug: #401711)
1373
1374 Fixed spelling mistakes, typos, and otherwise clarified man pages.
1375 (Addresses Debian Bug: #369761, #373004, #379695)
1376
1377 Fixed various Debian packaging issues --- see debian/changelog for
1378 details.  (Addresses Debian Bugs #389554, #390664, #413208, #419605,
1379 #408352, #415560, #399155)
1380
1381
1382 Programmer's notes:
1383 -------------------
1384
1385 E2fsck now supports the %It expansion when printing a problem report.
1386 It will print the type of the inode in the problem context.
1387
1388 Fix misc/Makefile.in so that it builds even if e2fsck hasn't been built yet
1389 (Addresses Sourceforge Bug: #1565561)
1390
1391 Remove unused variables and other lint/gcc -Wall cleanups
1392
1393 Add check to ext2fs_get_device_size() so it will return EFBIG for for
1394 filesystems contained in regular files where the filesystem image size
1395 is returned by stat64().
1396
1397 Set local environment variables to C so mk_cmds and compile_et always
1398 work.  (Addresses SourceForge Bug: #1532177)
1399
1400 Added the 64-bit byte swapping function ext2fs_swab64().
1401
1402 Added two new helper functions to prevent 2**31/2**32-1 overflow
1403 problems: ext2fs_div_ceil() and e2p_percent().
1404
1405 Create new ext2fs library inline functions ext2fs_group_first_block()
1406 and ext2fs_group_last_block() in order to calculate the starting and
1407 ending blocks in a block group.
1408
1409 Create the generated files read-only to remind developers not to edit them.
1410
1411 Add support for autoconf 2.60 (with backwards compatibility for older
1412 versions of autoconf).
1413
1414 Added an "make rpm" target to top-level Makefile
1415
1416 Added various FreeBSD portability fixes.
1417
1418 Exclude mercurial files from the RPM build tree to speed up copy/build.
1419
1420 Use root_sysconfdir to define the locations of mke2fs.conf and
1421 e2fsck.conf instead of using a hard-coded /etc pathname.
1422
1423 Prevent e2fsck.h and ext2_ext_attr.h from getting included multiple times.
1424
1425 Fixed "make clean" in blkid's Makefile.in file from removing tst_*.c files.
1426
1427 If diff -u is supported, use it to report test failures.
1428
1429 Updates/improvements to RPM spec file
1430
1431 Add on-disk format definitions for the following new features:
1432 EXT4_FEATURE_RO_COMPAT_HUGE_FILE, EXT4_FEATURE_RO_COMPAT_GDT_CSUM,
1433 EXT4_FEATURE_RO_COMPAT_DIR_NLINK, EXT4_FEATURE_INCOMPAT_64BIT,
1434 EXT4_FEATURE_RO_COMPAT_EXTRA_ISIZE
1435
1436 Add a new make target "checked-failed" in the tests directory which
1437 reruns any failed tests
1438
1439 Update draft-leach-uuids-guids-01.txt with rfc4122.txt
1440
1441 Fix miscellaneous bugs reported by Coverity: Dead code, potential nul
1442 pointer dereferences, memory leaks, etc.  None were security-criticial
1443 problems.
1444
1445 Fix up usage and decrement error messages in the test_icount program
1446
1447 Add debugging code to the com_err library; if the environment variable
1448 COMERR_DEBUG is set to 1, print out debugging messages as error tables
1449 are added and removed from the com_err library.  If the
1450 COMERR_DEBUG_FILE environment variable is set (and the process is not
1451 setuid) the debugging messages may be redirected to a file.
1452
1453 Change all of the e2fsprogs programs to use the newer add_error_table()
1454 and remove_error_table() interfaces instead of the much older
1455 initialize_*_error_table() function.
1456
1457 Add TDB support into the ext2fs library.  This allows us to have a
1458 guaranteed library we can count on always being present so we can
1459 store data in an on-disk database.
1460
1461 Add support for using TDB to store the icount data, so we don't run out
1462 of memory when checking really large filesystems.
1463
1464 Change the regression test suite so that it skips empty test directories.
1465
1466 Define the l_i_iversion field in ext2_inode.  The l_i_version field is
1467 now defined from the old l_i_reserved1 field in the ext2 inode.  This
1468 field will be used to store high 32 bits of the 64-bit inode version
1469 number.
1470
1471 Add Makefile production rule for e2fsprogs.spec in case it gets
1472 deleted.
1473
1474 Add new function profile_get_uint() to allow for a clean way to fetch
1475 unsigned integers from the context.
1476
1477 Add test to make sure the ext2 superblock structure is 1024 bytes.
1478
1479 Fix typo in name of f_dup4 regression test
1480
1481 Add new function blkid_gc_cache() which performs a garbage collection
1482 pass on the /etc/blkid.tab file.
1483
1484 The ext2fs_open() function now sets EXT2_FLAG_MASTER_SB_ONLY.  In
1485 general, only e2fsck (after the filesystem is clean), tune2fs, and
1486 resize2fs should change the backup superblocks by default.  Most
1487 callers of ext2fs_open() should not be touching any superblock fields
1488 which require the backups to be touched.
1489
1490 Add new function to libext2fs, ext2fs_default_journal_size(), which
1491 returns the default journal size.
1492
1493
1494 E2fsprogs 1.39 (May 29, 2006) 
1495 =============================
1496
1497 Fix 32-bit cleanliness in e2fsprogs so that we can support filesystems
1498 between 2**31 and 2**32 blocks.
1499
1500 Change mke2fs to use /etc/mke2fs.conf as a configuration file to
1501 configure the filesystem features, blocksize, and inode_ratio for
1502 different filesystem types.
1503
1504 Mke2fs will now create filesystems hash trees and on-line resizing
1505 enabled by default, based on the new /etc/mke2fs.conf file.
1506
1507 The e2fsprogs tools (resize2fs, e2fsck, mke2fs) will open the
1508 filesystem device node in exclusive mode to prevent accidents by
1509 system administrators.  In the case of resize2fs and mke2fs, it will
1510 only use exclusive mode if the filesystem is not mounted.
1511
1512 Fixed a bug in mke2fs which caused it to to fail when creating the
1513 resize inode for large filesystems.  (Addresses Debian Bug #346580)
1514
1515 When allocating space for the RAID filesystems with the stride
1516 parameter, mke2fs will now place each portion of the group's inode
1517 table right up after the superblock (if present) in order to minimize
1518 fragmentation of the freespace.
1519
1520 Speed up mke2fs and e2fsck by writing inode and block bitmaps more
1521 efficiently by writing the inode and block bitmaps in one pass, thus
1522 reducing the number of disk seeks required.
1523
1524 Add support for on-line resizing to resize2fs.
1525
1526 Fix blkid library so that logic to determine whether or not a device's
1527 cached information in /etc/blkid.tab needs to be verified or not
1528 doesn't get confused by a system clock which is insane (for example,
1529 if the battery is dead on a Macintosh running PPC Linux.  (Addresses
1530 Red Hat Bug: #182188)
1531
1532 The blkid library will now store the UUID of the external journal used
1533 by ext3 filesystems, so that in the future, the userspace mount binary
1534 can use this to find the location of the external journal and pass
1535 this information to the kernel.
1536
1537 E2fsck will now consult a configuration file, /etc/e2fsck.conf to
1538 control how various options should be handled.  See the e2fsck.conf
1539 man page for more details.   (Addresses Debian Bug: #150295)
1540
1541 E2fsck now prints an explanatory message when delaying a filesystem
1542 check when the system is running on battery.  (Addresses Debian Bug:
1543 #350306)
1544
1545 E2fsck will detect if the superblock's last mount field or last write
1546 field is in the future, and offer to fix if so.  (Addresses Debian Bug
1547 #327580) These problems will be fixed automatically in preen mode
1548 since Debian's boot sequence bogusly doesn't set the time correctly
1549 until potentially very late in the bootup process, and this can cause
1550 false positives which will cause users' systems to fail to boot.
1551 (Addresses Debian Bugs #343662 and #343645)
1552
1553 E2fsck now checks to see if the superblock hint for the location of
1554 the external journal is incorrect, and if so, offer to update it.
1555 (Addresses Debian Bug: #355644)
1556
1557 Fix e2fsck from segfaulting on disconnected inodes that contain one or
1558 more extended attributes.  (Addresses Debian Bug: #316736, #318463)
1559
1560 E2fsck will stop and print a warning if the user tries running a
1561 read/write badblocks test on a read-only mounted root filesystem.
1562
1563 Fix a memory leak in e2fsck's error paths.  (Thanks to Michael
1564 C. Thompson for pointing these out; they were originally found using
1565 Coverity.)
1566
1567 When resizing a file containing a filesystem, resize2fs will expand or
1568 truncate a file as necessary.  (Addresses Debian Bug: #271607)
1569
1570 Resize2fs will now automatically determine the RAID stride parameter that
1571 had been used to create the filesystem, and use that for newly created
1572 block groups.   The RAID stride parameter may also be manually specified
1573 on the command line using the new -S option to resize2fs.
1574
1575 Fix mke2fs so that it correctly creates external journals on
1576 big-endian machines (such as a S/390).  
1577
1578 Fix a bug in the e2p library which could cause dumpe2fs to (rarely)
1579 fail to print out the journal or hash seed UUID.  (Thanks to Guillaume
1580 Chambraud for pointing this out.)
1581
1582 Dumpe2fs will now print the size of the journal (if present).
1583
1584 Fix debugfs's set_inode_field command so it can properly set the frag,
1585 fsize, uid_high, gid_high, and author fields in the inode instead of
1586 silently failing, and so that setting the i_size actually sets i_size
1587 correctly.
1588
1589 Add a new debugfs command, set_current_time, which sets fs->now so
1590 that regression test suites can repeatedly modify the filesystem's
1591 last_write fields.
1592
1593 Fix a bug in debugfs's icheck which would incorrectly report the owner
1594 of an extended attribute block.
1595
1596 Fix the debugfs commands htree_dump, dx_hash, and list_dir so they print a
1597 print a usage message when an illegal option character is given.
1598
1599 Fix debugfs's dump_unsued command on filesystems with a 64k blocksize
1600 so it won't core dump.  (Addresses SourceForge bug #1424311)
1601
1602 Fix mklost+found so that it creates a full-sized directory on
1603 filesystems with larger block sizes.
1604
1605 Fix a file descriptor leak in blkid library.
1606
1607 Fix a display bug in "badblocks -sv" so that the done message properly
1608 clears the block number at the end of the test.  (Addresses Debian Bug
1609 #322231)
1610
1611 Allow fractional percentages to the -m option in mke2fs and tune2fs
1612 (Addresses Debian Bug: #80205)
1613
1614 Use fstat/fstat64 in getsize.c if the the target is a regular file,
1615 instead of attempting to do a binary search.  Fix some fd leaks in
1616 error cases.
1617
1618 Add support for device mapper library to the blkid library to ensure
1619 that the "best" (i.e., leaf) device is probed by the blkid library.
1620
1621 Fix the blkid library so that it notices when an ext2 filesystem is
1622 upgraded to ext3.
1623
1624 Improve the blkid's library VFAT/FAT detection; it now understands
1625 labels stored in the root directory, and is more paranoid about
1626 checking the FAT superblock values.
1627
1628 Fixed a fd leak in the uuid library which was causing problems for the
1629 LVM tools.  (Addresses Debian Bug: #345832)
1630
1631 Add support for the reiser4 and software suspend partitions to the
1632 blkid library.  Also add support for extract the label from iso9660
1633 filesystems.
1634
1635 Fix a compile_et bug which miscount the number of error messages if
1636 continuations are used in the .et file.
1637
1638 Add extra sanity checks to protect users from unusual cirucmstances
1639 where /etc/mtab may not be sane, by checking to see if the device is
1640 reported busy (works on Linux 2.6) kernels.  (Addresses Debian Bug
1641 #319002)
1642
1643 Updated French, Dutch, Polish, and Swedish translations.  (Addresses Debian
1644 Bug: #343149, #341911, #300871, #316604, #316782, #330789)
1645
1646 Fix use-after-free bug in e2fsck when finishing up the use of the
1647 e2fsck context structure.
1648
1649 Fixed spelling mistakes, typos, and otherwise clarified man pages and
1650 documentation.  (Addresses Debian Bugs: #329859, #322188, #316811,
1651 #312515, #351268, #357951, #347295, #316040, #368392, #368393, #368394,
1652 #368179)
1653
1654 Fixed various Debian packaging issues --- see debian/changelog for
1655 details.  (Addresses Debian Bugs #317862, #320389, #290429, #310950,
1656 #310428, #330737, #330736, #329074, #356293, #360046, #366017, #364516,
1657 #362544, #362970)
1658
1659
1660 Programmer's notes:
1661 -------------------
1662
1663 Update config.guess and config.sub to latest version (2006-02-23) from
1664 FSF.
1665
1666 Fix asm_types.h type conflicts on AMD 64 platforms.  (Addresses Debian
1667 Bugs: #360661, #360317)
1668
1669 Fixed the Makefile so that they work correctly on newer versions of
1670 GNU make (i.e., 3.81).
1671
1672 Add valgrind support to the regression test suites, and eliminate
1673 false positives from valgrind.
1674
1675 Add a regression test suite for the blkid library.
1676
1677 Fix a fencepost error in resize2fs caught by valgrind.  
1678
1679 Fix compiler warnings about missing memcpy prototypes.
1680
1681 We no longer have the sparc assembly code in the header file any more,
1682 so we shouldn't set _EXT2_HAVE_HAS_BITOPS_ for the sparc.  This would
1683 break compiles on the sparc architectures when using gcc.
1684
1685 In the libext2fs library, add the new field fs->now which if non-zero
1686 is used instead of the system time when setting various filesystem
1687 fields (last modified time, last write time, etc.)
1688
1689 Fix gcc 4.01 complaints by adding a missing #include <string.h> to
1690 ext2fs.h which is needed since the inline functions use memcpy().
1691 (Addresses Sourceforge Bug #1251062)
1692
1693 Use BUILD_CFLAGS and BUILD_LDFLAGS instead of CFLAGS and LDFLAGS in
1694 the build system when building files in the util directory which are
1695 needed during the build process.  This avoids potential problems when
1696 cross-compiling and some of the options specified in CFLAGS or LDFLAGS
1697 are not recognized as valid by the host compiler.  (Addresses
1698 Sourceforge Bug #1261547)
1699
1700 Clean up the blkid library by making the superblock and generic i/o
1701 functions to be more generic.  Clean up interface to the probe
1702 function, and fix memory leak.  Finallly, remove an unneeded reference
1703 to probe.h in the lib/blkid/resolve.c
1704
1705 Add an ext2fs_read_bb_FILE regression test to confirm proper detection
1706 of invalid block #'s.
1707
1708 The x86 asm constraints for ext2fs_{set/clear}_bit have been fixed to
1709 indicate that the the function read/writes the memory location.
1710
1711 Fix various gcc -Wall complaints.
1712
1713 Add a dependency to make sure that the subdirectories are created
1714 before creating all of the object files, in order to address parallel
1715 build problem in the library Makefiles.  (Addresses Sourceforge Bug:
1716 #1261553)
1717
1718 Add $(LDFLAGS) to the command line argument when generating an ELF or
1719 Solaris shared library, to allow cross-compile and other builds that
1720 might need to specify -L paths to needed libraries.  (Addresses
1721 Sourceforge Bug #1261549)
1722
1723 Add a new feature, EXT2_FEATURE_COMPAT_LAZY_BG, which is initially
1724 intended for testing purposes.  It allows an ext2/ext3 developer to
1725 create very large filesystems using sparse files where most of the
1726 block groups are not initialized and so do not require much disk
1727 space.  Eventually it could be used as a way of speeding up mke2fs and
1728 e2fsck for large filesystem, but that would be best done by adding an
1729 RO_COMPAT extension to the filesystem to allow the inode table to be
1730 lazily initialized on a per-block basis, instead of being entirely
1731 initialized or entirely unused on a per-blockgroup basis.
1732
1733 Fix backwards compatibility so e2fsprogs will better compile on Linux
1734 2.0.35 systems.
1735
1736 Make test scripts more robust against locale-related environment variables
1737
1738 Fix type warning problem with sizeof() in ext2fs_open2().
1739
1740 Fix type warning problem with time_t in debugfs.
1741
1742
1743 E2fsprogs 1.38 (June 30, 2005)
1744 ==============================
1745
1746 Fix blkid's test programs (built with "make check") compile correctly
1747 even without "configure --enable-blkid-debug".
1748
1749 Fix ia64 core dump bug caused by e2fsprogs running afoul of C99 strict
1750 type aliasing rules on newer gcc compilers.  (Addresses Red Hat
1751 Bugzilla ##161183.)
1752
1753 Fix com_err library to make it more compatible with recent changes
1754 made to the com_err library in MIT Kerberos V5 version 1.4.
1755 (Addresses Sourcefroge Bug #1150146)
1756
1757 General cleanup of messages printed by e2fsprogs programs for grammar,
1758 consistency, and to make life easier for translators.  Fixed a few
1759 strings containing English that had not been marked as needing
1760 translations.  Removed strings that do not need to be translated, to
1761 make life easier for translators.
1762
1763 Mke2fs and badblocks will take advantage of a feature in Linux 2.6 to
1764 test to see if a device appears to be in use instead of just relying
1765 on /proc/mounts and /etc/mtab.  (Addresses Debian Bug #308594).
1766
1767 Fix portability problem in the filefrag program affecting platforms
1768 where the size of an integer is smaller than the size of a long.
1769 (Addresses Debian Bug #309655)
1770
1771 Mke2fs will now use a larger journal by default for filesystems
1772 greater than 4GB.  (128 MB instead of 32MB).
1773
1774 Mke2fs will refuse to create filesystems greater than 2**31-1 blocks,
1775 unless forced.  This is to avoid signed vs. unsigned kernel bugs in
1776 block numbers that still need to be fixed.
1777
1778 The blkid program has a new option which will more efficiently search
1779 for device when it is known (or expected) that only one matching
1780 device will be found in the system, such as when doing a lookup by
1781 UUID.
1782
1783 Debian's e2fsprogs-specific initrd fragment will avoid including
1784 unnecessary libraries into the initrd ramdisk by unsetting LD_PRELOAD
1785 and LD_LIBRARY_PATH, and filtering out libraries found in
1786 /etc/ld.so.preload.  (Addresses Debian Bug: #304003)
1787
1788 Fixed a potential portability issue in the blkid programs for
1789 architectures where the char type is unsigned.  (Addresses Sourceforge
1790 Bug: #1180585)
1791
1792 Fix a bug in filefrag so that it doesn't falsely count an extra
1793 discontinuity when the first block found is an indirect block.
1794 (Addresses Debian Bug #307607).
1795
1796 Fix blkid's recognition of cramfs filesystems, and enhance it to be
1797 able to handle cramfs labels.
1798
1799 Fix debugfs's stat command to not core dump when a filesystem is not
1800 open.
1801
1802 Fix e2fsck's handling of error conditions caused by the resize inode
1803 claiming blocks that are also used by other inodes, a filesystem
1804 corruption which was commonly caused by a bug in Fedora Core 3's
1805 resize2fs program.
1806
1807 Fixed bug in filefrag which caused it to fail on non-ext2/3
1808 filesystems.  (Addresses Debian Bug: #303509)
1809
1810 If the superblock last mount time indicates that the system clock may
1811 not be accurate, then e2fsck will omit checking inodes' deletion time
1812 field for indications of a potential corrupted orphaned inode list.
1813 (Previously e2fsck only ommited these LOW_DTIME checks when the
1814 superblock's last write time looked insane.)
1815
1816 Fixed a IA64 core dump bug in the e2p library which affected dumpe2fs.
1817 (Addresses Debian bug #302200)
1818
1819 Make the blkid library more paranoid about being run from setgid
1820 programs, and to use __secure_getenv() from libc if it is available.
1821
1822 Fixed spelling mistakes, typos, and otherwise clarified man pages.
1823 (Addresses Debian Bugs: #304591, #304592, #304594, #304597, #304593
1824 and Sourceforge Bug: #1189803)
1825
1826 Updated and fixed translations.
1827
1828 Fixed various Debian packaging issues --- see debian/changelog for
1829 details.
1830
1831 Programmer's notes:
1832 -------------------
1833
1834 Ext2fs_set_bit(), ext2fs_clear_bit(), and ext2fs_test_bit( have been
1835 changed to take an unsigned int for the bit number.  Negative bit
1836 numbers were never allowed (and didn't make any sense), so this should
1837 be a safe change.  This is needed to allow safe use of block numbers
1838 greater than or equal to 2**31.
1839
1840 The compile_et program will avoid recreating generated foo_err.c and
1841 foo_err.h files if no changes are necessary.  The compile_et program
1842 will also atomically replace these files to avoid a potential parallel
1843 build race problem on SMP systems.  (Addresses Sourceforge Bug:
1844 #1157933)
1845
1846 Added a new function to the blkid library, blkid_probe_all_new(),
1847 which only probes newly added disk devices, and change
1848 blkid_find_dev_with_tag() to use this function so that when a
1849 requested tag is not found, devices that were previously not checked
1850 are searched before searching all devices in the system.
1851
1852 Added new functions to the blkid library, blkid_dev_set_search() and
1853 blkid_dev_has_tag().
1854
1855 E2fsck's problem strings can now use @m and @n as abbrevations for
1856 "multiply-claimed" and "invalid", respectively.
1857
1858 The e2fsprog.pot file now has an explanation of how the @-expansion
1859 and %-expansion works, and strings in e2fsck/problem.c which contain @
1860 characters now have comments in e2fsprogs.pot with the @-expansion to
1861 make life easier for translators.
1862
1863 Fixed missing return values in the ext2fs library which could cause it
1864 to return random garbage in certain error conditions.
1865
1866 Allow the current time to be overriden via the E2FSCK_TIME environment
1867 variable for use in regression tests.
1868
1869 The test scrpit driver program now exits with a non-zero status if
1870 there any of its test that it ran failed.
1871
1872 Fixed problems with parabuilds on SMP systems.  (Addresses Sourceforge
1873 Bug: #1157933)
1874
1875 Fixed "make check" so that it compiles correctly even when e2fsprogs'
1876 header files have not be installed in the system include directories.
1877 (Addresses Sourceforge Bug: #1180572)
1878
1879 Fixed gcc -Wall nits.
1880
1881
1882 E2fsprogs 1.37 (March 21, 2005)
1883 ===============================
1884
1885 Add support for checking the validity of Extended Attributes stored in
1886 inodes to e2fsck.
1887
1888 Add support for dumping the contents of large inodes to debugfs,
1889 including the extended attributes stored in inodes.
1890
1891 Fix mke2fs, e2fsck, debugfs, and the ext2fs_mkdir function so that
1892 when we create a new inode we make sure that the extra information in
1893 the inode (any extra fields in a large inode and any ea-in-inode
1894 information) is initialized correctly.  This can take place when
1895 mke2fs creates the root and lost+found directory, when e2fsck creates
1896 a new root inode or a new lost+found directory, and when the user uses
1897 the debugfs write, mknod, or mkdir commands.  Otherwise, the newly
1898 create inode could inherit garbage (or old EA information) from a
1899 previously deleted inode.
1900
1901 Fixed a bug in e2fsck so it would notice if a file with an extended
1902 attribute block was exactly 2**32 blocks, such that i_blocks wrapped
1903 to zero.
1904
1905 Added support to filefrag to detect files which are using the new
1906 experimental file extents format, and use the non-ext2 algorithm in
1907 that case.  Fixed a bug to avoid reporting a false discontinuity if
1908 there is one or more unallocated blocks at the beginning of a file.
1909
1910 Duplicated a check for noticing whether or not the number of blocks
1911 (given a certain blocksize) is greater than 2**32 when the
1912 BLKGETSIZE64 ioctl is not available to ext2fs_get_device_size().  This
1913 allows mke2fs to automatically use a larger blocksize when creating a
1914 filesystem on a very large device when run on systems that do not
1915 support BLKGETSIZE64.
1916
1917 Fix the I18N build which was broken in e2fsprogs 1.36 because the
1918 build system had been switched to treat the .gmo files as shipped
1919 files (for backwards compatibility with systems that have older GNU
1920 I18N tools installed), but the gen_tarball.in script was still
1921 removing the .gmo files from the official source distribution.
1922
1923 Fixed various Debian packaging issues --- see debian/changelog for
1924 details.  (Addresses Debian Bugs ##296769, #299341)
1925
1926 Programmer's notes:
1927 -------------------
1928
1929 Added new functions to the e2p library which convert between a string
1930 and os_type: e2p_os2string() and e2p_string2os(), and used them to
1931 make the generated binaries more compact.
1932
1933 Fixed a compile-time error on Darwin systems.
1934
1935 Cleaned up the lib/ext2fs Makefile slightly.
1936
1937
1938 E2fsprogs 1.36 (February 4, 2005)
1939 =================================
1940
1941 All of the patches that were applied to Fedore Core 3's
1942 e2fsprogs-1.35-11.2 have been integrated, although sometimes with a
1943 lot of bug fixes first.  Users of Fedora Core 3 are strongly
1944 encouraged to upgrade to e2fsprogs 1.36 as soon as possible.
1945
1946 Add support for filesystem with the online resizing via resize inode
1947 feature.  Fixed numerous bugs from the Fedora patches.  The Fedora
1948 patches also didn't bother to do any consistency checking on the
1949 resize inode, or add any tests to the regression test suite.  The "-R
1950 resize=4g" option to mke2fs was a no-op in the Fedora patches, despite
1951 being listed in mke2fs's usage message.  All of these shortcomings
1952 have been corrected.
1953
1954 E2fsck can also also fix filesystems trashed by Fedora's resize2fs
1955 program.  In order to do this, the user must run the commands:
1956
1957         debugfs -w /dev/hdXXX -R "features ^resize_inode"
1958         e2fsck -f /dev/hdXXX
1959
1960 Optionally, the ext2prepare command can be used to re-enable online
1961 resizing after the filesystem has been fixed.
1962
1963 The fsck program will now accept an optional filedescriptor argument
1964 to the -C option.  (The Fedora version of this patch would sometimes
1965 cause fsck to ignore a parameter on fsck's command line in some rare
1966 cases, sigh.)
1967
1968 Make sure e2fsprogs doesn't write garbage into the reserved portion of
1969 large inodes.
1970
1971 Make sure resize2fs releases the blocks belonging to the old inode
1972 table blocks when moving the inode table.  (Addresses Debian Bug:
1973 #290894)
1974
1975 Skip the r_resize_inode test if resize2fs is not compiled (due to
1976 configure --disable-resizer)
1977
1978 E2fsck now checks the summary filesystem accounting information, and
1979 if any of the information is obviously wrong, it will force a full
1980 filesystem check.  (Addresses Debian Bug #291571)
1981
1982 Fix e2fsck to not complain when the resize_inode feature is enabled,
1983 s_reserved_gdt_blocks is zero, and there is no DIND block allocated in
1984 the resize inode.
1985
1986 Fix e2fsck to note delete symlinks that contain an extended attribute
1987 after the ext_attr feature flag has been cleared.  (Addresses Red Hat
1988 Bugzilla #146284).
1989
1990 Add new utility program, copy_sparse.c, which is very useful
1991 for dealing with large sparse files (such as e2image files).
1992
1993 Add support for jnl_blocks[] for debugfs's set_super_value.
1994
1995 Fix filefrag so that it works correctly with sparse files.
1996
1997 Filefrag -v will print first and last blocks.
1998
1999 Add interpretation of OS Creator values for FreeBSD and Lites in mke2fs
2000 and dumpe2fs.
2001
2002 Add mke2fs support so that it can support filesystems larger than 4TB
2003 automatically, by retrying with a 4k blocksize if the device size is
2004 too big to be expressed using a 1k blocksize.  (Addresses Sourceforge
2005 bug #1106631)
2006
2007 Change blkid to test for NTFS first because Windows sometimes doesn't
2008 clear enough of the parition to confuse the probing routines into
2009 thinking the old filesystem type is still valid.  (Addresses Debian
2010 Bug #291990)
2011
2012 Add support for swap partition label and uuid's in the blkid library.
2013
2014 Add support to the blkid library to recognize Oracle ASM volumes.
2015
2016 Make blkid -t display all devices that match the specified criteria,
2017 not just the first one, and work more consistently when the blkid
2018 cache file is not available or set to /dev/null.  (Addresses Debian
2019 Bug #290530 and #292425)
2020
2021 Badblocks will now correctly display block numbers greater than
2022 999,999,999 in its progress display.
2023
2024 The tune2fs program will not allow the user from setting a ridiculous
2025 number of reserved blocks which would cause e2fsck to assume the
2026 superblock was corrupt.  E2fsck's standards for what is a ridiculous
2027 number of reserved block has also been relaxed to 50% of the blocks in
2028 the filesystem.
2029
2030 The blkid library will return vfat in preference to msdos, and ext3 in
2031 preference to ext2 (if the journalling flag is set) so that mount will
2032 do the right thing.  (Addresses Debian bug #287455)
2033   
2034 Mke2fs will now use the -E option for extended options; the old -R
2035 (raid options) option is still accepted for backwards compatibility.
2036 Fix a double-free problem in resize2fs.  (Red Hat Bugzilla #132707)
2037
2038 Mke2fs will now accept a size in megabytes, gigabytes, and other units
2039 (via "32m" or "4g" on the command line) if the user finds this more
2040 convenient than specifying a block count.
2041
2042 Fix an obscure, hard-to find bug in "e2fsck -S" caused by an inode
2043 cache conherency problem.
2044
2045 Debugfs now supports a new command, set_inode_field, which allows a
2046 user to manually set a specific inode field more conveniently, as well
2047 as set entries in the indirect block map.
2048
2049 Debugfs's set_super_value command has been enhanced so that the user
2050 can set most superblock fields, including the date/time fields and
2051 some of the more newsly added superblock fields.
2052
2053 E2fsprogs programs now accept an offset to be passed to the file
2054 specifiers, via the syntax: "/tmp/test.img?offset=1024".
2055
2056 E2fsprogs programs will now accept blocksizes up to 65536; kernel
2057 support on the x86 doesn't exist for now, but it can be useful on
2058 other architectures with page sizes greater than 4k.  There are 2.6
2059 kernel patches out there which enable this, but they are of this
2060 writing still experimental.
2061
2062 The e2image command now takes the -s option which will scramble
2063 directory entries for raw image files.
2064
2065 Fix a file descriptor leak in the filefrag program.
2066
2067 Make sure e2fsck doesn't crash when /proc/acpi/ac_adapter is not
2068 present.
2069
2070 Fix bug in debugfs where kill_file would lead to errors when deleting
2071 devices and symlinks.  (Sourceforge Bugs #954741 and #957244)
2072
2073 Fix bug in the blkid library when detecting the ocfs1 filesystem 
2074
2075 Remove obsolete EVMS 1.x and a.out DLL support.
2076
2077 E2fsck will attempt to recover from a journal containing illegal blocks.
2078
2079 Fixed two potential ordering constraint problems in e2fsck which might
2080 cause the filesystem to be corrupted if e2fsck is interrupted during a
2081 (extremely narrow) race window.  Thanks to Junfeng Yang from the
2082 Stanford Metacompilation group for pointing this out.
2083
2084 Fixed bug in e2fsck where it would not accurately detect whether or
2085 not the system is running on adaptor if the ACPI device representing
2086 the AC adapter didn't correspond to the what was used on IBM
2087 Thinkpads.
2088
2089 Change e2fsck to accept directories greater than 32MB.
2090
2091 Fix e2fsck so that a checkinterval of zero disables a time-based check
2092 of the filesystem.
2093
2094 Debugfs will check the DEBUGFS_PAGER enviroment variable in preference
2095 to the PAGER environment variable.  (Addresses Debian Bug #239547)
2096
2097 Tune2fs will not mark rewrite the superblock if the feature bitmasks 
2098 are not modified.
2099
2100 The debugfs program will set the filetype information when creating a
2101 link.
2102
2103 Add debugfs -d option to use a separate source of data blocks when
2104 reading from an e2image file.
2105
2106 Add e2image -I option which allows the e2image metadata to be
2107 installed into a filesystem.
2108
2109 Fixed bug in the badblocks program which caused "done" to always
2110 appear in english even when a translation was available.  (Addresses
2111 Debian Bug #252836)
2112
2113 The blkid program has a new option -o which controls the output format
2114 of the blkid program; this is makes blkid more convenient to use in
2115 shell scripts.
2116
2117 Fix a minor bug in uuid library, which was not using the full 14 bits
2118 of clock sequence when generating UUID's.
2119
2120 Fix a Y8.8888K problem in the uuid library.
2121
2122 Logsave now creates a new session id for itself to avoid getting
2123 killed by init whan transitioning between init levels.
2124
2125 Change the licensing of the UUID library to be the 3-clause BSD-style
2126 license; this allows Apple to use the uuid library in Darwin.
2127
2128 Add ocfs and ocfs2 probe support into the blkid library.
2129
2130 Fix a memory and file descriptor leak in the blkid library.
2131
2132 The blkid library will revalidate the device if the system time is
2133 earlier than last verification time of the device, since that
2134 indicates that the system time is probably nottrustworthy.
2135
2136 The blkid library will override the default location of the blkid.tab
2137 file by the BLKID_FILE environment variable, if it is available.
2138
2139 Change the getsize functions to use the BLKGETSIZE64 ioctl on Linux 2.6.
2140
2141 Add various portability fixes for lame new versions of glibc, Darwin
2142 and GNU/KFreeBSD, as well as removing XSI:ism's.  (Addresses Debian
2143 Bugs #239934, #264630, #269044, #255589, #289133)
2144
2145 Add support for Windows 9x/NT under Cygwin.
2146
2147 Updated and clarified various man pages.  (Addresses Debian Bugs #236383,
2148         #241940, #238741, #242995, #256669, #268148, #256760, #273679)
2149
2150 Updated and fixed translations.   (Addresses Debian bugs #244105, #262836)
2151
2152 Update the rpm spec files so that it works better with Fedora core 2
2153 and RH9.
2154
2155 Fixed various Debian packaging issues (see debian/changelog).  In
2156 particular, fixed the Debian initrd scripts.  (#241183, #248050,
2157 #253595, #247775)
2158
2159
2160 Programmer's notes: 
2161 -------------------
2162
2163 Fixed various gcc -Wall warnings.
2164
2165 The uuid library now has new functions uuid_unparse_upper() and
2166 uuid_unparse_lower() which forces the case of the hex digits to be
2167 upper case, or lower case.
2168
2169 The build process has been speeded up by enhancing the subst program
2170 to update the modtime on the generated files even when the generated
2171 file hasn't changed.
2172
2173 The uuid library now uses C99 stdint.h types instead of custom types.
2174
2175 Updated config.guess and config.sub with newer versions from the FSF.
2176
2177 Removed out of date .cvsignore files from the source distribution.
2178
2179 The ext2fs_unlink() function will return an error if both the name and
2180 inode number are unspecified, to avoid doing something surprising
2181 (such as unconditionally deleting the first directory entry).
2182 Directory entries are now deleted by coalescing them with the previous
2183 directory entry if possible, to avoid directory fragmentation.  This
2184 is not an issue with the e2fsprogs suite, but may be a problem for
2185 some of the users of libext2fs, such as e2tools.
2186
2187 Add support for version numbers of the form "1.36-rc1".
2188
2189 Fix build of mke2fs.static.
2190
2191 Add basic ext2fs library support for large (EA in inode) inodes.
2192
2193 The test_io mechanism can now abort after n reads or writes to a
2194 particular block.  The block is specified by TEST_IO_BLOCK environment
2195 variable, and the read/write count by the TEST_IO_READ_ABORT and
2196 TEST_IO_WRITE_ABORT environment variables.  The block data is now only
2197 dumped if the 0x10 bit is set in TEST_IO_FLAGS.
2198
2199 UUID_DEFINE() in the uuid library now creates a static variable, with
2200 __attribute__ ((unused)) if we are using GCC, so that UUID_DEFINE can
2201 be used in header files.
2202
2203 Add support for the install-strip and install-shlibs-strip targets, as
2204 suggested by the GNU coding guielines.  "make install" no longer
2205 strips the binaries which are installed.
2206
2207 Remove support for the --enable-old-bitops configure option which was
2208 only for very old sparc systems.
2209
2210 Remove support for --enable-clear-htree; this was only needed during
2211 the early development of the htree patch.
2212
2213 Use Linux-kernel-style makefile output so it is easier to see compiler
2214 warnings.
2215
2216 Update gettext files to version 0.14.1.
2217
2218 Update to use autoconf 2.5x.
2219
2220 Improved support for compiling e2fsprogs under dietlibc.
2221
2222 Make e2fsprogs portable to Solaris and FreeBSD systems.
2223
2224 Add blkid_verify(), blkid_get_library_version(), and
2225 blkid_parse_version_string() functions to the blkid library.
2226
2227 Add pkg-config files for e2fsprogs's libraries.
2228
2229 Fix "make uninstall" to so that it removes everything that is installed.
2230
2231 Add a configure --enable-maintainer-mode option which enables the
2232 makefile rules to rebuild the configure script from configure.in, and
2233 to reubuild the .gmo files in po directory.
2234
2235 Drop the sparc assembly bitwise operations; it's less efficient
2236 than the GCC 3.4 compile code and triggers compiler warnings on
2237 sparc64.  Thanks to Matthias Andree for his analysis and suggestions.
2238 (Addresses Debian Bug #232326)
2239
2240
2241 E2fsprogs 1.35 (February 28, 2004) 
2242 ==================================
2243
2244 E2fsck has a new -k option, which in conjunction with the -c options,
2245 preserves the existing badblocks list.
2246
2247 Cleaned up e2fsck's preen-mode messages during the passes 1b, 1c, and 1d.
2248
2249 E2fsprogs will now deal correctly with symlinks that contain
2250 extended attribute information, which can be created using SE Linux.
2251 (Addresses Debian Bug #232328)
2252                                                                                
2253 Remove a double longjump into an invalid stack frame bug in e2fsck.
2254 (This was during an abort sequence, which normally worked on Linux and
2255 caused a core dump on other operating systems.)
2256
2257 Fix NLS bug in e2fsck, by avoiding trying to expand an empty string
2258 (the NLS library will replace "" with the .po header information).
2259  
2260 Fix a bug in mke2fs which caused -T largefile or -T largefile4 to core
2261 dump due to a division by zero error.  (Addresses Debian bug #207082)
2262
2263 Fixed a bug in e2fsck which caused it to incorrectly fix a filesystem
2264 when reconnecting a directory requires creating a lost+found
2265 directory.  (Addresses Debian bug #219640).
2266
2267 Fixed a bug where e2fsck would bomb out if a journal needed to be
2268 replayed when using an alternate superblock.
2269  
2270 E2fsck will give an extra grace period before actually forcing a check
2271 if the laptop is running on battery.  The next time fsck runs while
2272 the system is on the AC mains, or after the grace period is exceeded,
2273 the filesystem will be checked.  (Addresses Debian bug #205177)
2274
2275 E2fsck will inform the user when there are 5 or fewer mounts before a
2276 filesystem check will be forced.  (Addresses Debian bug #157194)
2277
2278 Fix e2fsck's handling of corrupted indirect blocks in the bad block.
2279 We now correctly handle the case where there is an overlap between a
2280 block group descriptor or a superblock and a bad block indirect block.
2281 In the case where the indirect block is corrupted, we now suggest
2282 "e2fsck -c".
2283
2284 Fix byte swap bugs in e2fsck that caused the journal backup location 
2285 in the superblock and symlinks created by SE Linux to be cleared
2286 by e2fsck on big-endian machines.  (Addresses Debian bug #228723)
2287
2288 E2fsck -c now replaces the current list of bad blocks with the ones
2289 found by badblocks.
2290
2291 Fix bugs in e2fsck and tune2fs which could cause a core dump if a
2292 non-existent LABEL or UUID specifier is to e2fsck or tune2fs.
2293
2294 Fix a potential bug in e2fsck which could cause it to core dump when
2295 trying to print the location of the backup superblock.
2296
2297 Protect against a potential core dump in e2fsck when printing a
2298 message about backup superblocks.
2299
2300 Add support for backing up the journal inode location in the
2301 superblock.  E2fsck will automatically save the journal information in
2302 the superblock if it is not there already, and will use it if the
2303 journal inode appears to be corrupted.  ext2fs_add_journal_inode()
2304 will also save the backup information, so that new filesystems created
2305 by mke2fs and filesystems that have journals added via tune2fs will
2306 also have journal location written to the superblock as well.
2307 Debugfs's logdump command has been enhanced so that it can use the
2308 journal information in the superblock.
2309
2310 E2fsck will now update all superblocks when moving the journal inode.
2311   
2312 Shrink the size of the e2fsck executable by moving some initialized
2313 variables to the BSS segment.
2314
2315 E2fsck will avoid printing the ^A and ^B characters which bracket the
2316 progress bar when stdout and stdin are a tty device instead of a pipe
2317 to another program.  (Addresses Debian bug #204137)
2318
2319 Debugfs's mkdir command will automatically expand the directory if
2320 necessary.  (Addresses Debian Bug: #217892)
2321  
2322 Fixed a bug in debugfs so that copying a file from /dev/null uses the
2323 correct mode bits.  (Addresses Debian Bug: #217456)
2324  
2325 If the environment variables DEBUFS_PAGER and PAGER are not set,
2326 debugfs now searches for the appropriate pager to use, beginning with
2327 /usr/bin/pager, and then falling back to 'more' and 'less'.
2328 (Addresses Debian bug #221977)
2329
2330 Debugfs will now support 2.6 device numbers where the major or minor
2331 number may be larger than 255.  (Addresses Sourceforge bug #865289)
2332  
2333 Fix debugging printf in resize2fs.  (Addresses Debian Bug #271605)
2334
2335 Chattr now stops processing options when it sees '--'.  (Addresses
2336 Debian bug #225188)
2337
2338 Fix regression tests so they work correctly when e2fsprogs is compiled
2339 with configure --disable-htree.
2340
2341 Fix bug in uuid library when there is no network card and the library
2342 is generating a time-based uuid.  The random MAC address was not
2343 correctly generated to be a multicast address.
2344  
2345 Add compile_et extensions from Heimdall that were missed the first time
2346 around.
2347
2348 Fix bug in badblocks when using O_DIRECT; we need to make sure that
2349 we're reading from an offset which is page aligned.  For read-only and
2350 read-write tests, we try to recover after an error so that we can
2351 continue reading on page-aligned boundaries.  (Addresses Debian Bug
2352 #203713)
2353   
2354 Badblocks now checks 64 blocks at a time instead of 16.  (Addresses
2355 Debian bug #232240)
2356  
2357 Updated and clarified various man pages.  (Addresses Debian Bug
2358 #206845, #222606, #214920, #232406)
2359
2360 Updated and fixed translations.   (Addresses Debian bugs #200086, #214633)
2361
2362 Fixed various Debian packaging issues (see debian/changelog).
2363
2364 Programmer's notes: 
2365 -------------------
2366
2367 Fixed a build problem so that e2fsprogs would compile with the
2368 --enable-profile option to configure selected.  (Addresses Sourceforge
2369 bug #811408)
2370  
2371 Fixed C++ problems with the ext2fs.h header.  (Addresses Red Hat
2372 Bugzilla Bug #112448)
2373                                                                                
2374 Centralize code which calculates the location of the superblock
2375 and block group descriptors so that it is in a single library routine.
2376
2377 Added two new functions, ext2fs_file_open2() and
2378 ext2fs_inode_io_intern2() which take a pointer to an inode structure.
2379
2380 Fix compile_et to output the correct prototype for
2381 initialize_xxx_err_table_r() in the header file.  (Addresses Debian
2382 bug #204332)
2383
2384 In the lib/et makefile, make sure com_err.info is deleted on "make clean".
2385   
2386 Fix 64-bit warnings in e2fsprogs pass1b by using inttypes.h if
2387 present.  This is for when we try stuffing an int into void * pointer.
2388
2389 Fix type-punning which can cause gcc 3.x to miscompile code by getting
2390 confused about pointer aliasing.  ext2fs_getmem(), ext2fs_free_mem(),
2391 and ext2fs_resize_mem() all now take a 'void *' instead of a 'void
2392 **'.  The EVMS code uses an ugly union approach since we don't want to
2393 modify the EVMS interfaces. 
2394
2395 Make sure all Makefiles use $(MAKE) rather than hardcoded "make", to
2396 aid build process on systems can use invoke GNU make as "gmake".
2397
2398 Added regression testing for mke2fs.
2399
2400 Fixed gcc -Wall nitpicks.
2401
2402 Fixed various compiler warnings.
2403
2404 Add portability fixes for FreeBSD and for using fsctl under Darwin to
2405 support ext2 ioctl's.
2406
2407
2408 E2fsprogs 1.34 (July 25, 2003)
2409 ===============================
2410
2411 Fixed a bug introduced in E2fsprogs 1.30 which caused fsck to spin in
2412 a tight loop while waiting for a child fsck to exit in some cases.
2413 This burns CPU times which slows down the low-level filesystem check.
2414
2415 Added code to mke2fs to assure that the default block size for a
2416 filesystem is at least as big as the sector size of the device, if it
2417 can be determined.
2418
2419 Changed mke2fs and resize2fs to round the default size of a filesystem
2420 to be an even multiple of the VM pagesize in order to avoid a Linux
2421 kernel bug introduced when the storage of the buffer cache was moved
2422 into the page cache.
2423
2424 Mke2fs will warn the user when creating a filesystem with journaling
2425 and a blocksize greater than 4096.  (Addresses Debian bug #193773)
2426
2427 Fixed a bug in resize2fs which caused it to fail on filesystems with a
2428 non-empty bad block list.  Resize2fs now discards any blocks on the
2429 badblock list which are no longer part of the filesystem as the result
2430 of a filesystem shrink.  (Note: this means that shrinking and then
2431 enlarging a filesystem is no longer a reversible operation;
2432 information about bad blocks in the part of the filesystem which is to
2433 be chopped off will be lost.)
2434
2435 Changed resize2fs so the user can use prefixes to specify the units of
2436 the new filesystem size (sectors, kilobytes, megabytes, or gigabytes),
2437 and to make the error and informational messages explicitly display
2438 the blocksize used by the filesystem, in order to avoid confusion.
2439 (Addresses Debian bug: #189814)
2440
2441 Added a new debugfs command, dump_unused, which dumps the contents of
2442 all unused blocks to stdout.  (Useful as an emergency try-to-find
2443 deleted data command.)
2444
2445 Added a new debugfs command, imap, which prints the location of a
2446 specified inode in the inode table.
2447
2448 Fixed a bug in the badblocks program which caused it to use one bit of
2449 randomness in its non-destructive read/write test, instead of using a
2450 full 8 bits of randomness.
2451
2452 Added a new option (-t) to badblocks, which allows the user to control
2453 the test pattern(s) used when checking a disk.
2454
2455 The blkid probe function now more correctly detects UDF filesystems.
2456
2457 Fixed a bug in the blkid library which caused it to not update its
2458 cache if a filesystem changes from having a label to not having a
2459 label.
2460
2461 Fixed a bug in the blkid library wihch could avoid an infinite loop
2462 in blkid_find_dev_with_tag() if /proc is not mounted and there the
2463 /etc/blkid.tab file has not yet been created.
2464
2465 Fixed the badblocks program so that the destructive read/write test
2466 honors the -c option, and to use O_DIRECT when possible to avoid
2467 thrashing the system block buffer cache.
2468
2469 Fixed various NLS issues.
2470  - Added Czech and Swedish translations
2471  - Removed testing NYC translation
2472  - Fixed NLS support for message abbrevations in e2fsck
2473  - Remove de-utf.po, since we shouldn't have two versions using different
2474         charset encodings.
2475  - Used ngettext() (abbreivated with the macro P_(str1, str2, n)) to 
2476         simplify the statistics reporting in e2fsck.
2477
2478 Changed configure.in so that its defaults for *BSD systems no longer
2479 build an fsck wrapper, and not to install in /usr/local by default.
2480
2481 Fixed some minor spelling errors/typo's in e2fsck and the configure
2482 script.
2483
2484 Fixed various Debian packaging issues (see debian/changelog). 
2485
2486 Updated and clarified man pages.  (Addresses Debian Bug #195616)
2487
2488 Programmer's notes: 
2489 -------------------
2490
2491 Fix gcc -Wall nitpicks.
2492
2493 Updated gettext implementation used by e2fsprogs to 0.11.5, and enable
2494 NLS support by default.  (Added partial workaround for gettext/Darwin
2495 incompatibility problems.)
2496
2497 Added full MIT KRB5 and Himdall compaibility support to the com_err
2498 library and the compile_et program.  (Addresses Debian bug #191900)
2499
2500 Added the blkid_known_fstype() function to the blkid library, which
2501 returns true if it is passed a filesystem type which is recognized by
2502 the blkid probing functions.
2503
2504 Improved the documentation for the blkid library.
2505
2506 Added the ext2fs_get_device_sectsize() function the the ext2fs library, which
2507 returns the hardware sector size of a device, if it is available.
2508
2509 Added a dependency in the blkid library's .so file to the uuid
2510 library, since the former uses the latter.  (Addresses Debian bug
2511 #194094)
2512
2513 Added --with-diet-libc and --disable-evms to the configure script.
2514
2515 Fixed a minor memory leak in the badblocks program.
2516
2517 Fixed a portability problem in tune2fs --- not all systems have strptime().
2518
2519 Fixed a portability problem in debugfs with the use of getopt() more
2520 than once.  Old-style BSD, new-style BSD, and Linux C libraries all do
2521 things differently.
2522
2523 Add support Windows support to ext2fs_get_device_size().
2524
2525 Added (normally disabled) debugging code to the Unix I/O manager which
2526 causes it to disable all userspace caching if the NO_IO_CACHE is
2527 defined.
2528
2529 Changed the test I/O manager so it can always be linked into e2fsck,
2530 mke2fs, and tune2fs if enabled via --enable-test-io-debug to the
2531 configure script.  The test I/O manager will only print any debugging
2532 information if the TEST_IO_FLAGS or TEST_IO_BLOCK environment
2533 variables are set, which specifies which I/O operations are logged and
2534 a block number to watch, respectively.  The log messages are sent to
2535 stderr by default, unless a filename is specified via the
2536 TEST_IO_LOGFILE environment variable.
2537
2538
2539 E2fsprogs 1.33 (April 21, 2003)
2540 ===============================
2541
2542 Added a new utility program, logsave, which captures the output of a
2543 command in a log file, even if the containing directory hasn't been
2544 mounted yet (in which case the it saves the output in memory until it
2545 can write out the logfile).  This is useful for capturing the
2546 output of fsck during the boot sequence.
2547
2548 Fixed some portability problems that were causing problems under
2549 the Cygwin32 environment.
2550
2551 Mke2fs now interprets a negative number to the -b option as a minimum
2552 block size.
2553
2554 Fixed a bug in mke2fs which was incorrectly checking the argument to
2555 the -g option if the default block size was used.  (Addresses Debian
2556 bug #188319)
2557
2558 Fsck now explicitly ignores tmpfs and devpts, and it will complain if
2559 it can not find filesystem checkers for jfs, reseirfs, and xfs.
2560
2561 E2fsck now updates the global free block and inode counters from the
2562 block group specific counters quietly.  This is needed for an
2563 experimental patch which eliminates locking the entire filesystem when
2564 allocating blocks or inodes; if the filesystem is not unmounted
2565 cleanly, the global counts may not be accurate.
2566
2567 Imported bug fixes to the EVMS plugin from the EVMS 2.0 tree.  (EVMS
2568 2.0 is not yet supported; this only pulled in the bug fixes: fixed
2569 possible hangs caused by bugs in calling waitpid, and not setting the
2570 pipe to non-blocking mode; also fixed a file descriptor leak; made
2571 sure all functions call log entry/exit functions.)
2572
2573 Badblocks now flushes its output file as bad blocks are discovered.
2574
2575 The uuid library is now more paranoid about assuming the correctness
2576 of the /dev/random device; it mixes in a stream of bytes from
2577 random/srandom, just in case.
2578
2579 Update Debian files to reflect the fact that I am now the Debian
2580 maintainer of e2fsprogs.  Other various Debian-specific packaging
2581 cleanups.
2582
2583 Move the source tarball generation functions from the top-level
2584 makefile to the util/gen-tarball script.  
2585
2586 Updated the Turkish .po translation file.
2587
2588 Added Heimdal and MIT krb5 extensions to the com_err library to make
2589 it more compatible with com_err libraries from those distributions.
2590
2591 Changed dumpe2fs to always display the superblock fields relating to
2592 the journalling and/or directory indexing feature even if those
2593 features are not enabled.
2594
2595 Updated and clarify copyright statement vis-a-vis alpha releases of
2596 e2fsprogs.
2597
2598 The ss library will now try to dynamically link to the readline
2599 library and use it if it is present in the system.  This means that
2600 the debugfs program now has line editing and history features.  The
2601 SS_READLINE_PATH environment variable is used to find a readline or
2602 readline-compatible library.
2603
2604 E2fsck now finds most duplicate filenames (all when rebuilding all
2605 directories via the -D option) and offers to delete or rename
2606 duplicate filenames/directory entries.  (Addresses Debian Bug #176814).
2607
2608 Fix bug in e2image.  When writing out a raw image file, include data
2609 blocks from symlinks that do not store the symlink within the inode.
2610
2611 Fix bug in resize2fs which incorrectly moved the block and inode
2612 bitmaps for sparse superblock filesystems and incorrectly marked
2613 blocks as in use.  (Addresses Debian bug #174766)
2614  
2615 Added a new shared library, the blkid library, which efficiently
2616 allows fsck, mke2fs, e2fsck, and tune2fs to be able to look up LABEL
2617 and UUID filesystem specifiers without needing to search all of the
2618 devices in the system.  Instead, the device is looked up in a cache
2619 file, and then verified to make sure the blkid cache is correct.
2620
2621 Tune2fs and e2label will accept LABEL=xxx and UID=yyy specifiers for
2622 the device name, using the blkid library.  (Addresses Debian bugs
2623 #166048, #179671)
2624
2625 Fsck now supports backslash escapes in /etc/fstab so that \040 can be
2626 used for spaces in device labels.
2627
2628 Removed 32-bit limitations for debugfs's dump command.
2629
2630 If the user specifies a large number of inodes, Mke2fs will
2631 automatically adjust the number of blocks per group to find a valid
2632 set of filesystem parameters.
2633
2634 Add workaround to detect broken MD devices where when some of the
2635 underlying devices are marked read-only, writes to the MD device are
2636 silently dropped.  E2fsck will detect if there is an attempt to run
2637 the journal twice, and abort with an error if this is the case.
2638 (Addresses IBM Bugzilla bug #1226)
2639
2640 E2fsck will print an error if more than one of the -p/-a, -n or -y
2641 options are specified.
2642
2643 E2fsck will fix HTREE corruptions in preen mode, without stopping the
2644 boot process.  This is needed because the 2.4 ext2 filesystem
2645 accidentally had the INDEX_FL backwards compatibility code removed.
2646
2647 Mke2fs no longer creates filesystems with the dir_index flag set by
2648 default; the user has to specifically request it.
2649
2650 Update and clarified various man pages. (Addresses Debian bugs
2651 #173612, #175233, #175113, and #170497, #185945, #188318)
2652
2653 Created man page for the mk_cmds program (from the libss library).
2654
2655 Programmer's notes: 
2656 -------------------
2657
2658 Fix various gcc -Wall nits.
2659
2660 Fixed a lot of portability problems that caused e2fsprogs not to build
2661 successfully under Solaris and Apple/Darwin.
2662
2663 Fixed a Makefile dependency to allow building e2fsprogs using parallel
2664 make jobs.
2665
2666 Changes to create a subset distribution which consists only of the
2667 et, ss, uuid, and blkid libraries.  The configure script and top-level
2668 makefile were changed to support working with a subset distribution.
2669
2670 Removed EXT2_FEATURE_RO_COMPAT_BTREE_DIR mention of since it's not
2671 actually used, and might people who are looking for
2672 EXT2_FEATURE_COMPAT_DIR_INDEX, which is in use.
2673
2674 Updated debian files to fix a number of Lintian warnings.
2675
2676 Updated config.guess and config.sub with newer versions from the FSF.
2677
2678 Removed unnecessary libraries from being linked into the fsck, lsattr, 
2679 chattr, and blkid executables.
2680
2681 E2fsprogs 1.32 (Nomvember 9, 2002)
2682 ==================================
2683
2684 Fixed a bug in the Unix I/O routines which caused needless writebacks
2685 of clean blocks from the unix_io cache (they were erroneously marked
2686 as being dirty, so they were getting written back to disk before
2687 getting evicted from the disk cache).  This was harmless, but it
2688 significantly slowed down e2fsck.
2689
2690 Made some other minor optimizations to the Unix I/O routines to save a
2691 small amount of CPU time.
2692
2693 Updated internationalization files.
2694
2695
2696 E2fsprogs 1.31 (Nomvember 8, 2002)
2697 ==================================
2698
2699 Update EVMS ext2fsim plugin with EVMS 1.2.  (We still support
2700 compiling the fsim plugin with EVMS 1.0 and 1.1.)  Add better error
2701 handling for child process that die unexpectly.  Add a hack to force
2702 mkfs to create filesystems that won't cause problems with hardware
2703 that has 2k or 4k minimum blocksize requirements.  Read from child
2704 processes in non-blocking mode, so that the GUI continues to update.
2705
2706 Fix e2fsck so that it returns the appropriate exit code when the root
2707 filesystem has been changed, so that system's rc scripts will be told that 
2708 the system needs to be rebooted.
2709
2710 Fix a bug in ext2fs_flush/ext2fs_close; when the MASTER_SB_ONLY flag
2711 was set, some of the descriptor blocks that should have been written
2712 out were getting skipped.
2713
2714 Changed e2fsck to force out changes to the backup copies of the
2715 superblock and block group descriptors when important changes are made
2716 to those data structures.
2717
2718 Fix a bug where e2fsck could erroneously mark a filesystem as being
2719 clean if a check of dirty filesystem is interrupted with a ^C.  (Bug
2720 introduced in e2fsprogs 1.28.)
2721
2722 If journal debuging is enabled using --enable-jbd-debug, the debugging
2723 level is now set via the E2FSCK_JBD_DEBUG environment variable.
2724
2725 If byteswapping support is disabled using configure --disable-swapfs,
2726 skip the tests which depend on byte-swapping, so that "make check"
2727 won't bomb out.
2728
2729 Lshattr will now display the indexed directory flag.  Also, some of
2730 the more esoteric compression flags are supressed unless compression
2731 support has been enabled.
2732
2733 Update man pages.
2734
2735
2736 E2fsprogs 1.30 (October 31, 2002)
2737 =================================
2738
2739 When resizing a filesystem, and inodes need to moved, resize2fs will
2740 update the inode's ctime field, and the mtime field of the containing
2741 directories, so that incremental backups using dump/restore will work
2742 correctly.
2743
2744 In order to avoid spurious errors, e2fsck wil check the last
2745 superblock write time to determine whether or not it can safely use
2746 the LOW_DTIME checks to determine if there are inodes on the orphan
2747 inode linked list that had somehow gotten disconnected.  (Addresses
2748 Sourceforge bug #620980)
2749
2750 Partition in /proc/partitions that being with the string "lvm" are
2751 considered real partitions even if they do not end with a number.
2752
2753 Fixed a bug in the the uuid generation function, where if /dev/urandom
2754 is not present, but /dev/random is, and there isn't sufficient
2755 entropy, the get_random_byte function could spin a loop forever.
2756
2757 E2fsck, mke2fs, etc. will now reliably notice when image files are
2758 mounted using the loopback interface.  (Addresses Sourceforge bug
2759 #619119)
2760
2761 When flushing buffers (as is done by badblocks, for example) check to
2762 see if the BLKFLSBUF ioctl succeeds, and if so, avoid using the
2763 FDFLUSH ioctl which causes the MD device driver which causes confusing
2764 syslog messages about obselete ioctl messages.  (Addresses Sourceforge
2765 bug #545832).
2766
2767 Debugfs's write command now checks to see if the destination filename
2768 exists before creating it.  (Addresses Sourceforge bug #478195.)
2769
2770 When installing man pages, search for compressed man pages using all
2771 commonly used compression extensions (i.e., .Z, .gz, .bz2, etc.)
2772
2773 Fixed a bug in fsck where multiple filesystems specified on the
2774 command were not being checked in parallel due to a logic bug
2775 introduced to support the FSCK_MAX_INST environment variable.
2776
2777 We have added a new superblock field, s_mkfs_time, which indicates
2778 when a filesystem was created.  It is set via mke2fs, and printed out
2779 by dumpe2fs, but is not actually touched by the kernel.
2780
2781 Dumpe2fs has been made more robust by not aborting if there is an
2782 error reading the block/inode bitmaps; instead it will still print out
2783 the location of the block/inode bitmaps and inode table.
2784
2785 Add support for the an alternative block group descriptor layout which
2786 allows for on-line resizing without needing to prepare the filesystem
2787 in advance.  (This is the incomat feature flag meta_bg.)
2788
2789 Add support for storing default mount options in the superblock, so
2790 that the filesystem can be mounted with specific mount options without
2791 needing to specify them on the mount command line or in the /etc/fstab
2792 file.
2793
2794 Add support for a new inode flag, which is to be used for indicating
2795 the top of directory hierarchies for the Orlov block allocator.
2796
2797 Fix e2fsck so that if it creates the lost+found directory, it does so
2798 with the more apporpriate permissions of 0700.  Also change
2799 mklost+found so that it also creates the directory 0700.
2800
2801 Fixed format bug in e2fsck if NLS is in use.
2802   
2803 Add a German translation for e2fsprogs's NLS support.
2804
2805 Fixed e2fsck so that it more handles BAD_BLOCK_IN_INODE_TABLE even at
2806 the beginning of the inode table.  This won't matter much, since if
2807 there is a bad block at the beginning of the inode table, the root
2808 directory won't be available.  But at least e2fsck won't crash in this
2809 case.
2810
2811 Fixed endian problems in the htree code for e2fsck and debugfs.
2812   
2813 When byte-swapping a filesystem on a PPC architecture, byte-swap the
2814 bitmaps since the historical big-endian ext2 variant had byte-swapped
2815 bitmaps, and the ext2fs library assumes this.  This fixes the
2816 regression test suite on PPC machines.
2817
2818 Fix e2image so that it handles a bad block in the inode table
2819 appropriately.
2820
2821 E2fsck now uses a more sophisticated algorithm to salvage corrupted
2822 directories that recovers more information in the corrupted directory
2823 block.
2824
2825 E2fsck now performs additional consistency checks on indexed (HTREE)
2826 directories.
2827
2828 Fix bug where efsck might get confused about whether a completely
2829 empty directory block is an empty leaf block or an interior htree
2830 node.  This could cause e2fsck to get confused into think that a valid
2831 indexed directory was corrupted.
2832
2833 E2fsck no longer creates an empty directory entry at the end of a
2834 directory block when optimizing a directory.  This would cause some
2835 earlier versions of the dxdir kernel code to corrupt the directory
2836 when attempting to split a node containing an empty directory entry.
2837
2838 E2fsck could sometimes in rare circumstances leave the indexed flag
2839 set after a small directory was optimized by compressing it instead of
2840 indexing it.  (This should never happen in real life, since
2841 directories that small wouldn't have been indexed, but better safe
2842 than sorry.)
2843
2844 E2fsck now only updates the master superblock in all cases.  This
2845 slightly shortens its run time.
2846
2847 Ext2ed can deal with directory entries of length 0; previously it
2848 would get stuck in an infinite loop.
2849
2850 Fsck now has support for reiserfs volumes when parsing LABEL= and UUID=
2851 specifiers.  (Sourceforge patch #613447)
2852
2853 Badblocks will now work correctly on read-only devices such as
2854 CD-ROM's.  (Sourceforge patch #600451)
2855
2856 Updated and clarified man pages.  (Addresses Debian bug #167108)
2857
2858
2859 E2fsprogs 1.29 (September 24, 2002)
2860 ===================================
2861
2862 Fixed a bug in e2fsck which could corrupt a directory when optimizing
2863 it (via the -D option) or rebuiliding the hash tree index with a 1 in
2864 512 probability, due to a fence post error.
2865
2866 Fixed a bug in the LVM support code which caused LABEL='xxx' not to
2867 work correctly.
2868
2869 Mke2fs now enables the directory indexing flag by default.  (Since
2870 this is a compatible feature flag, it's safe to do so.)
2871
2872 Tune2fs will support setting the directory indexing feature flag.  It
2873 will automatically set up the default hash algorithm and hash seed
2874 fields in the superblock.
2875
2876 If the bone-headed user enters the root filesystem twice in
2877 /etc/fstab, the -R option which skips the root filesystem will skip
2878 all of them.  (Addresses Debian bug #159423).  Note!  This is not a
2879 precedent for dealing intelligently with any other kind of doubled
2880 entry in /etc/fstab!
2881
2882
2883 Programmer's notes: 
2884 -------------------
2885
2886 Removed perror declaration in lib/et/internal.h.  All modern systems
2887 can be expected to define perror() these days.  Besides, the lib/et
2888 code wasn't using perror at all anyway.  :-)
2889
2890
2891 E2fsprogs 1.28 (August 31, 2002)
2892 ================================
2893
2894 Add support for the Hashed-Tree Directory Indexing to e2fsck.  Support
2895 for setting the htree flag is not included yet, although it can be
2896 manually turned on via the debugfs program.
2897
2898 Clarified e2fsck error message which is printed when it cannot find
2899 sufficient contiguous block when relcating filesystem metadata.
2900
2901 Added support for building an EVMS plugin module for ext2/3.  This
2902 module is substantially the same as the EVMS module shipping with EVMS
2903 1.1, with one or two bugfixes.  E2fsprogs can also build this plugin
2904 for use with EVMS 1.0 (which did not include the ext2 plugin module),
2905 if the configure --enable-old-evms flag is given.
2906
2907 Fsck will search through EVMS volumes when trying to resolve
2908 filesystem specifications such as LABEL=xxx or UUID=xxx.
2909   
2910 Added a new utility program, /sbin/findfs, which will return
2911 filesystem specifications such as LABEL=xxx or UUID=xxx, and prints
2912 the device name.
2913
2914 Update and clarified various man pages. (addresses Debian Bug #145044,
2915 #146437, #131350, #151990, #144621, #141938)
2916
2917 If there are no filesystems specified on fsck's command line, fsck now
2918 treat that as if the -As options were given.  Previously it would
2919 simply do nothing.  (Addresses Debian Bug #153102)
2920
2921 Mke2fs no longer treats a failure to be able to clear the MD signature
2922 at the end of the filesystem as a fatal error.  (Addresses Debian Bug
2923 #155007)
2924
2925 The e2p library functions (which are used by lsattr and chattr) now
2926 double check to make sure the file is a regular file or directory
2927 before attempting to use the ext2 ioctls.  Some device drivers
2928 unfortunately respond to the ext2 ioctl's with unknown behaviour.
2929 (Addresses Debian Bug #152029).
2930
2931 The extended attribute handling has been updated to correspond with
2932 the latest V2 bestbits ACL code.
2933
2934 Fixed bug in e2fsck which caused it to not clear the dtime field when
2935 processing truncated inodes on the orphan list.  This could cause data
2936 loss(!) if a filesystem is rebooted before a truncate has been
2937 committed.
2938
2939 E2fsck now uses red/black trees in pass1b, which removes some O(n**2)
2940 algorithms.  This makes e2fsck much faster in the case of severely
2941 corrupted filesystems where a large number of blocks are claimed by a
2942 large number of inodes.  (Thanks to the 2.5 IDE device driver for
2943 inspiring this work.)
2944
2945 Resize2fs has been significantly sped up when shrinking and expanding
2946 a filesystem by a very small number of blocks (for example, when EVMS
2947 is converting a partition to be an EVMS legacy volume).
2948
2949 Added a new option to e2fsck, -D, which will optimize or compress all
2950 of the directories in the filesystem.
2951
2952 E2fsck now catches SIGINT and SIGTERM to make sure it will can
2953 properly clean up and only exit at safe points.  Fsck will pass
2954 SIGINT/SIGTERM to its child processes, and wait until they have all
2955 exited before it exits.
2956
2957 The uuid parsing code in the uuid library now properly complains when
2958 an illegally formated uuid is presented to it.  (Addresses Debian bug
2959 #152891)
2960
2961 Restrict use of the 2.4 setrlimit ABI f*ckup to kernels between 2.4.10
2962 and 2.4.17, since the workaround can cause problems when using a 2.4
2963 kernel with an old version of glibc built with the 2.2 headers.
2964
2965 Fixed a bug in mke2fs where it wasn't properly clearing the initial
2966 superblock used by other filesystems.  (Addresses Debian bug #147256.)
2967
2968 Added support for the synchronous directory feature written by Andrew
2969 Morton.
2970
2971 The debugfs program can delete directories using the rmdir command.
2972
2973 Add support for 8k and 16k filesystems (for systems with page sizes
2974 that are greater or equal to 8k or 16k, respectively).  Note that
2975 these filesystems can not be mounted on x86 systems, or other systems
2976 with only 4k page sizes, due to limitations in the current Linux VM
2977 code.
2978
2979 Resize2fs requires that the filesystem state be valid and have no
2980 errors; otherwise, e2fsck -f must be run first.  (Previously it simply
2981 required that the last fsck time be greater than the last mount time.)
2982
2983 Configure now defaults the man pages directory to /usr/share/man on
2984 Linux systems.
2985
2986 E2fsck now offers to truncate inodes which contain too many blocks (so
2987 that i_blocks would overflow.  Also fixed handling of large sparse
2988 files.
2989
2990 E2fsck now more completely checks for symlink validity, including
2991 requiring NULL termination and length checks.
2992
2993 E2fsck will offer to try forcing a disk write to remap a bad block
2994 after finding a read error when reading a filesystem metadata block.
2995
2996 Fixed a bug in debugfs which caused the -b and -s options to crash
2997 debugfs, as well as breaking the testb, setb, and clearb functions.
2998
2999 Added a bmap command to debugfs which calculates the logical to
3000 physical block mapping for a particular inode.
3001
3002 Fixed a bug in code which checked to see if a device was mounted which
3003 sometimes (rarely) failed in the case of a plain file.
3004
3005 Fixed a bug in resize2fs where when it reported an error, it would
3006 print a message erroneously indicating that the filesystem had been
3007 resized before it aborted.
3008
3009 When resizing a plain file which is smaller than the requested size,
3010 resize2fs will attempt to extended the file so that programs like
3011 e2fsck will not complain that the file is too small.
3012
3013 Resize2fs will print the actual new size of the filesystem when it is
3014 finished resizing.
3015
3016 Fixed a bug in debugfs where "ls -l" would report incorrectl file type
3017 information on big-endian systems.
3018
3019
3020 Programmer's notes:
3021 -------------------
3022
3023 Fixed collisions with C++ reserved words.
3024
3025 Added portability fixes for building e2fsprogs on the HURD and AIX.
3026
3027 Added the ext2ed program for creation of test cases.  (ext2ed has many
3028 limitations and bugs which make it unsuitable for production use.)
3029
3030 The ext2fs_read_dir_block2 and ext2fs_write_dir_block now take a new
3031 flag, EXT2_DIRBLOCK_V2_STRUCT, which will will reverse when the
3032 name_len field is byte swampped on big-endian machines, since in the
3033 V2 structure, name_len is a char field which is doesn't need to be
3034 byte swapped --- except if an old-style kernel had byte-swapped the
3035 name_len field as part of the V1 structure.
3036   
3037
3038 E2fsprogs 1.27 (March 8, 2002)
3039 ==============================
3040
3041 The warning messages for mke2fs now go to standard error.
3042
3043 Fixed to make sure "make check" runs all of the test programs with
3044 LD_LIBRARY_PATH set, so that we test the libraries in the build tree.
3045
3046 The mke2fs program checks the boot sector for the BSD disk label, and
3047 avoids erasing it if it is there.
3048
3049 Fixed a bug in e2fsck which caused it to core dump if the journal
3050 inode was missing when it was supposed to be there.
3051
3052 E2fsck now prints ranges in pass 5 when printing deltas for the block
3053 and inode bitmaps.
3054
3055 Debugfs's "ls -l" command now will print out the file type information
3056 in the directory entry.
3057
3058 Create man pages and hard links for fsck.ext3 and mkfs.ext3.  If
3059 mke2fs is invoked as mkfs.ext3, create the filesystem with a journal.
3060
3061 Debugfs can now examine the experimental directory indexing
3062 information.
3063
3064 Fixed bug in debugfs which caused it to core dump if modify_inode is
3065 called without an open filesystem.
3066
3067 The debugfs lsdel command now runs its output through a pager first.
3068
3069 When installing manual pages, remove the compressed manual pages first.
3070
3071 Synchronized with Debian's packaging information for e2fsprogs-1.26-1.
3072
3073 Fix the 2.4 resource limitation workaround introduced in 1.26 which
3074 actually broke things on mips32, sparc32, and Alpha platforms.
3075
3076 Updated the I18N code so that calls to setlocate(LC_CTYPE, 0) are made
3077 (which is required by the newer libintl libraries).
3078
3079 Programmer's notes:
3080 -------------------
3081
3082 Fixed various gcc -Wall complaints.
3083
3084 Fixed a few memory leaks in the e2fsck journaling code, and in the
3085 ismounted code checking for a swap device.
3086
3087 Add new inode I/O abstraction interface which exports an inode as
3088 an I/O object.
3089   
3090 Exported ext2_file_flush as a public interface.
3091   
3092 In ext2_file_write, we now mark the buffer void * argument as a const, since ext2_file_write doesn't modify the buffer.
3093
3094 Lots of small random portability fixes to make e2fsprogs build under
3095 AIX --- even without the 5L compatibility toolkit, and even using the
3096 uber-crippled AIX native C compiler.
3097
3098
3099 E2fsprogs 1.26 (February 3, 2002)
3100 =================================
3101
3102 Dumpe2fs will keep going now if the bad block inode can't be read.
3103 (Previously it stopped with a fatal error.)
3104
3105 E2fsck will now give an opportunity to run the journal even if the
3106 recovery flag is not set.  This is the default behaviour if e2fsck is
3107 using a backup superblock, since the needs_recovery flag will never be
3108 set in the backup superblock copies.
3109
3110 E2fsck now automatically finds the backup superblock/group descriptors
3111 even when the primary superblock is completely destroyed for 2k and 4k
3112 filesystems.  (Previously it just guessed/assumed that we were dealing
3113 with a 1k filesystem in that case, and users had to manually specify
3114 the backup superblock number.)
3115
3116 Fixed a bug in e2fsck where it dereferences a null pointer when there
3117 is a problem opening a filesystem in preen mode.
3118
3119 E2fsck now handles external journals correctly; previously it trashed
3120 the external journal device if the journal needed to be replayed.
3121
3122 Work around ulimit incompatibility problem caused by recent 2.4
3123 kernels; the unix IO module will automatically try to set any resource
3124 limits to be infinite on startup.
3125
3126 Fixed a bug in e2fsck where it wasn't allocating a new block or inode
3127 bitmap if it wasn't present and the blocksize was 2k or 4k.
3128  (Addresses Debian Bug #116975)
3129
3130 E2fsck will check and fix botched ext3 V1 to V2 superblock updates by
3131 clearing the new V2 fields if they do not make sense or if the ext3
3132 superblock is version 1 superblock.
3133
3134 E2fsck will automatically relocate the ext3 journal from a visible
3135 file (i.e., /.journal) to an hidden inode if the filesystem has been
3136 opened read/write.  This allows the users to add a journal while the
3137 filesystem is mounted, but the next time the system is rebooted, the
3138 journal file will disappear.  This avoids problems with backups,
3139 stupid operators with superuser bits, etc.
3140
3141 Fix a bug in fsck where it would not support a filesystem type of
3142 "auto" if the device was specified in terms of LABEL=xxx or UUID=xxx.
3143
3144 Fsck now supports fstab entries of the form "ext3,ext2".  It will also
3145 automatically identify reiserfs filesystems.
3146
3147 The number of processes spawned by fsck can now be limited using the
3148 FSCK_MAX_INST environment variable.
3149
3150 Fsck now searchs the LVM proc hierarchy to find logical volumes which
3151 should be searched for  UUID and label information.
3152
3153 Work around a bug in 2.4.10+ kernels by trying to unset the filesize
3154 limit if at all possible, when opening a block device.  (The filesize
3155 limit shouldn't be applied against writes to a block device.)
3156
3157 In mke2fs and e2fsck, specifying the -c option twice will now do
3158 a read/write test on the disk.  Update the man pages to encourage
3159 using the -c option, and to discouraging running badblocks separately,
3160 since users tend to forget to set the blocksize when running 
3161 badblocks.
3162
3163 Mke2fs now automatically clears the immutable attribute on a
3164 pre-existing .journal file left over from a previous failed attempt to
3165 add a journal to an alreadyy-mounted filesystem.
3166
3167 Fixed mke2fs's exit codes to consistently indicate when the mke2fs
3168 operation failed.
3169
3170 Mke2fs now creates the lost+found directory with permissions of 0700,
3171 so that files that had previously lived in protected directory are
3172 safe if they get dropped in lost+found and the system administrator
3173 doesn't deal with immediately.  (Addresses Debian #bug 118443)
3174
3175 Mke2fs and e2fsck (and all programs that use the
3176 ext2fs_check_if_mounted function) will now properly identify that a
3177 device is mounted, even in cases where devfs has confused things with
3178 multiple devices names with the same identity, or if a dim-witted
3179 system administrator has done something stupid like creating device
3180 file aliases in their home directory.  Also now checks for swap devices
3181 by using /proc/swaps.  (Addresses Debian bug #106622)
3182
3183 Added a new option (-T) to tune2fs which sets the time a filesystem
3184 was last checked.
3185
3186 Speed up e2image when creating sparse raw image files by optimizing
3187 away excess lseek() system calls.
3188
3189 Fix support of large (> 2GB) files when used as a filesystem in
3190 mke2fs, tune2fs, debugfs, and findsuper.
3191
3192 Debugfs's stat and icheck commands now properly deals with large (>
3193 2GB) files.
3194
3195 Debugfs's set_super_value command now prints out the list of valid
3196 superblock fields which can be set using the command.
3197
3198 Debugfs's rm and kill_file command now updates the superblock free block
3199 and inode counts, thus keeping the filesystem consistent.
3200
3201 Debugfs's lsdel command now takes an optional argument which allows
3202 the user to only see the most recently deleted files.
3203
3204 A new command (undel) was added to debugfs which automates
3205 undeleting a deleted inode and linking it back to a directory.
3206
3207 Debugfs's ls command now takes a new option, -d, which lists 
3208 deleted directory entries.
3209
3210 Debugfs's testb, freeb, setb, and find_free_block commands now take an
3211 optional count argument.
3212
3213 Add support for a new ext2 file attribute, EXT2_NOTAIL_FL, which will
3214 be used to signal that a particular inode should not be eligible for
3215 tail-merging --- this is needed for programs like LILO.
3216
3217 The findsuper (an unreleased, uninstalled utility program) has been
3218 improved to add extra validity checks and to add a progress meter.
3219 (It is still an unsupported program; the officially supported way to
3220 recover from a trashed partition table is to use gpart; findsuper is
3221 for wizards only.  :-)
3222
3223 Debugfs was fixed to compile with "configure --disable-swapfs".
3224
3225 Cleaned up various manual pages.   (Addresses Debian bug #119624, #120171)
3226
3227 Added new translation file for Turkish.
3228
3229 Programmer's notes:
3230 -------------------
3231
3232 Fix general gcc -Wall complaints.
3233
3234 E2fsprogs (mostly) works with the dietlibc.
3235
3236 The programming texinfo file has been expanded to include description
3237 of additional libext2fs functions.  (Still not compeltely done, but a
3238 lot of the more important functions have been documented.)
3239
3240 Added a umask structure to struct_ext2_filsys, which currently only
3241 modifies the behaviour of ext2fs_mkdir(), but if we add any file
3242 creation functions to libext2fs, we should also make sure they respect
3243 the umask setting.
3244
3245 The build-rpm script was fixed to be a bit more safe.
3246
3247 The tests' Makefile now has a way of automating test case creation 
3248 for e2fsck, using "make testnew".
3249
3250 Created a new function, ext2fs_dir_iterate2 which passes more
3251 information to the callback function (identical to the one used by
3252 ext2fs_dblist_dir_iterate).  The directory iterator functions take a
3253 new flag, DIRENT_FLAG_INCLUDE_REMOVED, which will return deleted
3254 directory entries.  If the directory entry is deleted, the callback
3255 function will be called with the entry paraemter set to
3256 DIRENT_DELETED_FILE.
3257   
3258 Added new functions, ext2fs_inode_alloc_stats and
3259 ext2fs_block_alloc_stats, which takes updates block/inode allocation
3260 statistics in the bitmaps, block group descriptors, and superblock
3261 when inodes or blocks are allocated or deallocated.
3262
3263
3264 E2fsprogs 1.25 (September 20, 2001)
3265 ===================================
3266
3267 This is primarily a bug-fix release; no new features were added, but
3268 there are a number of embarassing bug fixes and cleanups applied.
3269
3270 Fix a bug mke2fs which causes stack garbage to be written to disk when
3271 zapping disk sectors.  (This bug could cause mke2fs to core dump for
3272 some kernels, I suspect with security enhancement patches.)
3273
3274 Remove unneeded #include of <linux/config.h> which was breaking
3275 building e2fsprogs on the Hurd.  (Addresses Debian bug #112414.)
3276
3277 Updated tune2fs man page to reflect the fact that adding or removing a
3278 journal doesn't require running e2fsck.
3279
3280 Remove use of AC_REQUIRE from autoconf which had been used to prevent
3281 AC_CANONICAL_HOST from being called twice; unfortunately this causes
3282 recent autoconf to bomb out since they don't allow AC_REQUIRE to be
3283 used outside of autoconf macros.  Fortunately, it doesn't seem to be
3284 necessary any more, anyway.
3285
3286 E2fsck will now not fall back to an alternate superblock if the user
3287 specifies the superblock location explicitly on the command-line.
3288 This allows easier recovery from a situation where the primary
3289 superblock and block groups are slightly corrupted, but the backup
3290 superblocks are completely broken.  
3291
3292 Fix problem which caused compile_et and mk_cmds to blow up if
3293 e2fsprogs was in a directory with a pathname that contained spaces.
3294
3295 We are now more paranoid about checking the entry in /etc/mtab to make
3296 sure the filesystem is really mounted, since some broken distributions
3297 (read: Slackware) don't initialize /etc/mtab before checking non-root
3298 filesystems.  (Slackware also doesn't check the root filesystem
3299 separately, and reboot if the root filesystem had changes applied to
3300 it, which is dangerous and broken, but there's nothing I can do about
3301 that.)
3302
3303 Make UUID library C++ friendly by adding appropriate extern "C"
3304 declarations and using const in the function declarations.
3305
3306 Fix up the com_err texinfo file so that it can product a valid info
3307 file (previously, it could only be used to generate paper
3308 documentation using texinfo.tex).
3309
3310
3311 E2fsprogs 1.24a (September 2, 2001)
3312 ===================================
3313
3314 Fix brown-paper bug in mke2fs which caused it to segfault when
3315 printing the version string.
3316
3317
3318 E2fsprogs 1.24 (August 30, 2001)
3319 ================================
3320
3321 Revert the BLKGETSIZE64 support, since for some distributions, this
3322 ioctl has been used by an unofficial kernel patch to update the last
3323 sector on the disk, and this was causing disk corruption problems as a
3324 result.
3325
3326 Mke2fs is now more careful about zapping swap space signatures and
3327 other filesystem/raid superblock magic values so that programs like
3328 mount who try to use hueristics to determine the filesystem type of a
3329 partition are less likely to be confused.
3330
3331 E2fsck will no longer complain if the the mode of EXT2_RESIZE_INO is a
3332 regular file (since Andreas Dilger's on-line resizing tools will set
3333 its mode bits).
3334
3335 Fixed some minor texinfo, man pages nits for spelling errors,
3336 texinfo warnings, etc.  (Addresses Debian bug #110621.)
3337
3338 E2fsprogs program no longer print the filesystem version number
3339 (i.e. 0.5b), since it only confuses people and doesn't serve any real
3340 purpose.
3341
3342 E2fsck will once again compile under libc5, since it will supply its
3343 own version of strnlen if necesssary.
3344
3345 mke2fs and tune2fs will allow the use of UUID= or LABEL= specifiers
3346 when specifying the external journal device.  tune2fs will also search
3347 devices looking for the externla journal debice when removing.  
3348
3349 E2fsprogs 1.23 (August 15, 2001)
3350 ================================
3351
3352 Add initial support for extended attributes (EA); e2fsck will
3353 correctly handle a filesystem with EA's and check the EA blocks for
3354 corruptions.
3355
3356 E2fsck's symlink sanity checking has been cleaned up.  It now checks
3357 the i_size value of fast symlinks, and checks for immutable flags
3358 being set of symlinks, etc.
3359
3360 E2fsck now offers to clear inodes which are special files that have a
3361 non-zero i_blocks or i_size field.  (The i_size field check was in the
3362 previous version of the code, but due to a bug it didn't offer to
3363 clear the inode unless i_size and i_size_high were both non-zero.)
3364
3365 E2image can now create "raw" image files, which only contain the
3366 filesystem metadata placed in a spare file so that e2fsck, dumpe2fs,
3367 debugfs, etc., can be run directly on the raw image file.
3368
3369 Add support for the 64-bit block device patches.
3370
3371 Fixed bugs in creating external journals with a 1k blocksize.
3372
3373 Add initial support for external journals (so long as the external
3374 journal only supports a single filesystem) in e2fsck.
3375
3376 Remove requirement for needing to run fsck on a filesystem after
3377 removing a journal (either internal or external).
3378
3379 The man pages now document how to create and manage external journals.
3380
3381 Speed up the check of an ext3 filesystems by avoiding a needless flush
3382 of all of the superblock and block group descriptors.
3383
3384 Speed up creating an internal journal using tune2fs in the case where
3385 the filesystem has a lot blocks already allocated.
3386
3387 Tune2fs has been fixed to make sure that only error messages go to
3388 stderr, and normal message go to stdout. (Addresses Debian bug #108555)
3389
3390 Fixed a minor bug in mke2fs; if -O none is passed to mke2fs, it will
3391 now not set the sparse_super feature.  (Addresses Debian bug #108165)
3392
3393 Add support in fsck for the filesystem type "auto".
3394
3395 Fsck -A will not try to interpret device names for filesystems which
3396 have a pass number is 0.  (Addresses Debian bug #106696).
3397
3398 Fsck prints a warning message if now valid filesystems are passed to
3399 it.  (Addresses Debian Bug #107458.)
3400
3401 E2fsck now gives an explicit warning if there filesystem still has
3402 errors at the end of the run. (Addresses Debian bug #104502)
3403
3404 E2fsck will set the EXT2_ERROR_FS flag if the journal superblock
3405 reflects an error.  E2fsck will also not run the orphan list if the
3406 filesystem contains errors, since the orphan list might be corrupted.
3407
3408 E2fsck now prints the number of large files when given the -v option.
3409
3410 Fixed minor memory leaks in e2fsck.
3411
3412 Some minor man pages updates. (Addresses Debian bug #30833, #108174)
3413
3414
3415 E2fsprogs 1.22 (June 22, 2001)
3416 ==============================
3417
3418 Fixed a bug in e2fsck's handling of orphan inodes which are special
3419 files (i.e., block/character device files, named FIFO's, etc.).
3420
3421 Fixed a bug accidentally introduced in e2fsprogs 1.21 which caused
3422 tune2fs to fail at adding a journal to a mounted filesystem.
3423
3424 Fixed a few big-endian bugs in e2fsprogs
3425         * The directory block functions were accidentally reporting
3426                 some directories as corrupted when they weren't.
3427         * If e2fsprogs is compiled --disable-swapfs, the C language 
3428                 equivalents weren't being included for big-endian platforms.
3429                 (Fixes Debian bug #101686).
3430
3431 Fixed a Hurd compilation problem.  (Addresses Debian bug #101361)
3432
3433 Programmer's notes:
3434 -------------------
3435
3436 Use platform independent method of defining the BLKFLSBUF and FDFLUSH
3437 ioctls, and allow them to be defined for non-i386 platforms.
3438
3439 The uuid.h header file is now protected against multiple inclusions.
3440
3441 E2fsprogs is now being developed using BitKeeper.  Changed the test
3442 scripts to deal with BK's stripping CR characgters from text files,
3443 and changed the top-level Makefile.in to avoid including BitKeeper
3444 files when generating the source tarball.
3445
3446
3447 E2fsprogs 1.21 (June 15, 2001)
3448 ==============================
3449
3450 Added new configure flags which allow a subset e2fsprogs to be built;
3451 this is most useful for boot floopies, since the resulting shared
3452 libraries and programs are slimmed down by removing features that
3453 aren't necessary for a boot floppy.  The new flags that were added
3454 are: --disable-swapfs, which removes support for byte swapping old
3455 legacy PPC/68k filesystems, --disable-debugfs, which removes support
3456 for debugfs from the libext2fs library, --disable-imager, which
3457 removes support for the e2image program, and --disable-resizer, which
3458 removes support for resize2fs.
3459
3460 E2fsck now prints the number of mounts or days elapsed since the last
3461 check when e2fsck is forced to check an otherwise clean filesystem.
3462
3463 Tune2fs now prints an informative message about how often a filesystem
3464 will be checked when adding a journal to the filesystem, to remind the
3465 user that he/she may want to adjust those parameters using tune2fs
3466 -c/-i.
3467
3468 Worked around hurd brain-damage which causes e2fsck to sometimes
3469 believe a filesystem is the root filesystem based on device numbers
3470 (since Hurd doesn't have dev_t's, which is arguably a POSIX.1
3471 violation).
3472
3473 Fixed a bug introduced in 1.20 which caused e2fsck to abort with an
3474 erroneous error with the -F option was specified.
3475
3476 Fixed a ext3 recovery bug in the revoke handling; synchronized with
3477 ext3 0.7a.
3478
3479 Fixed two bugs in e2fsck's handling of dup block handling, dealing
3480 with relatively uncommon edge cases: a directory with an indirect
3481 block which is claimed by another file, and when the last inode in the
3482 filesystem has blocks claimed by another file.
3483
3484 E2fsck now checks to see if the i_size field of a fast symlink is too
3485 big, and offers to clear the symlink if so.
3486
3487 E2fsck now checks to see if i_size_high of special files is non-zero,
3488 and offers to clear i_size_high.
3489
3490 Fix e2fsck's handling of incompatible journal flags so that the user
3491 has chance to abort, and then has the option to clear out the journal
3492 entirely.  (Addresses Debian bug #98527.)
3493
3494 Fixed a bug in fsck which could cause it to core dump if a mix of
3495 standard and non-standard device names are used in /etc/fstab.
3496 (Debian bug #100559)
3497
3498 Fixed a bug in debugfs which caused read errors when copying a file to
3499 not be noticed.
3500
3501 The debugfs set_super_value command can now modify the s_lastcheck field.
3502
3503 Fixed a bug in lsattr and chattr which was accidentally introduced in
3504 1.20 to support > 2GB files; both lsattr and chattr wasn't reading
3505 directories correctly because the change modified the layout of struct
3506 dirent to be incompatible with the libe2p shared library.
3507
3508 Cleaned up the mke2fs manual page and included a discussion about why
3509 it's good to periodically check the filesystem even when journaling is
3510 enabled.
3511
3512 Programmer's notes:
3513 -------------------
3514
3515 Fix general gcc -Wall complaints.
3516
3517 The types needed by the ext2 header files are now provided by
3518 lib/ext2fs/ext2_types.h, instead of include/asm/types.h.
3519
3520 Integers are now preferred to longs when trying to find a 32-bit type
3521 in ext2_types.h.  Also, if linux/types.h has already been defined,
3522 don't try to redefine the types.
3523
3524 Fixed make depend script so that it automatically corrects the
3525 pathname cleanups performed by make -M, so I don't have to fix them up
3526 by hand.
3527
3528 Fixed the d_loaddump test case to be more robust, and not depend on
3529 bash'isms.
3530
3531 Removed debugfs's dependence on pread(), which was accidentally
3532 intrudced in e2fsprogs 1.20
3533
3534 Fixed a performance bug in the libext2fs's icount routine; the size
3535 estimate of the icount array was incorrectly being calculated.
3536
3537 Removed use of the badblocks compatibility functions in the e2fsprogs
3538 programs.
3539
3540 Added paranoia code which protects against strange cases where /etc
3541 isn't on the root filesystem, or if /etc/mtab doesn't exist.
3542
3543 The header file ext2_types.h is now installed.
3544
3545 Autoconf is used to determine when we are on big-endian machines,
3546 instead of doing run-time tests, to save a few bytes of code.
3547
3548 The ext2fs_mark_generic_bitmap and ext2fs_unmark_generic_bitmap
3549 functions are no longer inline functions, which saves space and
3550 doesn't really cost any real performance.
3551
3552 The ext2fs library no longer depends on the e2p library.  (What need
3553 there was of it --- namely, fsetflags, was coded in-line).
3554
3555 Fixed the makefile so that lib/ext2fs/ext2_types.h is generated even
3556 when the user is stupid and tries compiling the package using "make
3557 install" as root.
3558
3559 Miscellaneous code cleanups:
3560         * Added missing files from Makefile.in's SRCS file, so that 
3561                 their dependencies would be properly calculated.
3562         * Removed redundant code
3563         * Fixed comments in code
3564         * Removed no-longer unneeded argsused #pragma.
3565
3566
3567 E2fsprogs 1.20 (May 20, 2001)
3568 =============================
3569
3570 Add support for replaying the ext3 journal purely in user mode,
3571 including handling the orphaned inode list.  Used code contributed by
3572 Andreas Dilger, with bug fixes and the orphaned inode handling done
3573 by Theodore Ts'o.
3574
3575 The mke2fs and tune2fs programs can create or modify a filesystem to
3576 include an ext3 journal.  Tune2fs also can be used to remove an ext3
3577 journal from a filesystem.
3578
3579 E2fsck will now check for the existence of a linked list of orphan
3580 inodes in the superblock, and clear those inodes before starting the
3581 rest of the filesystem check (but after the journal playback).
3582
3583 E2fsck now validates the file descriptor passed to the -C option,
3584 which saves against the completion bar getting written to an
3585 unexpected location, such as the disk being checked.  (Debian
3586 bug/wishlist #55220)
3587
3588 E2fsck will now bump the filesystem revision number from zero to one
3589 if any of the compatibility bits are set.
3590
3591 Fixed a bug where a badly corrupted directory on a big endian system
3592 could cause e2fsck to die with a bus error.  The
3593 ext2fs_read_dir_block() and ext2fs_process_dir_block() functions in
3594 the ext2 library now does alignment sanity checks on the rec_len field
3595 of the directory entry before using it.
3596
3597 The ext2 library has been enhanced to make tune2fs safe to run on
3598 mounted filesystems.  (Users could usually get away with using tune2fs
3599 on mounted filesystems before, but with the advent of ext3 and
3600 journaling, it became important to make tune2fs was *really* safe for
3601 use even when the filesystem being modified is mounted.)  E2label is
3602 now implemented by tune2fs using an argv[0] dispatch, so that e2label
3603 is also now safe for use on mounted filesystems.
3604
3605 Added a new program, e2image, which creates a backup of critical ext2
3606 filesystem data structures.  The generated image file can be examined
3607 using dumpe2fs and debugfs.  In the future, e2fsck will be able to use
3608 the image file to help recover very badly damaged filesystems.
3609
3610 Fixed a number of LFS bugs in e2fsck; very, very large (> 2**42) files
3611 no longer cause e2fsck to bomb out.  Also treat files > 2GB as being
3612 large file when deciding whether or not the filesystem has large files.
3613
3614 Fixed lsattr and chattr so that they work correctly on large files.
3615 (Fixes Debian bug #72690.)
3616
3617 Removed limitation in get_device_size() which imposed a one terrabyte
3618 filesystem limitation.  (Most 2.2 kernels still have a signed int
3619 problem which cause 1 TB block device limitation.  Fortunately, the
3620 kernel patches to fix this are much easier than fixing the 2TB
3621 limitation in the kernel.  :-)
3622
3623 A max_mount_count of zero is now treated as if no mount count were
3624 set.  (Previously, no mount count was indicated by using -1, and a
3625 mount count of zero caused e2fsck to always be run.)
3626
3627 Mke2fs supports two new filesystem types largefile and largefile4.
3628
3629 Mke2fs now adds some randomness in s_max_mount_count so that multiple
3630 filesystems won't be all checked at the same time under normal
3631 operations.
3632
3633 Fixed bug in the progress bar printing code which could cause e2fsck
3634 to core dump on an illegal filesystem.
3635
3636 Fixed bug in fsck which could allow more than one instance of e2fsck
3637 to be printing a progress bar.  (Debian bug #65267)
3638
3639 Fsck using a UUID or a LABEL specifier will work even if devfs is
3640 compiled into the kernel and not mounted.  If the pathnames in
3641 /proc/partitions are incorrect, fsck will search /dev for the correct
3642 device (using the new ext2fs_find_block_device library function).
3643 Fsck now also checks the RAID devices first so that they are properly
3644 found when they are in use.  Support has also been added to support
3645 additional IDE disks and the DAC 960 device names.  (Debian bug #94159)
3646
3647 Fixed a bug in fsck which caused it not deal properly with 16
3648 byte long filesystem labels.
3649
3650 Fsck's -t option has been made a lot more flexible.  The semantics for
3651 what happens if a comma-separated list to fsck has been regularized,
3652 and it is now possible to filter what filesystems will get checked
3653 based what is in the filesystem's fstab entry's option field.  (Debian
3654 bug #89483.)
3655
3656 The dumpe2fs program can now print out the group description
3657 information in hex, and also prints the location of the superblock and
3658 block group descriptor for those block groups that have them.
3659
3660 Mke2fs now clears the ext2 superblock before it starts creating a
3661 filesystem, so that the superblock magic number is only written if the
3662 filesystem creation process successfully completes.
3663
3664 The debugfs program's stat command now pretty-prints the blocks used
3665 by an inode so that it's more compact and informative.
3666
3667 The debugfs stats command now uses the same libe2p code (which is used
3668 by dumpe2fs) to print the superblock header information.  This is more
3669 complete, and it avoids a bit of code duplication.
3670
3671 Added a new debugfs command, set_super_value (ssv) which allows the
3672 user to set arbitrary superblock fields.
3673
3674 Debugfs was extended to support inode numbers in hex (by prefixing
3675 them with 0x), and so that modify_inode can set the inode generation
3676 number.  Also, there is now a new function command called logdump
3677 which will dump an ext3 journal.
3678
3679 Fixed a bug in debugfs so that quitting out of the pager doesn't kill
3680 debugfs.
3681
3682 Debugfs's dump command now stops immediately upon reporting a disk
3683 read error.  (Fixed a bug in ext2fs_file_read library routine which
3684 caused debugfs not to stop.)  (Debian bug #79163)
3685
3686 On systems with /proc/mounts (mainly Linux systems), /proc/mounts is
3687 checked before /etc/mtab is used, since /proc/mounts is more likely to
3688 be accurate.
3689
3690 Added portability fixes for Solaris and Linux/ia64.
3691
3692 Various manual pages were clarified and cleaned up.  (Fixed debian
3693 bugs #63442, #67446, and #87216)
3694
3695
3696 Programmer's notes:
3697 -------------------
3698
3699 The e2fsck message printer now supports %Iu and %Ig, which will print
3700 out the inode's user and group owners, respectively.
3701
3702 E2fsprogs now includes its own version of include/linux/ext2_fs.h, so
3703 that no longer dependent on the system having the correct version of
3704 the kernel header files.
3705
3706 Added a new function to libext2, ext2fs_find_block_device(), which
3707 searches the system (i.e., /dev, /devfs, /devices) for a pathname to a
3708 device given its device number.
3709
3710 Added a new function to libext2, ext2fs_sync_device, which centralizes
3711 all of the places which might try to use the BLKFLSBUF or FDFLUSH
3712 ioctls (and usually failing to define them since the system header
3713 files don't usually do this for us, and we're trying to avoid usage of
3714 kernel include files now).
3715
3716 Added new utility programs in tests/progs: random_exercise and
3717 hold_inode.  They aren't built by default; they're useful for
3718 exercising ext3 filesystem code.
3719
3720 Added a new ext2 filesystem flag, EXT2_FLAG_SUPER_ONLY, which causes
3721 the filesystem close functions to only update the superblock, and to
3722 not touch the block group descriptors.  Needed by tune2fs when
3723 modifying a mounted filesystem.
3724
3725 Got rid of struct ext2fs_sb and replaced it with the standard struct
3726 ext2_super_block from include/linux/ext2_fs.h.  Note: this may break
3727 source (but not binary) compatibility of some users of the ext2
3728 library.  Those applications should just simply do a global search and
3729 replace of struct ext2fs_sb with struct ext2_super_block, and include
3730 the new header file <ext2fs/ext2_fs.h> which defines it.
3731
3732 The ino_t type has been renamed ext2_ino_t to protect applications
3733 that attempt to compile -D_FILE_OFFSET_BITS=64, since this
3734 inexplicably changes ino_t(!?).  So we use ext2_ino_t to avoid an
3735 unexpected ABI change.
3736
3737 The Makefiles have been reworked so that "make check" can be run from
3738 the top-level Makefile.
3739
3740 Fix general gcc -Wall complaints and removed dead code.
3741
3742 Remove use of NOARGS, because we assume everyone does ANSI C these
3743 days.
3744
3745 Added build-rpm script from sct.
3746
3747 New functions ext2fs_image_{inode,super,bitmap}_{read,write} added 
3748 to support e2image.
3749
3750 New function ext2fs_flush_icache which must be called if the
3751 application program modifies the inode table blocks without going
3752 through ext2fs_write_inode() interface.
3753
3754 New ext2fs_check_mount_point() function, which will return the mount
3755 point of a device if mounted.
3756
3757 The io_channel abstraction now has an optional interface,
3758 io_channel_write_range, which allows specific byte ranges to be
3759 written.  
3760
3761 The unix_io IO channel now supports write-through caching, so that
3762 journal creation is more efficient.
3763
3764 Added x86 assembly language routines to support byte swapping, to
3765 reduce executable size.
3766
3767 Fixed bug in the utility program subst so that it's possible to
3768 replace a substitution variable with a zero-length string.
3769
3770 Fixed numbering e2fsck pass1 problem numbers; an extra zero had
3771 slipped into some of the problem number.
3772
3773 E2fsprogs 1.19 (July 13, 2000)
3774 ==============================
3775
3776 Release the resize2fs program since the timeout before it could
3777 be released under the GPL has finally expired.
3778
3779 Add experimental support needed for the ext2 compression patches.
3780 This requires compiling e2fsprogs with the --enable-compression flag
3781 to the configure script.
3782
3783 Added ext3 journalling support.  E2fsck will run the journal (if
3784 necessary) by temporarily mounting the filesystem.  /sbin/fsck.ext3 is
3785 installed as a symlink to e2fsck.  Fsck has been taught about ext3,
3786 and treats it the same as ext2 in terms of the progress bar logic.
3787 Dumpe2fs will display the superblock journaling information if the
3788 filesystem has a journal.  The ext2 library will now permit opening an
3789 ext3 filesystem with the recovery flag set.  This is necessary for
3790 on-line dump's to work correctly, but there may be issues with this
3791 working well since ext3 is much less agressive about syncing blocks to
3792 the filesystem, since they're safe on the journal.
3793
3794 Tune2fs and e2fsck have been changed to allow the mount_count check to
3795 be disabled by setting max_mount_count to -1.  (This was already
3796 supported by the kernel.)
3797
3798 Create a symbolic link for fsck.ext3, since the e2fsprogs utilities
3799 are used for ext3 as well.
3800
3801 Added internationalization support for e2fsprogs; must be enabled
3802 by passing --enable-nls to configure.
3803
3804 Always use the provided ext2fs header files to insulate ourselves from
3805 kernel version changes.  Which include files are used by e2fsprogs
3806 have also been cleaned up to improve portability.
3807
3808 Limit the number of times that e2fsck updates the progress bar so that
3809 people who are booting using a 9600 baud console don't get swampped by
3810 too many updates.
3811
3812 Improved the loop detection algorithm in e2sck's pass #3 so that it is
3813 much, much faster for large filesystems with a large number of
3814 directories.
3815
3816 The memory footprint for e2fsck is now slightly smaller than before.
3817
3818 E2fsck now checks if special devices have a non-zero size, and offers
3819 to clear the size field if it finds such an inode.  
3820
3821 E2fsck now checks if special devices have the append-only flag set,
3822 and offers to clear the inode.
3823
3824 E2fsck now properly handles some "should never fail" cases during a
3825 bitmap copy in pass5.
3826
3827 E2fsck now properly prints control characters in filenames as ^A .. ^Z.
3828
3829 E2fsck now calculates the correct location of the backup superblock in
3830 the case of filesystem blocksizes > 1k.
3831
3832 Fixed a bug in e2fsck's calculation of the number of inodes_per_block
3833 which normally didn't cause problems under most filesystem parameters,
3834 but could cause a valid superblock to be rejected in extreme cases.
3835 Other checks for validating superblock values were made more
3836 stringent.
3837
3838 Added non-destructive write testing to the badblocks program, courtesy
3839 of David Beattie.  The badblocks also now has an option to input the
3840 current set of bad blocks, so that known bad blocks are skipped to
3841 speed up the badblocks test.  There is also a persistent rescan
3842 feature which causes badblocks to run until it has completed some
3843 number of passes without discovering any new bad blocks.
3844
3845 Badblocks now checks to see if the device is mounted and refuses to do
3846 the tests involving writing to the device if it is mounted.  Also,
3847 badblocks now allows the number of blocks to be checked to be
3848 defaulted to the size of the partition.
3849
3850 Fixed a bug in fsck which didn't allow non-root users to be able to
3851 check filesystems if there were any LABEL= or UUID= entries in
3852 /etc/fstab.
3853
3854 The Hurd doesn't support the filetype filesystem feature.  The mke2fs
3855 program now makes sure that for the Hurd, the filestype feature is
3856 turned off.  E2fsck will check to see if the filetype feature is
3857 turned on for Hurd filesystems, and offer to turn off the feature.
3858
3859 Mke2fs now has a safety check to make sure the number of blocks do not
3860 exceed 32 bits even on a 64 bit platform.
3861
3862 Really fixed a bug in fsck to allow "fsck -As" to run interactive
3863 fsck's.  (For those people who like to do interactive fsck's in the
3864 /etc/rc scripts!?!)
3865
3866 Debugfs has a few new features: the rdump command, which will do a
3867 recursive dump of a directory and all of its contents, and the lcd
3868 command which does a local chdir (much like the ftp command of the
3869 same name).  In addition, the debugfs program and the open_filesystem
3870 command now takes three new options: -b and -s, which allows the
3871 blocksize and superblock location to be specified, and the -c option
3872 which is used in catastrophic situations where the block group
3873 descriptors are corrupt.  If the -c option is specified, debugfs will
3874 skip trying to read in the block and inode bitmaps.
3875
3876 Debufs's lsdel command was fixed to handle bad blocks in the inode
3877 table.
3878
3879 A Y2K bug in debugfs's "ls -l" handling was fixed by switching to use
3880 4 digit years.
3881
3882 General improvements in error messages
3883
3884   - Mke2fs prints a sane error message if the partition size is zero
3885         (usually because the partition table wasn't reread by the
3886         kernel due to the partition being busy), instead of "invalid
3887         argument passed to ext2 library while initializing superblock".
3888
3889   - Fsck now prints more self-explanatory message if an invalid UUID=
3890         or LABEL= specification is passed to it.
3891
3892 UUID library changed to use the LGPL.
3893
3894 Fixed a bug in the UUID library where very rapid calls to the
3895 time-based UUID generator could cause duplicate UUID's to be returned.
3896 This was not a problem for e2fsprogs, but it could be a problem for
3897 other users of the library.
3898
3899 Make the UUID library more robust in the face of missing or an
3900 improper /dev/urandom or /dev/random files.
3901
3902 Added some random portability fixes for Solaris.
3903
3904 Some minor man page updates.
3905
3906 Fixed a memory leak in the ss library.
3907
3908
3909 Programmer's notes:
3910 -------------------
3911
3912 We now try to use lseek64 and open64 from the LFS if possible.
3913
3914 The 3rd parameter in e2p's print_flags is now a flags word, instead of
3915 a boolean option.
3916
3917 The mark and unmark bitmap functions now return the previous state of
3918 the bit that was being changed, which is useful for some speed
3919 optimizations.
3920
3921 The following functions have been added to enhance the badblocks list
3922 handling in libext2fs: ext2fs_write_bb_FILE, ext2fs_read_bb_FILE2, and
3923 ext2fs_badblocks_equal.
3924
3925 The ext2 header files now have the latest journalling fields to the
3926 superblock.
3927
3928 The ext2fs_mkdir function in libext2fs now properly backs out of error
3929 conditions robustly.
3930
3931 Cleaned up makefiles:
3932   - to cleanly  compile with the -j flag.
3933   - so distclean removes all generated files.
3934   - so in case of an error while installing header files, the make aborts.
3935
3936 Fix test_script so that it works correctly when compiling in the
3937 source directory.
3938
3939 The random UUID generation routine has been made slightly better in
3940 the case where /dev/random doesn't exist.  (Use of randomly-based UUID
3941 is still not recommended if /dev/random doesn't exist, however; it's
3942 better to use the time/ethernet MAC address UUID in this case.)
3943
3944 Clean up the build process so it's more friendly in case of missing
3945 directories.
3946
3947 The ext2fs header file can now be #include'd into C++ programs.
3948
3949 The e2p.h header file is now installed.
3950
3951 Added workaround to a gawk 3.0.5 bug in lib/ss/mk_cmds.
3952
3953
3954
3955 E2fsprogs 1.18 (November 10, 1999)
3956 ==================================
3957
3958 Fix a core dumping bug in e2fsck if an imagic inode is present or
3959 (more rarely) if the filesystem is badly corrupted enough that e2fsck
3960 has to restart pass 1 processing.  E2fsck now closes the filesystem
3961 before freeing a large number of its data structures, so in the case
3962 of future memory faults, at least the fixed filesystem will be fully
3963 written out.
3964
3965 If a filesystem doesn't support imagic inodes, and e2fsck discovers an
3966 imagic inode, it will offer to clear the imagic flag.
3967
3968 E2fsck will now offer to clear the immutable flag on special files
3969 (device/socket/fifos) when running it in non-preen mode.
3970
3971 E2fsck will now set the filetype when creating /lost+found, and when
3972 connected orphaned inodes to /lost+found.
3973
3974 Debugfs's ncheck and icheck commands now handles the case where there
3975 are bad blocks in the inode table without bombing out.
3976
3977 The badblocks list processing code has been made more efficiently for
3978 appending a large number of (ordered) badblocks to the badblocks list.
3979
3980 Some minor man page updates.
3981
3982 Fsck now allows interactive e2fsck's when using fsck -As (not a common
3983 mode, but some people like to do this in boot scripts for silly reasons).
3984
3985 Programmer's notes:
3986 -------------------
3987
3988 The internal e2fsck problem code for PR_2_SPLIT_DOT was fixed to meet
3989 with the problem code convention.
3990
3991 The badblocks list regression test program has been updated to work
3992 with previously made API name changes.
3993
3994 The ext2fs_free() command now uses the new badblocks API to avoid
3995 using the compatibility layer.
3996
3997 Added new regression test cases; the run_e2fsck test script now
3998 supports the ability for a test case to run a prepratory command
3999 before running e2fsck.
4000
4001 E2fsprogs 1.17 (October 26, 1999)
4002 =================================
4003
4004 Fixed nasty typo in fsck which caused parallelized fsck's to go into an
4005 infinite loop.
4006
4007 Fixed a bug in fsck where it used strncmp to compare a binary UUID,
4008 thus potentially causing problems if a binary UUID contained a NULL
4009 character.
4010
4011 E2fsck now uses stricter checks for directory entries in pass 2:
4012 zero-length filenames are not allowed; neither are 8 byte long
4013 directory entries.
4014
4015 The debugfs "dirty" command now clears the filesystem valid bit.
4016 (Previously this just set the dirty-as-in-needs-writing-out-to-disk
4017 bit in the in-core superblock image.  The new functionality is more
4018 what the user expects, and is more useful.)
4019
4020 Added a debugging hook to test parallel fsck; if the environment
4021 variable FSCK_FORCE_ALL_PARALLEL, then filesystems on the same drive
4022 will be checked in parallel when they normally would not be.
4023
4024 Programmer's notes:
4025 -------------------
4026
4027 Fixed some #ifdef's for compilation under the Hurd OS.
4028
4029 Fixed minor W2K compatibility problems.
4030
4031 Fixed some miscellaneous GCC warnings.
4032
4033
4034 E2fsprogs 1.16 (October 22, 1999)
4035 =================================
4036
4037 Fixed a race condition bug in fsck; when printing a progress bar, if
4038 checking multiple filesystems in parallel, it was possible for fsck to
4039 send e2fsck a SIGUSR1 signal before e2fsck had installed its signal
4040 handler, which would cause it to terminate with a signal 10.
4041
4042 E2fsck now properly handles filesystems that have the
4043 INCOMPAT_FILETYPE feature turned on.  It can be used to convert a
4044 filesystem into using or not using FILETYPE feature.
4045
4046 E2fsck now properly handles filesystems that have the IMAGIC feature
4047 turned on (this is used on Linux AFS servers).
4048
4049 The mke2fs program now creates filesystems that have the filetype and
4050 sparse_superblock features enabled by default, unless it is run on a
4051 pre-2.2 kernel.  These features are not supported by a pre-2.2 kernel,
4052 so there is now a new flag -O which allows the user to specify with
4053 which features she would like to create the filesystem; "mke2fs -O
4054 none" will create a filesystsem compatible with 2.0 kernels.
4055
4056 The tune2fs program now has a -O option which allows the user to set
4057 and reset "safe" filesystem features.  Currently, the only ones which
4058 allows to be modified are the filetype and sparse_superblock features.
4059 Note setting or clearing either feature will require running e2fsck on
4060 the filesystem afterwards.  (n.b. Clearing the sparse_superblock feature
4061 requires that there is enough free space on the filesystem for the
4062 extra superblocks which will be created by e2fsck.)
4063
4064 Debugfs can now set and print filesystem features in the superblock
4065 using the "features" command.  Dumpe2fs will print out the complete
4066 set of features when listing the superblock.
4067
4068 Dumpe2fs has new options -f (force) and -h (header-only).
4069
4070 Fixed a bug in e2fsck which could cause the PROGRAMMING ERROR/bonehead
4071 message to come up.  This could happen when decrementing or
4072 incrementing a link count could result in an overflow.
4073
4074 Fixed a bug in e2fsck where the block count on the lost+found
4075 directory would not be properly incremented when the directory was
4076 expanded to the point where an indirect block needed to be allocated.
4077
4078 E2fsck now makes some additional sanity checks on the superblock to
4079 avoid crashing or giving a memory allocation error if some of the
4080 values in the superblock are unresonable (but the superblock otherwise
4081 looks valid).
4082
4083 Fixed a bug in e2fsck where a very badly corrupted filesystem might
4084 require two passes to completely fix the filesystem.  This happened if
4085 an inode claimed blocks that was part of the filesystem metadata
4086 (typically, when garbage was written into an inode table or indirect
4087 block, since this kind of filesystem corruption normally doesn't
4088 happen otherwise).
4089
4090 On the Alpha, glibc declares st_flags although it isn't actually used;
4091 the configure script was improved to detect this case so that
4092 e2fsprogs can avoid using the non-functional stat field.
4093
4094 The manual pages were updated to use a more consistent formatting
4095 style consistent with standard Unix man pages.  Mke2fs's man page
4096 added documentation for a few previously undocumented options.
4097
4098 Fixed minor display bugs in tune2fs and mke2fs.
4099
4100 Programmer's notes:
4101 -------------------
4102
4103 Improved portability of e2fsprogs to non-Unix systems (in particular, NT).
4104
4105 Added features to parse and print feature strings into the e2p library.  
4106 (e2p_feature2string, e2p_string2feature, e2p_edit_feature).
4107
4108 ext2fs_mkdir() and ext2fs_new_dir_block() now creates directories
4109 whose directory entries contain proper filetype information if the
4110 filesystem supports it.
4111
4112 ext2fs_link() now uses the low 3 bits of its flags parameter to pass
4113 the directory entry filetype information.  This is used to set the
4114 directory entry filetype information if the filesystem supports it.
4115
4116 Fixed a bug in ext2fs_expand_dir() where the block count in a
4117 directory's inode would not be properly incremented when the directory
4118 was expanded to the point where an indirect block needed to be
4119 allocated.
4120
4121
4122 E2fsprogs 1.15 (July 18, 1999)
4123 ==============================
4124
4125 Add configuration checks so that e2fsprogs will compile cleanly on
4126 Linux 2.3 kernels that have renamed i_version to i_generation.
4127
4128 E2fsck now prints a progress/completion bar (and not just a simple
4129 spinner) if the -C0 option is requested or if it receives a SIGUSR1
4130 signal.  Fsck will automatically manage the (potentially muliple)
4131 e2fsck processes to print completion bars if it is given a -C option,
4132 with the right thing happening if multiple filesystems are being
4133 checked in parallel.
4134
4135 Mke2fs now has better automatic hueristics to determine the filesystem
4136 parameters to be used for a particular filesystem.  Added a new option
4137 -T which allows the user to specify how the filesystem is to be used,
4138 which helps mke2fs do a better job selecting the filesystem parameters.
4139
4140 Mke2fs now creates revision 1 filesystems by default, and with the
4141 sparse superblock feature enabled.  The sparse superblock feature is
4142 not understood by Linux 2.0 kernels, so they will only allow read-only
4143 mounts of filesystems with this sparse superblocks.
4144
4145 Fix bug where if /dev/null couldn't be opened (should never happen),
4146 e2fsck would hang in a tight loop.
4147
4148 Make e2fsck handle the case where /lost+found isn't a directory.
4149
4150 E2fsck now uses mallinfo if it exists to get accurate statistics about
4151 its memory usage.
4152
4153 Fix bug in e2fsck where it wouldn't check to see if a disconnected
4154 inode had any problems before connecting it to /lost+found.
4155
4156 Add check to e2fsck so it makes sure that total number of inodes in
4157 the filesystem is a sane number.
4158
4159 Fix fencepost error when clearing an the end of the block bitmap which
4160 caused the last block in the bitmap not to get cleared.
4161
4162 Cleaned up a number of messages in e2fsck:
4163         * The message "Group's #'s copy of the group descriptor..."
4164                 was fixed so that the correct number would be displayed.
4165         * Added missing space in the "disk write-protected" error messsage
4166         * Cleaned up the error message printed when a non-interactive
4167                 e2fsck needs to abort a check because the filesystem
4168                 appears to be mounted.
4169
4170 Added a new command-line utility, uuidgen, which will create and print
4171 a UUID.
4172
4173 Make debugfs's icheck command more robust by checking to make sure an
4174 inode has valid blocks before interarting over the inode's blocks.
4175
4176 UUID generation now uses a random-based scheme whenever possible to
4177 prevent potential privacy problems.
4178
4179 Man pages for all of the UUID functions in the lirbary were added.
4180
4181 Fixed bug in fsck so it won't coredump if a filesystem not in
4182 /etc/fstab is given to it.
4183
4184 Fsck now understands the UUID=xxxx and LABEL=yyyy forms in /etc/fstab
4185 that most of the other mount utilities understands.
4186
4187 Mke2fs will make a filesystem even if it appears mounted if the force
4188 option is given.
4189
4190 Dumpe2fs has new command-line options which allow a filesystem expert
4191 to specify the superblock and blocksize when opening a filesystem.
4192 This is mainly useful when examining the remains of a toasted
4193 filesystem.
4194
4195 The badblocks program has been updated to display correctly on disks
4196 with large block numbers.
4197
4198 The badblocks program no longer gives spurious errors when errors
4199 occur on non-block boundaries, which is common if the blocksize is
4200 larger than 1k.
4201
4202 Mke2fs will sync the disk device every MKE2FS_SYNC block groups if the
4203 MKE2FS_SYNC environment variable is set.  This is to work around a VM
4204 bug in the 2.0 kernel.  I've heard a report that a RAID user was able
4205 to trigger it even using a 2.2 kernel, but hopefully it will not be
4206 needed for most Linux 2.2 users.
4207
4208 Fixed miscellaneous documentation and man pages.
4209
4210 Programmer's notes:
4211 -------------------
4212
4213 Cleaned up functions such as pass1_get_blocks, pass1_read_inode which
4214 in e2fsck's pass1.c really should have been static.
4215
4216 The return value of the uuid_compare() function was changed to make it
4217 match with the convetions used by strcmp, memcmp, and Paul Leach's
4218 UUID sample document.
4219
4220 The "make depend" process has now been made more automated; it now
4221 automatically word-wraps the dependencies, and only replaces source
4222 Makefile.in if there has been a change in the dependencies.  Also, a
4223 top-level "make depend" now recurses through all the subdirectories
4224 automatically.
4225
4226 The Makefile in .../util has been changed so that subst is built using
4227 the native C compiler during a cross-compilation, since the subst
4228 program is only used during the build process.  Also add an explicit
4229 rule to build util/subst by cd'ing to the correct directory and
4230 running Makefile.
4231
4232 The man directories are defined in terms mandir, so that the configure
4233 script can override the location of the manual pages.
4234
4235 The config files have been updated to recognize new machine types for
4236 both the i386 and alpha families.
4237
4238 Fsck has been modified so that it will accurately create an
4239 fsck_instance even when the noexecute flag is set.  This allows for
4240 accurate debugging of the fsck pass structure.  Also, when the verbose
4241 flag is given twice, fsck will print debugging information about when
4242 fsck is waiting for jobs to finish.
4243
4244
4245 E2fsprogs 1.14 (January 9, 1999)
4246 ================================
4247
4248 Fix the fstab parsing code so that it can handle blank lines and
4249 comment characters.  Also, missing pass numbers need to be treated as
4250 zero.
4251
4252 Fixed a bug in e2fsck where under some circumstances (when e2fsck
4253 needs to restart processing after fixing an egregious inconsistency)
4254 it would try to access already freed memory.
4255
4256 E2fsck now prints non-printable characters in directory entries and
4257 pathnames using '^' and 'M-' notation.
4258
4259 Fixed chattr so that it will ignore symbolic links when doing
4260 recursive descent traversals.  For both chattr and lsattr, no longer
4261 print the version string unless the -V option is given.
4262
4263 Allow the system administrator to directly specify the number of
4264 inodes desired in the filesystem, for some special cases where this is
4265 necessary.
4266
4267 Fix portability problems so that e2fsprogs can be compiled under Linux
4268 1.2 systems and Solaris systems.
4269
4270 Update the config.guess file with a more recent version that will
4271 identify newer Linux platforms.
4272
4273 Programmer's notes
4274 ------------------
4275
4276 Ext2fs_read_inode and ext2fs_write_inode will now return an error if
4277 an inode number of zero is passed to them.
4278
4279 E2fsprogs 1.13 (December 15, 1998)
4280 ==================================
4281
4282 Fixed a bug in debugfs where an error messages weren't getting printed
4283 when the ext2 library routines to read inodes returned errors in the
4284 stat, cmri and rm commands.
4285
4286 Fixed a bug in mke2fs so that if a ridiculous inode ratio parameter is
4287 provided, it won't create an inode table smaller than the minimum
4288 number of inodes required for a proper ext2 filesystem.
4289
4290 Fsck now parses the /etc/fstab file directly (instead of using
4291 getmntent()), so that it can distinguish between a missing pass number
4292 field and pass number field of zero.  This caused problems for
4293 diskless workstations where all of the filesystems in /etc/fstab have
4294 an explicit pass number of zero, and fsck could not distinguish this
4295 from a /etc/fstab file with missing pass numbers.
4296
4297 E2fsck will create a /lost+found directory if there isn't one in the
4298 filesystem, since it's safer to create the lost+found directory before
4299 it's needed.
4300
4301 Fixed e2fsck so that it would detect bogus immutable inodes which
4302 happen to be sockets and FIFO files, and offer to clear them.
4303
4304 If a filesystem has multiple reasons why it needs to be checked, and
4305 one of the reasons is that it is uncleanly mounted, e2fsck will print
4306 that as the reason why the filesystem is being checked.
4307
4308 Cleaned up the output routines of mke2fs so that it doesn't overflow
4309 an 80 column display when formating really big filesystems.
4310
4311 Added a sanity check to e2fsck to make sure that file descriptors 0,
4312 1, 2 are open before opening the hard disk.  This avoids a problem
4313 where a broken program might exec e2fsck with those file descriptors
4314 closed, which would cause disastrous results if the kernel returns a
4315 file descriptor for the block device which is also used by FILE *
4316 stdout.
4317
4318 Fixed up the e2fsck progress reporting functions so that the values
4319 reliably reach 100% at the completion of all of the e2fsck passes.
4320
4321 Fixed minor documentation bugs in man pages and usage messages.
4322
4323 Programmer's notes:
4324 -------------------
4325
4326 Fixed a number of lint warnings in the ext2fs library and potential
4327 portability problems from other OS's header files that might define
4328 CPP macros for names like "max" and "min".
4329
4330 ext2fs_badblocks_list_add() has been made more efficient when it needs
4331 to grow the bad blocks list.
4332
4333 Fixed a bug in e2fsck which caused it to dereference a freed pointer
4334 just before exiting.
4335
4336 Fixed the substition process for generating the mk_cmds and compile_et
4337 scripts so that they will work outside of the build tree.
4338
4339 Add sanity check to e2fsck so that if an internal routine
4340 (ext2fs_get_dir_info) returns NULL, avoid dereferencing the pointer
4341 and causing a core dump.  This should never happen, but...
4342
4343 E2fsprogs 1.12 (July 9, 1998)
4344 ==================================
4345
4346 E2fsprogs now works with glibc (at least with the version shipped wtih
4347 RedHat 5.0).  The ext2fs_llseek() function should now work even with
4348 i386 ELF shared libraries and if llseek() is not present.  We also
4349 explicitly do a configure test to see if (a) llseek is in libc, and
4350 (b) if llseek is declared in the system header files.  (See standard
4351 complaints about libc developers don't understand the concept of
4352 compatibility with previous versions of libc.)
4353
4354 The ext2fs library now writes out the block group number in each of
4355 the superblock copies.  This makes it easier to automatically
4356 determine the starting block group of the filesystem when the block
4357 group information is trashed.
4358
4359 Added support for the EXT2_FEATURE_INCOMPAT_FILETYPE feature,
4360 which means that e2fsprogs will ignore the high 8 bits of the
4361 directory entry's name_len field, so that it can be used for other
4362 purposes.
4363
4364 Added support for the EXT2_FEATURE_RO_COMPAT_LARGE_FILE feature.
4365 E2fsprogs will now support filesystems with 64-bit sized files.
4366
4367 Added support for the EXT2_FEATURE_COMPAT_DIR_PREALLOC feature.
4368
4369 Added new program "e2label", contributed by Andries Brouwer.  E2label
4370 provides an easy-to-use interface to modify the filesystem label.
4371
4372 Fixed bug so that lsattr -v works instead of producing a core dump.
4373
4374 Fixed a minor bug in mke2fs so that all groups with bad superblock
4375 backup blocks are printed (not just the first one).
4376
4377 Mke2fs will check the size of the device, and if the user specifies a
4378 filesystem size larger than the apparent size of the device it will
4379 print a warning message and ask if the user wants to proceed.
4380
4381 E2fsck has a new option -C, which sends completion information to the
4382 specified file descriptor.  For the most part, this is intended for
4383 programs to use, although -C 0 will print a spinning character to the
4384 stdout device, which may be useful for users who want to see something
4385 happening while e2fsck goes about its business.
4386
4387 Fixed a bug in e2fsck which could cause a core dump when it needs to
4388 expand the /lost+found directory, and sometimes the bitmaps haven't
4389 been merged in.  Also fixed a related bug where ext2fs_write_dir_block
4390 was used to write out a non-directory block.  (Which would be bad on a
4391 non-Intel platform with byte swapping going on.)
4392
4393 Fixed bug in e2fsck where it would print a "programming error" message
4394 instead of correctly identifying where a bad block was in used when
4395 the bad block was in a non-primary superblock or block group
4396 descriptor.  Also fixed a related bug when sparse superblocks are in
4397 use and there is a bad block where a superblock or block group
4398 descriptor would have been in a group that doesn't include a
4399 superblock.
4400
4401 Fixed a bug in e2fsck (really in libext2fs's dblist function) where if
4402 the block group descriptor table is corrupt, it was possible to try to
4403 allocate a huge array, fail, and then abort e2fsck.
4404 ext2fs_get_num_dirs() now sanity checks the block group descriptor,
4405 and subsitutes reasonable values if the descriptors are obviously bogus.
4406
4407 If e2fsck finds a device file which has the immutable flag set and the
4408 i_blocks beyond the normal device number are non-zero, e2fsck will
4409 offer to remove it, since it's probably caused by garbage in the inode
4410 table.
4411
4412 When opening a filesystem, e2fsck specially checks for the EROFS error
4413 code, and prints a specific error message to the user which is more
4414 user friendly.
4415
4416 If the filesystem revision is too high, change the e2fsck to print
4417 that this is either because e2fsck is out of date, or because the
4418 superblock is corrupt.  
4419
4420 E2fsck now checks for directories that have duplicate '.' and '..'
4421 entries, and fixes this corruption.
4422
4423 E2fsck no longer forces a sync of the filesystem (with attendant sleep
4424 calls) at all times.  The ext2fs_flush() function now performs a sync
4425 only if it needed to write data blocks to disk.
4426
4427 Fixed a minor bug in e2fsck's pass1b's file cloning function, where
4428 certain errors would not be properly reported.
4429
4430 Updated and expanded a few points in the man pages which users
4431 complained wheren't explicit enough.
4432
4433 Added special case byte-swapping code if compiling on the PowerPC, to
4434 accomodate the strange big-endian variant of the ext2 filesystem that
4435 was previously used on the PowerPC port.
4436
4437
4438 Programmer's notes:
4439 -------------------
4440
4441 Removed C++ keywords from the ext2fs libraries so that it could be
4442 compiled with C++.
4443
4444 E2fsck's internal organization has now been massively reorganized so
4445 that pass*.c don't have any printf statements.  Instead, all problems
4446 are reported through the fix_problem() abstraction interface.  E2fsck
4447 has also been revamped so that it can be called as a library from a
4448 application.
4449
4450 Added new fileio primitives in libext2fs for reading and writing
4451 files on an unmounted ext2 filesystem.  This interface is now used by
4452 debugfs.
4453
4454 Added a new libext2fs function for mapping logical block numbers of
4455 a file to a physical block number.
4456
4457 Added a new libext2fs function, ext2fs_alloc_block(), which allocates
4458 a block, zeros it, and updates the filesystem accounting records
4459 appropriately.
4460
4461 Added a new libext2fs function, ext2fs_set_bitmap_padding(), which
4462 sets the padding of the bitmap to be all one's.  Used by e2fsck pass 5.
4463
4464 The libext2fs functions now use a set of memory allocation wrapper
4465 functions: ext2fs_get_mem, ext2fs_free_mem, and ext2fs_resize_mem,
4466 instead of malloc, free, and resize.  This makes it easier for us to
4467 be ported to strange environments where malloc, et. al. aren't
4468 necessarily available.
4469
4470 Change the libext2fs fucntion to return ext2-specific error codes
4471 (EXT2_DIR_EXISTS and EXT2_DB_NOT_FOUND, for example) instead of using
4472 and depending on the existence of system error codes (such as EEXIST
4473 and ENOENT).
4474
4475 Renamed io.h to ext2_io.h to avoid collision with other OS's header
4476 files.
4477
4478 Add protection against ext2_io.h and ext2fs.h being included multiple
4479 times.
4480
4481 The types used for memory lengths, etc. have been made more portable.
4482 In generla, the code has been made 16-bit safe.  Added Mark
4483 Habersack's contributed DOS disk i/o routines.
4484
4485 Miscellaneous portability fixes, including not depending on char's
4486 being signed.
4487
4488 The io_channel structure has a new element, app_data, which is
4489 initialized by the ext2fs routines to contain a copy of the filesystem
4490 handle.
4491
4492 ext2fs_check_directory()'s callback function may now return the error
4493 EXT2_ET_CALLBACK_NOTHANDLED if it wishes ext2fs_check_directory() to
4494 really do the checking, despite the presence of the callback function.
4495
4496
4497 E2fsprosg 1.11 (June 17, 1997)
4498 ==============================
4499
4500 Fixed e2fsck to detect (previously ignored) conflicts between the
4501 superblock or block group descriptors and block bitmaps, inode
4502 bitmaps, and inode tables.
4503
4504 Fixed bug in e2fsck so that when the message printed out when a block
4505 or inode bitmap conflicts with other data, it has the correct group
4506 number.
4507
4508 Fixed bug in e2fsck and mke2fs where the blocksize wasn't being passed
4509 to badblocks.  This meant that not all of the filesystem was being
4510 tested for bad blocks! 
4511
4512 Fixed an array boundary overrun case which cropped up in
4513 ext2fs_badblocks_list_test when a user tried running "mke2fs -c 
4514 -b 4096".
4515
4516 Adjusted the number of columns printed by mke2fs when displaying the
4517 superblock backups to avoid running over 80 columns when making a
4518 really big filesystem.
4519
4520 Fixed up the man pages for e2fsck, debugfs, badblocks, chattr,
4521 dumpe2fs, fsck, mke2fs, and tune2fs (typos and other minor grammar
4522 fixes), thanks to some suggestions from Bill Hawes (whawes@star.net).
4523
4524 Programmer's notes:
4525 -------------------
4526
4527 Fixed install rule in lib/ss so that ss_err.h is actually getting
4528 installed.
4529
4530 Fixed bug in ext2fs_copy_bitmap; the destination bitmap wasn't getting
4531 bassed back to the caller.
4532
4533 Fixed bug in ext2fs_inode_scan_goto_blockgroup; it had not been
4534 setting the current inode number (which meant this function wasn't
4535 working at all).
4536
4537 Fixed bug in ext2fs_resize_generic_bitmap; it had not be zeroing all
4538 blocks in the bitmap when increasing the size of the bitmap.
4539
4540 Changed the initial number of blocks allocated by ext2fs_init_dblist()
4541 to be more realistic.
4542
4543 Added a new function ext2fs_allocate_group_table, which sets up the
4544 group descriptor information (and allocates inode and block bitmaps,
4545 and inode tables for a particular group).  The function was created by
4546 factoring out code form ext2fs_allocate_tables().
4547
4548 Added a new function ext2fs_move_blocks which takes a bitmap of the
4549 blocks to be moved, and moves them to another location on the
4550 boardboard.
4551
4552 Make the unix_io channel's io_channel_flush implementation calls sync()
4553 to to flush the kernel buffers to disk.
4554
4555 Added a new function ext2fs_dblist_count returns the number of
4556 directory blocks in dblist.
4557
4558
4559 E2fsprogs 1.10 (April 24, 1997)
4560 ===============================
4561
4562 Mke2fs once again defaults to creating revision #0 filesystems, since
4563 people were complaining about breaking compatibility with 1.2 kernels.
4564 Warning messages were added to the mke2fs and tune2fs man pages that
4565 the sparse superblock option isn't supported by most kernels yet (1.2
4566 and 2.0 both don't support parse superblocks.)
4567
4568 Added new flag to mke2fs, -R <raid options>, which allows the user to
4569 tell mke2fs about the RAID configuration of the filesystem.  Currently
4570 the only supported raid option is "stride" which specifies the width
4571 of the RAID stripe.
4572
4573 Fixed bug in e2fsck where pass1b would bomb out if there were any
4574 blocks marked bad in the inode table.
4575
4576 Fixed rare bug in mke2fs where if the user had a very unlucky number
4577 of blocks in a filesystem (probability less than .002) the resulting
4578 filesystem would be corrupt in the last block group.
4579
4580 Fixed bug where if e2fsck tried to allocate a block to fix a
4581 filesystem corruption problem and the filesystem had no free blocks,
4582 ext2fs_new_block() would loop forever.
4583
4584 The configure script now checks explicitly to see if "-static" works,
4585 since that can't be assumed to be true --- RedHat doesn't install
4586 libc-static by default.
4587
4588 Fixed bug in libext2's block iterator functions where under some
4589 cirmcustances, file with holes would cause the bcount parameter to the
4590 callback function to be incorrect.  This bug didn't affect any of
4591 e2fsprogs programs, but it was discovered by Paul Mackerras, the
4592 author of the PPC boot loader.
4593
4594 Removed use of static variables to store the inode cache in libext2fs.
4595 This caused problems if more than one filesystem was accessed via
4596 libext2fs (static variables in libraries are generally a bad idea).
4597 Again, this didn't affect e2fsprogs programs, but it was discovered by
4598 Paul Mackerras.
4599
4600 Fixed minor bugs and version code drift to assure that e2fsprogs 1.10
4601 will compile cleanly with 1.2.13 kernels (even with a.out shared
4602 libraries!)
4603
4604 Programmer's notes:
4605 -------------------
4606
4607 Added new functions to duplicate an ext2 filesystem handle, and its
4608 associated substructure.  New functions: ext2fs_dup_handle(),
4609 ext2fs_copy_dblist(), ext2fs_badblocks_copy(), ext2fs_copy_bitmap().
4610 Other structures, such as the io_channel and the inode_cache, now have
4611 a ref count so that they only get freed when they are no longer used
4612 by any filesystem handle.  (These functions were added as part of the
4613 development effort for an ext2 resizer).
4614
4615 E2fsprogs 1.09 (April 14, 1997)
4616 ===============================
4617
4618 Fixed bug in mke2fs (really in lib/ext2fs/initialize.c) which was
4619 accidentally introduced in the 1.08 release.  The overhead calculation
4620 was accidentally removed, which caused ext2fs_initialize() to not
4621 notice when the filesystem size needed to be adjusted down because
4622 there wasn't enough space in the last block group.
4623
4624 Fixed bug in version parsing library routine; it was always parsing
4625 the library version string, instead of using the passed-in string.
4626
4627 Clarified chattr man page.
4628
4629 E2fsprogs 1.08 (April 10, 1997)
4630 ===============================
4631
4632 E2fsck 1.07 was very slow when checking very large filesystems with a
4633 lot of files that had hard links (i.e., news spools).  This was fixed
4634 by seriously revamping the icount abstraction.  Added a formal test
4635 suite for the icount abstraction.
4636
4637 Debugfs now has a "-l" option to the "ls" command, which lists the
4638 inode number, permissions, owner, group, size, and name of the files
4639 in the directory.
4640
4641 Fix a bug in e2fsck where when a directory had its blocks moved to
4642 another location during the pass 1b processing, the directory block
4643 list wasn't updated, so pass 2 wouldn't check (and correct) the
4644 correct directory block.
4645
4646 E2fsck will now treat inodes which contain blocks which are claimed by
4647 the filesystem metadata by treating them as multiply claimed blocks.
4648 This way, the data in those blocks can be copied to a new block during
4649 the pass 1b--1d processing.
4650
4651 E2fsck will attempt to determine the correct superblock number and
4652 display it in the diagnostic and warning messages if possible.
4653
4654 Add support for a new (incompatible) feature, "sparse_super".  This
4655 feature reduces the number of blocks which contain copies of backup
4656 superblocks and block group descriptors.  (It is only an incompatible
4657 feature because of a bug in ext2_free_blocks.)  mke2fs and tune2fs now
4658 support a new -s option; e2fsck will recognize filesystems built with
4659 this feature turned on.
4660
4661 E2fsck now checks the library to make sure is the correct version,
4662 using new library functions.  (This helps to diagnose incorrectly
4663 installed e2fsprogs distributions.)
4664
4665 Dumpe2fs now prints more information; its now prints the the
4666 filesystem revision number, the filesystem sparse_super feature (if
4667 present), the block ranges for each block group, and the offset from
4668 the beginning of the block group.
4669
4670 Mke2fs now distributes the inode and block bitmap blok so that the
4671 won't be concentrated in one or two disks in RAID/striping setups.
4672 Also, if the user chooses a 2k or 4k block group, mke2fs will try to
4673 choose the largest blocks per group that be chosen.  (For 2k blocks,
4674 you can have up to 16384 blocks/group; for 4k blocks, you can have up
4675 to 32768 blocks/group.)  Previously mke2fs would not allow
4676 specification of more than 8192 blocks per group, even if you were
4677 using a 2k or 4k block group.
4678
4679 Programmer's notes:
4680 -------------------
4681
4682 Added a new function ext2fs_create_icount2() which takes a "hint"
4683 argument.  This hint argument presets the icount array with the list
4684 of inodes which actually need to be in the icount array.  This really
4685 helps to speed up e2fsck.
4686
4687 Added a new function ext2fs_icount_validate() which checks the rep
4688 invariant for the icount structure.  This is used mostly for testing.
4689
4690 The error mesasage given when a bad inode number is passed to
4691 test_generic_bitmap to reflect EXT2FS_TEST_ERROR (instead of
4692 EXT2FS_UNMARK_ERROR).
4693
4694 Added a new function ext2fs_set_dir_block which sets the block of a
4695 dblist entry, given the directory inode and blockcnt.
4696
4697 Added a new function ext2fs_get_library_version() which returns the
4698 current library version, and ext2fs_parse_version_string() which
4699 returns a version number based on a e2fsprogs version string.
4700
4701 The icount functions will return EINVAL if the passed in inode number
4702 is out of bounds.
4703
4704 E2fsprogs 1.07 (March 9, 1997)
4705 ==============================
4706
4707 E2fsck is now uses much less memory when checking really large
4708 filesystems (or rather, filesystems with a large number of inodes).
4709 Previously a filesystem with 1 million inodes required 4 megabytes of
4710 memory to store inode count statistics; that storage requirement has
4711 now been reduced to roughly half a megabyte.
4712
4713 E2fsck can now properly deal with bad blocks appearing inside the
4714 inode table.  Instead of trying to relocate the inode table (which
4715 often failed because there wasn't enough space), the inodes in the bad
4716 block are marked as in use.
4717
4718 E2fsck will automatically try to use the backup superblocks if the
4719 primary superblocks have a bad magic number or have missing meta-data
4720 blocks (or meta-data blocks which are out of range).
4721
4722 E2fsck's pass 3 has been made more efficient; most noticeable on
4723 filesystems with a very large number of directories.
4724
4725 Completely revamped e2fsck's system of printing problem reports.  It
4726 is now table driven, to make them more easily customizeable and
4727 extendable.  Error messages which can be printed out during preen mode
4728 are now one line long.
4729
4730 Fixed e2fsck's filesystem swapping code so that it won't try to swap
4731 fast symbolic links or deleted files.
4732
4733 Fixed e2fsck core dumping when fixing a filesystem which has no
4734 directories (not even a root directory).
4735
4736 Added a check to e2fsck to make sure that the length of every
4737 directory entry is a multiple of 4 (since the kernel complains if it
4738 isn't).
4739
4740 Added a check to e2fsck to make sure that a directory entry isn't a
4741 link to the root directory, since that isn't allowed.
4742
4743 Added a check to e2fsk to now make sure the '.' and '..' directory
4744 entries are null terminated, since the 2.0 kernel requires it.
4745
4746 Added check to write_bitmaps() to make sure the superblock doesn't get
4747 trashed if the inode or block bitmap is marked as being block zero.
4748
4749 Added checking of the new feature set fields in the superblock, to
4750 avoid dealing with new filesystem features that this package wasn't
4751 set up to handle.
4752
4753 Fixed a fencepost error in ext2fs_new_block() which would occasionally
4754 try to allocate a block beyond the end of a filesystem.
4755
4756 When the UUID library picks a random IEEE 802 address (because it
4757 can't find one from a network card), it sets the multicast bit, to
4758 avoid conflicting with a legitimate IEEE 802 address.
4759
4760 Mke2fs now sets the root directory's owner to be the real uid of the
4761 user running mke2fs.  If the real uid is non-zero, it also sets
4762 the group ownership of the root directory to be the real group-id of
4763 the user running mke2fs.
4764
4765 Mke2fs now has more intelligent error checking when it is given a
4766 non-existent device.
4767
4768 When badblocks is given the -vv option, it now updates the block that
4769 it is currently testing on every block.
4770
4771 Fixed a bug in fsck where it wouldn't modify the PATH envirnoment
4772 currently correctly if PATH wasn't already set.
4773
4774 Shared libraries now built with dependencies.  This allows the shared
4775 library files to be used with dlopen(); it also makes the transition
4776 to libc 6 easier, since ld.so can tell which libc a particular shared
4777 library expects to use.
4778
4779 Programmer's notes:
4780 -------------------
4781
4782 Added new abstraction (defined in dblist.c) for maintaining a list of
4783 blocks which belongs to directories.  This is used in e2fsck and other
4784 programs which need to iterate over all directories.
4785
4786 Added new functions which test to see if a contiguous range of blocks
4787 (or inodes) are available.  (ext2fs_*_bitmap_range).
4788
4789 Added new function (ext2_inode_has_valid_blocks) which returns true if
4790 an inode has valid blocks.  (moved from e2fsck code).
4791
4792 Added new function (ext2fs_allocate_tables) which allocates the
4793 meta-data blocks as part of initializing a filesystem.  (moved from
4794 mke2fs code).
4795
4796 Added a new I/O manager for testing purposes.  It will either allow a
4797 program to intercept I/O requests, or print debugging messages to
4798 trace the activity of a program using the I/O manager.
4799
4800 The badblocks_list functions now store the bad blocks in a sorted
4801 order, and use a binary search to speed up badblocks_list_test.
4802
4803 The inode scan function ext2fs_get_next_inode() may now return a soft
4804 error returns: MISSING_INODE_TABLE and BAD_BLOCK_IN_INODE_TABLE in
4805 those cases where part of an inode table is missing or there is a bad
4806 block in the inode table.  
4807
4808 Added a new function (ext2fs_block_iterate2) which adds new arguments to
4809 the callback function to return a pointer (block and offset) to the
4810 reference of the block.
4811
4812 Added new function (ext2fs_inode_scan_goto_blockgroup) which allows an
4813 application to jump to a particular block group while doing an inode
4814 scan.
4815
4816 The badblocks list functions were renamed from badblocks_* to
4817 ext2fs_badblocks_*.  Backwards compatibility functions are available
4818 for now, but programs should be modified to use the new interface.
4819
4820 Some of the library functions were reorganized into separate files to
4821 reduce the size of some programs which statically link against the
4822 ext2 library.
4823
4824 Put in some miscellaneous fixes for the Alpha platform.
4825
4826
4827 E2fsprogs 1.06 (October 7, 1996)
4828 ================================
4829
4830 Fixed serious bug in e2fsck: if the block descriptors are bad, don't
4831 smash the backup copies in ext2fs_close().  (The problem was that when
4832 e2fsck -p discovered the problem, while it was closing the filesystem
4833 and exiting, it was also blowing away the backup superblocks on the
4834 disk, which was less than friendly.)  We now make it the case that we
4835 only write out the backup superblock and the back block descriptors if
4836 the filesystem is completely free from problems.
4837
4838 Fixed a bug in block_interate in the lib/ext2fs library which caused
4839 e2fsck to fail on GNU Hurd-created filesystems.
4840
4841 Add support for Linux/FT's bootloader, which actually uses
4842 EXT2_BOOT_LOADER, and sets its mode bits which caused e2fsck to want
4843 to clear the inode.
4844
4845 Add support for the "A" (no atime update) attribute.  (Note: this
4846 attribute is not yet in production kernels.)
4847
4848 The test suite is not automatically run when doing a "make all" from
4849 the top level directory.  Users should manually run "make check" if
4850 they wish to run the test suite.
4851
4852 Upon a preenhalt(), make the printed message more explicit that
4853 running e2fsck "MANAULLY" means without the -p or -a options.
4854
4855 In e2fsck, if a disconnected inode is zero-length, offer to clear it
4856 instead of offering to connect it to lost+found.
4857
4858 In e2fsck, if a filesystem was just unmounted uncleanly, and needs
4859 e2fsck to be run over it, change e2fsck to explicitly display this
4860 fact.
4861
4862 For dumpe2fs and e2fsck, cause the -V option to print out which
4863 version of the ext2fs library is actually getting used.  (This will
4864 help detect mismatches of using a 1.06 utility with a 1.05 library,
4865 etc.)
4866
4867 Programmers' notes:
4868 -------------------
4869
4870 EXT2_SWAP_BYTES was changed to EXT2_FLAG_SWAP_BYTES, which better fits
4871 the naming convention.
4872
4873 In ext2fs_initialize(), make sure the description for the inode bitmap
4874 is correctly initialize.
4875
4876 Fixed minor type typo in ext2fs_allocate_generic_bitmap();
4877
4878 E2fsprogs 1.05 (September 7, 1996)
4879 ==================================
4880
4881 Add support for new fields in the ext2 superblock --- volume name,
4882 volume UUID, and last mounted field.  Dumpe2fs displays these fields,
4883 tune2fs and mke2fs allows you to set them.  E2fsck will automatically
4884 generate a UUID for those volumes that don't have them.  
4885
4886 Put in support for e2fsck to recognize HURD specific ext2 features ---
4887 most notably, the translator block.  The e2fsprogs tools will now use
4888 the creator_os field in the superblock to correctly handle different
4889 OS-specific variants of the ext2 filesystem.
4890
4891 E2fsck now fixes inodes which have a the deletion time set, but which
4892 have a non-zero i_link_count field by offering to clear the deletion
4893 time.  Previously e2fsck assumed that the inode was deleted (per 0.3c
4894 ext2 kernel behavior) and offered to unlink the file.
4895
4896 If e2fsck sets the clean bit, but nothing else, set the exit code
4897 FSCK_NONDESTRUCT.  After all, e2fsck did fix a filesystem error --- it
4898 set the filesystem valid bit when it was previously cleared.  :-) This
4899 was needed to make the HURD fsck driver happy.
4900
4901 If the  user  refuses to attach an  unattached  inode, e2fsck  will no
4902 longer set the inode's link count.  Otherwise, the  inode would end up
4903 getting marked as unused, which might cause loss of data later.
4904
4905 Make the message issued by e2fsck when the superblock is corrupt less
4906 confusing for users.  It now mentions that another reason for the
4907 "corrupt superblock" message might be that the partition might not be
4908 an ext2 filesystem at all (it might swap, msdos filesystem, ufs, etc.)
4909
4910 Make the libext2 library more robuest so that e2fsck won't coredump on
4911 an illegal superblock where the blocksize is zero.  (f_crashdisk is
4912 the test case).
4913
4914 By default, create filesystems where the default checkinterval is 6
4915 months (180 days).  Linux servers can be robust enough that 20 reboots
4916 can be a long, long time.
4917
4918 Added configure flag --enable-old-bitops, which forces the bitops to
4919 use the old (native) bitmask operations.  By default on the sparc
4920 platform, the standard ext2 bit ordering is now used.
4921
4922 Added a new feature to e2fsck to byte-swap filesystems; this can be
4923 used to convert old m68k filesystems to use the standard byte-order
4924 storage for the superblock, inodes, and directory blocks.  This
4925 function is invoked by using the '-s' option to e2fsck.
4926
4927 Debugfs's "dump" command has been enhanced so that it writes out the
4928 exact size of the file so that the nulls at the end of the file are
4929 eliminated.  The command also accept a new "-p" option which will
4930 attempt preserve to preserve the ownernship, permissions, and
4931 file modification/access times.
4932
4933 Debugfs has two new options, -f and -R.  The -R option allows the user
4934 to execute a single debugfs command from the command line.  The -f
4935 option allows the user to specify a "command file" containing debugfs
4936 commands which will get executed.
4937
4938 Dumpe2fs now pretty prints the check interval, instead of just
4939 printing the check interval as a number of seconds.
4940
4941 Fix bugs in debugfs: the params command when no filesystem is opened
4942 no longer causes a core dump.  It is now possible to unlink a file
4943 when a pathame containing a '/' is specified.
4944
4945 Tune2fs has a new -C option which sets the number of times the
4946 filesystem has been mounted.
4947
4948 Fix the chattr '-v' option so that it actually works.  Chattr was
4949 being buggy about the -v option parsing.
4950
4951 Programmers' notes:
4952 -------------------
4953
4954 The directory lib/uuid contains a set of library routines to generate
4955 DCE compatible UUIDs.  
4956
4957 Extended ext2fs_namei() to handle symbolic links.  Added new function
4958 ext2fs_nami_follow() which will follow last symbolic link in the case
4959 where the pathname points to a sym link.
4960
4961 The ext2fs_block_iterate function will now return the HURD translator
4962 block, if present.  The new flag BLOCK_FLAG_DATA_ONLY will cause the
4963 iterator to return data blocks only.  The ext2fs.h file now defines
4964 constants BLOCK_COUNT_IND, BLOCK_COUNT_DIND, BLOCK_COUNT_TIND, and
4965 BLOCK_COUNT_TRANSLATOR, which are the magic values passed in the block
4966 count field of the iterator callback function.
4967
4968 The test script driver now takes an optional second argument, which is
4969 the test case to be run.  This allows you to run a test case without
4970 needing to run the entire test suite.
4971
4972 On Linux ELF systems, install the .so files in the correct places
4973 (/usr/lib).  The .so files must be stored in the same directory as the
4974 .a files.
4975
4976 Fixed miscellaneous HURD compilation issues with header file being
4977 included in the right order.
4978
4979 Fixed debugfs so that it resets optind to zero, not one, since setting
4980 optind to zero is more correct.
4981
4982
4983 E2fsprogs 1.04 (May 16, 1996)
4984 =============================
4985
4986 First "official" (1.03 was a limited release only) to support building
4987 e2fsprogs under Linux 2.0 kernels (as well as late model 1.3 and 1.99
4988 kernels).
4989
4990 This package includes a RPM specs file, that it can be built using the
4991 RedHat Package Manager.
4992
4993 E2fsck now prints a hint that if there are lots of incorrectly located
4994 inode bitmaps, block bitmaps, and inode table blocks, the user might
4995 want to try using e2fsck -b 8193 first, to see if that fares any
4996 better.
4997
4998 For ext2 filesystem written with the hurd, debugfs will now print out
4999 the translator field when printing an inode structure.
5000
5001 Lots of miscellaneous linking/installation cleanups:
5002
5003   Libraries are now linked using a relative pathname, instead of
5004   relying on -L working correct.  It doesn't, in many cases, including
5005   current versions of GNU ld.  This guarantees that the build tree is
5006   linking with the right libraries, instead of the ones installed in
5007   /usr/lib.
5008
5009   Header files, man pages, and the et/ss shell scripts are now
5010   generated using a custom substitution script, instead of relying on
5011   the configure script.  This prevents needless recompilation of
5012   files; in addition, the custom substitution script is much faster.
5013
5014   e2fsck may now be linked dynamically, by using the
5015   --enable-dynamic-e2fsck flag to configure.  This is not recommended,
5016   since it increases e2fsck's dependence on other files, but some
5017   people need to save disk space, and other critical programs on their
5018   systems were being linked dynamically anyway.
5019
5020   Programs such as fsck which didn't need to be linked against
5021   libext2fs (or mke2fs which didn't need to be linked against libe2p)
5022   only link against libraries they actually need.  Otherwise, those
5023   programs would require the presense of libraries that otherwise
5024   could be removed from a rescuse diskette.
5025
5026   The ss include files are now installed correctly so they can
5027   actually be used by another package.
5028
5029   If the profiling libraries are built, they are now installed on a
5030   "make install-libs".
5031
5032
5033 E2fsprogs 1.03 (March 27, 1996)
5034 ===============================
5035
5036 Change the m68k bit numbering for bitmasks to match the bit numbering
5037 used by all other ext2 implementations.  (This change was requested by
5038 the m68k kernel development team.)
5039
5040 Support (in-development) filesystem format revision which supports
5041 (among other things) dynamically sized inodes.
5042
5043 Fixed a bug in the ext2 library so that an intelligent error is
5044 returned if mke2fs is run with a ridiculously small number of blocks
5045 for a partition.
5046
5047 Fixed a bug in the ext2 library which required that the device be
5048 openable in read/write mode in order to determine its size.  This
5049 caused e2fsck -n to require read/write access when it was not
5050 previously necessary.
5051
5052 Fixed a bug in e2fsck which casued it to occasionally fail the test
5053 suite depending on which version of the floating point library it was
5054 using.
5055
5056 Fixed a bug in e2fsck so that it now halts with a fatal error when
5057 certain superblock consistency checks fail.  Previously it continued
5058 running e2fsck, with some potential confusing/damaging consequences.
5059
5060 Added new flag to fsck which allows the root to be checked in parallel
5061 with other filesytems.  This is not the safest thing in the world to
5062 do, but some system administrators really wanted it.
5063
5064 Fixed -Wall flames in lib/ss.
5065
5066
5067 E2fsprogs 1.02 (January 16, 1996)
5068 =================================
5069
5070 Fix to allow e2fsprogs to be compiled on recent 1.3 (pl45+) kernels.
5071
5072 Change e2fsck to print statistics of how many non-contiguous files are
5073 on the system.  Note that a file which is larger than 8k blocks, it is
5074 guaranteed to be non-contiguous.
5075
5076 In mke2fs, print a warning message if a user tries to format a whole
5077 disk (/dev/hda versus /dev/hda1).  If a user really wants to format a
5078 whole disk, the -F (force) option forces mke2fs to format a whole disk
5079 as a filesytem.
5080
5081 Fix a bug in fsck where in some cases it might start checking
5082 partitions in the next pass before it finishes checking partitions in
5083 the current pass.  This still won't cause two partitions on the same
5084 disk will be checked, so it's rarely a problem in real life.
5085
5086 Patch lsattr so that it won't hang when checking a named pipe.
5087
5088 Minor compilation fixes:
5089         * Fix the order of libraries that were linked in debugfs.
5090         * Allow the sources to be compiled with -ansi turned on.