CHGRP man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

CHGRP(1)							      CHGRP(1)

NAME
       chgrp - change file group ownership

SYNOPSIS
       chgrp [-fhR] group file...

       chgrp -s [-fhR] groupsid file...

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

       chgrp -s -R [f] [-H | -L | -P] groupsid 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 ref‐
	     erencing 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 hierar‐
	     chy below it.

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

       -s
	     The  specified  group is Windows SID. This option requires a file
	     system that supports storing SIDs, such as ZFS.

       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	subdi‐
	     rectories,	 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. 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	subdi‐
	     rectories,	 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
       ┌────────────────────┬─────────────────────┐
       │  ATTRIBUTE TYPE    │	ATTRIBUTE VALUE	  │
       ├────────────────────┼─────────────────────┤
       │CSI		    │ Enabled. See NOTES. │
       ├────────────────────┼─────────────────────┤
       │Interface Stability │ Committed		  │
       ├────────────────────┼─────────────────────┤
       │Standard	    │ See standards(5).	  │
       └────────────────────┴─────────────────────┘

   /usr/xpg4/bin/chgrp
       ┌────────────────────┬─────────────────────┐
       │  ATTRIBUTE TYPE    │	ATTRIBUTE VALUE	  │
       ├────────────────────┼─────────────────────┤
       │CSI		    │ Enabled. See NOTES. │
       ├────────────────────┼─────────────────────┤
       │Interface Stability │ Committed		  │
       ├────────────────────┼─────────────────────┤
       │Standard	    │ See standards(5).	  │
       └────────────────────┴─────────────────────┘

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.

				 Jul 11, 2008			      CHGRP(1)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net