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.
Trying to save cookie...

Top 10 most popular pages:

ssh man page (4011 hits)
(Suse Linux 10.1)

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

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

svn man page (1146 hits)
(FreeBSD 6.2)

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

lwptut man page (1033 hits)
(Suse Linux 10.1)

startpar man page (808 hits)
(Suse Linux 10.1)

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

Net::Config man page (740 hits)
(Suse Linux 10.1)

oowriter man page (720 hits)
(Suse Linux 10.1)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: Pyrenees Ski Holidays :: PCB Layout Bedfordshire :: <Link Available>
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