MAC_TRANSCEIVER_INFO(9F) Kernel Functions for Drivers MAC_TRANSCEIVER_INFO(9F)

NAME


mac_transceiver_info, mac_transceiver_info_set_present,
mac_transceiver_info_set_usable - set MAC transceiver property information

SYNOPSIS


#include <sys/mac_provider.h>

void
mac_transceiver_info_set_present(mac_transceiver_info_t *infop,
boolean_t present);

void
mac_transceiver_info_set_usable(mac_transceiver_info_t *infop,
boolean_t usable);

INTERFACE LEVEL


Volatile - This interface is still evolving in illumos. API and ABI
stability is not guaranteed.

PARAMETERS


infop A pointer to an opaque structure obtained as an argument to
the mct_info(9E) entry point.

present A boolean that indicates whether the transceiver is present.

usable A boolean that indicates whether the transceiver is usable.

DESCRIPTION


The mac_transceiver_set_present() and mac_transceiver_set_usable()
functions are used to set information about a transceiver as part of the
mct_info(9E) entry point to obtain information about a MAC transceiver.
For more information and background, see the Transceiver Information
Functions section of mac_capab_transceiver(9E).

The mct_transceiver_set_present() function sets whether or not the
transceiver is present and plugged into the system. If the transceiver is
not plugged in, then the function should be called with present set to
B_FALSE, otherwise it should use B_TRUE.

The mct_transceiver_set_usable() function determines whether or not the
device can use the transceiver. If the device cannot use the transceiver,
then it should call the function with usable set to B_FALSE. Otherwise, it
should use B_TRUE. If the transceiver is not present, then this function
should not be called.

CONTEXT


These functions should be called in response to handling the mct_info(9E)
entry point for transceivers in kernel context.

SEE ALSO


mac(9E), mac_capab_transceiver(9E), mct_info(9E)

OmniOS November 26, 2017 OmniOS