← Back to branch summary

~daniel-mehrmann/e2fsprogs/master

« back to all changes in this revision

Viewing changes to misc/chattr.1.in

  • Committer: Package Import Robot
  • Author(s): Dmitrijs Ledkovs
  • Date: 2012-06-14 13:01:21 UTC
  • mfrom: (8.4.18 sid)
  • Revision ID: package-import@ubuntu.com-20120614130121-t2gct0d09jepx0y6
Tags: 1.42.4-3ubuntu1
https://launchpad.net/bugs/978012
* Merge from Debian unstable (LP: #978012), remainging changes:
  - debian/control.in: 
      Build-depend on gettext:any instead of on gettext for (cross-building)
      Drop build dependency on dc, which hasn't been needed for some time.
      Update maintainer field.
  - debian/rules:
      Block pkg-create-dbgsym from operating on this package.
      Build without dietlibc-dev, which is in universe 
  - debian/control:
      Regenerate with ./debian/rules debian/control

Show diffs side-by-side

added added

removed removed

Lines of Context:
misc/chattr.1.in
27
27
.PP
28
28
The letters `acdeijstuADST' select the new attributes for the files:
29
29
append only (a), compressed (c), no dump (d), extent format (e), immutable (i),
30
 
data journalling (j), secure deletion (s), no tail-merging (t), 
31
 
undeletable (u), no atime updates (A), synchronous directory updates (D), 
 
30
data journalling (j), secure deletion (s), no tail-merging (t),
 
31
undeletable (u), no atime updates (A), synchronous directory updates (D),
32
32
synchronous updates (S), and top of directory hierarchy (T).
33
33
.PP
34
34
The following attributes are read-only, and may be listed by
55
55
systems.
56
56
.PP
57
57
A file with the `a' attribute set can only be open in append mode for writing.
58
 
Only the superuser or a process possessing the CAP_LINUX_IMMUTABLE 
 
58
Only the superuser or a process possessing the CAP_LINUX_IMMUTABLE
59
59
capability can set or clear this attribute.
60
60
.PP
61
61
A file with the `c' attribute set is automatically compressed on the disk
62
62
by the kernel.  A read from this file returns uncompressed data.  A write to
63
 
this file compresses data before storing them on the disk.  Note: please 
 
63
this file compresses data before storing them on the disk.  Note: please
64
64
make sure to read the bugs and limitations section at the end of this
65
65
document.
66
66
.PP
 
67
A file with the 'C' attribute set will not be subject to copy-on-write
 
68
updates.  This flag is only supported on file systems which perform
 
69
copy-on-write.  (Note: For btrfs, the 'C' flag should be
 
70
set on new or empty files.  If it is set on a file which already has
 
71
data blocks, it is undefined when the blocks assigned to the file will
 
72
be fully stable.  If the 'C' flag is set on a directory, it will have no
 
73
effect on the directory, but new files created in that directory will
 
74
the No_COW attribute.)
 
75
.PP
67
76
When a directory with the `D' attribute set is modified,
68
77
the changes are written synchronously on the disk; this is equivalent to
69
78
the `dirsync' mount option applied to a subset of the files.
72
81
.BR dump (8)
73
82
program is run.
74
83
.PP
75
 
The 'E' attribute is used by the experimental compression patches to 
 
84
The 'E' attribute is used by the experimental compression patches to
76
85
indicate that a compressed file has a compression error.  It may not be
77
 
set or reset using 
 
86
set or reset using
78
87
.BR chattr (1),
79
88
although it can be displayed by
80
89
.BR lsattr (1).
84
93
.BR chattr (1).
85
94
.PP
86
95
The 'I' attribute is used by the htree code to indicate that a directory
87
 
is being indexed using hashed trees.  It may not be set or reset using 
 
96
is being indexed using hashed trees.  It may not be set or reset using
88
97
.BR chattr (1),
89
98
although it can be displayed by
90
99
.BR lsattr (1).
105
114
journal before being written to the file itself, if the filesystem is
106
115
mounted with the "data=ordered" or "data=writeback" options.  When the
107
116
filesystem is mounted with the "data=journal" option all file data
108
 
is already journalled and this attribute has no effect.  
109
 
Only the superuser or a process possessing the CAP_SYS_RESOURCE
 
117
is already journalled and this attribute has no effect.  Only
 
118
the superuser or a process possessing the CAP_SYS_RESOURCE
110
119
capability can set or clear this attribute.
111
120
.PP
112
121
When a file with the `s' attribute set is deleted, its blocks are zeroed
117
126
the changes are written synchronously on the disk; this is equivalent to
118
127
the `sync' mount option applied to a subset of the files.
119
128
.PP
120
 
A directory with the 'T' attribute will be deemed to be the top of 
 
129
A directory with the 'T' attribute will be deemed to be the top of
121
130
directory hierarchies for the purposes of the Orlov block allocator.
122
131
This is a hint to the block allocator used by ext3 and ext4 that the
123
132
subdirectories under this directory are not related, and thus should be
129
138
.PP
130
139
A file with the 't' attribute will not have a partial block fragment at
131
140
the end of the file merged with other files (for those filesystems which
132
 
support tail-merging).  This is necessary for applications such as LILO 
 
141
support tail-merging).  This is necessary for applications such as LILO
133
142
which read the filesystem directly, and which don't understand tail-merged
134
143
files.  Note: As of this writing, the ext2 or ext3 filesystems do not
135
144
(yet, except in very experimental patches) support tail-merging.
139
148
make sure to read the bugs and limitations section at the end of this
140
149
document.
141
150
.PP
142
 
The 'X' attribute is used by the experimental compression patches to 
 
151
The 'X' attribute is used by the experimental compression patches to
143
152
indicate that a raw contents of a compressed file can be accessed
144
 
directly.  It currently may not be set or reset using 
 
153
directly.  It currently may not be set or reset using
145
154
.BR chattr (1),
146
155
although it can be displayed by
147
156
.BR lsattr (1).
148
157
.PP
149
 
The 'Z' attribute is used by the experimental compression patches to 
150
 
indicate a compressed file is dirty.  It may not be set or reset using 
 
158
The 'Z' attribute is used by the experimental compression patches to
 
159
indicate a compressed file is dirty.  It may not be set or reset using
151
160
.BR chattr (1),
152
161
although it can be displayed by
153
162
.BR lsattr (1).
157
166
was written by Remy Card <Remy.Card@linux.org>.  It is currently being
158
167
maintained by Theodore Ts'o <tytso@alum.mit.edu>.
159
168
.SH BUGS AND LIMITATIONS
160
 
The `c', 's',  and `u' attributes are not honored 
 
169
The `c', 's',  and `u' attributes are not honored
161
170
by the ext2 and ext3 filesystems as implemented in the current mainline
162
 
Linux kernels.    These attributes may be implemented
163
 
in future versions of the ext2 and ext3 filesystems.
 
171
Linux kernels.
164
172
.PP
165
173
The `j' option is only useful if the filesystem is mounted as ext3.
166
174
.PP