summaryrefslogtreecommitdiff
path: root/sys/dev/rndis.h
blob: 140793990e9c5bd8c9a38e05f23491e83f81e5d0 (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
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
/*	$OpenBSD: rndis.h,v 1.2 2016/09/20 10:34:41 mikeb Exp $ */

/*
 * Copyright (c) 2010 Jonathan Armani <armani@openbsd.org>
 * Copyright (c) 2010 Fabien Romano <fabien@openbsd.org>
 * Copyright (c) 2010 Michael Knudsen <mk@openbsd.org>
 * All rights reserved.
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

#ifndef _DEV_RNDIS_H_
#define _DEV_RNDIS_H_

/* Canonical major/minor version as of 22th Aug. 2016. */
#define RNDIS_VERSION_MAJOR		0x00000001
#define RNDIS_VERSION_MINOR		0x00000000

#define RNDIS_STATUS_SUCCESS 		0x00000000L
#define RNDIS_STATUS_PENDING 		0x00000103L
#define RNDIS_STATUS_MEDIA_CONNECT 	0x4001000BL
#define RNDIS_STATUS_MEDIA_DISCONNECT 	0x4001000CL
#define RNDIS_STATUS_BUFFER_OVERFLOW 	0x80000005L
#define RNDIS_STATUS_FAILURE 		0xC0000001L
#define RNDIS_STATUS_NOT_SUPPORTED 	0xC00000BBL
#define RNDIS_STATUS_RESOURCES 		0xC000009AL
#define RNDIS_STATUS_INVALID_DATA 	0xC0010015L
#define RNDIS_STATUS_OFFLOAD_CURRENT_CONFIG	0x40020006

#define OID_GEN_SUPPORTED_LIST		0x00010101
#define OID_GEN_HARDWARE_STATUS		0x00010102
#define OID_GEN_MEDIA_SUPPORTED		0x00010103
#define OID_GEN_MEDIA_IN_USE		0x00010104
#define OID_GEN_MAXIMUM_LOOKAHEAD	0x00010105
#define OID_GEN_MAXIMUM_FRAME_SIZE	0x00010106
#define OID_GEN_LINK_SPEED		0x00010107
#define OID_GEN_TRANSMIT_BUFFER_SPACE	0x00010108
#define OID_GEN_RECEIVE_BUFFER_SPACE	0x00010109
#define OID_GEN_TRANSMIT_BLOCK_SIZE	0x0001010A
#define OID_GEN_RECEIVE_BLOCK_SIZE	0x0001010B
#define OID_GEN_VENDOR_ID		0x0001010C
#define OID_GEN_VENDOR_DESCRIPTION	0x0001010D
#define OID_GEN_CURRENT_PACKET_FILTER	0x0001010E
#define OID_GEN_CURRENT_LOOKAHEAD	0x0001010F
#define OID_GEN_DRIVER_VERSION		0x00010110
#define OID_GEN_MAXIMUM_TOTAL_SIZE	0x00010111
#define OID_GEN_PROTOCOL_OPTIONS	0x00010112
#define OID_GEN_MAC_OPTIONS		0x00010113
#define OID_GEN_MEDIA_CONNECT_STATUS	0x00010114
#define OID_GEN_MAXIMUM_SEND_PACKETS	0x00010115
#define OID_GEN_VENDOR_DRIVER_VERSION	0x00010116
#define OID_GEN_SUPPORTED_GUIDS		0x00010117
#define OID_GEN_NETWORK_LAYER_ADDRESSES	0x00010118
#define OID_GEN_TRANSPORT_HEADER_OFFSET	0x00010119
#define OID_GEN_RECEIVE_SCALE_CAPABILITIES	0x00010203
#define OID_GEN_RECEIVE_SCALE_PARAMETERS	0x00010204
#define OID_GEN_MACHINE_NAME		0x0001021A
#define OID_GEN_RNDIS_CONFIG_PARAMETER	0x0001021B
#define OID_GEN_VLAN_ID			0x0001021C

#define OID_802_3_PERMANENT_ADDRESS	0x01010101
#define OID_802_3_CURRENT_ADDRESS	0x01010102
#define OID_802_3_MULTICAST_LIST	0x01010103
#define OID_802_3_MAXIMUM_LIST_SIZE	0x01010104
#define OID_802_3_MAC_OPTIONS		0x01010105
#define OID_802_3_RCV_ERROR_ALIGNMENT	0x01020101
#define OID_802_3_XMIT_ONE_COLLISION	0x01020102
#define OID_802_3_XMIT_MORE_COLLISIONS	0x01020103
#define OID_802_3_XMIT_DEFERRED		0x01020201
#define OID_802_3_XMIT_MAX_COLLISIONS	0x01020202
#define OID_802_3_RCV_OVERRUN		0x01020203
#define OID_802_3_XMIT_UNDERRUN		0x01020204
#define OID_802_3_XMIT_HEARTBEAT_FAILURE	0x01020205
#define OID_802_3_XMIT_TIMES_CRS_LOST	0x01020206
#define OID_802_3_XMIT_LATE_COLLISIONS	0x01020207

#define OID_TCP_OFFLOAD_PARAMETERS	0xFC01020C

#define RNDIS_MEDIUM_802_3		0x00000000

/* Device flags */
#define RNDIS_DF_CONNECTIONLESS		0x00000001
#define RNDIS_DF_CONNECTION_ORIENTED	0x00000002

/*
 * Common RNDIS message header.
 */
struct rndis_msghdr {
	uint32_t	rm_type;
	uint32_t	rm_len;
};

/*
 * RNDIS data message
 */
#define REMOTE_NDIS_PACKET_MSG		0x00000001


struct rndis_packet_msg {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_dataoffset;
	uint32_t	rm_datalen;
	uint32_t	rm_oobdataoffset;
	uint32_t	rm_oobdatalen;
	uint32_t	rm_oobdataelements;
	uint32_t	rm_pktinfooffset;
	uint32_t	rm_pktinfolen;
	uint32_t	rm_vchandle;
	uint32_t	rm_reserved;
};

/* Per-packet-info for RNDIS data message */
struct rndis_pktinfo {
	uint32_t	rm_size;
	uint32_t	rm_type;		/* NDIS_PKTINFO_TYPE_ */
	uint32_t	rm_pktinfooffset;
	uint8_t		rm_data[0];
};

#define NDIS_PKTINFO_TYPE_CSUM		0
#define NDIS_PKTINFO_TYPE_IPSEC		1
#define NDIS_PKTINFO_TYPE_LSO		2
#define NDIS_PKTINFO_TYPE_CLASSIFY	3
/* reserved 4 */
#define NDIS_PKTINFO_TYPE_SGLIST	5
#define NDIS_PKTINFO_TYPE_VLAN		6
#define NDIS_PKTINFO_TYPE_ORIG		7
#define NDIS_PKTINFO_TYPE_PKT_CANCELID	8
#define NDIS_PKTINFO_TYPE_ORIG_NBLIST	9
#define NDIS_PKTINFO_TYPE_CACHE_NBLIST	10
#define NDIS_PKTINFO_TYPE_PKT_PAD	11

/*
 * RNDIS control messages
 */
struct rndis_comp_hdr {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_rid;
	uint32_t	rm_status;
};

/* Initialize the device. */
#define REMOTE_NDIS_INITIALIZE_MSG	0x00000002
#define REMOTE_NDIS_INITIALIZE_CMPLT	0x80000002

struct rndis_init_req {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_rid;
	uint32_t	rm_ver_major;
	uint32_t	rm_ver_minor;
	uint32_t	rm_max_xfersz;
};

struct rndis_init_comp {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_rid;
	uint32_t	rm_status;
	uint32_t	rm_ver_major;
	uint32_t	rm_ver_minor;
	uint32_t	rm_devflags;
	uint32_t	rm_medium;
	uint32_t	rm_pktmaxcnt;
	uint32_t	rm_pktmaxsz;
	uint32_t	rm_align;
	uint32_t	rm_aflistoffset;
	uint32_t	rm_aflistsz;
};

/* Halt the device.  No response sent. */
#define REMOTE_NDIS_HALT_MSG		0x00000003

struct rndis_halt_req {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_rid;
};

/* Send a query object. */
#define REMOTE_NDIS_QUERY_MSG		0x00000004
#define REMOTE_NDIS_QUERY_CMPLT		0x80000004

struct rndis_query_req {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_rid;
	uint32_t	rm_oid;
	uint32_t	rm_infobuflen;
	uint32_t	rm_infobufoffset;
	uint32_t	rm_devicevchdl;
};

struct rndis_query_comp {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_rid;
	uint32_t	rm_status;
	uint32_t	rm_infobuflen;
	uint32_t	rm_infobufoffset;
};

/* Send a set object request. */
#define REMOTE_NDIS_SET_MSG		0x00000005
#define REMOTE_NDIS_SET_CMPLT		0x80000005

struct rndis_set_req {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_rid;
	uint32_t	rm_oid;
	uint32_t	rm_infobuflen;
	uint32_t	rm_infobufoffset;
	uint32_t	rm_devicevchdl;
};

struct rndis_set_comp {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_rid;
	uint32_t	rm_status;
};

/* Parameter used by OID_GEN_RNDIS_CONFIG_PARAMETER. */
#define REMOTE_NDIS_SET_PARAM_NUMERIC	0x00000000
#define REMOTE_NDIS_SET_PARAM_STRING	0x00000002

struct rndis_set_parameter {
	uint32_t	rm_nameoffset;
	uint32_t	rm_namelen;
	uint32_t	rm_type;
	uint32_t	rm_valueoffset;
	uint32_t	rm_valuelen;
};

/* Perform a soft reset on the device. */
#define REMOTE_NDIS_RESET_MSG		0x00000006
#define REMOTE_NDIS_RESET_CMPLT		0x80000006

struct rndis_reset_req {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_rid;
};

struct rndis_reset_comp {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_status;
	uint32_t	rm_adrreset;
};

/* 802.3 link-state or undefined message error.  Sent by device. */
#define REMOTE_NDIS_INDICATE_STATUS_MSG	0x00000007

struct rndis_status_msg {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_status;
	uint32_t	rm_stbuflen;
	uint32_t	rm_stbufoffset;
	/* rndis_diag_info */
};

/*
 * Immediately after rndis_status_msg.rm_stbufoffset, if a control
 * message is malformed, or a packet message contains inappropriate
 * content.
 */
struct rndis_diag_info {
	uint32_t	rm_diagstatus;
	uint32_t	rm_erroffset;
};

/* Keepalive messsage.  May be sent by device. */
#define REMOTE_NDIS_KEEPALIVE_MSG	0x00000008
#define REMOTE_NDIS_KEEPALIVE_CMPLT	0x80000008

struct rndis_keepalive_req {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_rid;
};

struct rndis_keepalive_comp {
	uint32_t	rm_type;
	uint32_t	rm_len;
	uint32_t	rm_rid;
	uint32_t	rm_status;
};

/* packet filter bits used by OID_GEN_CURRENT_PACKET_FILTER */
#define NDIS_PACKET_TYPE_DIRECTED		0x00000001
#define NDIS_PACKET_TYPE_MULTICAST		0x00000002
#define NDIS_PACKET_TYPE_ALL_MULTICAST		0x00000004
#define NDIS_PACKET_TYPE_BROADCAST		0x00000008
#define NDIS_PACKET_TYPE_SOURCE_ROUTING		0x00000010
#define NDIS_PACKET_TYPE_PROMISCUOUS		0x00000020
#define NDIS_PACKET_TYPE_SMT			0x00000040
#define NDIS_PACKET_TYPE_ALL_LOCAL		0x00000080
#define NDIS_PACKET_TYPE_GROUP			0x00001000
#define NDIS_PACKET_TYPE_ALL_FUNCTIONAL		0x00002000
#define NDIS_PACKET_TYPE_FUNCTIONAL		0x00004000
#define NDIS_PACKET_TYPE_MAC_FRAME		0x00008000

/* RNDIS offsets */
#define RNDIS_HEADER_OFFSET	(sizeof(struct rndis_msghdr))
#define RNDIS_DATA_OFFSET	(sizeof(struct rndis_packet_msg) - \
				 RNDIS_HEADER_OFFSET)

#endif	/* _DEV_RNDIS_H_ */