net_getifname(9F) Kernel Functions for Drivers net_getifname(9F)NAMEnet_getifname - determine the name given to a network interface
SYNOPSIS
#include <sys/neti.h>
int net_getifname(const net_data_t net, const phy_if_t ifp,
char *buffer, size_t buflen);
INTERFACE LEVEL
Solaris DDI specific (Solaris DDI).
PARAMETERS
net value returned from a successful call to net_proto‐
col_lookup(9F).
ifp value returned from a successful call to net_phylookup(9F) or
net_phygetnext(9F).
buffer pointer to the buffer in which to write the interface name.
buflen size of the buffer in which to store the interface name.
DESCRIPTION
The net_getifname() function copies the name of the network interface
into the buffer provided. The name will always be null-terminated. If
the buffer is too small to fit both the interface name and the null-
terminated name, the name in the buffer is truncated to fit. See
net_phygetnext(9F) for an example on how to use this function.
RETURN VALUES
The net_getifname() function returns:
-1 The network protocol does not support this function.
0 Successful completion.
1 Unsuccessful.
CONTEXT
The net_getifname() function may be called from user, kernel, or
interrupt context.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWcs │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOnet_phygetnext(9F), net_phylookup(9F), net_protocol_lookup(9F)SunOS 5.11 1 May 2008 net_getifname(9F)