[PATCH v3 4/6] manual: Document renameat

Florian Weimer fweimer@redhat.com
Wed Jun 4 15:16:33 GMT 2025


* Arjun Shankar:

> ---
>  manual/filesys.texi | 12 +++++++++++-
>  1 file changed, 11 insertions(+), 1 deletion(-)
>
> diff --git a/manual/filesys.texi b/manual/filesys.texi
> index d8f362f3be..8a173c562f 100644
> --- a/manual/filesys.texi
> +++ b/manual/filesys.texi
> @@ -1910,6 +1910,17 @@ file systems.
>  @end table
>  @end deftypefun
>  
> +@deftypefun int renameat (int @var{oldfiledes}, const char *@var{oldname}, int @var{newfiledes}, const char *@var{newname})
> +@standards{POSIX.1-2008, stdio.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{rename}
> +function above.  @xref{Descriptor-Relative Access}.
> +
> +Compared to @code{rename}, some additional error conditions can occur.
> +@xref{Descriptor-Relative Access}.
> +@end deftypefun

Maybe say that oldname is interpreted relative to oldfiledes and newname
relative to newfiledes?

I'm fine with this version, too.

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

Thanks,
Florian



More information about the Libc-alpha mailing list