|
Packit |
13e616 |
/*
|
|
Packit |
13e616 |
* Copyright (c) 2004, 2005 Voltaire, Inc. All rights reserved.
|
|
Packit |
13e616 |
* Copyright (c) 2002-2005 Mellanox Technologies LTD. All rights reserved.
|
|
Packit |
13e616 |
* Copyright (c) 1996-2003 Intel Corporation. All rights reserved.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* This software is available to you under a choice of one of two
|
|
Packit |
13e616 |
* licenses. You may choose to be licensed under the terms of the GNU
|
|
Packit |
13e616 |
* General Public License (GPL) Version 2, available from the file
|
|
Packit |
13e616 |
* COPYING in the main directory of this source tree, or the
|
|
Packit |
13e616 |
* OpenIB.org BSD license below:
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* Redistribution and use in source and binary forms, with or
|
|
Packit |
13e616 |
* without modification, are permitted provided that the following
|
|
Packit |
13e616 |
* conditions are met:
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* - Redistributions of source code must retain the above
|
|
Packit |
13e616 |
* copyright notice, this list of conditions and the following
|
|
Packit |
13e616 |
* disclaimer.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* - Redistributions in binary form must reproduce the above
|
|
Packit |
13e616 |
* copyright notice, this list of conditions and the following
|
|
Packit |
13e616 |
* disclaimer in the documentation and/or other materials
|
|
Packit |
13e616 |
* provided with the distribution.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
Packit |
13e616 |
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
Packit |
13e616 |
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
Packit |
13e616 |
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
|
|
Packit |
13e616 |
* BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
|
|
Packit |
13e616 |
* ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
Packit |
13e616 |
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
Packit |
13e616 |
* SOFTWARE.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
*/
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
/*
|
|
Packit |
13e616 |
* Abstract:
|
|
Packit |
13e616 |
* Declaration of osm_mad_wrapper_t.
|
|
Packit |
13e616 |
* This object represents the context wrapper for OpenSM MAD processing.
|
|
Packit |
13e616 |
* This object is part of the OpenSM family of objects.
|
|
Packit |
13e616 |
*/
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
#ifndef _OSM_VENDOR_AL_H_
|
|
Packit |
13e616 |
#define _OSM_VENDOR_AL_H_
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
#include <iba/ib_types.h>
|
|
Packit |
13e616 |
#include <iba/ib_al.h>
|
|
Packit |
13e616 |
#include <complib/cl_qlist.h>
|
|
Packit |
13e616 |
#include <complib/cl_thread.h>
|
|
Packit |
13e616 |
#include <opensm/osm_base.h>
|
|
Packit |
13e616 |
#include <opensm/osm_log.h>
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
#ifdef __cplusplus
|
|
Packit |
13e616 |
# define BEGIN_C_DECLS extern "C" {
|
|
Packit |
13e616 |
# define END_C_DECLS }
|
|
Packit |
13e616 |
#else /* !__cplusplus */
|
|
Packit |
13e616 |
# define BEGIN_C_DECLS
|
|
Packit |
13e616 |
# define END_C_DECLS
|
|
Packit |
13e616 |
#endif /* __cplusplus */
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
BEGIN_C_DECLS
|
|
Packit |
13e616 |
/****h* OpenSM/Vendor AL
|
|
Packit |
13e616 |
* NAME
|
|
Packit |
13e616 |
* Vendor AL
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* DESCRIPTION
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* The Vendor AL object is thread safe.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* This object should be treated as opaque and should be
|
|
Packit |
13e616 |
* manipulated only through the provided functions.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* Enable various hacks to compensate for bugs in external code...
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* AUTHOR
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
*********/
|
|
Packit |
13e616 |
/****h* OpenSM/Vendor Access Layer (AL)
|
|
Packit |
13e616 |
* NAME
|
|
Packit |
13e616 |
* Vendor AL
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* DESCRIPTION
|
|
Packit |
13e616 |
* This file is the vendor specific file for the AL Infiniband API.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* AUTHOR
|
|
Packit |
13e616 |
* Steve King, Intel
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
*********/
|
|
Packit |
13e616 |
#define OSM_AL_SQ_SGE 256
|
|
Packit |
13e616 |
#define OSM_AL_RQ_SGE 256
|
|
Packit |
13e616 |
#define OSM_DEFAULT_RETRY_COUNT 3
|
|
Packit |
13e616 |
/* AL supports RMPP */
|
|
Packit |
13e616 |
#define VENDOR_RMPP_SUPPORT 1
|
|
Packit |
13e616 |
/****s* OpenSM: Vendor AL/osm_ca_info_t
|
|
Packit |
13e616 |
* NAME
|
|
Packit |
13e616 |
* osm_ca_info_t
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* DESCRIPTION
|
|
Packit |
13e616 |
* Structure containing information about local Channle Adapters.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SYNOPSIS
|
|
Packit |
13e616 |
*/
|
|
Packit |
13e616 |
typedef struct _osm_ca_info {
|
|
Packit |
13e616 |
ib_net64_t guid;
|
|
Packit |
13e616 |
size_t attr_size;
|
|
Packit |
13e616 |
ib_ca_attr_t *p_attr;
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
} osm_ca_info_t;
|
|
Packit |
13e616 |
/*
|
|
Packit |
13e616 |
* FIELDS
|
|
Packit |
13e616 |
* guid
|
|
Packit |
13e616 |
* Node GUID of the local CA.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* attr_size
|
|
Packit |
13e616 |
* Size of the CA attributes for this CA.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* p_attr
|
|
Packit |
13e616 |
* Pointer to dynamicly allocated CA Attribute structure.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SEE ALSO
|
|
Packit |
13e616 |
*********/
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
/****f* OpenSM: CA Info/osm_ca_info_get_num_ports
|
|
Packit |
13e616 |
* NAME
|
|
Packit |
13e616 |
* osm_ca_info_get_num_ports
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* DESCRIPTION
|
|
Packit |
13e616 |
* Returns the number of ports owned by this CA.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SYNOPSIS
|
|
Packit |
13e616 |
*/
|
|
Packit |
13e616 |
static inline uint8_t
|
|
Packit |
13e616 |
osm_ca_info_get_num_ports(IN const osm_ca_info_t * const p_ca_info)
|
|
Packit |
13e616 |
{
|
|
Packit |
13e616 |
return (p_ca_info->p_attr->num_ports);
|
|
Packit |
13e616 |
}
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
/*
|
|
Packit |
13e616 |
* PARAMETERS
|
|
Packit |
13e616 |
* p_ca_info
|
|
Packit |
13e616 |
* [in] Pointer to a CA Info object.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* RETURN VALUE
|
|
Packit |
13e616 |
* Returns the number of ports owned by this CA.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* NOTES
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SEE ALSO
|
|
Packit |
13e616 |
*********/
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
/****f* OpenSM: CA Info/osm_ca_info_get_port_guid
|
|
Packit |
13e616 |
* NAME
|
|
Packit |
13e616 |
* osm_ca_info_get_port_guid
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* DESCRIPTION
|
|
Packit |
13e616 |
* Returns the port GUID of the specified port owned by this CA.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SYNOPSIS
|
|
Packit |
13e616 |
*/
|
|
Packit |
13e616 |
static inline ib_net64_t
|
|
Packit |
13e616 |
osm_ca_info_get_port_guid(IN const osm_ca_info_t * const p_ca_info,
|
|
Packit |
13e616 |
IN const uint8_t index)
|
|
Packit |
13e616 |
{
|
|
Packit |
13e616 |
return (p_ca_info->p_attr->p_port_attr[index].port_guid);
|
|
Packit |
13e616 |
}
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
/*
|
|
Packit |
13e616 |
* PARAMETERS
|
|
Packit |
13e616 |
* p_ca_info
|
|
Packit |
13e616 |
* [in] Pointer to a CA Info object.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* index
|
|
Packit |
13e616 |
* [in] Port "index" for which to retrieve the port GUID.
|
|
Packit |
13e616 |
* The index is the offset into the ca's internal array
|
|
Packit |
13e616 |
* of port attributes.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* RETURN VALUE
|
|
Packit |
13e616 |
* Returns the port GUID of the specified port owned by this CA.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* NOTES
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SEE ALSO
|
|
Packit |
13e616 |
*********/
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
/****f* OpenSM: CA Info/osm_ca_info_get_port_num
|
|
Packit |
13e616 |
* NAME
|
|
Packit |
13e616 |
* osm_ca_info_get_port_num
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* DESCRIPTION
|
|
Packit |
13e616 |
* Returns the port number of the specified port owned by this CA.
|
|
Packit |
13e616 |
* Port numbers start with 1 for HCA's.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SYNOPSIS
|
|
Packit |
13e616 |
*/
|
|
Packit |
13e616 |
static inline uint8_t
|
|
Packit |
13e616 |
osm_ca_info_get_port_num(IN const osm_ca_info_t * const p_ca_info,
|
|
Packit |
13e616 |
IN const uint8_t index)
|
|
Packit |
13e616 |
{
|
|
Packit |
13e616 |
return (p_ca_info->p_attr->p_port_attr[index].port_num);
|
|
Packit |
13e616 |
}
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
/*
|
|
Packit |
13e616 |
* PARAMETERS
|
|
Packit |
13e616 |
* p_ca_info
|
|
Packit |
13e616 |
* [in] Pointer to a CA Info object.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* index
|
|
Packit |
13e616 |
* [in] Port "index" for which to retrieve the port GUID.
|
|
Packit |
13e616 |
* The index is the offset into the ca's internal array
|
|
Packit |
13e616 |
* of port attributes.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* RETURN VALUE
|
|
Packit |
13e616 |
* Returns the port GUID of the specified port owned by this CA.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* NOTES
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SEE ALSO
|
|
Packit |
13e616 |
*********/
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
/****f* OpenSM: CA Info/osm_ca_info_get_ca_guid
|
|
Packit |
13e616 |
* NAME
|
|
Packit |
13e616 |
* osm_ca_info_get_ca_guid
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* DESCRIPTION
|
|
Packit |
13e616 |
* Returns the GUID of the specified CA.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SYNOPSIS
|
|
Packit |
13e616 |
*/
|
|
Packit |
13e616 |
static inline ib_net64_t
|
|
Packit |
13e616 |
osm_ca_info_get_ca_guid(IN const osm_ca_info_t * const p_ca_info)
|
|
Packit |
13e616 |
{
|
|
Packit |
13e616 |
return (p_ca_info->p_attr->ca_guid);
|
|
Packit |
13e616 |
}
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
/*
|
|
Packit |
13e616 |
* PARAMETERS
|
|
Packit |
13e616 |
* p_ca_info
|
|
Packit |
13e616 |
* [in] Pointer to a CA Info object.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* RETURN VALUE
|
|
Packit |
13e616 |
* Returns the GUID of the specified CA.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* NOTES
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SEE ALSO
|
|
Packit |
13e616 |
*********/
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
/****s* OpenSM: Vendor AL/osm_bind_handle_t
|
|
Packit |
13e616 |
* NAME
|
|
Packit |
13e616 |
* osm_bind_handle_t
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* DESCRIPTION
|
|
Packit |
13e616 |
* handle returned by the vendor transport bind call.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SYNOPSIS
|
|
Packit |
13e616 |
*/
|
|
Packit |
13e616 |
typedef struct _osm_vendor {
|
|
Packit |
13e616 |
ib_al_handle_t h_al;
|
|
Packit |
13e616 |
osm_log_t *p_log;
|
|
Packit |
13e616 |
uint32_t ca_count;
|
|
Packit |
13e616 |
osm_ca_info_t *p_ca_info;
|
|
Packit |
13e616 |
uint32_t timeout;
|
|
Packit |
13e616 |
ib_ca_handle_t h_ca;
|
|
Packit |
13e616 |
ib_pd_handle_t h_pd;
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
} osm_vendor_t;
|
|
Packit |
13e616 |
/*
|
|
Packit |
13e616 |
* FIELDS
|
|
Packit |
13e616 |
* h_al
|
|
Packit |
13e616 |
* Handle returned by AL open call (ib_open_al).
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* p_log
|
|
Packit |
13e616 |
* Pointer to the log object.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* ca_count
|
|
Packit |
13e616 |
* Number of CA's in the array pointed to by p_ca_info.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* p_ca_info
|
|
Packit |
13e616 |
* Pointer to dynamically allocated array of CA info objects.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* h_pool
|
|
Packit |
13e616 |
* MAD Pool handle returned by ib_create_mad_pool at init time.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* timeout
|
|
Packit |
13e616 |
* Transaction timeout time in milliseconds.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SEE ALSO
|
|
Packit |
13e616 |
*********/
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
#define OSM_BIND_INVALID_HANDLE 0
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
/****s* OpenSM: Vendor AL/osm_bind_handle_t
|
|
Packit |
13e616 |
* NAME
|
|
Packit |
13e616 |
* osm_bind_handle_t
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* DESCRIPTION
|
|
Packit |
13e616 |
* handle returned by the vendor transport bind call.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SYNOPSIS
|
|
Packit |
13e616 |
*/
|
|
Packit |
13e616 |
typedef void *osm_bind_handle_t;
|
|
Packit |
13e616 |
/***********/
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
/****s* OpenSM/osm_vend_wrap_t
|
|
Packit |
13e616 |
* NAME
|
|
Packit |
13e616 |
* AL Vendor MAD Wrapper
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* DESCRIPTION
|
|
Packit |
13e616 |
* AL specific MAD wrapper. AL transport layer uses this for
|
|
Packit |
13e616 |
* housekeeping.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SYNOPSIS
|
|
Packit |
13e616 |
*********/
|
|
Packit |
13e616 |
typedef struct _osm_vend_wrap_t {
|
|
Packit |
13e616 |
uint32_t size;
|
|
Packit |
13e616 |
osm_bind_handle_t h_bind;
|
|
Packit |
13e616 |
ib_mad_element_t *p_elem;
|
|
Packit |
13e616 |
ib_av_handle_t h_av;
|
|
Packit |
13e616 |
void *p_resp_madw;
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
} osm_vend_wrap_t;
|
|
Packit |
13e616 |
/*
|
|
Packit |
13e616 |
* FIELDS
|
|
Packit |
13e616 |
* size
|
|
Packit |
13e616 |
* Size of the allocated MAD
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* h_bind
|
|
Packit |
13e616 |
* Bind handle used on this transaction
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* p_elem
|
|
Packit |
13e616 |
* Pointer to the mad element structure associated with
|
|
Packit |
13e616 |
* this mad.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* h_av
|
|
Packit |
13e616 |
* Address vector handle used for this transaction.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* p_resp_madw
|
|
Packit |
13e616 |
* Pointer to the mad wrapper structure used to hold the pending
|
|
Packit |
13e616 |
* reponse to the mad, if any. If a response is expected, the
|
|
Packit |
13e616 |
* wrapper for the reponse is allocated during the send call.
|
|
Packit |
13e616 |
*
|
|
Packit |
13e616 |
* SEE ALSO
|
|
Packit |
13e616 |
*********/
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
END_C_DECLS
|
|
Packit |
13e616 |
#endif /* _OSM_VENDOR_AL_H_ */
|