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
|
/*
* Copyright (c) 2008 Apple Computer, Inc. All rights reserved.
*
* @APPLE_OSREFERENCE_LICENSE_HEADER_START@
*
* This file contains Original Code and/or Modifications of Original Code
* as defined in and that are subject to the Apple Public Source License
* Version 2.0 (the 'License'). You may not use this file except in
* compliance with the License. The rights granted to you under the License
* may not be used to create, or enable the creation or redistribution of,
* unlawful or unlicensed copies of an Apple operating system, or to
* circumvent, violate, or enable the circumvention or violation of, any
* terms of an Apple operating system software license agreement.
*
* Please obtain a copy of the License at
* http://www.opensource.apple.com/apsl/ and read it before using this file.
*
* The Original Code and all software distributed under the License are
* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
* Please see the License for the specific language governing rights and
* limitations under the License.
*
* @APPLE_OSREFERENCE_LICENSE_HEADER_END@
*/
/* Copyright (c) 1997, 1998 Apple Computer, Inc. All Rights Reserved */
/*
* @(#)ndrv.h 1.1 (MacOSX) 6/10/43
* Justin Walker - 970604
*/
#include <net/dlil.h>
#ifndef _NET_NDRV_H
#define _NET_NDRV_H
#include <sys/appleapiopts.h>
struct sockaddr_ndrv
{
unsigned char snd_len;
unsigned char snd_family;
unsigned char snd_name[IFNAMSIZ]; /* from if.h */
};
/*
* Support for user-mode protocol handlers
*/
#define NDRV_DEMUXTYPE_ETHERTYPE 4
#define NDRV_DEMUXTYPE_SAP 5
#define NDRV_DEMUXTYPE_SNAP 6
#define NDRVPROTO_NDRV 0
/*
* Struct: ndrv_demux_desc
* Purpose:
* To uniquely identify a packet based on its low-level framing information.
*
* Fields:
* type : type of protocol in data field, must be understood by
* the interface family of the interface the socket is bound to
* length : length of protocol data in "data" field
* data : union of framing-specific data, in network byte order
* ether_type : ethernet type in network byte order, assuming
* ethernet type II framing
* sap : first 3 bytes of sap header, network byte order
* snap : first 5 bytes of snap header, network byte order
* other : up to 28 bytes of protocol data for different protocol type
*
* Examples:
* 1) 802.1x uses ether_type 0x888e, so the descriptor would be set as:
* struct ndrv_demux_desc desc;
* desc.type = NDRV_DEMUXTYPE_ETHERTYPE
* desc.length = sizeof(unsigned short);
* desc.ether_type = htons(0x888e);
* 2) AppleTalk uses SNAP 0x080007809B
* struct ndrv_demux_desc desc;
* desc.type = NDRV_DEMUXTYPE_SNAP;
* desc.length = 5;
* desc.data.snap[0] = 08;
* desc.data.snap[1] = 00;
* desc.data.snap[2] = 07;
* desc.data.snap[3] = 80;
* desc.data.snap[4] = 9B;
*/
struct ndrv_demux_desc
{
u_int16_t type;
u_int16_t length;
union
{
u_int16_t ether_type;
u_int8_t sap[3];
u_int8_t snap[5];
u_int8_t other[28];
} data;
};
#define NDRV_PROTOCOL_DESC_VERS 1
/*
* Struct: ndrv_protocol_desc
* Purpose:
* Used to "bind" an NDRV socket so that packets that match
* given protocol demux descriptions can be received:
* Field:
* version : must be NDRV_PROTOCOL_DESC_VERS
* protocol_family : unique identifier for this protocol
* demux_count : number of demux_list descriptors in demux_list; maximum of 10
* demux_list : pointer to array of demux descriptors
*/
struct ndrv_protocol_desc
{
u_int32_t version;
u_int32_t protocol_family;
u_int32_t demux_count;
struct ndrv_demux_desc *demux_list;
};
#define SOL_NDRVPROTO NDRVPROTO_NDRV /* Use this socket level */
#define NDRV_DELDMXSPEC 0x02 /* Delete the registered protocol */
#define NDRV_SETDMXSPEC 0x04 /* Set the protocol spec */
#define NDRV_ADDMULTICAST 0x05 /* Add a physical multicast address */
#define NDRV_DELMULTICAST 0x06 /* Delete a phyiscal multicast */
/*
* SOL_NDRVPROTO - use this for the socket level when calling setsocketopt
* NDRV_DELDMXSPEC - removes the registered protocol and all related demuxes
* NDRV_SETDMXSPEC - set the protocol to receive, use struct ndrv_protocol_desc
* as the parameter.
* NDRV_ADDMULTICAST - Enable reception of a phyiscal multicast address, use
* a sockaddr of the appropriate type for the media in use.
* NDRV_DELMULTICAST - Disable reception of a phyiscal multicast address, use
* a sockaddr of the appropriate type for the media in use.
*
* When adding multicasts, the multicasts are ref counted. If the multicast is
* already registered in the kernel, the count will be bumped. When deleting
* the multicast, the count is decremented. If the count reaches zero the
* multicast is removed. If your process is killed, PF_NDRV will unregister
* the mulitcasts you've added. You can only delete multicasts you've added
* on the same socket.
*
* If the interface goes away while your socket is open, your protocol is
* immediately detached and sending/receiving is disabled on the socket.
* If you need a chance to do something, please file a bug and we can give
* you a second or two.
*/
/* Max number of descriptions allowed by default */
#define NDRV_DMUX_MAX_DESCR 1024
/*
* sysctl MIB tags at the kern.ipc.nrdv level
*/
#define NRDV_MULTICAST_ADDRS_PER_SOCK 1 /* to toggle NDRV_DMUX_MAX_DESCR value */
#endif /* _NET_NDRV_H */
|
