Return to chgrp.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / chown

Annotation of 43BSDReno/usr.sbin/chown/chgrp.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983, 1990 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted provided
                      5: .\" that: (1) source distributions retain this entire copyright notice and
                      6: .\" comment, and (2) distributions including binaries display the following
                      7: .\" acknowledgement:  ``This product includes software developed by the
                      8: .\" University of California, Berkeley and its contributors'' in the
                      9: .\" documentation or other materials provided with the distribution and in
                     10: .\" all advertising materials mentioning features or use of this software.
                     11: .\" Neither the name of the University nor the names of its contributors may
                     12: .\" be used to endorse or promote products derived from this software without
                     13: .\" specific prior written permission.
                     14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     17: .\"
                     18: .\"     @(#)chgrp.1    6.5 (Berkeley) 7/24/90
                     19: .\"
                     20: .Dd July 24, 1990
                     21: .Dt CHGRP 1
                     22: .Os BSD 4.2
                     23: .Sh NAME
                     24: .Nm chgrp
                     25: .Nd change group
                     26: .Sh SYNOPSIS
                     27: .Nm chgrp
                     28: .Op Fl Rf
                     29: .Ar group
                     30: .Ar files ...
                     31: .Sh DESCRIPTION
                     32: The chgrp utility sets the group ID of the file named by each
                     33: .Ar file
                     34: operand to the
                     35: .Ar group
                     36: ID specified by the group operand.
                     37: .Pp
                     38: Options:
                     39: .Tw Ds
                     40: .Tp Fl R
                     41: Recursively change file group IDs.
                     42: For each
                     43: .Ar file
                     44: operand that names a directory, chgrp changes the
                     45: group of the directory and all files in the file
                     46: hierarchy below it.
                     47: When symbolic links are encountered, their group is changed,
                     48: but they are not traversed.
                     49: .Tp Fl f
                     50: The force option ignores errors, except for usage errors and doesn't
                     51: query about strange modes (unless user does not have proper permissions).
                     52: .Tp
                     53: .Pp
                     54: Operands:
                     55: .Tw Ds
                     56: .Tp Ar group
                     57: The
                     58: .Ar group
                     59: can be either a group name from the group database, or a numeric
                     60: group ID.
                     61: .Tp Ar file
                     62: A pathname of a file whose group ID is to be modified.
                     63: .Tp
                     64: .Pp
                     65: The user invoking
                     66: must belong
                     67: to the specified group and be the owner of the file, or be the super-user.
                     68: .Pp
                     69: The
                     70: .Nm chgrp
                     71: utility exits 0 on success, and >0 if an error occurs.
                     72: .Sh FILES
                     73: .Dw /etc/group
                     74: .Di L
                     75: .Dp Pa /etc/group
                     76: Group ID file
                     77: .Dp
                     78: .Sh SEE ALSO
                     79: .Xr chown 2 ,
                     80: .Xr chown 8 ,
                     81: .Xr group 5 ,
                     82: .Xr passwd 5
                     83: .Sh STANDARDS
                     84: The
                     85: .Nm chgrp
                     86: function is expected to be POSIX 1003.2 compatible.
                     87: This manual page is derived from the POSIX 1003.2 manual page.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.