CHOWN(2)             INTERACTIVE UNIX System             CHOWN(2)



          NAME
               chown - change owner and group of a file

          SYNOPSIS
               int chown (path, owner, group)
               char *path;
               int owner, group;

          DESCRIPTION
               Path points to a path name naming a file.  The owner ID and
               group ID of the named file are set to the numeric values
               contained in owner and group respectively.

               Only processes with effective user ID equal to the file
               owner or super-user may change the ownership of a file.

               If chown is invoked by other than the super-user, the set-
               user-ID and set-group-ID bits of the file mode, 04000 and
               02000 respectively, will be cleared.

               chown will fail and the owner and group of the named file
               will remain unchanged if one or more of the following is
               true:

               [ENOTDIR]      A component of the path prefix is not a
                              directory.

               [ENOENT]       The named file does not exist.

               [EACCES]       Search permission is denied on a component of
                              the path prefix.

               [EPERM]        The effective user ID does not match the
                              owner of the file and the effective user ID
                              is not super-user.

               [EROFS]        The named file resides on a read-only file
                              system.

               [EFAULT]       Path points outside the allocated address
                              space of the process.

               [EINTR]        A signal was caught during the chown system
                              call.

               [ENOLINK]      Path points to a remote machine and the link
                              to that machine is no longer active.

               [EMULTIHOP]    Components of path require hopping to multi-
                              ple remote machines.

          SEE ALSO
               chmod(2).


          Rev. C Software Development Set                            Page 1

          CHOWN(2)             INTERACTIVE UNIX System             CHOWN(2)



               chown(1) in the INTERACTIVE UNIX System User's/System
               Administrator's Reference Manual.

          DIAGNOSTICS
               Upon successful completion, a value of 0 is returned.  Oth-
               erwise, a value of -1 is returned and errno is set to indi-
               cate the error.
















































          Rev. C Software Development Set                            Page 2