TABLE OF CONTENTS

1. OpenSM/DR Path
2. OpenSM: DR Path/osm_dr_path_t
3. OpenSM: DR Path/osm_dr_path_construct
4. OpenSM: DR Path/osm_dr_path_init
5. OpenSM: DR Path/osm_dr_path_extend
6. OpenSM: DR Path/osm_dr_path_get_bind_handle

OpenSM/DR Path

    DR Path

    The DR Path structure encapsulates a directed route through the subnet.

    This structure allows direct access to member variables.

    Steve King, Intel

OpenSM: DR Path/osm_dr_path_t

    osm_dr_path_t

    Directed Route structure.

    This structure allows direct access to member variables.

typedef struct _osm_dr_path
{
    osm_bind_handle_t       h_bind;
    uint8_t                 hop_count;
    uint8_t                 path[IB_SUBNET_PATH_HOPS_MAX];

} osm_dr_path_t;

    h_bind
        Bind handle for port to which this path applies.

    hop_count
        The number of hops in this path.

    path
        The array of port numbers that comprise this path.

    DR Path structure

OpenSM: DR Path/osm_dr_path_construct

    osm_dr_path_construct

    This function constructs a directed route path object.

 void
osm_dr_path_construct(
    IN osm_dr_path_t* const p_path );

    p_path
        [in] Pointer to a directed route path oject to initialize.

    h_bind
        [in] Bind handle for the port on which this path applies.

    hop_count
        [in] Hop count needed to reach this node.

    path
        [in] Directed route path to reach this node.

    None.

OpenSM: DR Path/osm_dr_path_init

    osm_dr_path_init

    This function initializes a directed route path object.

 void
osm_dr_path_init(
    IN osm_dr_path_t* const p_path,
    IN const osm_bind_handle_t h_bind,
    IN const uint8_t hop_count,
    IN const uint8_t path[IB_SUBNET_PATH_HOPS_MAX] );

    p_path
        [in] Pointer to a directed route path oject to initialize.

    h_bind
        [in] Bind handle for the port on which this path applies.

    hop_count
        [in] Hop count needed to reach this node.

    path
        [in] Directed route path to reach this node.

    None.

OpenSM: DR Path/osm_dr_path_extend

    osm_dr_path_extend

    Adds a new hop to a path.

 void
osm_dr_path_extend(
    IN osm_dr_path_t* const p_path,
    IN const uint8_t port_num );

    p_path
        [in] Pointer to a directed route path oject to initialize.

    port_num
        [in] Additional port to add to the DR path.

    None.

OpenSM: DR Path/osm_dr_path_get_bind_handle

    osm_dr_path_get_bind_handle

    Gets the bind handle from a path.

 osm_bind_handle_t
osm_dr_path_get_bind_handle(
    IN const osm_dr_path_t* const p_path );

    p_path
        [in] Pointer to a directed route path oject to initialize.

    port_num
        [in] Additional port to add to the DR path.

    None.