d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

chmod(2): Document S_ISVTX following SUSv3/SUSv4.

Browse Source 
S_ISTXT is non-standard.

While here, also update fchmodat() standards entry to POSIX.1-2008.
This commit is contained in:
Jilles Tjoelker 2013-12-01 12:24:57 +00:00
parent 09466daf8c
commit b865f8ef40
1 changed files with 16 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
lib/libc/sys/chmod.2
View File

@ -28,7 +28,7 @@
.\" @(#)chmod.2 8.1 (Berkeley) 6/4/93 .\" @(#)chmod.2 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd April 10, 2008 .Dd December 1, 2013
.Dt CHMOD 2 .Dt CHMOD 2
.Os .Os
.Sh NAME .Sh NAME
@ -139,21 +139,24 @@ defined in
#define S_ISUID 0004000 /* set user id on execution */ #define S_ISUID 0004000 /* set user id on execution */
#define S_ISGID 0002000 /* set group id on execution */ #define S_ISGID 0002000 /* set group id on execution */
#ifndef __BSD_VISIBLE #define S_ISVTX 0001000 /* sticky bit */
#define S_ISTXT 0001000 /* sticky bit */
#endif
.Ed .Ed
.Pp .Pp
The non-standard
.Dv S_ISTXT
is a synonym for
.Dv S_ISVTX .
.Pp
The The
.Fx .Fx
VM system totally ignores the sticky bit VM system totally ignores the sticky bit
.Pq Dv ISTXT .Pq Dv S_ISVTX
for executables. for executables.
On UFS-based file systems (FFS, LFS) the sticky On UFS-based file systems (FFS, LFS) the sticky
bit may only be set upon directories. bit may only be set upon directories.
.Pp .Pp
If mode If mode
.Dv ISTXT .Dv S_ISVTX
(the `sticky bit') is set on a directory, (the `sticky bit') is set on a directory,
an unprivileged user may not delete or rename an unprivileged user may not delete or rename
files of other users in that directory. files of other users in that directory.
@ -296,12 +299,15 @@ The
system call is expected to conform to system call is expected to conform to
.St -p1003.1-90 , .St -p1003.1-90 ,
except for the return of except for the return of
.Er EFTYPE .Er EFTYPE .
and the use of The
.Dv S_ISTXT . .Dv S_ISVTX
bit on directories is expected to conform to
.St -susv3 .
The The
.Fn fchmodat .Fn fchmodat
system call follows The Open Group Extended API Set 2 specification. system call is expected to conform to
.St -p1003.1-2008 .
.Sh HISTORY .Sh HISTORY
The The
.Fn chmod .Fn chmod