diff options
author | Aaron Campbell <aaron@cvs.openbsd.org> | 2000-10-18 05:12:14 +0000 |
---|---|---|
committer | Aaron Campbell <aaron@cvs.openbsd.org> | 2000-10-18 05:12:14 +0000 |
commit | f29d8bd9c9c901b81d8fadc341786c43528e63c1 (patch) | |
tree | a5fc4e4696d058bee8f5a8c5498044c06a963bda /lib/libc/sys/chmod.2 | |
parent | 906e3d9014b754421b64647e705b3cca2e9a7c01 (diff) |
Another round of man page cleanup, this time to remove more hard sentence
breaks and getting rid of short lines, making these files easier to work with.
Diffstat (limited to 'lib/libc/sys/chmod.2')
-rw-r--r-- | lib/libc/sys/chmod.2 | 48 |
1 files changed, 20 insertions, 28 deletions
diff --git a/lib/libc/sys/chmod.2 b/lib/libc/sys/chmod.2 index 57925f7f989..9ede4ff66dd 100644 --- a/lib/libc/sys/chmod.2 +++ b/lib/libc/sys/chmod.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: chmod.2,v 1.9 2000/04/15 11:46:02 aaron Exp $ +.\" $OpenBSD: chmod.2,v 1.10 2000/10/18 05:12:08 aaron Exp $ .\" $NetBSD: chmod.2,v 1.7 1995/02/27 12:32:06 cgd Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -51,28 +51,22 @@ .Sh DESCRIPTION The function .Fn chmod -sets the file permission bits -of the file -specified by the pathname +sets the file permission bits of the file specified by the pathname .Fa path to .Fa mode . .Fn fchmod -sets the permission bits of the specified -file descriptor +sets the permission bits of the specified file descriptor .Fa fd . .Fn chmod -verifies that the process owner (user) either owns -the file specified by +verifies that the process owner (user) either owns the file specified by .Fa path (or .Fa fd ) , -or -is the superuser. +or is the superuser. A mode is created from .Em or'd -permission bit masks -defined in +permission bit masks defined in .Aq Pa sys/stat.h : .Pp .Bd -literal -offset indent -compact @@ -102,26 +96,25 @@ The .Em sticky bit ) indicates to the system which executable files are shareable (the default) and the system maintains the program text of the files -in the swap area. The sticky bit may only be set by the super user -on shareable executable files. +in the swap area. +The sticky bit may only be set by the superuser on shareable executable files. .Pp If mode .Dv ISVTX -(the `sticky bit') is set on a directory, -an unprivileged user may not delete or rename -files of other users in that directory. The sticky bit may be -set by any user on a directory which the user owns or has appropriate -permissions. +(the +.Dq sticky bit ) +is set on a directory, an unprivileged user may not delete or rename +files of other users in that directory. +The sticky bit may be set by any user on a directory which the user owns +or has appropriate permissions. For more details of the properties of the sticky bit, see .Xr sticky 8 . .Pp -Writing or changing the owner of a file -turns off the set-user-ID and set-group-ID bits -unless the user is the superuser. -This makes the system somewhat more secure -by protecting set-user-ID (set-group-ID) files -from remaining set-user-ID (set-group-ID) if they are modified, -at the expense of a degree of compatibility. +Writing or changing the owner of a file turns off the set-user-ID and +set-group-ID bits unless the user is the superuser. +This makes the system somewhat more secure by protecting +set-user-ID (set-group-ID) files from remaining set-user-ID (set-group-ID) +if they are modified, at the expense of a degree of compatibility. .Sh RETURN VALUES Upon successful completion, a value of 0 is returned. Otherwise, a value of \-1 is returned and @@ -190,6 +183,5 @@ function is expected to conform to .Sh HISTORY The .Fn fchmod -function call -appeared in +function call appeared in .Bx 4.2 . |