diff options
| author | Theodore Ts'o <tytso@mit.edu> | 2005-12-31 01:04:40 -0500 |
|---|---|---|
| committer | Theodore Ts'o <tytso@mit.edu> | 2005-12-31 01:04:40 -0500 |
| commit | 1aa3d56ae719425b04e4b1275f73367fb84983b1 (patch) | |
| tree | 7a1118e1961f1bdde6d3bdc3e5645a29e7fd8daa | |
| parent | eb065ccf181d49cd1a3709bf607c25d07a6322f1 (diff) | |
| download | e2fsprogs-1aa3d56ae719425b04e4b1275f73367fb84983b1.tar.gz e2fsprogs-1aa3d56ae719425b04e4b1275f73367fb84983b1.tar.xz e2fsprogs-1aa3d56ae719425b04e4b1275f73367fb84983b1.zip | |
Clarify chattr man page to make sure people realize limitations in the kernel
Add notes in chattr's man page to make sure the reader refers to the
BUGS AND LIMITATIONS section so that even an idiot will be able to see
that some of these attributes are not yet implemented. (Addresses
Debian Bug: #312515)
Signed-off-by: "Theodore Ts'o" <tytso@mit.edu>
| -rw-r--r-- | misc/ChangeLog | 7 | ||||
| -rw-r--r-- | misc/chattr.1.in | 17 |
2 files changed, 18 insertions, 6 deletions
diff --git a/misc/ChangeLog b/misc/ChangeLog index 773473fe..dd1c1daf 100644 --- a/misc/ChangeLog +++ b/misc/ChangeLog @@ -1,3 +1,10 @@ +2005-12-31 Theodore Ts'o <tytso@mit.edu> + + * chattr.1.in: Add notes in the man page to make sure the reader + refers to the BUGS AND LIMITATIONS section so that even an + idiot will be able to see that some of these attributes + are not yet implemented. (Addresses Debian Bug: #312515) + 2005-12-10 Theodore Ts'o <tytso@mit.edu> * dumpe2fs.c, e2image.c, filefrag.c, mke2fs.c: Fix various gcc diff --git a/misc/chattr.1.in b/misc/chattr.1.in index e5ea58e0..a8179e9a 100644 --- a/misc/chattr.1.in +++ b/misc/chattr.1.in @@ -53,7 +53,9 @@ 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 -this file compresses data before storing them on the disk. +this file compresses data before storing them on the disk. Note: please +make sure to read the bugs and limitations section at the end of this +document. .PP When a directory with the `D' attribute set is modified, the changes are written synchronously on the disk; this is equivalent to @@ -89,8 +91,9 @@ 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. +When a file with the `s' attribute set is deleted, its blocks are zeroed +and written back to the disk. Note: please make sure to read the bugs +and limitations section at the end of this document. .PP When a file with the `S' attribute set is modified, the changes are written synchronously on the disk; this is equivalent to @@ -107,8 +110,10 @@ which read the filesystem directly, and which don't understand tail-merged files. Note: As of this writing, the ext2 or ext3 filesystems do not (yet, except in very experimental patches) support tail-merging. .PP -When a file with the `u' attribute set is deleted, its contents are saved. -This allows the user to ask for its undeletion. +When a file with the `u' attribute set is deleted, its contents are +saved. This allows the user to ask for its undeletion. Note: please +make sure to read the bugs and limitations section at the end of this +document. .PP The 'X' attribute is used by the experimental compression patches to indicate that a raw contents of a compressed file can be accessed @@ -131,7 +136,7 @@ maintained by Theodore Ts'o <tytso@alum.mit.edu>. The `c', 's', and `u' attributes are not honored by the ext2 and ext3 filesystems as implemented in the current mainline Linux kernels. These attributes may be implemented -in future versions ext2 and ext3. +in future versions of the ext2 and ext3 filesystems. .PP The `j' option is only useful if the filesystem is mounted as ext3. .PP |