cnet's Application Programming Interface
- NAME
- CNET_set_nicaddr - set the NIC address of a LAN or WLAN link
- SYNOPSIS
- #include <cnet.h>
int CNET_set_nicaddr(int link, CnetNICaddr new_nicaddr);
- DESCRIPTION
-
CNET_set_nicaddr sets the hardware address recognized by
the Network Interface Card (NIC) of the indicated physical link.
The new address may not be the zero address, 00:00:00:00:00:00,
or the broadcast address, ff:ff:ff:ff:ff:ff.
No check is made to ensure that the new address is unique within the
network
(thereby enabling some snooping/sniffing "protocols" to be developed).
NIC addresses may only be set for links of type LT_LAN
or LT_WLAN.
- RETURN VALUE
-
The value 0 is returned on success.
On failure, the value -1 is returned,
and the global variable cnet_errno is set to one of the
following values to describe the error:
- ER_BADARG
- The value of new_nicaddr is either the zero or the
broadcast address.
- ER_BADLINK
- The value of link is less than zero or greater than the
number of physical links.
- ER_NOTSUPPORTED
- The current link is not of link type LT_LAN or
LT_WLAN.
- SEE ALSO
-
CNET_parse_nicaddr and
CNET_format_nicaddr
|
cnet v3.3.4, written by Chris.McDonald@uwa.edu.au
Last modified: Tue Mar 1 7:43AM 2016