fchmod(2)                  DG/UX 4.30                   fchmod(2)



     NAME
          fchmod - Change mode of file.

     SYNOPSIS
          int   fchmod  (fildes, mode)
          int           fildes;
          int             mode;

     PARAMETERS
          fildes         File descriptor.


          mode           File's new mode.

     DESCRIPTION
          <Fildes> is a valid, active descriptor referring to an open
          file of type ordinary, directory, block special, or
          character special, or symbolic link.  The file must reside
          on a file system device mounted read-write.  Fchmod changes
          the file's mode (st_mode) in a manner semantically identical
          to the way chmod does.

     ACCESS CONTROL
          The effective user id of the calling process must be
          superuser or match the user id of the file.

          The process's effective user id must be superuser to set the
          sticky bit.  To set the set-group-id bit, the process's
          effective user id must be superuser or its effective group
          id must match the file's group id.  Failure to meet the
          requirements for setting one of these bits does not produce
          an error.  Note that meeting the first access requirement is
          sufficient to allow a process to set the set-user-id bit.

     RETURN VALUE
          0              The file's mode was successfully changed.


          -1             An error occurred.  Errno is set to indicate
                         the error.

     EXCEPTIONS
          Errno may be set to one of the following error codes:


          EBADF          <Fildes> is not a valid, active file
                         descriptor.


          EINVAL         The file descriptor refers to a pipe or an
                         object that is not a file.




     Licensed material--property of copyright holder(s)         Page 1

     fchmod(2)                  DG/UX 4.30                   fchmod(2)



          EPERM          The process is denied permission to change
                         the file's mode.


          EROFS          The named file resides on a file system
                         device mounted read-only.

     SEE ALSO
          The related manual sections:  chmod(2), chown(2), creat(2),
          fchown(2), fcntl(2), fstat(2), mknod(2), mknod(2), open(2),
          read(2), stat(2), write(2),
          chmod(1).











































     Licensed material--property of copyright holder(s)         Page 2