SVR5 and SCO OpenServer

close(D2mdi)

close -- relinquish access to an MDI device

Syntax

See close(D2) for syntax, context, and general usage information about this entry point routine in DDI drivers.

See close(D2oddi) for syntax, context, and general usage information about this entry point routine in ODDI drivers.

Usage

The close( ) entry point routine is called when the MDI device is closed. The MDI driver should shutdown the adapter so that it no longer generates interrupts or generates network traffic. The adapter will be fully re-initialized when the MDI device is re-opened and the open( ) routine is called.

The MDI driver's close( ) routine should do the following:

Free all resources that were allocated in the open(D2mdi) entry point routine.
Issue the unbufcall(D3str) function to cancel any pending bufcall(D3str) requests.
Issue the untimeout(D3) function to cancel any pending itimeout(D3) requests.
If the MAC address has been set to a non-factory value with the MACIOC_SETADDR ioctl, the new MAC address should be used for the next open(D2mdi). In other words, do not reset the MAC address to the factory default address in the close( ) routine.
If the driver called the mdi_tx_if_init(D3mdi) and mdi_tx_if_enable(D3mdi) functions in its open(D2mdi) routine, call the mdi_tx_if_disable(D3mdi) and mdi_tx_if_deinit(D3mdi) functions to deallocate those resources.
Disable interrupts on the adapter if possible, especially for PCI devices.

Since MDI drivers enforce a single open( ) per minor number, there will usually be one close( ) for each open( ). The exception is when the system is halted. In this case, DDI 7 MDI drivers may get their halt(D2mdi) routine called, and DDI 8 MDI drivers may get their config(D2mdi) routine called (with CFG_SUSPEND), but in neither instance is the close( ) routine called.

Version applicability

mdi: 1, 2, 2.1 running with ddi: 7, 7mp, 8, 8mp.

References

close(D2), close(D2str), close(D2oddi), mdi_tx_if_deinit(D3mdi), mdi_tx_if_disable(D3mdi), Intro(MDI) manual page on OpenServer 6 and the Intro(7mdi) manual page on UnixWare 7.1.4.