Online Man Page

This form may be used to access the UNIX man pages. Note this form runs on a Solaris machine, so the results may disagree with other operating system implementations of the commands.

Topic:     Section:   Keyword search:


NAME

     chgrp - change file group ownership


SYNOPSIS

     chgrp [-fhR] group file...

     chgrp -R [f] [-H | -L | -P]  group file...


DESCRIPTION

     The chgrp utility will set the group ID of the file named by
     each  file  operand  to  the group ID specified by the group
     operand.

     For each file operand, it will perform actions equivalent to
     the  chown(2) function, called with the following arguments:

       o  The file operand will be used as the path argument.

       o  The user ID of the file will be used as the owner argu-
          ment.

       o  The specified group ID will be used as the group  argu-
          ment.

     Unless chgrp  is  invoked  by  a  process  with  appropriate
     privileges, the set-user-ID and set-group-ID bits of a regu-
     lar file will be cleared  upon  successful  completion;  the
     set-user-ID and set-group-ID bits of other file types may be
     cleared.

     The   operating   system   has   a   configuration    option
     _POSIX_CHOWN_RESTRICTED, to restrict ownership changes. When
     this option is in effect, the owner of the file  may  change
     the  group  of  the  file only to a group to which the owner
     belongs. Only the super-user can  arbitrarily  change  owner
     IDs,  whether  or  not this option is in effect. To set this
     configuration  option,  include  the   following   line   in
     /etc/system:

     set rstchown = 1

     To disable  this  option,  include  the  following  line  in
     /etc/system:

     set rstchown = 0

     _POSIX_CHOWN_RESTRICTED is enabled by default. See system(4)
     and fpathconf(2).


OPTIONS

     The following options are supported.

  /usr/bin/chgrp and /usr/xpg4/bin/chgrp
     -f       Force. Does not report errors.

     -h       If the file is a symbolic link, this option changes
              the  group  of  the  symbolic  link.  Without  this
              option, the group of the  file  referenced  by  the
              symbolic link is changed.

     -H       If the file specified on the command line is a sym-
              bolic  link  referencing  a file of type directory,
              this option changes  the  group  of  the  directory
              referenced  by  the symbolic link and all the files
              in the file hierarchy below it. If a symbolic  link
              is  encountered  when  traversing a file hierarchy,
              the group of the target file  is  changed,  but  no
              recursion takes place.

     -L       If the file is a symbolic link, this option changes
              the  group  of  the file referenced by the symbolic
              link. If the file specified on the command line, or
              encountered   during  the  traversal  of  the  file
              hierarchy, is a symbolic link referencing a file of
              type  directory, then this option changes the group
              of the directory referenced by  the  symbolic  link
              and all files in the file hierarchy below it.

     -P       If the  file  specified  on  the  command  line  or
              encountered  during the traversal of a file hierar-
              chy is a symbolic link,  this  option  changes  the
              group  of  the  symbolic link. This option does not
              follow the symbolic link to any other part  of  the
              file hierarchy.

     Specifying more than one of the  mutually-exclusive  options
     -H,  -L,  or  -P is not considered an error. The last option
     specified determines the behavior of chgrp.

  /usr/bin/chgrp

     -R       Recursive. chgrp descends  through  the  directory,
              and any subdirectories, setting the specified group
              ID as it proceeds. When a symbolic link is  encoun-
              tered,  the  group  of  the target file is changed,
              unless the -h or -P option is  specified.  However,
              no  recursion  takes  place,  unless  the  -H or -L
              option is specified.

  /usr/xpg4/bin/chgrp
     -R       Recursive. chgrp descends  through  the  directory,
              and any subdirectories, setting the specified group
              ID as it proceeds. When a symbolic link is  encoun-
              tered,  the  group  of  the target file is changed,
              unless the -h or -P option is specified. Unless the
              -H, -L, or -P option is specified, the -L option is
              used as the default mode.


OPERANDS

     The following operands are supported:

     group    A group name from the group database or  a  numeric
              group  ID.  Either specifies a group ID to be given
              to each file named by one of the file operands.  If
              a  numeric  group operand exists in the group data-
              base as a group name, the group ID  number  associ-
              ated with that group name is used as the group ID.

     file     A path name of a file whose group ID is to be modi-
              fied.


USAGE

     See largefile(5) for the  description  of  the  behavior  of
     chgrp  when  encountering  files  greater than or equal to 2
     Gbyte (2**31 bytes).


ENVIRONMENT VARIABLES

     See environ(5) for descriptions of the following environment
     variables  that affect the execution of chgrp: LANG, LC_ALL,
     LC_CTYPE, LC_MESSAGES, and NLSPATH.


EXIT STATUS

     The following exit values are returned:

     0        The utility executed successfully and all requested
              changes were made.

     >0       An error occurred.


FILES

     /etc/group      group file


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

  /usr/bin/chgrp
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|
    | CSI                         | Enabled (see NOTES)         |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|

  /usr/xpg4/bin/chgrp
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWxcu4                    |
    |_____________________________|_____________________________|
    | CSI                         | Enabled (see NOTES)         |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|


SEE ALSO

     chmod(1),   chown(1),   id(1M),   chown(2),    fpathconf(2),
     group(4),  passwd(4),  system(4), attributes(5), environ(5),
     largefile(5), standards(5)


NOTES

     chgrp is CSI-enabled except for the group name.