LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

statx.2: Remove mention of pathname == NULL case 

Kernel commit 1e2f82d1e9d12223b4cbd1feb3f2b5596f8049eb
removed the option to specify 'pathname' as NULL, since
this was redundant with AT_EMPTY_PATH + pathname == "".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2017-04-27 14:20:52 +02:00
parent 8560f2bf16
commit 85dbf7cdd0
1 changed files with 11 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
man2/statx.2
View File

@ -156,19 +156,13 @@ referred to by
By file descriptor
If
.IR pathname
is NULL, then the target file is the one referred to by the file descriptor
.IR dirfd .
.I dirfd
may refer to any type of file, not just a directory.
(The
is an empty string and the
.B AT_EMPTY_PATH
flag described below provides similar functionality.)
.\" FIXME
.\" It appears that there are two different ways of doing the same thing:
.\" specifying the file to be stat'ed via a file descriptor.
.\" Either, we specify 'pathname' as NULL, or we specify 'pathname'
.\" as an empty string and include the AT_EMPTY_PATH flag. What's
.\" the rationale for having two ways of doing this?
flag is specified in
.IR flags
(see below),
then the target file is the one referred to by the file descriptor
.IR dirfd .
.PP
.I flags
can be used to influence a pathname-based lookup.
@ -186,14 +180,16 @@ is an empty string, operate on the file referred to by
.BR open (2)
.B O_PATH
flag).
In this case,
.I dirfd
can refer to any type of file, not just a directory.
If
.I dirfd
is
.BR AT_FDCWD ,
the call operates on the current working directory.
In this case,
.I dirfd
can refer to any type of file, not just a directory.
This flag is Linux-specific; define
.B _GNU_SOURCE
.\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed