Return to chmod.2 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / sys

Annotation of 43BSDReno/lib/libc/sys/chmod.2, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1980 Regents of the University of California.
        !             2: .\" All rights reserved.  The Berkeley software License Agreement
        !             3: .\" specifies the terms and conditions for redistribution.
        !             4: .\"
        !             5: .\"    @(#)chmod.2     6.5 (Berkeley) 5/13/86
        !             6: .\"
        !             7: .TH CHMOD 2 "May 13, 1986"
        !             8: .UC 4
        !             9: .SH NAME
        !            10: chmod \- change mode of file
        !            11: .SH SYNOPSIS
        !            12: .nf
        !            13: .ft B
        !            14: chmod(path, mode)
        !            15: char *path;
        !            16: int mode;
        !            17: .PP
        !            18: .ft B
        !            19: fchmod(fd, mode)
        !            20: int fd, mode;
        !            21: .fi
        !            22: .SH DESCRIPTION
        !            23: The file whose name
        !            24: is given by \fIpath\fP
        !            25: or referenced by the descriptor
        !            26: .I fd
        !            27: has its mode changed to
        !            28: .IR mode .
        !            29: Modes are constructed by
        !            30: .IR or 'ing
        !            31: together some
        !            32: combination of the following, defined in
        !            33: .IR <sys/inode.h> :
        !            34: .PP
        !            35: .RS
        !            36: .nf
        !            37: .ta \w'IWRITE\ \ 'u +\w'04000\ \ \ 'u
        !            38: ISUID  04000   set user ID on execution
        !            39: ISGID  02000   set group ID on execution
        !            40: ISVTX  01000   `sticky bit' (see below)
        !            41: IREAD  00400   read by owner
        !            42: IWRITE 00200   write by owner
        !            43: IEXEC  00100   execute (search on directory) by owner
        !            44:        00070   read, write, execute (search) by group
        !            45:        00007   read, write, execute (search) by others
        !            46: .fi
        !            47: .RE
        !            48: .PP
        !            49: If an executable file is set up for sharing (this is the default)
        !            50: then mode ISVTX (the `sticky bit') prevents the system from
        !            51: abandoning the swap-space image of the program-text portion
        !            52: of the file when its last user terminates.
        !            53: Ability to set this bit on executable files is restricted to the super-user.
        !            54: .PP
        !            55: If mode ISVTX (the `sticky bit') is set on a directory,
        !            56: an unprivileged user may not delete or rename
        !            57: files of other users in that directory.
        !            58: For more details of the properties of the sticky bit, see
        !            59: .IR sticky (8).
        !            60: .PP
        !            61: Only the owner of a file (or the super-user) may change the mode.
        !            62: .PP
        !            63: Writing or changing the owner of a file
        !            64: turns off the set-user-id and set-group-id bits
        !            65: unless the user is the super-user.
        !            66: This makes the system somewhat more secure
        !            67: by protecting set-user-id (set-group-id) files
        !            68: from remaining set-user-id (set-group-id) if they are modified,
        !            69: at the expense of a degree of compatibility.
        !            70: .SH "RETURN VALUE
        !            71: Upon successful completion, a value of 0 is returned.
        !            72: Otherwise, a value of \-1 is returned and
        !            73: .I errno
        !            74: is set to indicate the error.
        !            75: .SH "ERRORS
        !            76: .I Chmod
        !            77: will fail and the file mode will be unchanged if:
        !            78: .TP 15
        !            79: [ENOTDIR]
        !            80: A component of the path prefix is not a directory.
        !            81: .TP 15
        !            82: [EINVAL]
        !            83: The pathname contains a character with the high-order bit set.
        !            84: .TP 15
        !            85: [ENAMETOOLONG]
        !            86: A component of a pathname exceeded 255 characters,
        !            87: or an entire path name exceeded 1023 characters.
        !            88: .TP 15
        !            89: [ENOENT]
        !            90: The named file does not exist.
        !            91: .TP 15
        !            92: [EACCES]
        !            93: Search permission is denied for a component of the path prefix.
        !            94: .TP 15
        !            95: [ELOOP]
        !            96: Too many symbolic links were encountered in translating the pathname.
        !            97: .TP 15
        !            98: [EPERM]
        !            99: The effective user ID does not match the owner of the file and
        !           100: the effective user ID is not the super-user.
        !           101: .TP 15
        !           102: [EROFS]
        !           103: The named file resides on a read-only file system.
        !           104: .TP 15
        !           105: [EFAULT]
        !           106: .I Path
        !           107: points outside the process's allocated address space.
        !           108: .TP 15
        !           109: [EIO]
        !           110: An I/O error occurred while reading from or writing to the file system.
        !           111: .PP
        !           112: .I Fchmod
        !           113: will fail if:
        !           114: .TP 15
        !           115: [EBADF]
        !           116: The descriptor is not valid.
        !           117: .TP 15
        !           118: [EINVAL]
        !           119: .I Fd
        !           120: refers to a socket, not to a file.
        !           121: .TP 15
        !           122: [EROFS]
        !           123: The file resides on a read-only file system.
        !           124: .TP 15
        !           125: [EIO]
        !           126: An I/O error occurred while reading from or writing to the file system.
        !           127: .SH "SEE ALSO"
        !           128: chmod(1), open(2), chown(2), stat(2), sticky(8)

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