Content-type: text/html
Man page of net_getifname
net_getifname
Section: Kernel Functions for Drivers (9F)
Updated: 1 May 2008
Index
Return to Main Contents
NAME
net_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_protocol_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 | SUNWcsu
|
|
Interface Stability |
|
SEE ALSO
net_phygetnext(9F), net_phylookup(9F), net_protocol_lookup(9F)
Index
- NAME
-
- SYNOPSIS
-
- INTERFACE LEVEL
-
- PARAMETERS
-
- DESCRIPTION
-
- RETURN VALUES
-
- CONTEXT
-
- ATTRIBUTES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 02:39:44 GMT, October 02, 2010