|
|
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.