1997-04-26 17:21:57 +04:00
|
|
|
.\" -*- nroff -*-
|
1997-04-26 18:37:06 +04:00
|
|
|
.TH CHATTR 1 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
|
1997-04-26 17:21:57 +04:00
|
|
|
.SH NAME
|
|
|
|
chattr \- change file attributes on a Linux second extended file system
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B chattr
|
|
|
|
[
|
|
|
|
.B \-RV
|
|
|
|
]
|
|
|
|
[
|
Many files:
badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in,
fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in,
tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard
format (bold option flags and italicized variables), as suggested by
Andreas Dilger (adilger@enel.ucalgary.ca)
ChangeLog, e2fsck.8.in:
e2fsck.8.in: Update man page to use a more standard format (bold
option flags and italicized variables), as suggested by Andreas Dilger
(adilger@enel.ucalgary.ca)
ChangeLog, uuid_generate.3.in:
uuid_generate.8.in: Update man page to use a more standard format
(bold option flags and italicized variables), as suggested by Andreas
Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
|
|
|
.B \-v
|
|
|
|
.I version
|
1997-04-26 17:21:57 +04:00
|
|
|
]
|
|
|
|
[
|
Many files:
badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in,
fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in,
tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard
format (bold option flags and italicized variables), as suggested by
Andreas Dilger (adilger@enel.ucalgary.ca)
ChangeLog, e2fsck.8.in:
e2fsck.8.in: Update man page to use a more standard format (bold
option flags and italicized variables), as suggested by Andreas Dilger
(adilger@enel.ucalgary.ca)
ChangeLog, uuid_generate.3.in:
uuid_generate.8.in: Update man page to use a more standard format
(bold option flags and italicized variables), as suggested by Andreas
Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
|
|
|
.I mode
|
1997-04-26 17:21:57 +04:00
|
|
|
]
|
|
|
|
.I files...
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.B chattr
|
1997-05-09 07:06:31 +04:00
|
|
|
changes the file attributes on a Linux second extended file system.
|
1997-04-26 17:21:57 +04:00
|
|
|
.PP
|
2001-11-06 03:22:02 +03:00
|
|
|
The format of a symbolic mode is +-=[ASacdistu].
|
1997-04-26 17:21:57 +04:00
|
|
|
.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
|
2000-12-31 16:48:12 +03:00
|
|
|
The letters `ASacdijsu' select the new attributes for the files:
|
1997-04-29 21:57:00 +04:00
|
|
|
don't update atime (A), synchronous updates (S), append only (a),
|
2000-12-31 16:48:12 +03:00
|
|
|
compressed (c), no dump (d), immutable (i), data journalling (j),
|
1997-04-26 17:34:30 +04:00
|
|
|
secure deletion (s), and undeletable (u).
|
1997-04-26 17:21:57 +04:00
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
Many files:
badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in,
fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in,
tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard
format (bold option flags and italicized variables), as suggested by
Andreas Dilger (adilger@enel.ucalgary.ca)
ChangeLog, e2fsck.8.in:
e2fsck.8.in: Update man page to use a more standard format (bold
option flags and italicized variables), as suggested by Andreas Dilger
(adilger@enel.ucalgary.ca)
ChangeLog, uuid_generate.3.in:
uuid_generate.8.in: Update man page to use a more standard format
(bold option flags and italicized variables), as suggested by Andreas
Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
|
|
|
.B \-R
|
1997-04-26 17:21:57 +04:00
|
|
|
Recursively change attributes of directories and their contents.
|
1999-01-05 10:02:39 +03:00
|
|
|
Symbolic links encountered during recursive directory traversals are
|
|
|
|
ignored.
|
1997-04-26 17:21:57 +04:00
|
|
|
.TP
|
Many files:
badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in,
fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in,
tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard
format (bold option flags and italicized variables), as suggested by
Andreas Dilger (adilger@enel.ucalgary.ca)
ChangeLog, e2fsck.8.in:
e2fsck.8.in: Update man page to use a more standard format (bold
option flags and italicized variables), as suggested by Andreas Dilger
(adilger@enel.ucalgary.ca)
ChangeLog, uuid_generate.3.in:
uuid_generate.8.in: Update man page to use a more standard format
(bold option flags and italicized variables), as suggested by Andreas
Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
|
|
|
.B \-V
|
1999-01-05 10:02:39 +03:00
|
|
|
Be verbose with chattr's output and print the program version.
|
1997-04-26 17:21:57 +04:00
|
|
|
.TP
|
Many files:
badblocks.8.in, chattr.1.in, dumpe2fs.8.in, e2label.8.in,
fsck.8.in, lsattr.1.in, mke2fs.8.in, mklost+found.8.in,
tune2fs.8.in, uuidgen.1.in: Update man page to use a more standard
format (bold option flags and italicized variables), as suggested by
Andreas Dilger (adilger@enel.ucalgary.ca)
ChangeLog, e2fsck.8.in:
e2fsck.8.in: Update man page to use a more standard format (bold
option flags and italicized variables), as suggested by Andreas Dilger
(adilger@enel.ucalgary.ca)
ChangeLog, uuid_generate.3.in:
uuid_generate.8.in: Update man page to use a more standard format
(bold option flags and italicized variables), as suggested by Andreas
Dilger (adilger@enel.ucalgary.ca)
1999-10-21 23:56:34 +04:00
|
|
|
.BI \-v " version"
|
2000-02-11 08:00:19 +03:00
|
|
|
Set the file's version/generation number.
|
1997-04-26 17:34:30 +04:00
|
|
|
.SH ATTRIBUTES
|
1997-04-29 21:57:00 +04:00
|
|
|
When a file with the 'A' attribute set is modified, its atime record is
|
1997-05-09 07:06:31 +04:00
|
|
|
not modified. This avoids a certain amount of disk I/O for laptop
|
1997-04-29 21:57:00 +04:00
|
|
|
systems.
|
1998-03-30 05:20:55 +04:00
|
|
|
.PP
|
1997-04-26 17:34:30 +04:00
|
|
|
A file with the `a' attribute set can only be open in append mode for writing.
|
1998-03-30 05:20:55 +04:00
|
|
|
Only the superuser can set or clear this attribute.
|
|
|
|
.PP
|
1997-04-26 17:34:30 +04:00
|
|
|
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.
|
1998-03-30 05:20:55 +04:00
|
|
|
.PP
|
1997-04-26 17:34:30 +04:00
|
|
|
A file with the `d' attribute set is not candidate for backup when the
|
|
|
|
.BR dump (8)
|
|
|
|
program is run.
|
1998-03-30 05:20:55 +04:00
|
|
|
.PP
|
1997-04-26 17:34:30 +04:00
|
|
|
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.
|
1998-03-30 05:20:55 +04:00
|
|
|
.PP
|
2000-12-31 16:48:12 +03:00
|
|
|
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.
|
|
|
|
.PP
|
1997-04-26 17:34:30 +04:00
|
|
|
When a file with the `s' attribute set is deleted, its blocks are zeroed and
|
|
|
|
written back to the disk.
|
1998-03-30 05:20:55 +04:00
|
|
|
.PP
|
1997-04-26 17:34:30 +04:00
|
|
|
When a file with the `S' attribute set is modified,
|
|
|
|
the changes are written synchronously on the disk; this is equivalent to
|
|
|
|
the `sync' mount option applied to a subset of the files.
|
1998-03-30 05:20:55 +04:00
|
|
|
.PP
|
2001-11-06 03:22:02 +03:00
|
|
|
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
|
|
|
|
support tail-merging). This is necessary for applications such as LILO
|
|
|
|
which read the filesystem directly, and who don't understand tail-merged
|
|
|
|
files.
|
|
|
|
.PP
|
1997-05-09 07:06:31 +04:00
|
|
|
When a file with the `u' attribute set is deleted, its contents are saved.
|
1997-04-26 17:34:30 +04:00
|
|
|
This allows the user to ask for its undeletion.
|
1998-03-30 05:20:55 +04:00
|
|
|
.PP
|
1997-04-26 17:21:57 +04:00
|
|
|
.SH AUTHOR
|
|
|
|
.B chattr
|
2000-04-03 17:27:41 +04:00
|
|
|
was written by Remy Card <Remy.Card@linux.org>.
|
1997-04-26 17:21:57 +04:00
|
|
|
.SH BUGS AND LIMITATIONS
|
2000-04-03 17:27:41 +04:00
|
|
|
As of Linux 2.2, the `c', 's', and `u' attribute are not honored
|
2000-12-31 16:48:12 +03:00
|
|
|
by the kernel filesystem code. These attributes will be implemented
|
|
|
|
in a future ext2 fs version.
|
1997-04-26 17:21:57 +04:00
|
|
|
.PP
|
2000-12-31 16:48:12 +03:00
|
|
|
The `j' option is only useful if the filesystem is mounted as ext3.
|
1997-04-26 17:21:57 +04:00
|
|
|
.SH AVAILABILITY
|
|
|
|
.B chattr
|
2001-05-12 19:46:21 +04:00
|
|
|
is part of the e2fsprogs package and is available from
|
|
|
|
http://e2fsprogs.sourceforge.net.
|
1997-04-26 17:21:57 +04:00
|
|
|
.SH SEE ALSO
|
|
|
|
.BR lsattr (1)
|