xref: /freebsd/usr.sbin/chown/chgrp.1 (revision c98323078dede7579020518ec84cdcb478e5c142)
1.\" Copyright (c) 1983, 1990, 1993, 1994
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" This code is derived from software contributed to Berkeley by
5.\" the Institute of Electrical and Electronics Engineers, Inc.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. All advertising materials mentioning features or use of this software
16.\"    must display the following acknowledgement:
17.\"	This product includes software developed by the University of
18.\"	California, Berkeley and its contributors.
19.\" 4. Neither the name of the University nor the names of its contributors
20.\"    may be used to endorse or promote products derived from this software
21.\"    without specific prior written permission.
22.\"
23.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33.\" SUCH DAMAGE.
34.\"
35.\"     @(#)chgrp.1	8.3 (Berkeley) 3/31/94
36.\" $FreeBSD$
37.\"
38.Dd April 25, 2003
39.Dt CHGRP 1
40.Os
41.Sh NAME
42.Nm chgrp
43.Nd change group
44.Sh SYNOPSIS
45.Nm
46.Op Fl fhv
47.Oo
48.Fl R
49.Op Fl H | Fl L | Fl P
50.Oc
51.Ar group
52.Ar
53.Sh DESCRIPTION
54The
55.Nm
56utility sets the group ID of the file named by each
57.Ar file
58operand to the
59.Ar group
60ID specified by the group operand.
61.Pp
62The following options are available:
63.Bl -tag -width indent
64.It Fl H
65If the
66.Fl R
67option is specified, symbolic links on the command line are followed.
68(Symbolic links encountered in the tree traversal are not followed).
69.It Fl L
70If the
71.Fl R
72option is specified, all symbolic links are followed.
73.It Fl P
74If the
75.Fl R
76option is specified, no symbolic links are followed.
77This is the default.
78.It Fl R
79Change the group ID for the file hierarchies rooted
80in the files instead of just the files themselves.
81.It Fl f
82The force option ignores errors, except for usage errors and doesn't
83query about strange modes (unless the user does not have proper permissions).
84.It Fl h
85If the file is a symbolic link, the group ID of the link itself is changed
86rather than the file that is pointed to.
87.It Fl v
88Cause
89.Nm
90to be verbose, showing files as the group is modified.
91If the
92.Fl v
93flag is specified more than once,
94.Nm
95will print the filename, followed by the old and new numeric group ID.
96.El
97.Pp
98The
99.Fl H ,
100.Fl L
101and
102.Fl P
103options are ignored unless the
104.Fl R
105option is specified.
106In addition, these options override each other and the
107command's actions are determined by the last one specified.
108.Pp
109The
110.Ar group
111operand can be either a group name from the group database,
112or a numeric group ID.
113If a group name is also a numeric group ID, the operand is used as a
114group name.
115.Pp
116The user invoking
117.Nm
118must belong to the specified group and be the owner of the file,
119or be the super-user.
120.Sh DIAGNOSTICS
121.Ex -std
122.Sh COMPATIBILITY
123In previous versions of this system, symbolic links did not have groups.
124.Pp
125The
126.Fl v
127option is non-standard and its use in scripts is not recommended.
128.Sh FILES
129.Bl -tag -width /etc/group -compact
130.It Pa /etc/group
131group ID file
132.El
133.Sh SEE ALSO
134.Xr chown 2 ,
135.Xr fts 3 ,
136.Xr group 5 ,
137.Xr passwd 5 ,
138.Xr symlink 7 ,
139.Xr chown 8
140.Sh STANDARDS
141The
142.Nm
143utility is expected to be
144.St -p1003.2
145compatible.
146