chgrp(1)              MPE/iX Shell and Utilities              chgrp(1)
  ______________________________________________________________________

  NAME
       chgrp -- change the group ownership of files and/or directories

  SYNOPSIS
       chgrp [-fR] group pathname ...

  DESCRIPTION
       chgrp sets the group ID to group for the files and directories
       named by the pathname arguments.  group may be a group name from
       the group database, or a numeric group ID.

  Options
       chgrp accepts the following options:

       -f   does not issue an error message if chgrp cannot change the
            group ID.  In this case, chgrp always returns a status of
            zero.

       -R   If a pathname on the command line is the name of a direc-
            tory, chgrp changes the group ID of all files and subdirec-
            tories under that directory.  If chgrp cannot change some
            file or subdirectory under the directory, it continues to
            try to change the other files and subdirectories under the
            directory, but exits with a non-zero status.

  DIAGNOSTICS
       Possible exit status values are:

       0  You specified -f, or chgrp successfully changed the group own-
          ership of all the specified files and directories.

       1  Failure due to any of the following:
            -- unable to access a specified file
            -- unable to change the group of a specified file
            -- encountered a fatal error when you specified -R option

       2  Failure due to any of the following:
            -- the command line contained an unknown option or too few arguments
            -- chgrp did not recognize the specified group

  Messages

       Message:  cannot determine OPEN_MAX: system error
       Cause:    See syserror(3).
       Action:   See syserror(3).

                                                                       1

  chgrp(1)              MPE/iX Shell and Utilities              chgrp(1)
  ______________________________________________________________________

       Message:  fatal error during "-R" option
       Cause:    You specified the -R option but some file or directory
                 in the directory structure was inaccessible.
       Action:   Make sure that you have access to all files in the
                 directory structure.

       Message:  file "filename": system error
       Cause:    See syserror(3).
       Action:   See syserror(3).

       Message:  file "filename": You are not a member of the group
                 group
       Cause:    You attempted to change the group ownership of filename
                 to group, but you are not a member of the specified
                 group.
       Action:   Specify a group to which you belong.

       Message:  group "group" is unknown
       Cause:    You specified a group name that chgrp was unable to
                 find in the group database.
       Action:   Specify a valid group name or use a valid numeric group
                 ID.

       Message:  read directory "pathname": system error
       Cause:    See syserror(3).
       Action:   See syserror(3).

       Message:  stat file "filename": system error
       Cause:    See syserror(3).
       Action:   See syserror(3).

       Message:  Unknown option "-option"
       Cause:    You specified an option that is not valid for chgrp.
       Action:   Check the Options section of this man page for a list
                 of valid options.

  PORTABILITY
       POSIX.2.  x/OPEN Portability Guide 4.0.  All UNIX systems.

       The -f option is an extension to the POSIX standard.

  MPE/iX NOTES
       The current MPE/iX implementation of chgrp does not allow you to
       modify the group ID of the root directory, account directories,
       and group directories.

       For more information on how the current MPE/iX implementation may
       affect the operation of this utility, see Appendix A, MPE/iX
       Implementation Considerations.

  SEE ALSO
       chmod(1), chown(1)

                                                                       2