korg/e2fsprogs
0
0
Fork 0
mirror of https://git.kernel.org/pub/scm/fs/ext2/e2fsprogs.git synced 2024-11-27 03:54:19 +08:00
Code Issues Packages Projects Releases Wiki Activity
dede39bbb8
e2fsprogs/misc/chattr.1.in

90 lines
2.9 KiB
Groff
Raw Normal View History

Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08:00
.\" -*- nroff -*-
Many files: Checkin of e2fsprogs 1.02.
1997-04-26 22:37:06 +08:00
.TH CHATTR 1 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08: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-22 03:56:34 +08:00
.B \-v
.I version
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08: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-22 03:56:34 +08:00
.I mode
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08:00
]
.I files...
.SH DESCRIPTION
.B chattr
Many files: Fix minor typos and grammer oops found by Bill Hawes (whawes@star.net).
1997-05-09 11:06:31 +08:00
changes the file attributes on a Linux second extended file system.
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08:00
.PP
Many files: Checked in e2fsprogs 1.09
1997-04-30 01:57:00 +08:00
The format of a symbolic mode is +-=[ASacdisu].
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08: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
Many files: Checked in e2fsprogs 1.09
1997-04-30 01:57:00 +08:00
The letters `ASacdisu' select the new attributes for the files:
don't update atime (A), synchronous updates (S), append only (a),
compressed (c), immutable (i), no dump (d),
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:34:30 +08:00
secure deletion (s), and undeletable (u).
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08: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-22 03:56:34 +08:00
.B \-R
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08:00
Recursively change attributes of directories and their contents.
ChangeLog, chattr.1.in, chattr.c, lsattr.1.in, lsattr.c: chattr.c, lsattr.c: Only print the version information for the program if the -V option is given. chattr.c: Ignore symbolic links when doing a recursive descent through a directory.
1999-01-05 15:02:39 +08:00
Symbolic links encountered during recursive directory traversals are
ignored.
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08: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-22 03:56:34 +08:00
.B \-V
ChangeLog, chattr.1.in, chattr.c, lsattr.1.in, lsattr.c: chattr.c, lsattr.c: Only print the version information for the program if the -V option is given. chattr.c: Ignore symbolic links when doing a recursive descent through a directory.
1999-01-05 15:02:39 +08:00
Be verbose with chattr's output and print the program version.
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08: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-22 03:56:34 +08:00
.BI \-v " version"
Set the filesystem version.
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:34:30 +08:00
.SH ATTRIBUTES
Many files: Checked in e2fsprogs 1.09
1997-04-30 01:57:00 +08:00
When a file with the 'A' attribute set is modified, its atime record is
Many files: Fix minor typos and grammer oops found by Bill Hawes (whawes@star.net).
1997-05-09 11:06:31 +08:00
not modified. This avoids a certain amount of disk I/O for laptop
Many files: Checked in e2fsprogs 1.09
1997-04-30 01:57:00 +08:00
systems.
Many files: e2label.c: Fix -Wall warning by making functions static. chattr.1.in: Document that the append-only attribute may only be set or cleared by the superuser. Update all manual pages to that the availability section is up-to-date. e2label.8.in, tune2fs.8.in: Update manual page to state that labels must be no longer than 16 characters, or they will be truncated. e2label.c (change_label), tune2fs.c (main): If the label is longer than 16 characters, print a warning message stating that the label will be truncated. mke2fs.c (PRS): If the user specifies a filesystem size, and it's larger than the apparent size of the device, print a warning message and ask if the user wants to proceed.
1998-03-30 09:20:55 +08:00
.PP
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:34:30 +08:00
A file with the `a' attribute set can only be open in append mode for writing.
Many files: e2label.c: Fix -Wall warning by making functions static. chattr.1.in: Document that the append-only attribute may only be set or cleared by the superuser. Update all manual pages to that the availability section is up-to-date. e2label.8.in, tune2fs.8.in: Update manual page to state that labels must be no longer than 16 characters, or they will be truncated. e2label.c (change_label), tune2fs.c (main): If the label is longer than 16 characters, print a warning message stating that the label will be truncated. mke2fs.c (PRS): If the user specifies a filesystem size, and it's larger than the apparent size of the device, print a warning message and ask if the user wants to proceed.
1998-03-30 09:20:55 +08:00
Only the superuser can set or clear this attribute.
.PP
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:34:30 +08: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.
Many files: e2label.c: Fix -Wall warning by making functions static. chattr.1.in: Document that the append-only attribute may only be set or cleared by the superuser. Update all manual pages to that the availability section is up-to-date. e2label.8.in, tune2fs.8.in: Update manual page to state that labels must be no longer than 16 characters, or they will be truncated. e2label.c (change_label), tune2fs.c (main): If the label is longer than 16 characters, print a warning message stating that the label will be truncated. mke2fs.c (PRS): If the user specifies a filesystem size, and it's larger than the apparent size of the device, print a warning message and ask if the user wants to proceed.
1998-03-30 09:20:55 +08:00
.PP
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:34:30 +08:00
A file with the `d' attribute set is not candidate for backup when the
.BR dump (8)
program is run.
Many files: e2label.c: Fix -Wall warning by making functions static. chattr.1.in: Document that the append-only attribute may only be set or cleared by the superuser. Update all manual pages to that the availability section is up-to-date. e2label.8.in, tune2fs.8.in: Update manual page to state that labels must be no longer than 16 characters, or they will be truncated. e2label.c (change_label), tune2fs.c (main): If the label is longer than 16 characters, print a warning message stating that the label will be truncated. mke2fs.c (PRS): If the user specifies a filesystem size, and it's larger than the apparent size of the device, print a warning message and ask if the user wants to proceed.
1998-03-30 09:20:55 +08:00
.PP
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:34:30 +08: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.
Many files: e2label.c: Fix -Wall warning by making functions static. chattr.1.in: Document that the append-only attribute may only be set or cleared by the superuser. Update all manual pages to that the availability section is up-to-date. e2label.8.in, tune2fs.8.in: Update manual page to state that labels must be no longer than 16 characters, or they will be truncated. e2label.c (change_label), tune2fs.c (main): If the label is longer than 16 characters, print a warning message stating that the label will be truncated. mke2fs.c (PRS): If the user specifies a filesystem size, and it's larger than the apparent size of the device, print a warning message and ask if the user wants to proceed.
1998-03-30 09:20:55 +08:00
.PP
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:34:30 +08:00
When a file with the `s' attribute set is deleted, its blocks are zeroed and
written back to the disk.
Many files: e2label.c: Fix -Wall warning by making functions static. chattr.1.in: Document that the append-only attribute may only be set or cleared by the superuser. Update all manual pages to that the availability section is up-to-date. e2label.8.in, tune2fs.8.in: Update manual page to state that labels must be no longer than 16 characters, or they will be truncated. e2label.c (change_label), tune2fs.c (main): If the label is longer than 16 characters, print a warning message stating that the label will be truncated. mke2fs.c (PRS): If the user specifies a filesystem size, and it's larger than the apparent size of the device, print a warning message and ask if the user wants to proceed.
1998-03-30 09:20:55 +08:00
.PP
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:34:30 +08: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.
Many files: e2label.c: Fix -Wall warning by making functions static. chattr.1.in: Document that the append-only attribute may only be set or cleared by the superuser. Update all manual pages to that the availability section is up-to-date. e2label.8.in, tune2fs.8.in: Update manual page to state that labels must be no longer than 16 characters, or they will be truncated. e2label.c (change_label), tune2fs.c (main): If the label is longer than 16 characters, print a warning message stating that the label will be truncated. mke2fs.c (PRS): If the user specifies a filesystem size, and it's larger than the apparent size of the device, print a warning message and ask if the user wants to proceed.
1998-03-30 09:20:55 +08:00
.PP
Many files: Fix minor typos and grammer oops found by Bill Hawes (whawes@star.net).
1997-05-09 11:06:31 +08:00
When a file with the `u' attribute set is deleted, its contents are saved.
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:34:30 +08:00
This allows the user to ask for its undeletion.
Many files: e2label.c: Fix -Wall warning by making functions static. chattr.1.in: Document that the append-only attribute may only be set or cleared by the superuser. Update all manual pages to that the availability section is up-to-date. e2label.8.in, tune2fs.8.in: Update manual page to state that labels must be no longer than 16 characters, or they will be truncated. e2label.c (change_label), tune2fs.c (main): If the label is longer than 16 characters, print a warning message stating that the label will be truncated. mke2fs.c (PRS): If the user specifies a filesystem size, and it's larger than the apparent size of the device, print a warning message and ask if the user wants to proceed.
1998-03-30 09:20:55 +08:00
.PP
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08:00
.SH AUTHOR
.B chattr
Many files: Fix minor typos and grammer oops found by Bill Hawes (whawes@star.net).
1997-05-09 11:06:31 +08:00
was written by Remy Card <card@masi.ibp.fr>, the developer and maintainer
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08:00
of the ext2 fs.
.SH BUGS AND LIMITATIONS
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:34:30 +08:00
As of ext2 fs 0.5a, the `c' and `u' attribute are not honoured by the kernel
Many files: Checked in e2fsprogs 1.06
1997-04-29 23:29:49 +08:00
code. As of the Linux 2.0 kernel, the 'A' attribute is not yet supported by
the kernel code. (The noatime code is still in testing.)
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08:00
.PP
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:34:30 +08:00
These attributes will be implemented in a future ext2 fs version.
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08:00
.SH AVAILABILITY
.B chattr
Many files: e2label.c: Fix -Wall warning by making functions static. chattr.1.in: Document that the append-only attribute may only be set or cleared by the superuser. Update all manual pages to that the availability section is up-to-date. e2label.8.in, tune2fs.8.in: Update manual page to state that labels must be no longer than 16 characters, or they will be truncated. e2label.c (change_label), tune2fs.c (main): If the label is longer than 16 characters, print a warning message stating that the label will be truncated. mke2fs.c (PRS): If the user specifies a filesystem size, and it's larger than the apparent size of the device, print a warning message and ask if the user wants to proceed.
1998-03-30 09:20:55 +08:00
is part of the e2fsprogs package and is available for anonymous
ftp from tsx-11.mit.edu in /pub/linux/packages/ext2fs.
Many files: Checkin of e2fsprogs 0.5b
1997-04-26 21:21:57 +08:00
.SH SEE ALSO
.BR lsattr (1)
Reference in New Issue Copy Permalink