From: Arjun Shankar <arjun@redhat.com>
Date: Wed, 4 Jun 2025 11:08:55 +0000 (+0200)
Subject: manual: Document mkdirat
X-Git-Tag: glibc-2.42~162
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=49766eb1a5b93d093bd0fada55ca7a42dfdb10d6;p=thirdparty%2Fglibc.git

manual: Document mkdirat

Reviewed-by: Florian Weimer <fweimer@redhat.com>
---

diff --git a/manual/filesys.texi b/manual/filesys.texi
index 17c15b5403..d8f362f3be 100644
--- a/manual/filesys.texi
+++ b/manual/filesys.texi
@@ -1964,6 +1964,17 @@ To use this function, your program should include the header file
 @pindex sys/stat.h
 @end deftypefun
 
+@deftypefun int mkdirat (int @var{filedes}, const char *@var{filename}, mode_t @var{mode})
+@standards{POSIX.1-2008, sys/stat.h}
+@comment Unaudited and therefore marked AC-Unsafe and AS-Unsafe by default
+@safety{@mtsafe{}@asunsafe{@asucorrupt{}}@acunsafe{@acucorrupt{}}}
+This function is a descriptor-relative version of the @code{mkdir}
+function above.  @xref{Descriptor-Relative Access}.
+
+Compared to @code{mkdir}, some additional error conditions can occur.
+@xref{Descriptor-Relative Access}.
+@end deftypefun
+
 @node File Attributes
 @section File Attributes
 
@@ -3877,7 +3888,6 @@ The @code{mkdtemp} function comes from OpenBSD.
 @c futimesat
 @c fstatat (there's a commented-out safety assessment for this one)
 @c statx
-@c mkdirat
 @c mkfifoat
 @c name_to_handle_at
 @c openat