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 TYPEATTRIBUTE VALUE

AvailabilitySUNWcsu

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