OS Manuals

/usr/bin/chown

GNU core utilities

From coreutils 9.12-r7 (os), captured 2026-11-05 by running chown --help (exit 0). permalink

Also provided by 1 other package version
Usage: /usr/bin/chown [OPTION]... [OWNER][:[GROUP]] FILE...
  or:  /usr/bin/chown [OPTION]... --reference=RFILE FILE...
Change the owner and/or group of each FILE to OWNER and/or GROUP.
With --reference, change the owner and group of each FILE to those of RFILE.

  -c, --changes
         like verbose but report only when a change is made
  -f, --silent, --quiet
         suppress most error messages
  -v, --verbose
         output a diagnostic for every file processed
      --dereference
         affect the referent of each symbolic link (this is
         the default), rather than the symbolic link itself
  -h, --no-dereference
         affect symbolic links instead of any referenced file;
         useful only on systems that can change the ownership of a symlink
      --from=CURRENT_OWNER:CURRENT_GROUP
         change the ownership of each file only if its
         current owner and/or group match those specified here.
         Either may be omitted, in which case a match
         is not required for the omitted attribute
      --no-preserve-root
         do not treat '/' specially (the default)
      --preserve-root
         fail to operate recursively on '/'
      --reference=RFILE
         use RFILE's ownership rather than specifying values.
         RFILE is always dereferenced if a symbolic link.
  -R, --recursive
         operate on files and directories recursively

The following options modify how a hierarchy is traversed when the -R
option is also specified.  If more than one is specified, only the final
one takes effect. -P is the default.

  -H
         if a command line argument is a symlink to a directory, traverse it
  -L
         traverse every symbolic link to a directory encountered
  -P
         do not traverse any symbolic links

      --help
         display this help and exit
      --version
         output version information and exit

Owner is unchanged if missing.  Group is unchanged if missing, but changed
to login group if implied by a ':' following a symbolic OWNER.
OWNER and GROUP may be numeric as well as symbolic.

Examples:
  /usr/bin/chown root /u        Change the owner of /u to "root".
  /usr/bin/chown root:staff /u  Likewise, but also change its group to "staff".
  /usr/bin/chown -hR root /u    Change the owner of /u and subfiles to "root".

Report bugs to: <bug-coreutils@gnu.org>.
GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
General help using GNU software: <https://www.gnu.org/gethelp/>
Full documentation <https://www.gnu.org/software/coreutils/chown>
or available locally via: info '(coreutils) chown invocation'
Options (15)
OptionDescriptionSource
-c, --changeslike verbose but report only when a change is madehelp + man
-f, --silent, --quietsuppress most error messageshelp + man
-v, --verboseoutput a diagnostic for every file processedhelp + man
--dereferenceaffect the referent of each symbolic link (this is the default), rather than the symbolic link itselfhelp + man
-h, --no-dereferenceaffect symbolic links instead of any referenced file;help + man
--from CURRENT_OWNER:CURRENT_GROUPchange the ownership of each file only if its current owner and/or group match those specified here.help + man
--no-preserve-rootdo not treat '/' specially (the default)help + man
--preserve-rootfail to operate recursively on '/'help + man
--reference RFILEuse RFILE's ownership rather than specifying values.help + man
-R, --recursiveoperate on files and directories recursivelyhelp + man
-Hif a command line argument is a symlink to a directory, traverse ithelp + man
-Ltraverse every symbolic link to a directory encounteredhelp + man
-Pdo not traverse any symbolic linkshelp + man
--helpdisplay this help and exithelp + man
--versionoutput version information and exithelp + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.