projects / unix-history / blame
| Commit | Line | Data |
|---|---|---|
| 33e3bdbe KM |
1 | .\" Copyright (c) 1983 Regents of the University of California. |
| 2 | .\" All rights reserved. The Berkeley software License Agreement | |
| 3 | .\" specifies the terms and conditions for redistribution. | |
| 4 | .\" | |
| ca67e7b4 | 5 | .\" @(#)chgrp.1 6.3 (Berkeley) 4/21/88 |
| 33e3bdbe | 6 | .\" |
| ca67e7b4 | 7 | .TH CHGRP 1 "April 21, 1988" |
| 33e3bdbe KM |
8 | .UC 5 |
| 9 | .SH NAME | |
| 10 | chgrp \- change group | |
| 11 | .SH SYNOPSIS | |
| 12 | .B chgrp | |
| 19146e2d KB |
13 | [ |
| 14 | .B -Rf | |
| 15 | ] | |
| 33e3bdbe KM |
16 | group file ... |
| 17 | .SH DESCRIPTION | |
| 18 | .I Chgrp | |
| 19 | changes the group-ID of the | |
| 20 | .I files | |
| 21 | to | |
| 22 | .IR group . | |
| 23 | The group may be either a decimal GID or | |
| 24 | a group name found in the group-ID file. | |
| 25 | .PP | |
| 26 | The user invoking | |
| 27 | .I chgrp | |
| 28 | must belong | |
| 29 | to the specified group and be the owner of the file, or be the super-user. | |
| 30 | .PP | |
| 19146e2d | 31 | No errors, except for usage errors, are reported when the |
| 33e3bdbe KM |
32 | .B \-f |
| 33 | (force) option is given. | |
| b10ae48f KM |
34 | .PP |
| 35 | When the | |
| 36 | .B \-R | |
| 37 | option is given, | |
| 38 | .I chgrp | |
| 39 | recursively descends its directory arguments | |
| 40 | setting the specified group-ID. | |
| 2da69ef2 KM |
41 | When symbolic links are encountered, their group is changed, |
| 42 | but they are not traversed. | |
| 33e3bdbe | 43 | .SH "SEE ALSO" |
| 19146e2d | 44 | chown(1), chown(2), passwd(5), group(5) |