IPB
>  Man Pages > Unix > Solaris 10 11/06 > Section 1 > chgrp man page

chgrp man page

Section 1 - Solaris 10 11/06 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!





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




SunOS 5.10          Last change: 25 Nov 2003                    1






User Commands                                            chgrp(1)



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




SunOS 5.10          Last change: 25 Nov 2003                    2






User Commands                                            chgrp(1)



     -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:





SunOS 5.10          Last change: 25 Nov 2003                    3






User Commands                                            chgrp(1)



     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.






SunOS 5.10          Last change: 25 Nov 2003                    4





Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Wed Sep 12 11:24:29 GMT 2007

Your favourite pages:

No pages logged yet...

Top 10 most popular pages:

prstat man page (24546 hits)
(Solaris 10 11_06)

netcat man page (17695 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (13530 hits)
(Solaris 10 11_06)

signal man page (12550 hits)
(Suse Linux 10.1)

startproc man page (11991 hits)
(Suse Linux 10.1)

raidctl man page (11357 hits)
(Solaris 10 11_06)

adv_cap_autoneg man page (10285 hits)
(Solaris 10 11_06)

sqlite3 man page (9729 hits)
(openSUSE 10.2)

CPAN man page (8947 hits)
(Suse Linux 10.1)

BusyBox man page (7702 hits)
(Suse Linux 10.1)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Cambridge Plus :: Pyrenees Ski Holidays :: PCB Layout Bedfordshire :: British Bike Piston Rings
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum