From 51f8f8d260bab06d8c5c3aa12470e7787dae4199 Mon Sep 17 00:00:00 2001 From: Theodore Ts'o Date: Fri, 8 Nov 2002 20:02:21 -0500 Subject: [PATCH] chattr.1.in: Update man page --- misc/ChangeLog | 4 ++++ misc/chattr.1.in | 22 ++++++++++++++++------ 2 files changed, 20 insertions(+), 6 deletions(-) diff --git a/misc/ChangeLog b/misc/ChangeLog index 4c1cb119..c201928a 100644 --- a/misc/ChangeLog +++ b/misc/ChangeLog @@ -1,3 +1,7 @@ +2002-11-08 Theodore Ts'o + + * chattr.1.in: Update man page. + 2002-10-31 Theodore Ts'o * Release of E2fsprogs 1.30 diff --git a/misc/chattr.1.in b/misc/chattr.1.in index 1e17bd89..6c9ecf10 100644 --- 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