FCOE_GetPortHandle - open FCoE port handle
cc [ flag... ] file... -lfcoe [ library... ] #include <libfcoe.h>
FCOE_STATUS FCOE_GetPortHandle( FCOE_UINT32 *linkName, FCOE_UINT8 portResType FCOE_PORT_HANDLE * phandle);
The name of the data link on which the FCoE port has been created.
Resource type should be FCOE_RT_PORT_PROPERTY.
An opaque pointer to an FCOE_PORT_HANDLE that on successful return, contains a valid port handle, or NULL on failed return.
The FCOE_GetPortHandle() function opens the FCoE port handle specified by macLinkName, retrieves the port information only related to portResType. When the caller is finished using the phandle, it must free the memory allocated for port information by calling FCOE_ClosePortHandle(3FCOE) .
The following values are returned:
The fcoe driver is busy and cannot complete the operation.
MAC link name exceeds the maximum length.
The value specified for macLinkName or portResType was not valid.
Failed to get link information by macLinkName.
Not enough permission to open the fcoe device.
Failed to open fcoe device.
The FCoE port was not found on the specified MAC link.
The API call was successful.
See attributes(5) for descriptions of the following attributes: