Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
CHFLAGS(1)              FreeBSD General Commands Manual             CHFLAGS(1)

NAME
     chflags - change file flags

SYNOPSIS
     chflags [-h] [-R [-H | -L | -P]] 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:

     -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 is a symbolic link, change the mode of the link
             itself rather than the file to which it points.

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

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

     -R      Change the file flags for the file hierarchies rooted in the
             files instead of just the files themselves.

     The flags are specified as an octal number or a comma separated list of
     keywords.  The following keywords are currently defined:

           arch, archived
                       set the archived flag (super-user only)

           opaque      set the opaque flag (owner or super-user only)

           nodump      set the nodump flag (owner or super-user only)

           sappnd, sappend
                       set the system append-only flag (super-user only)

           schg, schange, simmutable
                       set the system immutable flag (super-user only)

           sunlnk, sunlink
                       set the system undeletable flag (super-user only)

           uappnd, uappend
                       set the user append-only flag (owner or super-user
                       only)

           uchg, uchange, uimmutable
                       set the user immutable flag (owner or super-user only)

           uunlnk, uunlink
                       set the user undeletable flag (owner or super-user
                       only)

     Putting the letters ``no'' before or removing the letters ``no'' from a
     keyword causes the flag to be cleared.  For example:

           nouchg  clear the user immutable flag (owner or super-user only)
           dump    clear the nodump flag (owner or super-user only)

     Unless the -H, -L, or -h options are given, chflags on a symbolic link
     always succeeds and has no effect.  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.

     You can use "ls -lo" to see the flags of existing files.

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

SEE ALSO
     ls(1), chflags(2), stat(2), fts(3), symlink(7)

HISTORY
     The chflags command first appeared in 4.4BSD.

BUGS
     Only a limited number of utilities are chflags aware.  Some of these
     tools include ls(1), cp(1), find(1), install(1), dump(8), and restore(8).
     In particular a tool which is not currently chflags aware is the pax(1)
     utility.

FreeBSD 11.0-PRERELEASE          May 14, 2005          FreeBSD 11.0-PRERELEASE

NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | SEE ALSO | HISTORY | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=chflags&sektion=1&manpath=FreeBSD+6.1-RELEASE>

home | help