summaryrefslogtreecommitdiff
path: root/usr/src/lib/libdladm/common/libdlwlan.h
blob: 2176910d354b54ad0f63fdf506e94be5238e1588 (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
/*
 * 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 2009 Sun Microsystems, Inc.  All rights reserved.
 * Use is subject to license terms.
 */

#ifndef _LIBDLWLAN_H
#define	_LIBDLWLAN_H

/*
 * This file includes structures, macros and routines used by WLAN link
 * administration.
 */

#include <sys/types.h>
#include <libdladm.h>

/*
 * General libdlwlan definitions and functions.
 *
 * These interfaces are ON consolidation-private.
 * For documentation, refer to PSARC/2006/623.
 */

#ifdef	__cplusplus
extern "C" {
#endif

#define	DLADM_WLAN_MAX_ESSID_LEN    (32 + 1)	/* per 802.11 spec */
						/* max essid length is 32 */
						/* one more for '\0' */
#define	DLADM_WLAN_BSSID_LEN		6	/* per 802.11 spec */
#define	DLADM_WLAN_WPA_KEY_LEN		32	/* per 802.11i spec */
#define	DLADM_WLAN_MAX_WPA_IE_LEN	40	/* per 802.11i spec */

#define	DLADM_WLAN_CONNECT_TIMEOUT_DEFAULT	10
#define	DLADM_WLAN_CONNECT_CREATEIBSS		0x00000001
#define	DLADM_WLAN_CONNECT_NOSCAN		0x00000002

typedef struct dladm_wlan_essid {
	char	we_bytes[DLADM_WLAN_MAX_ESSID_LEN];
} dladm_wlan_essid_t;

typedef struct dladm_wlan_bssid {
	uint8_t	wb_bytes[DLADM_WLAN_BSSID_LEN];
} dladm_wlan_bssid_t;

typedef struct dladm_wlan_ess {
	dladm_wlan_bssid_t	we_bssid;
	dladm_wlan_essid_t	we_ssid;
	uint_t			we_ssid_len;
	uint8_t			we_wpa_ie[DLADM_WLAN_MAX_WPA_IE_LEN];
	uint_t			we_wpa_ie_len;
	int			we_freq;
} dladm_wlan_ess_t;

typedef enum {
	DLADM_WLAN_CIPHER_WEP		= 0,
	DLADM_WLAN_CIPHER_TKIP,
	DLADM_WLAN_CIPHER_AES_OCB,
	DLADM_WLAN_CIPHER_AES_CCM,
	DLADM_WLAN_CIPHER_CKIP,
	DLADM_WLAN_CIPHER_NONE
} dladm_wlan_cipher_t;

typedef enum {
	DLADM_WLAN_MLME_ASSOC		= 1,	/* associate station */
	DLADM_WLAN_MLME_DISASSOC	= 2	/* disassociate station */
} dladm_wlan_mlme_op_t;

typedef enum {
	DLADM_WLAN_REASON_UNSPECIFIED	= 1,
	DLADM_WLAN_REASON_DISASSOC_LEAVING	= 5
} dladm_wlan_reason_t;

typedef enum {
	DLADM_WLAN_SECMODE_NONE = 1,
	DLADM_WLAN_SECMODE_WEP,
	DLADM_WLAN_SECMODE_WPA
} dladm_wlan_secmode_t;

typedef enum {
	DLADM_WLAN_STRENGTH_VERY_WEAK = 1,
	DLADM_WLAN_STRENGTH_WEAK,
	DLADM_WLAN_STRENGTH_GOOD,
	DLADM_WLAN_STRENGTH_VERY_GOOD,
	DLADM_WLAN_STRENGTH_EXCELLENT
} dladm_wlan_strength_t;

typedef enum {
	DLADM_WLAN_MODE_NONE = 0,
	DLADM_WLAN_MODE_80211A,
	DLADM_WLAN_MODE_80211B,
	DLADM_WLAN_MODE_80211G,
	DLADM_WLAN_MODE_80211GN,
	DLADM_WLAN_MODE_80211AN
} dladm_wlan_mode_t;

typedef enum {
	DLADM_WLAN_AUTH_OPEN = 1,
	DLADM_WLAN_AUTH_SHARED
} dladm_wlan_auth_t;

typedef enum {
	DLADM_WLAN_BSSTYPE_BSS = 1,
	DLADM_WLAN_BSSTYPE_IBSS,
	DLADM_WLAN_BSSTYPE_ANY
} dladm_wlan_bsstype_t;

typedef enum {
	DLADM_WLAN_LINK_DISCONNECTED = 1,
	DLADM_WLAN_LINK_CONNECTED
} dladm_wlan_linkstatus_t;

typedef uint32_t dladm_wlan_speed_t;
typedef	uint32_t dladm_wlan_channel_t;

enum {
	DLADM_WLAN_ATTR_ESSID	= 0x00000001,
	DLADM_WLAN_ATTR_BSSID	= 0x00000002,
	DLADM_WLAN_ATTR_SECMODE	= 0x00000004,
	DLADM_WLAN_ATTR_STRENGTH = 0x00000008,
	DLADM_WLAN_ATTR_MODE	= 0x00000010,
	DLADM_WLAN_ATTR_SPEED	= 0x00000020,
	DLADM_WLAN_ATTR_AUTH	= 0x00000040,
	DLADM_WLAN_ATTR_BSSTYPE	= 0x00000080,
	DLADM_WLAN_ATTR_CHANNEL	= 0x00000100
};
typedef struct dladm_wlan_attr {
	uint_t			wa_valid;
	dladm_wlan_essid_t	wa_essid;
	dladm_wlan_bssid_t	wa_bssid;
	dladm_wlan_secmode_t	wa_secmode;
	dladm_wlan_strength_t	wa_strength;
	dladm_wlan_mode_t	wa_mode;
	dladm_wlan_speed_t	wa_speed;
	dladm_wlan_auth_t	wa_auth;
	dladm_wlan_bsstype_t	wa_bsstype;
	dladm_wlan_channel_t	wa_channel;
} dladm_wlan_attr_t;

enum {
	DLADM_WLAN_LINKATTR_STATUS	= 0x00000001,
	DLADM_WLAN_LINKATTR_WLAN	= 0x00000002
};
typedef struct dladm_wlan_linkattr {
	uint_t			la_valid;
	dladm_wlan_linkstatus_t	la_status;
	dladm_wlan_attr_t	la_wlan_attr;
} dladm_wlan_linkattr_t;

#define	DLADM_WLAN_WEPKEY64_LEN		5 	/* per WEP spec */
#define	DLADM_WLAN_WEPKEY128_LEN	13 	/* per WEP spec */
#define	DLADM_WLAN_MAX_KEY_LEN		64	/* per WEP/WPA spec */
#define	DLADM_WLAN_MAX_WEPKEYS		4 	/* MAX_NWEPKEYS */
#define	DLADM_WLAN_MAX_KEYNAME_LEN	64
typedef struct dladm_wlan_key {
	uint_t		wk_idx;
	uint_t		wk_len;
	uint8_t		wk_val[DLADM_WLAN_MAX_KEY_LEN];
	char		wk_name[DLADM_WLAN_MAX_KEYNAME_LEN];
	uint_t		wk_class;
} dladm_wlan_key_t;

extern dladm_status_t	dladm_wlan_scan(dladm_handle_t, datalink_id_t, void *,
			    boolean_t (*)(void *, dladm_wlan_attr_t *));
extern dladm_status_t	dladm_wlan_connect(dladm_handle_t, datalink_id_t,
			    dladm_wlan_attr_t *, int, void *, uint_t, uint_t);
extern dladm_status_t	dladm_wlan_disconnect(dladm_handle_t, datalink_id_t);
extern dladm_status_t	dladm_wlan_get_linkattr(dladm_handle_t, datalink_id_t,
			    dladm_wlan_linkattr_t *);
/* WPA support routines */
extern dladm_status_t	dladm_wlan_wpa_get_sr(dladm_handle_t, datalink_id_t,
			    dladm_wlan_ess_t *, uint_t, uint_t *);
extern dladm_status_t	dladm_wlan_wpa_set_ie(dladm_handle_t, datalink_id_t,
			    uint8_t *, uint_t);
extern dladm_status_t	dladm_wlan_wpa_set_wpa(dladm_handle_t, datalink_id_t,
			    boolean_t);
extern dladm_status_t	dladm_wlan_wpa_del_key(dladm_handle_t, datalink_id_t,
			    uint_t, const dladm_wlan_bssid_t *);
extern dladm_status_t	dladm_wlan_wpa_set_key(dladm_handle_t, datalink_id_t,
			    dladm_wlan_cipher_t, const dladm_wlan_bssid_t *,
			    boolean_t, uint64_t, uint_t, uint8_t *, uint_t);
extern dladm_status_t	dladm_wlan_wpa_set_mlme(dladm_handle_t, datalink_id_t,
			    dladm_wlan_mlme_op_t,
			    dladm_wlan_reason_t, dladm_wlan_bssid_t *);

extern const char	*dladm_wlan_essid2str(dladm_wlan_essid_t *, char *);
extern const char	*dladm_wlan_bssid2str(dladm_wlan_bssid_t *, char *);
extern const char	*dladm_wlan_secmode2str(dladm_wlan_secmode_t *, char *);
extern const char	*dladm_wlan_strength2str(dladm_wlan_strength_t *,
			    char *);
extern const char	*dladm_wlan_mode2str(dladm_wlan_mode_t *, char *);
extern const char	*dladm_wlan_speed2str(dladm_wlan_speed_t *, char *);
extern const char	*dladm_wlan_auth2str(dladm_wlan_auth_t *, char *);
extern const char	*dladm_wlan_bsstype2str(dladm_wlan_bsstype_t *, char *);
extern const char	*dladm_wlan_linkstatus2str(dladm_wlan_linkstatus_t *,
			    char *);

extern dladm_status_t	dladm_wlan_str2essid(const char *,
			    dladm_wlan_essid_t *);
extern dladm_status_t	dladm_wlan_str2bssid(const char *,
			    dladm_wlan_bssid_t *);
extern dladm_status_t	dladm_wlan_str2secmode(const char *,
			    dladm_wlan_secmode_t *);
extern dladm_status_t	dladm_wlan_str2strength(const char *,
			    dladm_wlan_strength_t *);
extern dladm_status_t	dladm_wlan_str2mode(const char *,
			    dladm_wlan_mode_t *);
extern dladm_status_t	dladm_wlan_str2speed(const char *,
			    dladm_wlan_speed_t *);
extern dladm_status_t	dladm_wlan_str2auth(const char *,
			    dladm_wlan_auth_t *);
extern dladm_status_t	dladm_wlan_str2bsstype(const char *,
			    dladm_wlan_bsstype_t *);
extern dladm_status_t	dladm_wlan_str2linkstatus(const char *,
			    dladm_wlan_linkstatus_t *);

#ifdef	__cplusplus
}
#endif

#endif	/* _LIBDLWLAN_H */