net_phylookup(9F)

Name | Synopsis | Interface Level | Parameters | Description | Return Values | Context | Attributes | See Also

Name

net_phylookup– determine if a network interface name exists for a network protocol

Synopsis

#include <sys/neti.h>

phy_if_t net_phylookup(const net_data_t net, const char *name);

Interface Level

Solaris DDI specific (Solaris DDI).

Parameters

net

value returned from a successful call to net_protocol_lookup(9F).

name

name of the network interface to find.

Description

The net_phylookup() function attempts to resolve the interface name passed in with the network protocol.

When called successfully, the value returned represents a network interface that exists, at the time of the call, within the scope of the network interface. This value is only guaranteed to be unique for a name within the scope of the network protocol.

Return Values

The net_phylookup() function returns -1 if it is not supported by the network protocol, and 0 if the named network interface does not exist (or is otherwise unknown). Otherwise, it returns a value greater than 0 representing a network interface that currently exists within the scope of this network protocol.

Context

The net_phylookup() 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	Committed

See Also

net_getifname(9F), net_phygetnext(9F), net_protocol_lookup(9F), attributes(5)

SunOS 5.11  Last Revised 1 May 2008

Name | Synopsis | Interface Level | Parameters | Description | Return Values | Context | Attributes | See Also