CHOWN(2)                 HP Integral PC                  CHOWN(2)
     CHOWN(2)                 HP Integral PC                  CHOWN(2)
     CHOWN(2)                 HP Integral PC                  CHOWN(2)
     CHOWN(2)                 HP Integral PC                  CHOWN(2)



     NAME
     NAME
     NAME
     NAME
          chown - change owner and group of a file

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

     DESCRIPTION
     DESCRIPTION
     DESCRIPTION
     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 are
          true:

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

               The named file does not exist.  [ENOENT]

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

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

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

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

     RETURN VALUE
     RETURN VALUE
     RETURN VALUE
     RETURN VALUE
          Upon successful completion, a value of 0 is returned.
          Otherwise, a value of -1 is returned and errno is set to
          indicate the error.

     SEE ALSO
     SEE ALSO
     SEE ALSO
     SEE ALSO
          chmod(2).






     Hewlett-Packard               - 1 -            (printed 12/11/84)