


      CHMOD(2)                    (UNIX 5.0)                   CHMOD(2)



      NAME
           chmod - change mode of file

      SYNTAX
           int chmod (path, mode)
           char *path;
           int mode;

      DESCRIPTION
           Path points to a path name naming a file.  Chmod sets the
           access permission portion of the named file's mode according
           to the bit pattern contained in mode.

           Access permission bits are interpreted as follows:

                04000
                     Set user ID on execution.
                02000
                     Set group ID on execution.
                00400
                     Read by owner
                00200
                     Write by owner
                00100
                     Execute (or search if a directory) by owner
                00070
                     Read, write, execute (search) by group
                00007
                     Read, write, execute (search) by others

           The effective user ID of the process must match the owner of
           the file or be super-user to change the mode of a file.

           If the effective user ID of the process is not super-user or
           the effective group ID of the process does not match the
           group ID of the file, mode bit 02000 (set group ID on
           execution) is cleared.

           If the mode bit 02000 (set group ID on execution) is set and
           the mode bit 00010 (execute or search by group) is not set,
           mandatory file/record locking will exist on the file.  This
           may effect future calls to open(2), creat(2), read(2), and
           write(2) on this file.

           Chmod will fail and the file mode will be 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]




      Page 1                                         (73 A2 02MTA REV1)






      CHMOD(2)                    (UNIX 5.0)                   CHMOD(2)



                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
           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
           chown(2), mknod(2).



































      Page 2                                         (73 A2 02MTA REV1)



