The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
PerlPowerTools-1.014
River stage one • 1 direct dependent • 1 total dependent
39 ++
/ chgrp

NAME

chgrp - change group ownership of files

SYNOPSIS

chgrp [-R [-H | -L | -P]] group file [files ...]

DESCRIPTION

chgrp sets the group ownership of files. The first argument after the options is the new group.

OPTIONS

chgrp accepts the options described below. The options -L, -H and -P are mutally exclusive, and only the last given option will be honoured. All of -L, -H and -P require the -R option to be set first.

-R

Recurse into directories. Any directories are recursively traversed, and all files and directories will change owner.

-L

Follow symbolic links. By default, chgrp will not follow symbolic links. This is a potential dangerous option, as chgrp will not check for cycles. Be careful. This option requires the -R option to be set.

-H

Follow symbolic links of command line files/directories only. This option requires the -R option to be set.

-P

Do not follow symbolic links at all. This option requires the -R option to be set.

ENVIRONMENT

The working of chgrp is not influenced by any environment variables.

BUGS

chgrp can loop forever when symbolic links create cycles.

chgrp uses File::Find to recurse.

REVISION HISTORY

    $Log: chgrp,v $
    Revision 1.2  2004/08/05 14:17:43  cwest
    cleanup, new version number on website

    Revision 1.1  2004/07/23 20:10:01  cwest
    initial import

    Revision 1.1  1999/03/02 22:34:29  abigail
    Initial revision

AUTHOR

The Perl implementation of chgrp was written by Abigail, perlpowertools@abigail.be.

COPYRIGHT and LICENSE

This program is copyright by Abigail 1999.

This program is free and open software. You may use, copy, modify, distribute and sell this program (and any modified variants) in any way you wish, provided you do not restrict others to do the same.