- NetBSD Manual Pages
CHFLAGS(1) NetBSD General Commands Manual CHFLAGS(1)
Powered by man-cgi (2021-06-01).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.
chflags -- change file flags
chflags [-R [-H | -L | -P]] [-d] [-h] flags file ...
The chflags utility modifies the file flags of the listed files as speci-
fied by the flags operand.
The options are as follows:
-d If the change requested would not alter the flags currently
set for file then attempt no change operation.
-H If the -R option is specified, symbolic links on the command
line are followed. Symbolic links encountered in the tree
traversal are not followed.
-h If the file or a file encountered during directory traversal
is a symbolic link, the file flags of the link itself are
-L If the -R option is specified, all symbolic links are fol-
-P If the -R option is specified, no symbolic links are fol-
-R Change the file flags for the file hierarchies rooted in the
files instead of just the files themselves.
Flags are a comma separated list of keywords. The following keywords are
Keyword Flag Permission
arch archived super-user only
opaque opaque owner or super-user
nodump nodump owner or super-user
sappnd system append-only super-user only
schg system immutable super-user only
uappnd user append-only owner or super-user
uchg user immutable owner or super-user
Putting the letters `no' before a keyword causes the flag to be turned
off. For example, nouchg requests the immutable bit should be cleared.
The -H, -L and -P options are ignored unless the -R option is specified.
In addition, these options override each other and the command's actions
are determined by the last one specified. The default is as if the -P
option had been specified.
The -o option of ls(1) is used to display the flags.
The kernel does not allow the flags on block and character devices to be
changed except by the super-user.
Note that the ability to clear certain flags is dependent on the current
kernel securelevel. See secmodel_securelevel(9) for details.
The chflags utility exits 0 on success, and >0 if an error occurs.
ls(1), chflags(2), lchflags(2), stat(2), fts(3), symlink(7), dump(8),
NetBSD 10.99 May 25, 2023 NetBSD 10.99