[apple/xnu.git] / bsd / netat / appletalk.h

/*
 * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
 *
 * @APPLE_LICENSE_HEADER_START@
 * 
 * The contents of this file constitute Original Code as defined in and
 * are subject to the Apple Public Source License Version 1.1 (the
 * "License").  You may not use this file except in compliance with the
 * License.  Please obtain a copy of the License at
 * http://www.apple.com/publicsource and read it before using this file.
 * 
 * This 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 OR NON-INFRINGEMENT.  Please see the
 * License for the specific language governing rights and limitations
 * under the License.
 * 
 * @APPLE_LICENSE_HEADER_END@
 */
/*
 *
 * ORIGINS: 82
 *
 * (C) COPYRIGHT Apple Computer, Inc. 1992-1996
 * All Rights Reserved
 *
 */                                                                   

/* Miscellaneous definitions for AppleTalk used by all protocol 
 * modules.
 */

#ifndef _NETAT_APPLETALK_H_
#define _NETAT_APPLETALK_H_
#include <sys/appleapiopts.h>

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

/* 
   Non-aligned types are used in packet headers. 
*/

/* New fundemental types: non-aligned variations of u_short and u_long */
typedef u_char ua_short[2];		/* Unaligned short */
typedef u_char ua_long[4];		/* Unaligned long */

/* Two at_net typedefs; the first is aligned the other isn't */
typedef u_short at_net_al;		/* Aligned AppleTalk network number */
typedef ua_short at_net_unal;		/* Unaligned AppleTalk network number */

/* Miscellaneous types */
typedef u_char	at_node;		/* AppleTalk node number */
typedef u_char  at_socket;		/* AppleTalk socket number */

typedef at_net_unal at_net;	/* Default: Unaligned AppleTalk network number */
struct atalk_addr {
	u_char	atalk_unused;
	at_net	atalk_net;
	at_node	atalk_node;
};

/* Macros to manipulate unaligned fields */
#define	UAS_ASSIGN(x,s)	*(unsigned short *) &(x[0]) = (unsigned short) (s)
#define	UAS_UAS(x,y)	*(unsigned short *) &(x[0]) = *(unsigned short *) &(y[0])
#define	UAS_VALUE(x)	(*(unsigned short *) &(x[0]))
#define	UAL_ASSIGN(x,l)	*(unsigned long *) &(x[0]) = (unsigned long) (l)
#define	UAL_UAL(x,y)	*(unsigned long *) &(x[0]) = *(unsigned long *) &(y[0])
#define	UAL_VALUE(x)	(*(unsigned long *) &(x[0]))

/* Macros to manipulate at_net variables */
#define	NET_ASSIGN(x,s)	*(unsigned short *)&(x[0]) = (unsigned short)(s)
#define	NET_NET(x, y)	*(unsigned short *)&(x[0]) = *(unsigned short *)&(y[0])
#define	NET_VALUE(x)	(*(unsigned short *) &(x[0]))
#define ATALK_ASSIGN(a, net, node, unused ) \
  a.atalk_unused = unused; a.atalk_node = node; NET_ASSIGN(a.atalk_net, net)

#define NET_EQUAL(a, b)	(NET_VALUE(a) == NET_VALUE(b))
#define NET_NOTEQ(a, b)	(NET_VALUE(a) != NET_VALUE(b))
#define NET_EQUAL0(a)	(NET_VALUE(a) == 0)
#define NET_NOTEQ0(a)	(NET_VALUE(a) != 0)


/* 
   AppleTalk Internet Address 
*/

typedef struct at_inet {
	u_short	net;			/* Network Address */
	u_char	node;			/* Node number */
	u_char	socket;			/* Socket number */
} at_inet_t;

/*
   DDP Address for OT
*/

typedef struct ddp_addr {
	at_inet_t	inet;
	u_short		ddptype;
} ddp_addr_t;

/*
  AppleTalk address
*/

struct at_addr {
	u_short     s_net;		/* 16-bit network address */
	u_char      s_node;		/* 8-bit node # (1-0xfd) */
};

/*
  Appletalk sockaddr definition
*/
struct sockaddr_at {
	u_char  	sat_len;        /* total length */
	u_char  	sat_family;     /* address family (AF_APPLETALK) */
	u_char  	sat_port;	/* 8-bit "socket number" */
	struct at_addr 	sat_addr;	/* 16-bit "net" and 8-bit "node */
	char		sat_zero[8];	/* used for netrange in netatalk */
};

#define ATADDR_ANYNET	(u_short)0x0000
#define ATADDR_ANYNODE	(u_char)0x00
#define ATADDR_ANYPORT	(u_char)0x00

#define ATADDR_BCASTNODE (u_char)0xff	/* There is no BCAST for NET */

/* make sure the net, node and socket numbers are in legal range :
 *
 * Net#		0		Local Net
 *		1 - 0xfffe	Legal net nos
 *		0xffff		Reserved by Apple for future use.
 * Node#	0		Illegal
 *		1 - 0x7f	Legal (user node id's)
 *		0x80 - 0xfe	Legal (server node id's; 0xfe illegal in
 *				Phase II nodes)
 *		0xff		Broadcast
 * Socket#	0		Illegal
 *		1 - 0xfe	Legal
 *		0xff		Illegal
 */
#define valid_at_addr(addr) \
	((!(addr) || (addr)->net == 0xffff || (addr)->node == 0 || \
	  (addr)->socket == 0 || (addr)->socket == 0xff)? 0: 1)

/*** * ETHERTYPE_ definitions are in netinet/if_ether.h *** */
#define ETHERTYPE_AT    0x809B          /* AppleTalk protocol */
#define ETHERTYPE_AARP  0x80F3          /* AppleTalk ARP */

/* 
   DDP protocol types 
*/

#define DDP_RTMP          0x01
#define DDP_NBP           0x02
#define DDP_ATP           0x03
#define DDP_ECHO          0x04
#define DDP_RTMP_REQ      0x05
#define DDP_ZIP           0x06
#define DDP_ADSP          0x07

/* 
   Protocols for the socket API 
*/

#define ATPROTO_NONE  	0		/* no corresponding DDP type exists */

#define ATPROTO_ATP	DDP_ATP		/* must match DDP type */
#define ATPROTO_ADSP    DDP_ADSP	/* must match DDP type */

#define ATPROTO_DDP	249		/* *** to be eliminated eventually *** */
#define ATPROTO_LAP   	250 		/* *** to be eliminated eventually *** */

#define ATPROTO_AURP  	251		/* no corresponding DDP type exists */
#define ATPROTO_ASP	252		/* no corresponding DDP type exists */
#define ATPROTO_AFP	253		/* no corresponding DDP type exists */

#define ATPROTO_RAW	255		/* no corresponding DDP type exists */

/*
  Options for use with [gs]etsockopt at the DDP level.
  First word of comment is data type; bool is stored in int.
*/
#define DDP_CHKSUM_ON	1	/* int; default = FALSE;
				   DDP checksums should be used */
#define DDP_HDRINCL	2	/* int; default = FALSE;
				   header is included with data */
#define DDP_GETSOCKNAME	3	/* used to get ddp_addr_t */
#define DDP_SLFSND_ON	4	/* int; default = FALSE;
				   packets sent to the cable-multicast address
				   on this socket will be looped back */
#define DDP_STRIPHDR	5	/* int; default = FALSE;
				   drop DDP header on receive (raw) */

/* 
   AppleTalk protocol retry and timeout 
*/

typedef struct at_retry {
    short	interval;		/* Retry interval in seconds */
    short	retries;		/* Maximum number of retries */
    u_char      backoff;                /* Retry backoff, must be 1 through 4 */
} at_retry_t;

/* 
   Basic NBP Definitions needed for AppleTalk framework
*/

#define MAX_ZONES 50

#define NBP_NVE_STR_SIZE	32	/* Maximum NBP tuple string size */
typedef struct at_nvestr {
	u_char		len;
	u_char		str[NBP_NVE_STR_SIZE];
} at_nvestr_t;

/* Entity Name */
typedef struct at_entity {
	at_nvestr_t	object;
	at_nvestr_t	type;
	at_nvestr_t	zone;
} at_entity_t;

#define NBP_TUPLE_SIZE	((3*NBP_NVE_STR_SIZE)+3) 
			/* 3 for field lengths + 3*32 for three names */
typedef struct at_nbptuple {
	at_inet_t	enu_addr;
	u_char		enu_enum;
	at_entity_t 	enu_entity;
} at_nbptuple_t;

/* 
   Basic ATP Definitions needed for LibcAT 
*/

#define ATP_TRESP_MAX       8	/* Maximum number of Tresp pkts */

/* Response buffer structure for atp_sendreq() and atp_sendrsp() */
typedef	struct	at_resp {
	u_char	bitmap;				/* Bitmap of responses */
	u_char	filler[3];			/* Force 68K to RISC alignment */
	struct	iovec resp[ATP_TRESP_MAX];	/* Buffer for response data */
	long	userdata[ATP_TRESP_MAX];	/* Buffer for response user data */
} at_resp_t;

/* 
   Needed for ASP and ADSP 
*/

typedef struct {
	int  maxlen; /* max buffer length */
	int  len;    /* length of data */
	char *buf;   /* pointer to buffer */
} strbuf_t;

#define	IFID_HOME	1 		/* home port in ifID_table */

#define	ATALK_VALUE(a)		((*(u_long *) &(a))&0x00ffffff)
#define	ATALK_EQUAL(a, b)	(ATALK_VALUE(a) == ATALK_VALUE(b))

#define VERSION_LENGTH		80	/* length of version string */

/* struture containing general information regarding the state of
 * the Appletalk networking 
 */
typedef struct at_state {
	unsigned int	flags;		/* various init flags */
} at_state_t;

/*  at_state_t 'flags' defines */
#define AT_ST_STARTED		0x0001	/* set if protocol is fully enabled */
#define AT_ST_STARTING		0x0002	/* set if interfaces are configured */
#define AT_ST_MULTIHOME		0x0080	/* set if multihome mode */
#define AT_ST_ROUTER		0x0100	/* set if we are a router */
#define AT_ST_IF_CHANGED	0x0200	/* set when state of any I/F 
					   changes (for SNMP) */
#define AT_ST_RT_CHANGED	0x0400  /* route table changed (for SNMP)*/
#define AT_ST_ZT_CHANGED 	0x0800  /* zone table changed (for SNMP) */
#define AT_ST_NBP_CHANGED	0x1000  /* if nbp table changed (for SNMP)*/

#ifdef KERNEL
#ifdef __APPLE_API_PRIVATE
extern at_state_t at_state;		/* global state of AT network */

#define ROUTING_MODE	(at_state.flags & AT_ST_ROUTER)
#define MULTIHOME_MODE	(at_state.flags & AT_ST_MULTIHOME)
#define MULTIPORT_MODE (ROUTING_MODE || MULTIHOME_MODE)
#endif /* __APPLE_API_PRIVATE */
#endif /* KERNEL */

/* defines originally from h/at_elap.h */
#define AT_ADDR			0
#define ET_ADDR			1
#define AT_ADDR_NO_LOOP		2	/* disables packets from looping back */

#endif /* _NETAT_APPLETALK_H_ */
Commit	Line	Data
1c79356b A	1	/*
	2	* Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
	3	*
	4	* @APPLE_LICENSE_HEADER_START@
	5	*
	6	* The contents of this file constitute Original Code as defined in and
	7	* are subject to the Apple Public Source License Version 1.1 (the
	8	* "License"). You may not use this file except in compliance with the
	9	* License. Please obtain a copy of the License at
	10	* http://www.apple.com/publicsource and read it before using this file.
	11	*
	12	* This Original Code and all software distributed under the License are
	13	* distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
	14	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
	15	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
	16	* FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the
	17	* License for the specific language governing rights and limitations
	18	* under the License.
	19	*
	20	* @APPLE_LICENSE_HEADER_END@
	21	*/
	22	/*
	23	*
	24	* ORIGINS: 82
	25	*
	26	* (C) COPYRIGHT Apple Computer, Inc. 1992-1996
	27	* All Rights Reserved
	28	*
	29	*/
	30
	31	/* Miscellaneous definitions for AppleTalk used by all protocol
	32	* modules.
	33	*/
	34
	35	#ifndef _NETAT_APPLETALK_H_
	36	#define _NETAT_APPLETALK_H_
9bccf70c	37	#include <sys/appleapiopts.h>
1c79356b A	38
	39	#include <sys/types.h>
	40	#include <sys/uio.h>
	41
	42	/*
	43	Non-aligned types are used in packet headers.
	44	*/
	45
	46	/* New fundemental types: non-aligned variations of u_short and u_long */
	47	typedef u_char ua_short[2]; /* Unaligned short */
	48	typedef u_char ua_long[4]; /* Unaligned long */
	49
	50	/* Two at_net typedefs; the first is aligned the other isn't */
	51	typedef u_short at_net_al; /* Aligned AppleTalk network number */
	52	typedef ua_short at_net_unal; /* Unaligned AppleTalk network number */
	53
	54	/* Miscellaneous types */
	55	typedef u_char at_node; /* AppleTalk node number */
	56	typedef u_char at_socket; /* AppleTalk socket number */
	57
	58	typedef at_net_unal at_net; /* Default: Unaligned AppleTalk network number */
	59	struct atalk_addr {
	60	u_char atalk_unused;
	61	at_net atalk_net;
	62	at_node atalk_node;
	63	};
	64
	65	/* Macros to manipulate unaligned fields */
	66	#define UAS_ASSIGN(x,s) (unsigned short ) &(x[0]) = (unsigned short) (s)
	67	#define UAS_UAS(x,y) (unsigned short ) &(x[0]) = (unsigned short ) &(y[0])
	68	#define UAS_VALUE(x) ((unsigned short ) &(x[0]))
	69	#define UAL_ASSIGN(x,l) (unsigned long ) &(x[0]) = (unsigned long) (l)
	70	#define UAL_UAL(x,y) (unsigned long ) &(x[0]) = (unsigned long ) &(y[0])
	71	#define UAL_VALUE(x) ((unsigned long ) &(x[0]))
	72
	73	/* Macros to manipulate at_net variables */
	74	#define NET_ASSIGN(x,s) (unsigned short )&(x[0]) = (unsigned short)(s)
	75	#define NET_NET(x, y) (unsigned short )&(x[0]) = (unsigned short )&(y[0])
	76	#define NET_VALUE(x) ((unsigned short ) &(x[0]))
	77	#define ATALK_ASSIGN(a, net, node, unused ) \
	78	a.atalk_unused = unused; a.atalk_node = node; NET_ASSIGN(a.atalk_net, net)
	79
	80	#define NET_EQUAL(a, b) (NET_VALUE(a) == NET_VALUE(b))
	81	#define NET_NOTEQ(a, b) (NET_VALUE(a) != NET_VALUE(b))
	82	#define NET_EQUAL0(a) (NET_VALUE(a) == 0)
	83	#define NET_NOTEQ0(a) (NET_VALUE(a) != 0)
	84
	85
	86	/*
	87	AppleTalk Internet Address
	88	*/
	89
	90	typedef struct at_inet {
	91	u_short net; /* Network Address */
	92	u_char node; /* Node number */
	93	u_char socket; /* Socket number */
	94	} at_inet_t;
	95
	96	/*
	97	DDP Address for OT
	98	*/
	99
	100	typedef struct ddp_addr {
	101	at_inet_t inet;
102	u_short ddptype;
103	} ddp_addr_t;
104
105	/*
106	AppleTalk address
107	*/
108
109	struct at_addr {
110	u_short s_net; /* 16-bit network address */
111	u_char s_node; /* 8-bit node # (1-0xfd) */
112	};
113
114	/*
115	Appletalk sockaddr definition
116	*/
117	struct sockaddr_at {
118	u_char sat_len; /* total length */
119	u_char sat_family; /* address family (AF_APPLETALK) */
120	u_char sat_port; /* 8-bit "socket number" */
121	struct at_addr sat_addr; /* 16-bit "net" and 8-bit "node */
122	char sat_zero[8]; /* used for netrange in netatalk */
123	};
124
125	#define ATADDR_ANYNET (u_short)0x0000
126	#define ATADDR_ANYNODE (u_char)0x00
127	#define ATADDR_ANYPORT (u_char)0x00
128
129	#define ATADDR_BCASTNODE (u_char)0xff /* There is no BCAST for NET */
130
131	/* make sure the net, node and socket numbers are in legal range :
132	*
133	* Net# 0 Local Net
134	* 1 - 0xfffe Legal net nos
135	* 0xffff Reserved by Apple for future use.
136	* Node# 0 Illegal
137	* 1 - 0x7f Legal (user node id's)
138	* 0x80 - 0xfe Legal (server node id's; 0xfe illegal in
139	* Phase II nodes)
140	* 0xff Broadcast
141	* Socket# 0 Illegal
142	* 1 - 0xfe Legal
143	* 0xff Illegal
144	*/
145	#define valid_at_addr(addr) \
146	((!(addr) \|\| (addr)->net == 0xffff \|\| (addr)->node == 0 \|\| \
147	(addr)->socket == 0 \|\| (addr)->socket == 0xff)? 0: 1)
148
149	/*** * ETHERTYPE_ definitions are in netinet/if_ether.h *** */
150	#define ETHERTYPE_AT 0x809B /* AppleTalk protocol */
151	#define ETHERTYPE_AARP 0x80F3 /* AppleTalk ARP */
152
153	/*
154	DDP protocol types
155	*/
156
157	#define DDP_RTMP 0x01
158	#define DDP_NBP 0x02
159	#define DDP_ATP 0x03
160	#define DDP_ECHO 0x04
161	#define DDP_RTMP_REQ 0x05
162	#define DDP_ZIP 0x06
163	#define DDP_ADSP 0x07
164
165	/*
166	Protocols for the socket API
167	*/
168
169	#define ATPROTO_NONE 0 /* no corresponding DDP type exists */
170
171	#define ATPROTO_ATP DDP_ATP /* must match DDP type */
172	#define ATPROTO_ADSP DDP_ADSP /* must match DDP type */
173
174	#define ATPROTO_DDP 249 /* * to be eliminated eventually * */
175	#define ATPROTO_LAP 250 /* * to be eliminated eventually * */
176
177	#define ATPROTO_AURP 251 /* no corresponding DDP type exists */
178	#define ATPROTO_ASP 252 /* no corresponding DDP type exists */
179	#define ATPROTO_AFP 253 /* no corresponding DDP type exists */
180
181	#define ATPROTO_RAW 255 /* no corresponding DDP type exists */
182
183	/*
184	Options for use with [gs]etsockopt at the DDP level.
185	First word of comment is data type; bool is stored in int.
186	*/
187	#define DDP_CHKSUM_ON 1 /* int; default = FALSE;
188	DDP checksums should be used */
189	#define DDP_HDRINCL 2 /* int; default = FALSE;
190	header is included with data */
191	#define DDP_GETSOCKNAME 3 /* used to get ddp_addr_t */
192	#define DDP_SLFSND_ON 4 /* int; default = FALSE;
193	packets sent to the cable-multicast address
194	on this socket will be looped back */
195	#define DDP_STRIPHDR 5 /* int; default = FALSE;
196	drop DDP header on receive (raw) */
197
198	/*
199	AppleTalk protocol retry and timeout
200	*/
201
202	typedef struct at_retry {
203	short interval; /* Retry interval in seconds */
204	short retries; /* Maximum number of retries */
205	u_char backoff; /* Retry backoff, must be 1 through 4 */
206	} at_retry_t;
207
208	/*
209	Basic NBP Definitions needed for AppleTalk framework
210	*/
211
212	#define MAX_ZONES 50
213
214	#define NBP_NVE_STR_SIZE 32 /* Maximum NBP tuple string size */
215	typedef struct at_nvestr {
216	u_char len;
217	u_char str[NBP_NVE_STR_SIZE];
218	} at_nvestr_t;
219
220	/* Entity Name */
221	typedef struct at_entity {
222	at_nvestr_t object;
223	at_nvestr_t type;
224	at_nvestr_t zone;
225	} at_entity_t;
226
227	#define NBP_TUPLE_SIZE ((3*NBP_NVE_STR_SIZE)+3)
228	/* 3 for field lengths + 332 for three names /
229	typedef struct at_nbptuple {
230	at_inet_t enu_addr;
231	u_char enu_enum;
232	at_entity_t enu_entity;
233	} at_nbptuple_t;
234
235	/*
236	Basic ATP Definitions needed for LibcAT
237	*/
238
239	#define ATP_TRESP_MAX 8 /* Maximum number of Tresp pkts */
240
241	/* Response buffer structure for atp_sendreq() and atp_sendrsp() */
242	typedef struct at_resp {
243	u_char bitmap; /* Bitmap of responses */
244	u_char filler[3]; /* Force 68K to RISC alignment */
245	struct iovec resp[ATP_TRESP_MAX]; /* Buffer for response data */
246	long userdata[ATP_TRESP_MAX]; /* Buffer for response user data */
247	} at_resp_t;
248
249	/*
250	Needed for ASP and ADSP
251	*/
252
253	typedef struct {
254	int maxlen; /* max buffer length */
255	int len; /* length of data */
256	char buf; / pointer to buffer */
257	} strbuf_t;
258
259	#define IFID_HOME 1 /* home port in ifID_table */
260
261	#define ATALK_VALUE(a) (((u_long ) &(a))&0x00ffffff)
262	#define ATALK_EQUAL(a, b) (ATALK_VALUE(a) == ATALK_VALUE(b))
263
264	#define VERSION_LENGTH 80 /* length of version string */
265
266	/* struture containing general information regarding the state of
267	* the Appletalk networking
268	*/
269	typedef struct at_state {
270	unsigned int flags; /* various init flags */
271	} at_state_t;
272
273	/* at_state_t 'flags' defines */
9bccf70c A	274	#define AT_ST_STARTED 0x0001 /* set if protocol is fully enabled */
9bccf70c A	275	#define AT_ST_STARTING 0x0002 /* set if interfaces are configured */
1c79356b A	276	#define AT_ST_MULTIHOME 0x0080 /* set if multihome mode */
	277	#define AT_ST_ROUTER 0x0100 /* set if we are a router */
	278	#define AT_ST_IF_CHANGED 0x0200 /* set when state of any I/F
	279	changes (for SNMP) */
	280	#define AT_ST_RT_CHANGED 0x0400 /* route table changed (for SNMP)*/
	281	#define AT_ST_ZT_CHANGED 0x0800 /* zone table changed (for SNMP) */
	282	#define AT_ST_NBP_CHANGED 0x1000 /* if nbp table changed (for SNMP)*/
	283
	284	#ifdef KERNEL
9bccf70c	285	#ifdef __APPLE_API_PRIVATE
1c79356b A	286	extern at_state_t at_state; /* global state of AT network */
	287
	288	#define ROUTING_MODE (at_state.flags & AT_ST_ROUTER)
	289	#define MULTIHOME_MODE (at_state.flags & AT_ST_MULTIHOME)
	290	#define MULTIPORT_MODE (ROUTING_MODE \|\| MULTIHOME_MODE)
9bccf70c	291	#endif /* __APPLE_API_PRIVATE */
1c79356b A	292	#endif /* KERNEL */
	293
	294	/* defines originally from h/at_elap.h */
	295	#define AT_ADDR 0
	296	#define ET_ADDR 1
	297	#define AT_ADDR_NO_LOOP 2 /* disables packets from looping back */
	298
	299	#endif /* _NETAT_APPLETALK_H_ */