From 1aa3d56ae719425b04e4b1275f73367fb84983b1 Mon Sep 17 00:00:00 2001 From: Theodore Ts'o Date: Sat, 31 Dec 2005 01:04:40 -0500 Subject: [PATCH] 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" --- misc/ChangeLog | 7 +++++++ misc/chattr.1.in | 17 +++++++++++------ 2 files changed, 18 insertions(+), 6 deletions(-) diff --git a/misc/ChangeLog b/misc/ChangeLog index 773473feb..dd1c1dafd 100644 --- a/misc/ChangeLog +++ b/misc/ChangeLog @@ -1,3 +1,10 @@ +2005-12-31 Theodore Ts'o + + * 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 * dumpe2fs.c, e2image.c, filefrag.c, mke2fs.c: Fix various gcc diff --git a/misc/chattr.1.in b/misc/chattr.1.in index e5ea58e06..a8179e9a2 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 . 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 -- 2.47.3