DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

udi_nsr_unbind_ack(3udi)


Network unbind acknowledgment

SYNOPSIS

#include <udi.h>

void udi_nsr_unbind_ack (

	udi_nic_cb_t *cb,

	udi_status_t status );
 

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

TARGET CHANNEL The udi_nsr_unbind_ack 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_unbind_req then the channel parameter will already be set to the correct value; this is the recommended mode of operation.

DESCRIPTION Handshakes the network unbind request operation initiated by the NSR. As a result of this operation the routing information will be removed from the NSR and the control and data handling channels will be closed by both the ND and the NSR. No more data transfer will occur for this adapter instance unless another udi_nd_bind_req is issued by the NSR to create and bind a new set of data channels.

The udi_nsr_unbind_ack must use the same control block received with the udi_nd_unbind_req.

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

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

UDI_STAT_INVALID_STATE indicates that the ND has not completed a metalanguage bind with the NSR as setup by the udi_nd_bind_req and udi_nsr_bind_ack operations.

REFERENCES udi_nd_unbind_req, udi_nic_cb_t

3.3.5 Interface Control

The interface control operations are used by the NSR to instruct the ND to enable or disable the network interface for link activity. Once the NSR and the ND have successfully been bound together, the udi_nd_enable_req operation is performed to activate the interface, usually as the result of a control operation by the system or user (e.g. ifconfig ... up).

The udi_nd_enable_req is successfully acknowledged by the ND using the udi_nsr_enable_ack operation as soon as the link activation operation is initiated. The acknowledgement is not expected to wait for the link to actually become enabled and the returned status in the udi_nsr_enable_ack is only used to indicated the success or failure of the ND in initiating the enable operation.

When the interface actually reports active, it will use the udi_nsr_status_ind operation to indicate that the link state has changed to the active state. Note that the interface may be enabled, but not necessarily have an active link status. Whenever the interface is in the enabled state, udi_nsr_status_ind operations must be used to indicate the link status if the link status changes.

The udi_nd_disable_req is used to disable an interface. The link status change may or may not be indicated by the udi_nsr_status_ind indication, but this request must perform the appropriate activity to force the interface into the disabled state. There is no acknowledgement to the NSR for the disable operation; the link must be disabled if currently active and there are no reasonable failure conditions.

When an interface is in the disabled state, link status changes must not be indicated by the udi_nsr_status_ind operation; if generated in this state, these indications will be ignored.


UDI NIC Driver Specification Contents