chattr.1.in: Update man page

diff --git a/misc/ChangeLog b/misc/ChangeLog
index 4c1cb1196ebb1b93a79549ff0a8e4673c64c5b43..c201928aad34d9117c897191f49b3947c6572bdc 100644 (file)
--- a/misc/ChangeLog
+++ b/misc/ChangeLog
@@ -1,3 +1,7 @@
+2002-11-08  Theodore Ts'o  <tytso@mit.edu>
+
+       * chattr.1.in: Update man page.
+
 2002-10-31  Theodore Ts'o  <tytso@mit.edu>
 
        * Release of E2fsprogs 1.30

diff --git a/misc/chattr.1.in b/misc/chattr.1.in
index 1e17bd89d63ce0a94d00fd0dd9cff7e5d520f029..6c9ecf106417c0a96ee2600b0cfe5ea8e49ad187 100644 (file)
--- a/misc/chattr.1.in
+++ b/misc/chattr.1.in
@@ -19,7 +19,7 @@ chattr \- change file attributes on a Linux second extended file system
 .B chattr
 changes the file attributes on a Linux second extended file system.
 .PP
-The format of a symbolic mode is +-=[ASacDdisTtu].
+The format of a symbolic mode is +-=[ASacDdIijsTtu].
 .PP
 The operator `+' causes the selected attributes to be added to the
 existing attributes of the files; `-' causes them to be removed; and
@@ -48,10 +48,11 @@ not modified.  This avoids a certain amount of disk I/O for laptop
 systems.
 .PP
 A file with the `a' attribute set can only be open in append mode for writing.
-Only the superuser can set or clear this attribute.
+Only the superuser or a process pessessing the CAP_LINUX_IMMUTABLE 
+capability can set or clear this attribute.
 .PP
 A file with the `c' attribute set is automatically compressed on the disk
-by the kernel. A read from this file returns uncompressed data. A write to
+by the kernel.  A read from this file returns uncompressed data.  A write to
 this file compresses data before storing them on the disk.
 .PP
 When a directory with the `D' attribute set is modified,
@@ -69,15 +70,24 @@ set or reset using
 although it can be displayed by
 .BR lsattr (1).
 .PP
+The 'I' attribute is used by the htree code to indicate that a directory
+is behind indexed using hashed trees.  It may not be set or reset using 
+.BR chattr (1),
+although it can be displayed by
+.BR lsattr (1).
+.PP
 A file with the `i' attribute cannot be modified: it cannot be deleted or
 renamed, no link can be created to this file and no data can be written
-to the file. Only the superuser can set or clear this attribute.
+to the file.  Only the superuser or a process pessessing the
+CAP_LINUX_IMMUTABLE capability can set or clear this attribute.
 .PP
 A file with the `j' attribute has all of its data written to the ext3
 journal before being written to the file itself, if the filesystem is
 mounted with the "data=ordered" or "data=writeback" options.  When the
 filesystem is mounted with the "data=journalled" option all file data
-is already journalled and this attribute has no effect.
+is already journalled and this attribute has no effect.  
+Only the superuser or a process possessing the CAP_SYS_RESOURCE
+capability can set or clear this attribute.
 .PP
 When a file with the `s' attribute set is deleted, its blocks are zeroed and
 written back to the disk.
@@ -88,7 +98,7 @@ the `sync' mount option applied to a subset of the files.
 .PP
 A directory with the 'T' attribute will be deemed to be the top of 
 directory hierarchies for the purposes of the Orlov block allocator
-(which is used in newer kernels).
+(which is used in on systems with Linux 2.5.46 or later).
 .PP
 A file with the 't' attribute will not have a partial block fragment at
 the of the file merged with other files (for those filesystems which