4.4BSD/usr/share/man/cat8/chown.0

Compare this file to the similar file:
Show the results in this format:
CHOWN(8)                  BSD System Manager's Manual                 CHOWN(8)

NNAAMMEE
     cchhoowwnn - change file owner and group

SSYYNNOOPPSSIISS
     cchhoowwnn [--HHRRffhh] _o_w_n_e_r [_:_g_r_o_u_p] _f_i_l_e _._._.
     cchhoowwnn [--HHRRffhh] _:_g_r_o_u_p _f_i_l_e _._._.

DDEESSCCRRIIPPTTIIOONN
     CChhoowwnn sets the user ID and/or the group ID of the specified files.

     The options are as follows:

     --HH      When encountering a symbolic link on the command line, follow it.
             All other symbolic links encountered in the traversal are not
             followed.

     --RR      Change the user ID and/or the group ID for the file hierarchies
             rooted in the files instead of just the files themselves.

     --ff      Don't report any failure to change file owner or group, nor modi-
             fy the exit status to reflect such failures.

     --hh      When encountering a symbolic link anywhere in the traversal, fol-
             low it.

     The ownership of a symbolic link is immutable, so unless the --hh or --HH
     flag is set, cchhoowwnn on a symbolic link is a no-op.

     The _o_w_n_e_r and _g_r_o_u_p operands are both optional, however, one must be
     specified.  If the _g_r_o_u_p operand is specified, it must be preceded by a
     colon (``:'') character.

     The _o_w_n_e_r may be either a numeric user ID or a user name.  If a user name
     is also a numeric user ID, the operand is used as a user name.  The _g_r_o_u_p
     may be either a numeric group ID or a group name.  If a group name is al-
     so a numeric group ID, the operand is used as a group name.

     The ownership of a file may only be altered by a super-user for obvious
     security reasons.

     The cchhoowwnn utility exits 0 on success, and >0 if an error occurs.

CCOOMMPPAATTIIBBIILLIITTYY
     Previous versions of the cchhoowwnn utility used the dot (``.'') character to
     distinguish the group name.  This has been changed to be a colon (``:'')
     character so that user and group names may contain the dot character.

SSEEEE AALLSSOO
     chgrp(1),  find(1),  chown(2),  fts(3),  symlink(7)

SSTTAANNDDAARRDDSS
     The cchhoowwnn command is expected to be POSIX 1003.2 compliant.

4th Berkeley Distribution        June 29, 1993                               1