summaryrefslogtreecommitdiff
path: root/include/ipmitool/ipmi_channel.h
blob: 7cbb9adefc1c022cbde4d382254ad14a5f4283ff (plain)
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
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
/*
 * Copyright (c) 2003 Sun Microsystems, Inc.  All Rights Reserved.
 * 
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 
 * Redistribution of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer.
 * 
 * Redistribution in binary form must reproduce the above copyright
 * notice, this list of conditions and the following disclaimer in the
 * documentation and/or other materials provided with the distribution.
 * 
 * Neither the name of Sun Microsystems, Inc. or the names of
 * contributors may be used to endorse or promote products derived
 * from this software without specific prior written permission.
 * 
 * This software is provided "AS IS," without a warranty of any kind.
 * ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
 * INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
 * PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED.
 * SUN MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL NOT BE LIABLE
 * FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING
 * OR DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.  IN NO EVENT WILL
 * SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA,
 * OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR
 * PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF
 * LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE,
 * EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
 */

#ifndef IPMI_CHANNEL_H
#define IPMI_CHANNEL_H

#if HAVE_CONFIG_H
# include <config.h>
#endif
#include <ipmitool/ipmi.h>


#define IPMI_GET_CHANNEL_AUTH_CAP      0x38
#define IPMI_GET_CHANNEL_ACCESS        0x41
#define IPMI_GET_CHANNEL_INFO          0x42
#define IPMI_SET_USER_ACCESS           0x43
#define IPMI_GET_USER_ACCESS           0x44
#define IPMI_SET_USER_NAME             0x45
#define IPMI_GET_USER_NAME             0x46
#define IPMI_SET_USER_PASSWORD         0x47
#define IPMI_GET_CHANNEL_CIPHER_SUITES 0x54


/*
 * The Get Authentication Capabilities response structure
 * From table 22-15 of the IPMI v2.0 spec
 */
#ifdef HAVE_PRAGMA_PACK
#pragma pack(1)
#endif
struct get_channel_auth_cap_rsp {
	uint8_t channel_number;
#if WORDS_BIGENDIAN
	uint8_t v20_data_available : 1; /* IPMI v2.0 data is available */
	uint8_t __reserved1        : 1; 
	uint8_t enabled_auth_types : 6; /* IPMI v1.5 enabled auth types */
#else
	uint8_t enabled_auth_types : 6; /* IPMI v1.5 enabled auth types */
	uint8_t __reserved1        : 1;
	uint8_t v20_data_available : 1; /* IPMI v2.0 data is available */
#endif
#if WORDS_BIGENDIAN
	uint8_t __reserved2        : 2;
	uint8_t kg_status          : 1; /* two-key login status */
	uint8_t per_message_auth   : 1; /* per-message authentication status */
	uint8_t user_level_auth    : 1; /* user-level authentication status */
	uint8_t non_null_usernames : 1; /* one or more non-null users exist */
	uint8_t null_usernames     : 1; /* one or more null usernames non-null pwds */
	uint8_t anon_login_enabled : 1; /* a null-named, null-pwd user exists */
#else
	uint8_t anon_login_enabled : 1; /* a null-named, null-pwd user exists */
	uint8_t null_usernames     : 1; /* one or more null usernames non-null pwds */
	uint8_t non_null_usernames : 1; /* one or more non-null users exist */
	uint8_t user_level_auth    : 1; /* user-level authentication status */
	uint8_t per_message_auth   : 1; /* per-message authentication status */
	uint8_t kg_status          : 1; /* two-key login status */
	uint8_t __reserved2        : 2;
#endif
#if WORDS_BIGENDIAN
	uint8_t __reserved3        : 6;
	uint8_t ipmiv20_support    : 1; /* channel supports IPMI v2.0 connections */
	uint8_t ipmiv15_support    : 1; /* channel supports IPMI v1.5 connections */
#else
	uint8_t ipmiv15_support    : 1; /* channel supports IPMI v1.5 connections */
	uint8_t ipmiv20_support    : 1; /* channel supports IPMI v2.0 connections */
	uint8_t __reserved3        : 6;
#endif
	uint8_t oem_id[3];    /* IANA enterprise number for auth type */
	uint8_t oem_aux_data; /* Additional OEM specific data for oem auths */
} ATTRIBUTE_PACKING;
#ifdef HAVE_PRAGMA_PACK
#pragma pack(0)
#endif



/*
 * The Get Channel Info response structure
 * From table 22-29 of the IPMI v2.0 spec
 */
#ifdef HAVE_PRAGMA_PACK
#pragma pack(1)
#endif
struct get_channel_info_rsp {
#if WORDS_BIGENDIAN
	uint8_t __reserved1       : 4; 
	uint8_t channel_number    : 4; /* channel number */
#else
	uint8_t channel_number    : 4; /* channel number */
	uint8_t __reserved1       : 4; 
#endif
#if WORDS_BIGENDIAN
	uint8_t __reserved2       : 1;
	uint8_t channel_medium    : 7; /* Channel medium type per table 6-3 */
#else
	uint8_t channel_medium    : 7; /* Channel medium type per table 6-3 */
	uint8_t __reserved2       : 1;
#endif
#if WORDS_BIGENDIAN
	uint8_t __reserved3       : 3;
	uint8_t channel_protocol  : 5; /* Channel protocol per table 6-2 */
#else
	uint8_t channel_protocol  : 5; /* Channel protocol per table 6-2 */
	uint8_t __reserved3       : 3;
#endif
#if WORDS_BIGENDIAN
	uint8_t session_support   : 2; /* Description of session support */
	uint8_t active_sessions   : 6; /* Count of active sessions */
#else
	uint8_t active_sessions   : 6; /* Count of active sessions */
	uint8_t session_support   : 2; /* Description of session support */
#endif
	uint8_t vendor_id[3]; /* For OEM that specified the protocol */
	uint8_t aux_info[2];  /* Not used*/
} ATTRIBUTE_PACKING;
#ifdef HAVE_PRAGMA_PACK
#pragma pack(0)
#endif



/*
 * The Get Channel Access response structure
 * From table 22-28 of the IPMI v2.0 spec
 */
#ifdef HAVE_PRAGMA_PACK
#pragma pack(1)
#endif
struct get_channel_access_rsp {
#if WORDS_BIGENDIAN
	uint8_t __reserved1        : 2;
	uint8_t alerting           : 1;
	uint8_t per_message_auth   : 1;
	uint8_t user_level_auth    : 1;
	uint8_t access_mode        : 3;
#else
	uint8_t access_mode        : 3;
	uint8_t user_level_auth    : 1;
	uint8_t per_message_auth   : 1;
	uint8_t alerting           : 1;
	uint8_t __reserved1        : 2;
#endif
#if WORDS_BIGENDIAN
	uint8_t __reserved2        : 4;
	uint8_t channel_priv_limit : 4; /* Channel privilege level limit */
#else
	uint8_t channel_priv_limit : 4; /* Channel privilege level limit */
	uint8_t __reserved2        : 4;
#endif
} ATTRIBUTE_PACKING;
#ifdef HAVE_PRAGMA_PACK
#pragma pack(0)
#endif

#ifdef HAVE_PRAGMA_PACK
#pragma pack(1)
#endif
struct get_user_access_rsp {
#if WORDS_BIGENDIAN
	uint8_t __reserved1        : 2;
	uint8_t max_user_ids       : 6;
	uint8_t __reserved2        : 2;
	uint8_t enabled_user_ids   : 6;
	uint8_t __reserved3        : 2;
	uint8_t fixed_user_ids     : 6;
	uint8_t __reserved4        : 1;
	uint8_t callin_callback    : 1;
	uint8_t link_auth          : 1;
	uint8_t ipmi_messaging     : 1;
	uint8_t privilege_limit    : 4;
#else
	uint8_t max_user_ids       : 6;
	uint8_t __reserved1        : 2;
	uint8_t enabled_user_ids   : 6;
	uint8_t __reserved2        : 2;
	uint8_t fixed_user_ids     : 6;
	uint8_t __reserved3        : 2;
	uint8_t privilege_limit    : 4;
	uint8_t ipmi_messaging     : 1;
	uint8_t link_auth          : 1;
	uint8_t callin_callback    : 1;
	uint8_t __reserved4        : 1;
#endif
} ATTRIBUTE_PACKING;
#ifdef HAVE_PRAGMA_PACK
#pragma pack(0)
#endif

#ifdef HAVE_PRAGMA_PACK
#pragma pack(1)
#endif
struct set_user_access_data {
#if WORDS_BIGENDIAN
	uint8_t change_bits        : 1;
	uint8_t callin_callback    : 1;
	uint8_t link_auth          : 1;
	uint8_t ipmi_messaging     : 1;
	uint8_t channel            : 4;
	uint8_t __reserved1        : 2;
	uint8_t user_id            : 6;
	uint8_t __reserved2        : 4;
	uint8_t privilege_limit    : 4;
	uint8_t __reserved3        : 4;
	uint8_t session_limit      : 4;
#else
	uint8_t channel            : 4;
	uint8_t ipmi_messaging     : 1;
	uint8_t link_auth          : 1;
	uint8_t callin_callback    : 1;
	uint8_t change_bits        : 1;
	uint8_t user_id            : 6;
	uint8_t __reserved1        : 2;
	uint8_t privilege_limit    : 4;
	uint8_t __reserved2        : 4;
	uint8_t session_limit      : 4;
	uint8_t __reserved3        : 4;
#endif
} ATTRIBUTE_PACKING;
#ifdef HAVE_PRAGMA_PACK
#pragma pack(0)
#endif

uint8_t ipmi_get_channel_medium(struct ipmi_intf * intf, uint8_t channel);
uint8_t ipmi_current_channel_medium(struct ipmi_intf * intf);
int ipmi_channel_main(struct ipmi_intf * intf, int argc, char ** argv);
int ipmi_get_channel_auth_cap(struct ipmi_intf * intf, uint8_t channel, uint8_t priv);
int ipmi_get_channel_info(struct ipmi_intf * intf, uint8_t channel);

#endif /*IPMI_CHANNEL_H*/