manual: Document error codes missing for 'if_indextoname'

Add documentation for ENXIO error code returned and refer to 'socket'
for further possible codes from the underlying function call.

While changing the text clarify the description by mentioning 'ifname'
and replace @code tags with @var ones where referring to a function
parameter.

Reviewed-by: Florian Weimer <fweimer@redhat.com>
This commit is contained in:
Maciej W. Rozycki 2025-06-04 16:27:20 +01:00
parent e885fd43db
commit 46acdf46cc
1 changed files with 16 additions and 5 deletions

View File

@ -505,11 +505,22 @@ name. If no interface exists with the name given, it returns 0.
@safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{} @acsfd{}}} @safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{} @acsfd{}}}
@c It opens a socket with opensock to use ioctl on the fd to get the @c It opens a socket with opensock to use ioctl on the fd to get the
@c name from the index. @c name from the index.
This function maps an interface index to its corresponding name. The This function maps an interface index @var{ifindex} to its corresponding
returned name is placed in the buffer pointed to by @code{ifname}, which name. The returned name is placed in the buffer pointed to by @var{ifname},
must be at least @code{IFNAMSIZ} bytes in length. If the index was which must be at least @code{IFNAMSIZ} bytes in length.
invalid, the function's return value is a null pointer, otherwise it is
@code{ifname}. The return value is @var{ifname} on success. On failure, the function's
return value is a null pointer and @code{errno} is set accordingly. The
following @code{errno} values are specific to this function:
@table @code
@item ENXIO
There is no interface at the index requested.
@end table
Additionally, since @code{if_indextoname} invokes @code{socket}
internally, @code{errno} may also be set to a value listed for the
@code{socket} function (@pxref{Creating a Socket}).
@end deftypefun @end deftypefun
@deftp {Data Type} {struct if_nameindex} @deftp {Data Type} {struct if_nameindex}