diff options
Diffstat (limited to 'manual/filesys.texi')
| -rw-r--r-- | manual/filesys.texi | 39 |
1 files changed, 6 insertions, 33 deletions
diff --git a/manual/filesys.texi b/manual/filesys.texi index 26758e626e..edc7c64d22 100644 --- a/manual/filesys.texi +++ b/manual/filesys.texi @@ -928,12 +928,10 @@ parameter to the function is a pointer to a variable of type int (*) (const char *, const struct stat *, int, struct FTW *) @end smallexample -@vindex FTW_DP -@vindex FTW_SLN The first three arguments are the same as for the @code{__ftw_func_t} type. However for the third argument some additional values are defined to allow finer differentiation: -@table @code +@vtable @code @item FTW_DP The current item is a directory and all subdirectories have already been visited and reported. This flag is returned instead of @code{FTW_D} if @@ -941,7 +939,7 @@ the @code{FTW_DEPTH} flag is passed to @code{nftw} (see below). @item FTW_SLN The current item is a stale symbolic link. The file it points to does not exist. -@end table +@end vtable The last parameter of the callback function is a pointer to a structure with some extra information as described below. @@ -2209,49 +2207,42 @@ This is a bit mask used to extract the file type code from a mode value. These are the symbolic names for the different file type codes: -@table @code +@vtable @code @comment sys/stat.h @comment BSD @item S_IFDIR -@vindex S_IFDIR This is the file type constant of a directory file. @comment sys/stat.h @comment BSD @item S_IFCHR -@vindex S_IFCHR This is the file type constant of a character-oriented device file. @comment sys/stat.h @comment BSD @item S_IFBLK -@vindex S_IFBLK This is the file type constant of a block-oriented device file. @comment sys/stat.h @comment BSD @item S_IFREG -@vindex S_IFREG This is the file type constant of a regular file. @comment sys/stat.h @comment BSD @item S_IFLNK -@vindex S_IFLNK This is the file type constant of a symbolic link. @comment sys/stat.h @comment BSD @item S_IFSOCK -@vindex S_IFSOCK This is the file type constant of a socket. @comment sys/stat.h @comment BSD @item S_IFIFO -@vindex S_IFIFO This is the file type constant of a FIFO or pipe. -@end table +@end vtable The POSIX.1b standard introduced a few more objects which possibly can be implemented as objects in the filesystem. These are message queues, @@ -2404,15 +2395,13 @@ All of the symbols listed in this section are defined in the header file These symbolic constants are defined for the file mode bits that control access permission for the file: -@table @code +@vtable @code @comment sys/stat.h @comment POSIX.1 @item S_IRUSR -@vindex S_IRUSR @comment sys/stat.h @comment BSD @itemx S_IREAD -@vindex S_IREAD Read permission bit for the owner of the file. On many systems this bit is 0400. @code{S_IREAD} is an obsolete synonym provided for BSD compatibility. @@ -2420,22 +2409,18 @@ compatibility. @comment sys/stat.h @comment POSIX.1 @item S_IWUSR -@vindex S_IWUSR @comment sys/stat.h @comment BSD @itemx S_IWRITE -@vindex S_IWRITE Write permission bit for the owner of the file. Usually 0200. @w{@code{S_IWRITE}} is an obsolete synonym provided for BSD compatibility. @comment sys/stat.h @comment POSIX.1 @item S_IXUSR -@vindex S_IXUSR @comment sys/stat.h @comment BSD @itemx S_IEXEC -@vindex S_IEXEC Execute (for ordinary files) or search (for directories) permission bit for the owner of the file. Usually 0100. @code{S_IEXEC} is an obsolete synonym provided for BSD compatibility. @@ -2443,69 +2428,58 @@ synonym provided for BSD compatibility. @comment sys/stat.h @comment POSIX.1 @item S_IRWXU -@vindex S_IRWXU This is equivalent to @samp{(S_IRUSR | S_IWUSR | S_IXUSR)}. @comment sys/stat.h @comment POSIX.1 @item S_IRGRP -@vindex S_IRGRP Read permission bit for the group owner of the file. Usually 040. @comment sys/stat.h @comment POSIX.1 @item S_IWGRP -@vindex S_IWGRP Write permission bit for the group owner of the file. Usually 020. @comment sys/stat.h @comment POSIX.1 @item S_IXGRP -@vindex S_IXGRP Execute or search permission bit for the group owner of the file. Usually 010. @comment sys/stat.h @comment POSIX.1 @item S_IRWXG -@vindex S_IRWXG This is equivalent to @samp{(S_IRGRP | S_IWGRP | S_IXGRP)}. @comment sys/stat.h @comment POSIX.1 @item S_IROTH -@vindex S_IROTH Read permission bit for other users. Usually 04. @comment sys/stat.h @comment POSIX.1 @item S_IWOTH -@vindex S_IWOTH Write permission bit for other users. Usually 02. @comment sys/stat.h @comment POSIX.1 @item S_IXOTH -@vindex S_IXOTH Execute or search permission bit for other users. Usually 01. @comment sys/stat.h @comment POSIX.1 @item S_IRWXO -@vindex S_IRWXO This is equivalent to @samp{(S_IROTH | S_IWOTH | S_IXOTH)}. @comment sys/stat.h @comment POSIX @item S_ISUID -@vindex S_ISUID This is the set-user-ID on execute bit, usually 04000. @xref{How Change Persona}. @comment sys/stat.h @comment POSIX @item S_ISGID -@vindex S_ISGID This is the set-group-ID on execute bit, usually 02000. @xref{How Change Persona}. @@ -2513,7 +2487,6 @@ This is the set-group-ID on execute bit, usually 02000. @comment sys/stat.h @comment BSD @item S_ISVTX -@vindex S_ISVTX This is the @dfn{sticky} bit, usually 01000. For a directory it gives permission to delete a file in that directory @@ -2558,7 +2531,7 @@ This bit is only available on BSD systems (and those derived from them). Therefore one has to use the @code{_GNU_SOURCE} feature select macro, or not define any feature test macros, to get the definition (@pxref{Feature Test Macros}). -@end table +@end vtable The actual bit values of the symbols are listed in the table above so you can decode file mode values when debugging your programs. |