1IF_INDEXTONAME(3P)         POSIX Programmer's Manual        IF_INDEXTONAME(3P)
2
3
4

PROLOG

6       This  manual  page is part of the POSIX Programmer's Manual.  The Linux
7       implementation of this interface may differ (consult the  corresponding
8       Linux  manual page for details of Linux behavior), or the interface may
9       not be implemented on Linux.
10

NAME

12       if_indextoname — map a network interface  index  to  its  corresponding
13       name
14

SYNOPSIS

16       #include <net/if.h>
17
18       char *if_indextoname(unsigned ifindex, char *ifname);
19

DESCRIPTION

21       The  if_indextoname() function shall map an interface index to its cor‐
22       responding name.
23
24       When this function is called, ifname shall point  to  a  buffer  of  at
25       least  {IF_NAMESIZE} bytes. The function shall place in this buffer the
26       name of the interface with index ifindex.
27

RETURN VALUE

29       If ifindex is an interface index, then the function  shall  return  the
30       value  supplied  in ifname, which points to a buffer now containing the
31       interface name. Otherwise, the function shall return a null pointer and
32       set errno to indicate the error.
33

ERRORS

35       The if_indextoname() function shall fail if:
36
37       ENXIO  The interface does not exist.
38
39       The following sections are informative.
40

EXAMPLES

42       None.
43

APPLICATION USAGE

45       None.
46

RATIONALE

48       None.
49

FUTURE DIRECTIONS

51       None.
52

SEE ALSO

54       getsockopt(),   if_freenameindex(),  if_nameindex(),  if_nametoindex(),
55       setsockopt()
56
57       The Base Definitions volume of POSIX.1‐2017, <net_if.h>
58

60       Portions of this text are reprinted and reproduced in  electronic  form
61       from  IEEE Std 1003.1-2017, Standard for Information Technology -- Por‐
62       table Operating System Interface (POSIX), The Open Group Base  Specifi‐
63       cations  Issue  7, 2018 Edition, Copyright (C) 2018 by the Institute of
64       Electrical and Electronics Engineers, Inc and The Open Group.   In  the
65       event of any discrepancy between this version and the original IEEE and
66       The Open Group Standard, the original IEEE and The Open Group  Standard
67       is  the  referee document. The original Standard can be obtained online
68       at http://www.opengroup.org/unix/online.html .
69
70       Any typographical or formatting errors that appear  in  this  page  are
71       most likely to have been introduced during the conversion of the source
72       files to man page format. To report such errors,  see  https://www.ker‐
73       nel.org/doc/man-pages/reporting_bugs.html .
74
75
76
77IEEE/The Open Group                  2017                   IF_INDEXTONAME(3P)
Impressum