share/man/man1/chgrp.1

   1 '\" te
   2 .\" Copyright 1989 AT&T  Copyright (c) 1983 Regents of the University of California.  All rights reserved.  The Berkeley software License Agreement  specifies the terms and conditions for redistribution.
   3 .\" Copyright (c) 2003, Sun Microsystems, Inc.  All Rights Reserved
   4 .\" Portions Copyright (c) 1992, X/Open Company Limited  All Rights Reserved
   5 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at
   6 .\" http://www.opengroup.org/bookstore/.
   7 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
   8 .\"  This notice shall appear on any product containing this material.
   9 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
  10 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
  11 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
  12 .TH CHGRP 1 "Oct 25, 2017"
  13 .SH NAME
  14 chgrp \- change file group ownership
  15 .SH SYNOPSIS
  16 .LP
  17 .nf
  18 \fBchgrp\fR [\fB-fhR\fR] \fIgroup\fR \fIfile\fR...
  19 .fi
  20
  21 .LP
  22 .nf
  23 \fBchgrp\fR \fB-s\fR [\fB-fhR\fR] \fIgroupsid\fR \fIfile\fR...
  24 .fi
  25
  26 .LP
  27 .nf
  28 \fBchgrp\fR \fB-R\fR [f] [\fB-H\fR | \fB-L\fR | \fB-P\fR] \fIgroup\fR \fIfile\fR...
  29 .fi
  30
  31 .LP
  32 .nf
  33 \fBchgrp\fR \fB-s\fR \fB-R\fR [f] [\fB-H\fR | \fB-L\fR | \fB-P\fR] \fIgroupsid\fR \fIfile\fR...
  34 .fi
  35
  36 .SH DESCRIPTION
  37 .sp
  38 .LP
  39 The \fBchgrp\fR utility will set the group ID of the file named by each
  40 \fIfile\fR operand to the group ID specified by the \fIgroup\fR operand.
  41 .sp
  42 .LP
  43 For each \fIfile\fR operand, it will perform actions equivalent to the
  44 \fBchown\fR(2) function, called with the following arguments:
  45 .RS +4
  46 .TP
  47 .ie t \(bu
  48 .el o
  49 The \fIfile\fR operand will be used as the \fIpath\fR argument.
  50 .RE
  51 .RS +4
  52 .TP
  53 .ie t \(bu
  54 .el o
  55 The user ID of the file will be used as the \fIowner\fR argument.
  56 .RE
  57 .RS +4
  58 .TP
  59 .ie t \(bu
  60 .el o
  61 The specified group ID will be used as the \fIgroup\fR argument.
  62 .RE
  63 .sp
  64 .LP
  65 Unless \fBchgrp\fR is invoked by a process with appropriate privileges, the
  66 set-user-ID and set-group-ID bits of a regular file will be cleared upon
  67 successful completion; the set-user-ID and set-group-ID bits of other file
  68 types may be cleared.
  69 .sp
  70 .LP
  71 The operating system has a configuration option \fB_POSIX_CHOWN_RESTRICTED\fR,
  72 to restrict ownership changes. When this option is in effect, the owner of the
  73 file may change the group of the file only to a group to which the owner
  74 belongs. Only the super-user can arbitrarily change owner IDs, whether or not
  75 this option is in effect. To set this configuration option, include the
  76 following line in \fB/etc/system\fR:
  77 .sp
  78 .in +2
  79 .nf
  80 set rstchown = 1
  81 .fi
  82 .in -2
  83
  84 .sp
  85 .LP
  86 To disable this option, include the following line in \fB/etc/system\fR:
  87 .sp
  88 .in +2
  89 .nf
  90 set rstchown = 0
  91 .fi
  92 .in -2
  93
  94 .sp
  95 .LP
  96 \fB_POSIX_CHOWN_RESTRICTED\fR is enabled by default. See \fBsystem\fR(4) and
  97 \fBfpathconf\fR(2).
  98 .SH OPTIONS
  99 .sp
 100 .LP
 101 The following options are supported.
 102 .sp
 103 .ne 2
 104 .na
 105 \fB\fB-f\fR\fR
 106 .ad
 107 .RS 6n
 108 Force. Does not report errors.
 109 .RE
 110
 111 .sp
 112 .ne 2
 113 .na
 114 \fB\fB-h\fR\fR
 115 .ad
 116 .RS 6n
 117 If the file is a symbolic link, this option changes the group of the symbolic
 118 link. Without this option, the group of the file referenced by the symbolic
 119 link is changed.
 120 .RE
 121
 122 .sp
 123 .ne 2
 124 .na
 125 \fB\fB-H\fR\fR
 126 .ad
 127 .RS 6n
 128 If the file specified on the command line is a symbolic link referencing a file
 129 of type directory, this option changes the group of the directory referenced by
 130 the symbolic link and all the files in the file hierarchy below it. If a
 131 symbolic link is encountered when traversing a file hierarchy, the group of the
 132 target file is changed, but no recursion takes place.
 133 .RE
 134
 135 .sp
 136 .ne 2
 137 .na
 138 \fB\fB-L\fR\fR
 139 .ad
 140 .RS 6n
 141 If the file is a symbolic link, this option changes the group of the file
 142 referenced by the symbolic link. If the file specified on the command line, or
 143 encountered during the traversal of the file hierarchy, is a symbolic link
 144 referencing a file of type directory, then this option changes the group of the
 145 directory referenced by the symbolic link and all files in the file hierarchy
 146 below it.
 147 .RE
 148
 149 .sp
 150 .ne 2
 151 .na
 152 \fB\fB-P\fR\fR
 153 .ad
 154 .RS 6n
 155 If the file specified on the command line or encountered during the traversal
 156 of a file hierarchy is a symbolic link, this option changes the group of the
 157 symbolic link. This option does not follow the symbolic link to any other part
 158 of the file hierarchy.
 159 .RE
 160
 161 .sp
 162 .ne 2
 163 .na
 164 \fB\fB-s\fR\fR
 165 .ad
 166 .RS 6n
 167 The specified group is Windows SID. This option requires a file system that
 168 supports storing SIDs, such as ZFS.
 169 .RE
 170
 171 .sp
 172 .LP
 173 Specifying more than one of the mutually-exclusive options \fB-H\fR, \fB-L\fR,
 174 or \fB-P\fR is not considered an error. The last option specified determines
 175 the behavior of \fBchgrp\fR.
 176 .sp
 177 .ne 2
 178 .na
 179 \fB\fB-R\fR\fR
 180 .ad
 181 .RS 6n
 182 Recursive. \fBchgrp\fR descends through the directory, and any subdirectories,
 183 setting the specified group \fBID\fR as it proceeds. When a symbolic link is
 184 encountered, the group of the target file is changed, unless the \fB-h\fR or
 185 \fB-P\fR option is specified. Unless the \fB-H\fR, \fB-L\fR, or \fB-P\fR option
 186 is specified, the \fB-L\fR option is used as the default mode.
 187 .RE
 188
 189 .SH OPERANDS
 190 .sp
 191 .LP
 192 The following operands are supported:
 193 .sp
 194 .ne 2
 195 .na
 196 \fB\fIgroup\fR\fR
 197 .ad
 198 .RS 9n
 199 A group name from the group database or a numeric group ID. Either specifies a
 200 group ID to be given to each file named by one of the \fIfile\fR operands. If a
 201 numeric \fIgroup\fR operand exists in the group database as a group name, the
 202 group ID number associated with that group name is used as the group ID.
 203 .RE
 204
 205 .sp
 206 .ne 2
 207 .na
 208 \fB\fIfile\fR\fR
 209 .ad
 210 .RS 9n
 211 A path name of a file whose group ID is to be modified.
 212 .RE
 213
 214 .SH USAGE
 215 .sp
 216 .LP
 217 See \fBlargefile\fR(5) for the description of the behavior of \fBchgrp\fR when
 218 encountering files greater than or equal to 2 Gbyte (2^31 bytes).
 219 .SH ENVIRONMENT VARIABLES
 220 .sp
 221 .LP
 222 See \fBenviron\fR(5) for descriptions of the following environment variables
 223 that affect the execution of \fBchgrp\fR: \fBLANG\fR, \fBLC_ALL\fR,
 224 \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
 225 .SH EXIT STATUS
 226 .sp
 227 .LP
 228 The following exit values are returned:
 229 .sp
 230 .ne 2
 231 .na
 232 \fB\fB0\fR\fR
 233 .ad
 234 .RS 6n
 235 The utility executed successfully and all requested changes were made.
 236 .RE
 237
 238 .sp
 239 .ne 2
 240 .na
 241 \fB\fB>0\fR\fR
 242 .ad
 243 .RS 6n
 244 An error occurred.
 245 .RE
 246
 247 .SH FILES
 248 .sp
 249 .ne 2
 250 .na
 251 \fB\fB/etc/group\fR\fR
 252 .ad
 253 .RS 14n
 254 group file
 255 .RE
 256
 257 .SH ATTRIBUTES
 258 .sp
 259 .LP
 260 See \fBattributes\fR(5) for descriptions of the following attributes:
 261 .SS "/usr/bin/chgrp"
 262 .sp
 263
 264 .sp
 265 .TS
 266 box;
 267 c | c
 268 l | l .
 269 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 270 _
 271 CSI     Enabled. See NOTES.
 272 _
 273 Interface Stability     Committed
 274 _
 275 Standard        See \fBstandards\fR(5).
 276 .TE
 277
 278 .SH SEE ALSO
 279 .sp
 280 .LP
 281 \fBchmod\fR(1), \fBchown\fR(1), \fBid\fR(1M), \fBchown\fR(2),
 282 \fBfpathconf\fR(2), \fBgroup\fR(4), \fBpasswd\fR(4), \fBsystem\fR(4),
 283 \fBattributes\fR(5), \fBenviron\fR(5), \fBlargefile\fR(5), \fBstandards\fR(5)
 284 .SH NOTES
 285 .sp
 286 .LP
 287 \fBchgrp\fR is CSI-enabled except for the \fIgroup\fR name.