Return to chmod.2 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man2

Annotation of cci/usr/src/man/man2/chmod.2, revision 1.1.1.1

1.1       root        1: .TH CHMOD 2 "2 July 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: chmod \- change mode of file
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .ft B
                      8: chmod(path, mode)
                      9: char *path;
                     10: int mode;
                     11: .PP
                     12: .ft B
                     13: fchmod(fd, mode)
                     14: int fd, mode;
                     15: .fi
                     16: .SH DESCRIPTION
                     17: The file whose name
                     18: is given by \fIpath\fP
                     19: or referenced by the descriptor
                     20: .I fd
                     21: has its mode changed to
                     22: .IR mode .
                     23: Modes are constructed by
                     24: .IR or 'ing
                     25: together some
                     26: combination of the following:
                     27: .PP
                     28: .RS
                     29:  04000 set user ID on execution
                     30:  02000 set group ID on execution
                     31:  01000 save text image after execution
                     32:  00400 read by owner
                     33:  00200 write by owner
                     34:  00100 execute (search on directory) by owner
                     35:  00070 read, write, execute (search) by group
                     36:  00007 read, write, execute (search) by others
                     37: .RE
                     38: .PP
                     39: If an executable file is set up for sharing (this is the default)
                     40: then mode 1000 prevents the system from
                     41: abandoning the swap-space image of the program-text portion
                     42: of the file when its last user
                     43: terminates.
                     44: Ability to set this bit is restricted to the super-user.
                     45: .PP
                     46: Only the owner of a file (or the super-user) may change the mode.
                     47: .PP
                     48: Writing or changing the owner of a file
                     49: turns off the set-user-id and set-group-id bits.
                     50: This makes the system somewhat more secure
                     51: by protecting set-user-id (set-group-id) files
                     52: from remaining set-user-id (set-group-id) if they are modified,
                     53: at the expense of a degree of compatibility.
                     54: .SH "RETURN VALUE
                     55: Upon successful completion, a value of 0 is returned.
                     56: Otherwise, a value of \-1 is returned and
                     57: .I errno
                     58: is set to indicate the error.
                     59: .SH "ERRORS
                     60: .I Chmod
                     61: will fail and the file mode will be unchanged if:
                     62: .TP 15
                     63: [EPERM]
                     64: The argument contains a byte with the high-order bit set.
                     65: .TP 15
                     66: [ENOTDIR]
                     67: A component of the path prefix is not a directory.
                     68: .TP 15
                     69: [ENOENT]
                     70: The pathname was too long.
                     71: .TP 15
                     72: [ENOENT]
                     73: The named file does not exist.
                     74: .TP 15
                     75: [EACCES]
                     76: Search permission is denied on a component of the path prefix.
                     77: .TP 15
                     78: [EPERM]
                     79: The effective user ID does not match the owner of the file and
                     80: the effective user ID is not the super-user.
                     81: .TP 15
                     82: [EROFS]
                     83: The named file resides on a read-only file system.
                     84: .TP 15
                     85: [EFAULT]
                     86: .I Path
                     87: points outside the process's allocated address space.
                     88: .TP 15
                     89: [ELOOP]
                     90: Too many symbolic links were encountered in translating the pathname.
                     91: .PP
                     92: .I Fchmod
                     93: will fail if:
                     94: .TP 15
                     95: [EBADF]
                     96: The descriptor is not valid.
                     97: .TP 15
                     98: [EINVAL]
                     99: .I Fd
                    100: refers to a socket, not to a file.
                    101: .TP 15
                    102: [EROFS]
                    103: The file resides on a read-only file system.
                    104: .SH "SEE ALSO"
                    105: open(2), chown(2)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.