TABLE OF CONTENTS

1. OpenSM/Switch Info Receiver
2. OpenSM: Switch Info Receiver/osm_si_rcv_t
3. OpenSM: Switch Info Receiver/osm_si_rcv_construct
4. OpenSM: Switch Info Receiver/osm_si_rcv_destroy
5. OpenSM: Switch Info Receiver/osm_si_rcv_init
6. OpenSM: Switch Info Receiver/osm_si_rcv_is_inited
7. OpenSM: Switch Info Receiver/osm_si_rcv_process

OpenSM/Switch Info Receiver

    Switch Info Receiver

    The Switch Info Receiver object encapsulates the information
    needed to receive the SwitchInfo attribute from a node.

    The Switch Info Receiver object is thread safe.

    This object should be treated as opaque and should be
    manipulated only through the provided functions.

    Steve King, Intel

OpenSM: Switch Info Receiver/osm_si_rcv_t

    osm_si_rcv_t

    Switch Info Receiver structure.

    This object should be treated as opaque and should
    be manipulated only through the provided functions.

typedef struct _osm_si_rcv
{
    osm_subn_t                  *p_subn;
    osm_log_t                   *p_log;
    osm_req_t                   *p_req;
    osm_state_mgr_t             *p_state_mgr;
    cl_plock_t                  *p_lock;

} osm_si_rcv_t;

    base
        OpenSM base object.

    p_subn
        Pointer to the Subnet object for this subnet.

    p_log
        Pointer to the log object.

    p_req
        Pointer to the Request object.

    p_state_mgr
        Pointer to the State Manager object.

    p_lock
        Pointer to the serializing lock.

    Switch Info Receiver object

OpenSM: Switch Info Receiver/osm_si_rcv_construct

    osm_si_rcv_construct

    This function constructs a Switch Info Receiver object.

void osm_si_rcv_construct(
    IN osm_si_rcv_t* const p_ctrl );

    p_ctrl
        [in] Pointer to a Switch Info Receiver object to construct.

    This function does not return a value.

    Allows calling osm_si_rcv_init, osm_si_rcv_destroy,
    and osm_si_rcv_is_inited.

    Calling osm_si_rcv_construct is a prerequisite to calling any other
    method except osm_si_rcv_init.

    Switch Info Receiver object, osm_si_rcv_init,
    osm_si_rcv_destroy, osm_si_rcv_is_inited

OpenSM: Switch Info Receiver/osm_si_rcv_destroy

    osm_si_rcv_destroy

    The osm_si_rcv_destroy function destroys the object, releasing
    all resources.

void osm_si_rcv_destroy(
    IN osm_si_rcv_t* const p_ctrl );

    p_ctrl
        [in] Pointer to the object to destroy.

    This function does not return a value.

    Performs any necessary cleanup of the specified
    Switch Info Receiver object.
    Further operations should not be attempted on the destroyed object.
    This function should only be called after a call to
    osm_si_rcv_construct or osm_si_rcv_init.

    Switch Info Receiver object, osm_si_rcv_construct,
    osm_si_rcv_init

OpenSM: Switch Info Receiver/osm_si_rcv_init

    osm_si_rcv_init

    The osm_si_rcv_init function initializes a
    Switch Info Receiver object for use.

ib_api_status_t osm_si_rcv_init(
    IN osm_si_rcv_t* const p_ctrl,
    IN osm_subn_t* const p_subn,
    IN osm_log_t* const p_log,
    IN osm_req_t* const p_req,
    IN osm_state_mgr_t* const p_state_mgr,
    IN cl_plock_t* const p_lock );

    p_ctrl
        [in] Pointer to an osm_si_rcv_t object to initialize.

    p_subn
        [in] Pointer to the Subnet object for this subnet.

    p_log
        [in] Pointer to the log object.

    p_req
        [in] Pointer to an osm_req_t object.

    p_state_mgr
        [in] Pointer to the State Manager object.

    p_lock
        [in] Pointer to the OpenSM serializing lock.

    IB_SUCCESS if the Switch Info Receiver object was initialized
    successfully.

    Allows calling other Switch Info Receiver methods.

    Switch Info Receiver object, osm_si_rcv_construct,
    osm_si_rcv_destroy, osm_si_rcv_is_inited

OpenSM: Switch Info Receiver/osm_si_rcv_is_inited

    osm_si_rcv_is_inited

    Indicates if the object has been initialized with osm_si_rcv_init.

boolean_t osm_si_rcv_is_inited(
    IN const osm_si_rcv_t* const p_ctrl );

    p_ctrl
        [in] Pointer to an osm_si_rcv_t object.

    TRUE if the object was initialized successfully,
    FALSE otherwise.

    The osm_si_rcv_construct or osm_si_rcv_init must be
    called before using this function.

    Switch Info Receiver object, osm_si_rcv_construct,
    osm_si_rcv_init

OpenSM: Switch Info Receiver/osm_si_rcv_process

    osm_si_rcv_process

    Process the SwitchInfo attribute.

void osm_si_rcv_process(
    IN const osm_si_rcv_t* const p_ctrl,
    IN osm_madw_t* const p_madw );

    p_ctrl
        [in] Pointer to an osm_si_rcv_t object.

    p_madw
        [in] Pointer to the MAD Wrapper containing the MAD
        that contains the node's SwitchInfo attribute.

    CL_SUCCESS if the SwitchInfo processing was successful.

    This function processes a SwitchInfo attribute.

    Switch Info Receiver, Switch Info Response Controller