unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

chgrp(1)                         User Commands                        chgrp(1)



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 argument.

         o  The specified group ID will be used as the group argument.


       Unless  chgrp  is invoked by a process with appropriate privileges, the
       set-user-ID and set-group-ID bits of a regular  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 fpath-
       conf(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 symbolic 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 spec-
                ified 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  dur-
                ing the traversal of a file hierarchy 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  sub-
                directories,  setting  the  specified group ID as it proceeds.
                When a symbolic link is encountered, the group of  the  target
                file is changed, unless the -h or -P option is specified. How-
                ever, 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 sub-
                directories, setting the specified group ID  as  it  proceeds.
                When  a  symbolic link is encountered, 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 database as a group name, the group ID number asso-
                ciated with that group name is used as the group ID.



       file     A path name of a file whose group ID is to be modified.



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_MES-
       SAGES, 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 attributes:

   /usr/bin/chgrp
       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).    ATTRIBUTE   TYPEATTRIBUTE  VALUE  AvailabilitySUNWcsu
       CSIEnabled (see NOTES) Interface StabilityStandard


   /usr/xpg4/bin/chgrp
       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).    ATTRIBUTE  TYPEATTRIBUTE  VALUE  AvailabilitySUNWxcu4
       CSIEnabled (see NOTES) Interface StabilityStandard


SEE ALSO
       chmod(1),   chown(1),   id(1M),   chown(2),   fpathconf(2),   group(4),
       passwd(4),  system(4),  attributes(5),  environ(5), largefile(5), stan-
       dards(5)

NOTES
       chgrp is CSI-enabled except for the group name.



SunOS 5.10                        25 Nov 2003                         chgrp(1)