Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../../../../../usr/man/man3c/if_nametoindex.3c
Real path: /usr/share/man/man3c/if_nametoindex.3c
Zurück

'\" te .\" Copyright (c) 2009, 2021, Oracle and/or its affiliates. .TH if_nametoindex 3C "2 Feb 2021" "Oracle Solaris 11.4" "Standard C Library Functions" .SH NAME if_nametoindex, if_indextoname, if_nameindex, if_freenameindex \- routines to map Internet Protocol network interface names and interface indexes .SH SYNOPSIS .LP .nf #include <net/if.h> \fBunsigned int\fR \fBif_nametoindex\fR(\fBconst char *\fR\fIifname\fR); .fi .LP .nf \fBchar *\fR\fBif_indextoname\fR(\fBunsigned int\fR \fIifindex\fR, \fBchar *\fR\fIifname\fR); .fi .LP .nf \fBstruct if_nameindex *\fR\fBif_nameindex\fR(\fBvoid\fR); .fi .LP .nf \fBvoid\fR \fBif_freenameindex\fR(\fBstruct if_nameindex *\fR\fIptr\fR); .fi .SH PARAMETERS .sp .ne 2 .mk .na \fB\fIifname\fR\fR .ad .RS 11n .rt interface name .RE .sp .ne 2 .mk .na \fB\fIifindex\fR\fR .ad .RS 11n .rt interface index .RE .sp .ne 2 .mk .na \fB\fIptr\fR\fR .ad .RS 11n .rt pointer returned by \fBif_nameindex()\fR .RE .SH DESCRIPTION .sp .LP This \fBAPI\fR defines two functions that map between an Internet Protocol network interface name and index, a third function that returns all the interface names and indexes, and a fourth function to return the dynamic memory allocated by the previous function. .sp .LP Network interfaces are normally known by names such as \fBnet0\fR, \fBnet1\fR, and the like. The \fIifname\fR argument must point to a buffer of at least \fBIF_NAMESIZE\fR bytes into which the interface name corresponding to the specified index is returned. \fBIF_NAMESIZE\fR is defined in <\fBnet/if.h\fR> and its value includes a terminating null byte at the end of the interface name. .sp .ne 2 .mk .na \fB\fBif_nametoindex()\fR\fR .ad .br .sp .6 .RS 4n The \fBif_nametoindex()\fR function returns the interface index corresponding to the interface name pointed to by the \fIifname\fR pointer. If the specified interface name does not exist, the return value is \fB0\fR, and \fIerrno\fR is set to \fBENXIO\fR. If there was a system error, such as running out of memory, the return value is \fB0\fR and \fIerrno\fR is set to the proper value, for example, \fBENOMEM\fR. .RE .sp .ne 2 .mk .na \fB\fBif_indextoname()\fR\fR .ad .br .sp .6 .RS 4n The \fBif_indextoname()\fR function maps an interface index into its corresponding name. This pointer is also the return value of the function. If there is no interface corresponding to the specified index, \fBNULL\fR is returned, and \fIerrno\fR is set to \fBENXIO\fR, if there was a system error, such as running out of memory, \fBif_indextoname()\fR returns \fBNULL\fR and \fIerrno\fR is set to the proper value, for example, \fBENOMEM\fR. .RE .sp .ne 2 .mk .na \fB\fBif_nameindex()\fR\fR .ad .br .sp .6 .RS 4n The \fBif_nameindex()\fR function returns an array of \fBif_nameindex\fR structures, one structure per interface. The \fBif_nameindex\fR structure holds the information about a single interface and is defined when the <\fBnet/if.h\fR> header is included: .sp .sp .in +2 .nf struct if_nameindex unsigned int if_index; /* 1, 2, ... */ char *if_name; /* "net0", ... */ }; .fi .in -2 .sp While any IPMP IP interfaces are returned by \fBif_nameindex()\fR, the underlying IP interfaces that comprise each IPMP group are not returned. .sp The end of the array of structures is indicated by a structure with an \fBif_index\fR of 0 and an \fBif_name\fR of \fBNULL\fR. The function returns a null pointer upon an error and sets \fIerrno\fR to the appropriate value. The memory used for this array of structures along with the interface names pointed to by the \fBif_name\fR members is obtained dynamically. This memory is freed by the \fBif_freenameindex()\fR function. .RE .sp .ne 2 .mk .na \fB\fBif_freenameindex()\fR\fR .ad .br .sp .6 .RS 4n The \fBif_freenameindex()\fR function frees the dynamic memory that was allocated by \fBif_nameindex()\fR. The argument to this function must be a pointer that was returned by \fBif_nameindex()\fR. .RE .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Interface Stability Committed _ MT-Level MT-Safe _ Standard See \fBstandards\fR(7) .TE .sp .SH SEE ALSO .sp .LP \fBif\fR(4P), \fBattributes\fR(7), \fBdladm\fR(8), \fBifconfig\fR(8), \fBipadm\fR(8) .sp .LP Gilligan, R. \fIRFC 3493, Basic Socket Interface Extensions for IPv6\fR. Network Working Group. February 2003. https://tools.ietf.org/html/rfc3493 .SH HISTORY .sp .LP These functions were added to Oracle Solaris in the Solaris 8 release.