X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=misc%2Fchattr.1.in;h=5949d096687b7bac5b4dd863e4281d87f59191cd;hb=1378bb6515e98a27f0f5c220381d49d20544204e;hp=33ef9a20f5916d5bfb3652a5877310b1c4765710;hpb=0fe40211b4b8931c3023164fc1037e639027b543;p=thirdparty%2Fe2fsprogs.git diff --git a/misc/chattr.1.in b/misc/chattr.1.in index 33ef9a20f..5949d0966 100644 --- a/misc/chattr.1.in +++ b/misc/chattr.1.in @@ -12,6 +12,10 @@ chattr \- change file attributes on a Linux file system .I version ] [ +.B \-p +.I project +] +[ .I mode ] .I files... @@ -19,13 +23,13 @@ chattr \- change file attributes on a Linux file system .B chattr changes the file attributes on a Linux file system. .PP -The format of a symbolic mode is +-=[aAcCdDeijsStTu]. +The format of a symbolic mode is +-=[aAcCdDeijPsStTu]. .PP The operator '+' causes the selected attributes to be added to the existing attributes of the files; '-' causes them to be removed; and '=' causes them to be the only attributes that the files have. .PP -The letters 'aAcCdDeijsStTu' select the new attributes for the files: +The letters 'aAcCdDeFijPsStTu' select the new attributes for the files: append only (a), no atime updates (A), compressed (c), @@ -33,8 +37,10 @@ no copy on write (C), no dump (d), synchronous directory updates (D), extent format (e), +case-insensitive directory lookups (F), immutable (i), data journalling (j), +project hierarchy (P), secure deletion (s), synchronous updates (S), no tail-merging (t), @@ -44,12 +50,9 @@ and undeletable (u). The following attributes are read-only, and may be listed by .BR lsattr (1) but not modified by chattr: -compression error (E), -huge file (h), +encrypted (E), indexed directory (I), -inline data (N), -compression raw access (X), -and compressed dirty file (Z). +and inline data (N). .PP Not all flags are supported or utilized by all filesystems; refer to filesystem-specific man pages such as @@ -71,6 +74,9 @@ Suppress most error messages. .TP .BI \-v " version" Set the file's version/generation number. +.TP +.BI \-p " project" +Set the file's project number. .SH ATTRIBUTES A file with the 'a' attribute set can only be open in append mode for writing. Only the superuser or a process possessing the CAP_LINUX_IMMUTABLE @@ -93,7 +99,7 @@ set on new or empty files. If it is set on a file which already has data blocks, it is undefined when the blocks assigned to the file will be fully stable. If the 'C' flag is set on a directory, it will have no effect on the directory, but new files created in that directory will -the No_COW attribute.) +have the No_COW attribute set.) .PP A file with the 'd' attribute set is not candidate for backup when the .BR dump (8) @@ -114,17 +120,16 @@ set or reset using although it can be displayed by .BR lsattr (1). .PP -The 'h' attribute indicates the file is storing its blocks in units of the -filesystem blocksize instead of in units of sectors, and means that the file -is (or at one time was) larger than 2TB. It may not be set or reset using -.BR chattr (1), -although it can be displayed by -.BR lsattr (1). +A directory with the 'F' attribute set indicates that all the path +lookups inside that directory are made in a case-insensitive fashion. +This attribute can only be changed in empty directories on file systems +with the fname_encoding feature enabled. .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 or a process possessing the -CAP_LINUX_IMMUTABLE capability can set or clear this attribute. +renamed, no link can be created to this file, most of the file's +metadata can not be modified, and the file can not be opened in write mode. +Only the superuser or a process possessing the CAP_LINUX_IMMUTABLE +capability can set or clear this attribute. .PP The 'I' attribute is used by the htree code to indicate that a directory is being indexed using hashed trees. It may not be set or reset using @@ -132,13 +137,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 @@ -146,6 +151,14 @@ stored inline, within the inode itself. It may not be set or reset using although it can be displayed by .BR lsattr (1). .PP +A directory with the 'P' attribute set will enforce a hierarchical +structure for project id's. This means that files and directory created +in the directory will inherit the project id of the directory, rename +operations are constrained so when a file or directory is moved into +another directory, that the project id's much match. In addition, a +hard link to file can only be created when the project id for the file +and the destination directory match. +.PP 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. @@ -176,19 +189,6 @@ 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 the raw contents of a compressed file can be accessed -directly. It currently may not be set or reset using -.BR chattr (1), -although it can be displayed by -.BR lsattr (1). -.PP -The 'Z' attribute is used by the experimental compression patches to -indicate a compressed file is dirty. It may not be set or reset using -.BR chattr (1), -although it can be displayed by -.BR lsattr (1). -.PP .SH AUTHOR .B chattr was written by Remy Card . It is currently being @@ -197,8 +197,10 @@ maintained by Theodore Ts'o . The 'c', 's', and 'u' attributes are not honored by the ext2, ext3, and ext4 filesystems as implemented in the current mainline Linux kernels. +Setting 'a' and 'i' attributes will not affect the ability to write +to already existing file descriptors. .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