Return to chown.2 CVS log

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

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

1.1       root        1: .TH CHOWN 2 "27 July 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: chown \- change owner and group of a file
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .ft B
                      8: chown(path, owner, group)
                      9: char *path;
                     10: int owner, group;
                     11: .PP
                     12: .ft B
                     13: fchown(fd, owner, group)
                     14: int fd, owner, group;
                     15: .fi
                     16: .SH DESCRIPTION
                     17: The file
                     18: which is named by \fIpath\fP or referenced by \fIfd\fP
                     19: has its
                     20: .I owner
                     21: and 
                     22: .I group
                     23: changed as specified.
                     24: Only the super-user may
                     25: execute this call,
                     26: because if users were able to give files away,
                     27: they could defeat the file-space accounting procedures.
                     28: .PP
                     29: On some systems,
                     30: .I chown
                     31: clears the set-user-id and set-group-id bits
                     32: on the file
                     33: to prevent accidental creation of
                     34: set-user-id and set-group-id programs
                     35: owned by the super-user.
                     36: .PP
                     37: .I Fchown
                     38: is particularly useful when used in conjunction
                     39: with the file locking primitives (see
                     40: .IR flock (2)).
                     41: .PP
                     42: Only one of the owner and group id's
                     43: may be set by specifying the other as \-1.
                     44: .SH "RETURN VALUE
                     45: Zero is returned if the operation was successful;
                     46: \-1 is returned if an error occurs, with a more specific
                     47: error code being placed in the global variable \fIerrno\fP.
                     48: .SH "ERRORS
                     49: .I Chown
                     50: will fail and the file will be unchanged if:
                     51: .TP 15
                     52: [EINVAL]
                     53: The argument path does not refer to a file.
                     54: .TP 15
                     55: [ENOTDIR]
                     56: A component of the path prefix is not a directory.
                     57: .TP 15
                     58: [ENOENT]
                     59: The argument pathname is too long.
                     60: .TP 15
                     61: [EPERM]
                     62: The argument contains a byte with the high-order bit set.
                     63: .TP 15
                     64: [ENOENT]
                     65: The named file does not exist.
                     66: .TP 15
                     67: [EACCES]
                     68: Search permission is denied on a component of the path prefix.
                     69: .TP 15
                     70: [EPERM]
                     71: The effective user ID does not match the owner of the file and
                     72: the effective user ID is not the super-user.
                     73: .TP 15
                     74: [EROFS]
                     75: The named file resides on a read-only file system.
                     76: .TP 15
                     77: [EFAULT]
                     78: .I Path
                     79: points outside the process's allocated address space.
                     80: .TP 15
                     81: [ELOOP]
                     82: Too many symbolic links were encountered in translating the pathname.
                     83: .PP
                     84: .I Fchown
                     85: will fail if:
                     86: .TP 15
                     87: [EBADF]
                     88: .I Fd
                     89: does not refer to a valid descriptor.
                     90: .TP 15
                     91: [EINVAL]
                     92: .I Fd
                     93: refers to a socket, not a file.
                     94: .SH "SEE ALSO"
                     95: chmod(2), flock(2)

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