fstatat: extend tests and documentation

Document the fstatat behaviour leading to a ENOENT errno, and extend
tests to test the case where filename does not exist.

Signed-off-by: Matteo Croce <teknoraver@meta.com>

diff --git a/io/tst-stat-time64.c b/io/tst-stat-time64.c
index a20265c570fcb3fa70cdd9b674877271fe668c14..4415765c8a0e5526ad7e4da3aabe7a200ee084a0 100644 (file)
--- a/io/tst-stat-time64.c
+++ b/io/tst-stat-time64.c
@@ -52,6 +52,12 @@ fstat_check (int fd, const char *path, struct stat *st)
 static void
 fstatat_check (int fd, const char *path, struct stat *st)
 {
+  TEST_COMPARE (fstatat (fd, "", st, 0), -1);
+  TEST_COMPARE (errno, ENOENT);
+
+  TEST_COMPARE (fstatat (AT_FDCWD, "_non_existing_file", st, 0), -1);
+  TEST_COMPARE (errno, ENOENT);
+
   TEST_COMPARE (fstatat (fd, path, st, 0), 0);
 }
 

diff --git a/io/tst-stat.c b/io/tst-stat.c
index cc57aec45c598b2ebae830096a86f6641a1ac069..61bdbfb6380a5051431ee34c102661161d935a50 100644 (file)
--- a/io/tst-stat.c
+++ b/io/tst-stat.c
@@ -56,6 +56,9 @@ fstatat_check (int fd, const char *path, struct stat *st)
   TEST_COMPARE (fstatat (fd, "", st, 0), -1);
   TEST_COMPARE (errno, ENOENT);
 
+  TEST_COMPARE (fstatat (AT_FDCWD, "_non_existing_file", st, 0), -1);
+  TEST_COMPARE (errno, ENOENT);
+
   TEST_COMPARE (fstatat (fd, path, st, 0), 0);
 }
 

diff --git a/manual/filesys.texi b/manual/filesys.texi
index e1c7be867edbb4a6272e71fc2a9108456a9a110d..fb7986cff720b7d266d026ba7b93509d0d04faa9 100644 (file)
--- a/manual/filesys.texi
+++ b/manual/filesys.texi
@@ -2398,6 +2398,10 @@ The @var{flags} argument is not valid for this function.
 @item ENOTDIR
 The descriptor @var{filedes} is not associated with a directory, and
 @var{filename} is a relative file name.
+
+@item ENOENT
+The file named by @var{filename} does not exist, or @var{filename} is an
+empty string and @var{flags} does not contain @code{AT_EMPTY_PATH}.
 @end table
 
 When the sources are compiled with @code{_FILE_OFFSET_BITS == 64} this