]> git.saurik.com Git - apple/xnu.git/blame - bsd/netat/atp.h
xnu-344.49.tar.gz
[apple/xnu.git] / bsd / netat / atp.h
CommitLineData
1c79356b
A
1/*
2 * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
3 *
4 * @APPLE_LICENSE_HEADER_START@
5 *
43866e37 6 * Copyright (c) 1999-2003 Apple Computer, Inc. All Rights Reserved.
1c79356b 7 *
43866e37
A
8 * This file contains Original Code and/or Modifications of Original Code
9 * as defined in and that are subject to the Apple Public Source License
10 * Version 2.0 (the 'License'). You may not use this file except in
11 * compliance with the License. Please obtain a copy of the License at
12 * http://www.opensource.apple.com/apsl/ and read it before using this
13 * file.
14 *
15 * The Original Code and all software distributed under the License are
16 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
1c79356b
A
17 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
18 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
43866e37
A
19 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
20 * Please see the License for the specific language governing rights and
21 * limitations under the License.
1c79356b
A
22 *
23 * @APPLE_LICENSE_HEADER_END@
24 */
25/*
26 *
27 * ORIGINS: 82
28 *
29 * (C) COPYRIGHT Apple Computer, Inc. 1992-1996
30 * All Rights Reserved
31 *
32 */
33
34/* Definitions for ATP protocol and streams module, per
35 * AppleTalk Transaction Protocol documentation from
36 * `Inside AppleTalk', July 14, 1986.
37 */
38
39/*
40 * Copyright (c) 1988, 1989 Apple Computer, Inc.
41 *
42 * The information contained herein is subject to change without
43 * notice and should not be construed as a commitment by Apple
44 * Computer, Inc. Apple Computer, Inc. assumes no responsibility
45 * for any errors that may appear.
46 *
47 * Confidential and Proprietary to Apple Computer, Inc.
48 */
49
50#ifndef _NETAT_ATP_H_
51#define _NETAT_ATP_H_
9bccf70c 52#include <sys/appleapiopts.h>
1c79356b
A
53
54/* ATP function codes */
55
56#define ATP_CMD_TREQ 0x01 /* TRequest packet */
57#define ATP_CMD_TRESP 0x02 /* TResponse packet */
58#define ATP_CMD_TREL 0x03 /* TRelease packet */
59
60/* Miscellaneous definitions */
61
62#define ATP_DEF_RETRIES 8 /* Default for maximum retry count */
63#define ATP_DEF_INTERVAL 2 /* Default for retry interval in seconds */
64
65#define ATP_TRESP_MAX 8 /* Maximum number of Tresp pkts */
66
67#define ATP_HDR_SIZE 8 /* Size of the ATP header */
68#define ATP_DATA_SIZE 578 /* Maximum size of the ATP data area */
69
70/* Consts for asynch support */
71#define ATP_ASYNCH_REQ 1
72#define ATP_ASYNCH_RESP 2
73
74/* Timer values for XO release timers */
75#define ATP_XO_DEF_REL_TIME 0
76#define ATP_XO_30SEC 0
77#define ATP_XO_1MIN 1
78#define ATP_XO_2MIN 2
79#define ATP_XO_4MIN 3
80#define ATP_XO_8MIN 4
81
82typedef struct {
83 unsigned cmd : 2,
84 xo : 1,
85 eom : 1,
86 sts : 1,
87 xo_relt : 3;
88 u_char bitmap;
89 ua_short tid;
90 ua_long user_bytes;
91 u_char data[ATP_DATA_SIZE];
92} at_atp_t;
93
94#define ATP_ATP_HDR(c) ((at_atp_t *)(&((at_ddp_t *)(c))->data[0]))
95
96#define TOTAL_ATP_HDR_SIZE (ATP_HDR_SIZE+DDP_X_HDR_SIZE)
97#define ATP_CLEAR_CONTROL(c) (*(char *)(c) = 0)
98
99/* ATP ioctl interface */
100
101/* Structure for the atp_set_default call */
102
103#define ATP_INFINITE_RETRIES 0xffffffff /* means retry forever
104 * in the def_retries field
105 */
106
107struct atp_set_default {
108 u_int def_retries; /* number of retries for a request */
109 u_int def_rate; /* retry rate (in seconds/100) NB: the
110 * system may not be able to resolve
111 * delays of 100th of a second but will
112 * instead make a 'best effort'
113 */
114 struct atpBDS *def_bdsp; /* BDS structure associated with this req */
115 u_int def_BDSlen; /* size of BDS structure */
116};
117
118
119/* Return header from requests */
120
121struct atp_result {
122 u_short count; /* the number of packets */
123 u_short hdr; /* offset to header in buffer */
124 u_short offset[8]; /* offset to the Nth packet in the buffer */
125 u_short len[8]; /* length of the Nth packet */
126};
127
128struct atpBDS {
129 ua_short bdsBuffSz;
130 ua_long bdsBuffAddr;
131 ua_short bdsDataSz;
132 unsigned char bdsUserData[4];
133};
134
135
136typedef struct {
137 u_short at_atpreq_type;
138 at_inet_t at_atpreq_to;
139 u_char at_atpreq_treq_user_bytes[4];
140 u_char *at_atpreq_treq_data;
141 u_short at_atpreq_treq_length;
142 u_char at_atpreq_treq_bitmap;
143 u_char at_atpreq_xo;
144 u_char at_atpreq_xo_relt;
145 u_short at_atpreq_retry_timeout;
146 u_short at_atpreq_maximum_retries;
147 u_char at_atpreq_tresp_user_bytes[ATP_TRESP_MAX][4];
148 u_char *at_atpreq_tresp_data[ATP_TRESP_MAX];
149 u_short at_atpreq_tresp_lengths[ATP_TRESP_MAX];
150 u_long at_atpreq_debug[4];
151 u_short at_atpreq_tid;
152 u_char at_atpreq_tresp_bitmap;
153 u_char at_atpreq_tresp_eom_seqno;
154 u_char at_atpreq_got_trel;
155} at_atpreq;
156
157
158/* The ATP module ioctl commands */
159
160#define AT_ATP_CANCEL_REQUEST (('|'<<8)|1)
161#define AT_ATP_ISSUE_REQUEST (('|'<<8)|2) /* ALO */
162#define AT_ATP_ISSUE_REQUEST_DEF (('|'<<8)|3) /* XO */
163#define AT_ATP_ISSUE_REQUEST_DEF_NOTE (('|'<<8)|4) /* XO & nowait -- not needed*/
164#define AT_ATP_ISSUE_REQUEST_NOTE (('|'<<8)|5) /* ALO & nowait */
165#define AT_ATP_GET_POLL (('|'<<8)|6)
166#define AT_ATP_RELEASE_RESPONSE (('|'<<8)|7)
167#define AT_ATP_REQUEST_COMPLETE (('|'<<8)|8)
168#define AT_ATP_SEND_FULL_RESPONSE (('|'<<8)|9) /* not used */
169#define AT_ATP_BIND_REQ (('|'<<8)|10)
170#define AT_ATP_GET_CHANID (('|'<<8)|11)
171#define AT_ATP_PEEK (('|'<<8)|12)
172#define AT_ATP_ISSUE_REQUEST_TICKLE (('|'<<8)|13) /* ALO & nowait */
173
174/* These macros don't really depend here, but since they're used only by the
175 * old ATP and old PAP, they're put here. Unisoft PAP includes this file.
176 */
177#define R16(x) UAS_VALUE(x)
178#define W16(x,v) UAS_ASSIGN(x, v)
179#define C16(x,v) UAS_UAS(x, v)
180
181/*
182 * these are the dispatch codes for
183 * the new atp_control system call
184 */
185#define ATP_SENDREQUEST 0
186#define ATP_GETRESPONSE 1
187#define ATP_SENDRESPONSE 2
188#define ATP_GETREQUEST 3
189
190#ifdef KERNEL
9bccf70c 191#ifdef __APPLE_API_PRIVATE
1c79356b
A
192
193
194/*
195 * Stuff for accessing protocol headers
196 */
197#define AT_DDP_HDR(m) ((at_ddp_t *)(gbuf_rptr(m)))
198#define AT_ATP_HDR(m) ((at_atp_t *)(&((at_ddp_t *)(gbuf_rptr(m)))->data[0]))
199
200/*
201 * Masks for accessing/manipulating the bitmap field in atp headers
202 */
203
204#ifdef ATP_DECLARE
205unsigned char atp_mask [] = {
206 0x01, 0x02, 0x04, 0x08,
207 0x10, 0x20, 0x40, 0x80,
208};
209
210unsigned char atp_lomask [] = {
211 0x00, 0x01, 0x03, 0x07,
212 0x0f, 0x1f, 0x3f, 0x7f,
213 0xff
214};
215#else
216extern unsigned char atp_mask [];
217extern unsigned char atp_lomask [];
218#endif /* ATP_DECLARE */
219
220/*
221 * doubly linked queue types and primitives
222 */
223
224#define ATP_Q_ENTER(hdr, object, entry) { \
225 if ((hdr).head) { \
226 (hdr).head->entry.prev = (object); \
227 (object)->entry.next = (hdr).head; \
228 } else { \
229 (hdr).tail = (object); \
230 (object)->entry.next = NULL; \
231 } \
232 (object)->entry.prev = NULL; \
233 (hdr).head = (object); \
234 }
235
236#define ATP_Q_APPEND(hdr, object, entry) { \
237 if ((hdr).head) { \
238 (hdr).tail->entry.next = (object); \
239 (object)->entry.prev = (hdr).tail; \
240 } else { \
241 (hdr).head = (object); \
242 (object)->entry.prev = NULL; \
243 } \
244 (object)->entry.next = NULL; \
245 (hdr).tail = (object); \
246 }
247
248#define ATP_Q_REMOVE(hdr, object, entry) { \
249 if ((object)->entry.prev) { \
250 (object)->entry.prev->entry.next = (object)->entry.next;\
251 } else { \
252 (hdr).head = (object)->entry.next; \
253 } \
254 if ((object)->entry.next) { \
255 (object)->entry.next->entry.prev = (object)->entry.prev;\
256 } else { \
257 (hdr).tail = (object)->entry.prev; \
258 } \
259 }
260
261struct atp_rcb_qhead {
262 struct atp_rcb *head;
263 struct atp_rcb *tail;
264};
265
266struct atp_rcb_q {
267 struct atp_rcb *prev;
268 struct atp_rcb *next;
269};
270
271struct atp_trans_qhead {
272 struct atp_trans *head;
273 struct atp_trans *tail;
274};
275
276struct atp_trans_q {
277 struct atp_trans *prev;
278 struct atp_trans *next;
279};
280
281/*
282 * Locally saved remote node address
283 */
284
285struct atp_socket {
286 u_short net;
287 at_node node;
288 at_socket socket;
289};
290
291/*
292 * transaction control block (local context at requester end)
293 */
294
295struct atp_trans {
296 struct atp_trans_q tr_list; /* trans list */
297 struct atp_state *tr_queue; /* state data structure */
298 gbuf_t *tr_xmt; /* message being sent */
299 gbuf_t *tr_rcv[8]; /* message being rcvd */
300 unsigned int tr_retry; /* # retries left */
301 unsigned int tr_timeout; /* timer interval */
302 char tr_state; /* current state */
303 char tr_rsp_wait; /* waiting for transaction response */
304 char filler[2];
305 unsigned char tr_xo; /* execute once transaction */
306 unsigned char tr_bitmap; /* requested bitmask */
307 unsigned short tr_tid; /* transaction id */
308 struct atp_socket tr_socket; /* the remote socket id */
309 struct atp_trans_q tr_snd_wait; /* list of transactions waiting
310 for space to send a msg */
311 at_socket tr_local_socket;
312 at_node tr_local_node;
313 at_net tr_local_net;
314 gbuf_t *tr_bdsp; /* bds structure pointer */
315 unsigned int tr_tmo_delta;
316 void (*tr_tmo_func)();
317 struct atp_trans *tr_tmo_next;
318 struct atp_trans *tr_tmo_prev;
319 atlock_t tr_lock;
320 atevent_t tr_event;
321};
322
323#define TRANS_TIMEOUT 0 /* waiting for a reply */
324#define TRANS_REQUEST 1 /* waiting to send a request */
325#define TRANS_RELEASE 2 /* waiting to send a release */
0b4e3aa0 326#define TRANS_DONE 3 /* done - waiting for poll to complete */
1c79356b 327#define TRANS_FAILED 4 /* done - waiting for poll to report failure */
0b4e3aa0 328#define TRANS_ABORTING 5 /* waiting on atp_trans_abort list for thread to wakeup */
1c79356b
A
329
330/*
331 * reply control block (local context at repling end)
332 */
333
334struct atp_rcb {
335 struct atp_rcb_q rc_list; /* rcb list */
336 struct atp_rcb_q rc_tlist;
337 struct atp_state *rc_queue; /* state data structure */
338 gbuf_t *rc_xmt; /* replys being sent */
339 gbuf_t *rc_ioctl; /* waiting ioctl */
340 char rc_snd[8]; /* replys actually to be sent */
341 int rc_pktcnt; /* no of pkts in this trans */
342 short rc_state; /* current state */
343 unsigned char rc_xo; /* execute once transaction */
344 at_node rc_local_node;
345 at_net rc_local_net;
346 short rc_rep_waiting; /* in the reply wait list */
347 int rc_timestamp; /* reply timer */
348 unsigned char rc_bitmap; /* replied bitmask */
349 unsigned char rc_not_sent_bitmap; /* replied bitmask */
350 unsigned short rc_tid; /* transaction id */
351 struct atp_socket rc_socket; /* the remote socket id */
352};
353
354#define RCB_UNQUEUED 0 /* newly allocated, not q'd */
355#define RCB_RESPONDING 2 /* waiting all of response from process*/
356#define RCB_RESPONSE_FULL 3 /* got all of response */
357#define RCB_RELEASED 4 /* got our release */
358#define RCB_PENDING 5 /* a no wait rcb is full */
359#define RCB_NOTIFIED 6
360#define RCB_SENDING 7 /* we're currently xmitting this trans */
361
362/*
363 * socket state (per module data structure)
364 */
365
366struct atp_state {
367 gref_t *atp_gref; /* must be the first entry */
368 int atp_pid; /* process id, must be the second entry */
369 gbuf_t *atp_msgq; /* data msg, must be the third entry */
370 unsigned char dflag; /* structure flag, must be the fourth entry */
371 unsigned char filler;
372 short atp_socket_no;
373 short atp_flags; /* general flags */
374 struct atp_trans_qhead atp_trans_wait; /* pending transaction list */
375 struct atp_state *atp_trans_waiting; /* list of atps waiting for a
376 free transaction */
377 unsigned int atp_retry; /* retry count */
378 unsigned int atp_timeout; /* retry timeout */
379 struct atp_state *atp_rcb_waiting;
380 struct atp_rcb_qhead atp_rcb; /* active rcbs */
381 struct atp_rcb_qhead atp_attached; /* rcb's waiting to be read */
382 atlock_t atp_lock;
383 atevent_t atp_event;
384 atlock_t atp_delay_lock;
385 atevent_t atp_delay_event;
386};
387
388
389/*
390 * atp_state flag definitions
391 */
392#define ATP_CLOSING 0x08 /* atp stream in process of closing */
393
394
395/*
396 * tcb/rcb/state allocation queues
397 */
398
399/*
400 * Size defines; must be outside following #ifdef to permit
401 * debugging code to reference independent of ATP_DECLARE
402 */
403#define NATP_RCB 512 /* the number of ATP RCBs at once */
404#define NATP_STATE 192 /* the number of ATP sockets open at once */
405 /* note: I made NATP_STATE == NSOCKETS */
406
407#ifdef ATP_DECLARE
408struct atp_trans *atp_trans_free_list = NULL; /* free transactions */
0b4e3aa0 409struct atp_rcb *atp_rcb_free_list = NULL; /* free rcbs */
9bccf70c 410struct atp_state *atp_free_list = NULL; /* free atp states */
0b4e3aa0 411struct atp_trans_qhead atp_trans_abort; /* aborted trans list */
9bccf70c
A
412struct atp_rcb* atp_rcb_data = NULL;
413struct atp_state* atp_state_data=NULL;
0b4e3aa0
A
414
415
1c79356b
A
416#else
417extern struct atp_trans *atp_trans_free_list; /* free transactions */
0b4e3aa0
A
418extern struct atp_rcb *atp_rcb_free_list; /* free rcbs */
419extern struct atp_state *atp_free_list; /* free atp states */
9bccf70c
A
420extern struct atp_rcb* atp_rcb_data;
421extern struct atp_state* atp_state_data;
0b4e3aa0 422extern struct atp_trans_qhead atp_trans_abort; /* aborting trans list */
1c79356b
A
423
424extern void atp_req_timeout();
425extern void atp_rcb_timer();
426extern void atp_x_done();
427extern struct atp_rcb *atp_rcb_alloc();
428extern struct atp_trans *atp_trans_alloc();
429#endif /* ATP_DECLARE */
430
431/* prototypes */
432void atp_send_req(gref_t *, gbuf_t *);
433void atp_drop_req(gref_t *, gbuf_t *);
434void atp_send_rsp(gref_t *, gbuf_t *, int);
435void atp_wput(gref_t *, gbuf_t *);
436void atp_rput(gref_t *, gbuf_t *);
437void atp_retry_req(gbuf_t *);
438void atp_stop(gbuf_t *, int);
439void atp_cancel_req(gref_t *, unsigned short);
440int atp_open(gref_t *, int);
441int atp_bind(gref_t *, unsigned int, unsigned char *);
442int atp_close(gref_t *, int);
443gbuf_t *atp_build_release(struct atp_trans *);
444void atp_req_timeout(struct atp_trans *);
445void atp_free(struct atp_trans *);
446void atp_x_done(struct atp_trans *);
447void atp_send(struct atp_trans *);
448void atp_rsp_ind(struct atp_trans *, gbuf_t *);
449void atp_trans_free(struct atp_trans *);
450void atp_reply(struct atp_rcb *);
451void atp_rcb_free(struct atp_rcb *);
452void atp_send_replies(struct atp_state *, struct atp_rcb *);
453void atp_dequeue_atp(struct atp_state *);
454int atp_iocack(struct atp_state *, gbuf_t *);
455void atp_req_ind(struct atp_state *, gbuf_t *);
456int atp_iocnak(struct atp_state *, gbuf_t *, int);
457void atp_trp_timer(void *, int);
458void atp_timout(void (*func)(), struct atp_trans *, int);
459void atp_untimout(void (*func)(), struct atp_trans *);
460int atp_tid(struct atp_state *);
461
9bccf70c 462#endif /* __APPLE_API_PRIVATE */
1c79356b
A
463#endif /* KERNEL */
464#endif /* _NETAT_ATP_H_ */