DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

udi_nsr_enable_ack(3udi)


Network link enable acknowledgment

SYNOPSIS

#include <udi.h>

void udi_nsr_enable_ack (

	udi_nic_cb_t *cb,

	udi_status_t status );
 

ARGUMENTS cb is a pointer to a Network Interface Metalanguage standard control block.

status indicates the success or failure of the enable operation

TARGET CHANNEL This request is issued to the NSR over the Network Interface Metalanguage control channel. If the control block used for this operation is the one received in the corresponding udi_nd_enable_req then the channel parameter will already be set to the correct value; this is the recommended mode of operation.

DESCRIPTION Handshakes network link enable request operation to the NSR. If successful, the NSR will subsequently expect to receive a udi_nsr_status_ind which indicates the actual link-up state for this network adapter connection.

Once the link-up state has been reached, the ND is expected to "post" transmit control blocks to the NSR for use in transmit requests by pre-allocating one or more of these control blocks and passing them to the NSR over the transmit channel using the udi_nsr_tx_rdy operation. The number of these transmit control blocks that are provided to the NSR represents the flow control level of the connection between the NSR and the ND; the NSR will never internally allocate transmit control blocks to be passed to the ND and will instead wait for the ND to supply these control blocks with the udi_nsr_tx_rdy operation.

This operation causes the ND and NSR to enter the ENABLED state (see Section 2.4.1, "NIC Metalanguage States").

STATUS VALUES UDI_OK indicates that the network enable request operation succeeded.

UDI_STAT_HW_PROBLEM indicates that the ND will not be able to enable the link due to a hardware problem.

UDI_STAT_INVALID_STATE indicates that the ND was not in the proper state and could not enable the hardware. This error code usually indictes a problem between the NSR and the ND.

WARNINGS This operation must use the same control block as originally received from the udi_nd_enable_req operation.

REFERENCES udi_nsr_unbind_req


UDI NIC Driver Specification Contents