Manual Pages for UNIX Operating System command usage for man FCOE_CreatePort

FCoE Port Management Library Functions     FCOE_CreatePort(3FCOE)



NAME
     FCOE_CreatePort - create an FCoE port

SYNOPSIS
     cc [ flag... ] file... -lfcoe [ library... ]
     #include 

     int FCOE_CreatePort(const char *macLinkName, int portType,
          struct fcoe_port_wwn pwwn, struct fcoe_port_wwn nwwn,
          int promiscuous);


PARAMETERS
     macLinkName    The name of the MAC link on which  to  create
                    the FCoE port.


     portType       This    parameter    should     always     be
                    FCOE_PORTTYPE_TARGET.


     pwwn           The Port WorldWideName to  be  used  for  the
                    FCoE  port.  Fill the structure with zeros to
                    let the fcoe driver generate a valid Port WWN
                    from  the  MAC  address of the underlying NIC
                    hardware.


     nwwn           The Node WorldWideName to  be  used  for  the
                    FCoE  port.  Fill the structure with zeros to
                    let the fcoe driver generate a valid Node WWN
                    from  the  MAC  address of the underlying NIC
                    hardware.


     promiscuous    A non-zero value to enable  promiscuous  mode
                    on  the underlying NIC hardware. A value of 0
                    indicates use of the multiple unicast address
                    feature of the underlying NIC hardware.


DESCRIPTION
     The FCOE_CreatePort() function creates an FCoE port over the
     specified MAC link.

RETURN VALUES
     The following values are returned:

     FCOE_STATUS_ERROR_BUSY

         The fcoe driver is busy and cannot complete  the  opera-
         tion.



SunOS 5.11           Last change: 1 Apr 2009                    1






FCoE Port Management Library Functions     FCOE_CreatePort(3FCOE)



     FCOE_STATUS_ERROR_ALREADY

         An existing FCoE port was found over the  specified  MAC
         link.


     FCOE_STATUS_ERROR_OPEN_DEV

         Failed to open fcoe device.


     FCOE_STATUS_ERROR_WWN_SAME

         The specified Port WWN is same  as  the  specified  Node
         WWN.


     FCOE_STATUS_ERROR_MAC_LEN

         MAC link name exceeds the maximum length.


     FCOE_STATUS_ERROR_PWWN_CONFLICTED

         The specified Port WWN is already in use.


     FCOE_STATUS_ERROR_NWWN_CONFLICTED

         The specified Node WWN is already in use.


     FCOE_STATUS_ERROR_NEED_JUMBO_FRAME

         The MTU size of the  specified  MAC  link  needs  to  be
         increased to 2500 or above.


     FCOE_STATUS_ERROR_OPEN_MAC

         Failed to open the specified MAC link.


     FCOE_STATUS_ERROR_CREATE_PORT

         Failed to create FCoE port on the specified MAC link.


     FCOE_STATUS_OK

         The API call was successful.




SunOS 5.11           Last change: 1 Apr 2009                    2






FCoE Port Management Library Functions     FCOE_CreatePort(3FCOE)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|


SEE ALSO
     libfcoe(3LIB), attributes(5)






































SunOS 5.11           Last change: 1 Apr 2009                    3