Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.


CHFLAGS(1)                  General Commands Manual                 CHFLAGS(1)

NAME
     chflags - change file flags

SYNOPSIS
     chflags [-R [-H | -L | -P]] [-d] [-h] flags file ...

DESCRIPTION
     The chflags utility modifies the file flags of the listed files as
     specified 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
                 changed.

     -L          If the -R option is specified, all symbolic links are
                 followed.

     -P          If the -R option is specified, no symbolic links are
                 followed.

     -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
     currently defined:

           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.

EXIT STATUS
     The chflags utility exits 0 on success, and >0 if an error occurs.

SEE ALSO
     ls(1), chflags(2), lchflags(2), stat(2), fts(3), stat_flags(3),
     symlink(7), dump(8), init(8), secmodel_securelevel(9)

NetBSD 10.99                     May 25, 2023                     NetBSD 10.99