aboutsummaryrefslogtreecommitdiffstats
path: root/misc
diff options
context:
space:
mode:
authorTheodore Ts'o <tytso@mit.edu>2018-03-24 21:44:30 -0400
committerTheodore Ts'o <tytso@mit.edu>2018-03-24 22:27:51 -0400
commit46cf3712b39bc83bb5dbd6bd19ecc21af80d6ac1 (patch)
tree14cf7b2c032416acdace348c8fa476f46cc0e43e /misc
parentd7829f0500f543645a4e7499516e6212090721ae (diff)
downloadandroid_external_e2fsprogs-46cf3712b39bc83bb5dbd6bd19ecc21af80d6ac1.tar.gz
android_external_e2fsprogs-46cf3712b39bc83bb5dbd6bd19ecc21af80d6ac1.tar.bz2
android_external_e2fsprogs-46cf3712b39bc83bb5dbd6bd19ecc21af80d6ac1.zip
Add some minor clarifications to chattr's man page
Addresses-Debian-Bug: #890390 Signed-off-by: Theodore Ts'o <tytso@mit.edu>
Diffstat (limited to 'misc')
-rw-r--r--misc/chattr.1.in19
1 files changed, 10 insertions, 9 deletions
diff --git a/misc/chattr.1.in b/misc/chattr.1.in
index fa53ee70..fba9cea0 100644
--- a/misc/chattr.1.in
+++ b/misc/chattr.1.in
@@ -120,7 +120,8 @@ 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
+renamed, no link can be created to this file, most of the file's
+metadata can not be modified, and no data can be written
to the file. Only the superuser or a process possessing the
CAP_LINUX_IMMUTABLE capability can set or clear this attribute.
.PP
@@ -130,13 +131,13 @@ is being indexed using hashed trees. It may not be set or reset using
although it can be displayed by
.BR lsattr (1).
.PP
-A file with the 'j' attribute has all of its data written to the ext3
-or ext4 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=journal" option all file data
-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.
+A file with the 'j' attribute has all of its data written to the ext3 or
+ext4 journal before being written to the file itself, if the file system
+is mounted with the "data=ordered" or "data=writeback" options and the
+file system has a journal. When the filesystem is mounted with the
+"data=journal" option all file data 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
A file with the 'N' attribute set indicates that the file has data
stored inline, within the inode itself. It may not be set or reset using
@@ -191,7 +192,7 @@ The 'c', 's', and 'u' attributes are not honored
by the ext2, ext3, and ext4 filesystems as implemented in the current
mainline Linux kernels.
.PP
-The 'j' option is only useful if the filesystem is mounted as ext3 or ext4.
+The 'j' option is only useful for ext3 and ext4 file systems.
.PP
The 'D' option is only useful on Linux kernel 2.5.19 and later.
.SH AVAILABILITY