1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or http://www.opensolaris.org/os/licensing.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2008 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _SYS_IB_ADAPTERS_HERMON_AGENTS_H
#define _SYS_IB_ADAPTERS_HERMON_AGENTS_H
/*
* hermon_agents.h
* Contains all of the prototypes, #defines, and structures necessary
* for all of the Hermon Infiniband Management Agent (SMA, PMA, BMA)
* routines
* Specifically it contains the various flags, structures used for tracking
* the Hermon agents, and prototypes for initialization and teardown
* functions.
*/
#include <sys/types.h>
#include <sys/conf.h>
#include <sys/ddi.h>
#include <sys/sunddi.h>
#include <sys/ib/mgt/ibmf/ibmf.h>
#ifdef __cplusplus
extern "C" {
#endif
/*
* The following defines specify the default number of (SW-assisted) agents
* per port. It is broken down by QP number. QP0 will have only the one
* agent, the SMA. QP1 should have two agents, the PMA and BMA, but for now
* the Hermon firmware doesn't support a BMA. So we do not register it with
* the IBMF.
*/
#define HERMON_NUM_QP0_AGENTS_PER_PORT 1
#define HERMON_NUM_QP1_AGENTS_PER_PORT 1
/* Number of threads for the agent handling task queue */
#define HERMON_TASKQ_NTHREADS 1
/* Maximum number of tasks on task queue */
#define HERMON_TASKQ_MAX_TASKS 4
/*
* The following defines the name for the task queue. Note: this string
* will later be combined with the Hermon driver instance number to create
* a unique name for the task queue
*/
#define HERMON_TASKQ_NAME "hermon_taskq"
/*
* The following macros are used when handling directed route MADs. They tell
* the driver whether a given MAD is a directed route MAD, can extract the
* "hop pointer" and "hop count" fields, and can even set the "direction" bit
* in the MAD and (if necessary) update the "hop pointer".
* More details on how these macros are used can be found in the
* hermon_agents.c source file.
*/
#define HERMON_MAD_IS_DR(madhdrp) \
(((sm_dr_mad_hdr_t *)(madhdrp))->MgmtClass == 0x81)
#define HERMON_DRMAD_GET_HOPCOUNT(madhdrp) \
(((sm_dr_mad_hdr_t *)(madhdrp))->HopCount)
#define HERMON_DRMAD_GET_HOPPOINTER(madhdrp) \
(((sm_dr_mad_hdr_t *)(madhdrp))->HopPointer)
#define HERMON_DRMAD_SET_HOPPOINTER(madhdrp, hp) \
(((sm_dr_mad_hdr_t *)(madhdrp))->HopPointer = (hp))
#ifdef _LITTLE_ENDIAN
#define HERMON_DRMAD_SET_DIRECTION(madhdrp) \
(((sm_dr_mad_hdr_t *)(madhdrp))->D_Status |= 0x0080)
#else
#define HERMON_DRMAD_SET_DIRECTION(madhdrp) \
(((sm_dr_mad_hdr_t *)(madhdrp))->D_Status |= 0x8000)
#endif
/*
* The following macro is used to determine whether a received MAD is
* one of the special "Hermon Trap" MADs. If it is, then some special
* processing (described in hermon_agents.c) is necessary.
*/
#define HERMON_IS_SPECIAL_TRAP_MAD(msgp) \
((((msgp)->im_msgbufs_recv.im_bufs_mad_hdr->R_Method & \
MAD_METHOD_MASK) == MAD_METHOD_TRAP) && \
((msgp)->im_local_addr.ia_remote_lid == 0))
/*
* The following macro is used to determine whether a received MAD is
* a "TrapRepress" MAD. If it is, then no response MAD should be sent
* (described in hermon_agents.c).
*/
#define HERMON_IS_TRAP_REPRESS_MAD(msgp) \
((((msgp)->im_msgbufs_recv.im_bufs_mad_hdr->R_Method & \
MAD_METHOD_MASK) == MAD_METHOD_TRAP_REPRESS))
/*
* The following define specified the offset for the start of "Return Path"
* in a directed route MAD. Note: this is the offset from the start of the
* MAD data area (in bytes).
*/
#define HERMON_DRMAD_RETURN_PATH_OFFSET 0x80
/*
* The hermon_agent_list_s structure is used in the Hermon IB Management Agent
* routines to keep track of the number (and type) of each registered agent.
* The primary purpose of tracking this information (port number, management
* class, and IBMF handle) is to be able to later deregister all the agents
* which are registered at attach() time. Note: a pointer to this structure
* is returned to the driver (by the IBMF) every time the agent callback
* routine is called. This is why the structure contains a backpointer to
* the Hermon softstate.
*/
struct hermon_agent_list_s {
hermon_state_t *agl_state;
uint_t agl_port;
ibmf_client_type_t agl_mgmtclass;
ibmf_handle_t agl_ibmfhdl;
};
/*
* The hermon_agent_handler_arg_t structure is used in the Hermon IB Management
* Agent routines to pass request information through the task queue. Each
* time a request is received (by the Hermon agent request callback), one
* of these structures is allocated and filled with the relevant information
* for the request. It is then dispatched to the task queue (with a pointer
* to the structure passed as an argument). From there it is later pulled
* apart and the individual fields of the structure used to handle the
* request.
*/
typedef struct hermon_agent_handler_arg_s {
ibmf_handle_t ahd_ibmfhdl;
ibmf_msg_t *ahd_ibmfmsg;
hermon_agent_list_t *ahd_agentlist;
} hermon_agent_handler_arg_t;
int hermon_agent_handlers_init(hermon_state_t *state);
int hermon_agent_handlers_fini(hermon_state_t *state);
#ifdef __cplusplus
}
#endif
#endif /* _SYS_IB_ADAPTERS_HERMON_AGENTS_H */
|
