FreeCalypso > hg > fc-magnetite
comparison cdg3/sap/tcpip.pdf @ 16:c15047b3d00d
cdg3: import from freecalypso-citrine/cdg
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Tue, 27 Sep 2016 16:27:34 +0000 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
15:c8bdae60fcb1 | 16:c15047b3d00d |
---|---|
1 ;******************************************************************************** | |
2 ;*** File : tcpip.pdf | |
3 ;*** Creation : Wed Mar 11 09:57:43 CST 2009 | |
4 ;*** XSLT Processor : Apache Software Foundation / http://xml.apache.org/xalan-j / supports XSLT-Ver: 1 | |
5 ;*** Copyright : (c) Texas Instruments AG, Berlin Germany 2002 | |
6 ;******************************************************************************** | |
7 ;*** Document Type : Service Access Point Specification | |
8 ;*** Document Name : tcpip | |
9 ;*** Document No. : 8462.000.03.005 | |
10 ;*** Document Date : 2003-09-05 | |
11 ;*** Document Status: BEING_PROCESSED | |
12 ;*** Document Author: NI | |
13 ;******************************************************************************** | |
14 | |
15 | |
16 | |
17 PRAGMA SRC_FILE_TIME "Thu Nov 29 09:55:14 2007" | |
18 PRAGMA LAST_MODIFIED "2003-09-05" | |
19 PRAGMA ID_AND_VERSION "8462.000.03.005" | |
20 | |
21 | |
22 | |
23 CONST TCPIP_HNAMELEN 256 ; Maximum length of the full-qualified domain name of an Internet host (as defined in [RFC 1034]) plus one byte for the zero termination. | |
24 CONST TCPIP_DEFAULT_MTU_SIZE 1500 ; Default size of the maximum transfer unit of the network connection. To be used if no other information is available. | |
25 CONST TCPIP_UNSPECIFIED_IPADDR 0 ; The unspecified IP address (0.0.0.0) | |
26 CONST TCPIP_UNSPECIFIED_PORT 0 ; The unspecified port number. | |
27 | |
28 | |
29 | |
30 VALTAB VAL_ipproto | |
31 VAL 6 TCPIP_IPPROTO_TCP "Value for TCP" | |
32 VAL 17 TCPIP_IPPROTO_UDP "Value for UDP" | |
33 | |
34 VALTAB VAL_event_type | |
35 VAL 1 TCPIP_EVT_CREATE_CNF "Result of TCPIP_CREATE_REQ" | |
36 VAL 2 TCPIP_EVT_CLOSE_CNF "Result of TCPIP_CLOSE_REQ" | |
37 VAL 3 TCPIP_EVT_BIND_CNF "Result of TCPIP_BIND_REQ" | |
38 VAL 4 TCPIP_EVT_LISTEN_CNF "Result of TCPIP_LISTEN_REQ" | |
39 VAL 5 TCPIP_EVT_CONNECT_CNF "Result of TCPIP_CONNECT_REQ" | |
40 VAL 6 TCPIP_EVT_SOCKNAME_CNF "Result of TCPIP_SOCKNAME_REQ" | |
41 VAL 7 TCPIP_EVT_PEERNAME_CNF "Result of TCPIP_PEERNAME_REQ" | |
42 VAL 8 TCPIP_EVT_HOSTINFO_CNF "Result of TCPIP_HOSTINFO_REQ" | |
43 VAL 9 TCPIP_EVT_MTU_SIZE_CNF "Result of TCPIP_MTU_SIZE_REQ" | |
44 VAL 10 TCPIP_EVT_RECV_IND "Indication of incoming data" | |
45 VAL 11 TCPIP_EVT_CONNECT_IND "Indication of incoming connection" | |
46 VAL 12 TCPIP_EVT_CONN_CLOSED_IND "Indication of remotely closed connection" | |
47 VAL 13 TCPIP_EVT_ERROR_IND "Indication of asynchronous error" | |
48 VAL 14 TCPIP_EVT_FLOW_READY_IND "Flow Control: application can send again (not used by a TCPIP primitive!)" | |
49 | |
50 VALTAB VAL_result | |
51 VAL 0 TCPIP_RESULT_OK "Operation was successful." | |
52 VAL 1 TCPIP_RESULT_INVALID_PARAMETER "A parameter was invalid." | |
53 VAL 2 TCPIP_RESULT_INTERNAL_ERROR "An internal error has happened." | |
54 VAL 3 TCPIP_RESULT_ADDR_IN_USE "The address or port is already in use." | |
55 VAL 4 TCPIP_RESULT_OUT_OF_MEMORY "There is not enough memory to fulfill the request." | |
56 VAL 5 TCPIP_RESULT_NOT_SUPPORTED "The socket is not of a type that can support this operation." | |
57 VAL 6 TCPIP_RESULT_UNREACHABLE "The specified host cannot be reached." | |
58 VAL 7 TCPIP_RESULT_CONN_REFUSED "The connection to the specified address was refused by the remote host." | |
59 VAL 8 TCPIP_RESULT_TIMEOUT "The connection attempt timed out without establishing a connection." | |
60 VAL 9 TCPIP_RESULT_IS_CONNECTED "The request could not be fulfilled because the socket is already connected." | |
61 VAL 10 TCPIP_RESULT_HOST_NOT_FOUND "The specified host could not be found in the DNS." | |
62 VAL 11 TCPIP_RESULT_DNS_TEMP_ERROR "A temporary DNS error has occurred. Retrying the query may be successful." | |
63 VAL 12 TCPIP_RESULT_DNS_PERM_ERROR "A permanent DNS error has occurred." | |
64 VAL 13 TCPIP_RESULT_NO_IPADDR "The specified name has been found in the DNS, but no IP address is available." | |
65 VAL 14 TCPIP_RESULT_NOT_CONNECTED "The socket has not been connected yet." | |
66 VAL 15 TCPIP_RESULT_MSG_TOO_BIG "The size of the data buffer is too large for a UDP socket." | |
67 VAL 16 TCPIP_RESULT_CONN_RESET "The connection has been reset by the remote peer." | |
68 VAL 17 TCPIP_RESULT_CONN_ABORTED "The connection was aborted due to timeout or some other error condition." | |
69 VAL 18 TCPIP_RESULT_NO_BUFSPACE "Sending failed temporarily because the space to buffer the message was exhausted. The application should wait for a TCPIP_FLOW_READY_IND event to retry the operation." | |
70 VAL 19 TCPIP_RESULT_NETWORK_LOST "The operation failed because TCP/IP's network connection has been disconnected." | |
71 VAL 20 TCPIP_RESULT_NOT_READY "The operation failed because the TCP/IP entity was not yet initialised." | |
72 | |
73 VALTAB VAL_if_up | |
74 VAL 0 TCPIP_IFCONFIG_DOWN "Interface going down" | |
75 VAL 1 TCPIP_IFCONFIG_UP "Interface coming up" | |
76 | |
77 VALTAB VAL_dti_direction | |
78 VAL 0 TCPIP_DTI_TO_HIGHER_LAYER "Connect to higher layer, i. e. an application" | |
79 VAL 1 TCPIP_DTI_TO_LOWER_LAYER "Connect to lower layer, i. e. to protocol stack" | |
80 | |
81 VALTAB VAL_dti_conn | |
82 VAL 0 TCPIP_CONNECT_DTI "Connect the DTI link" | |
83 VAL 1 TCPIP_DISCONNECT_DTI "Disconnect the DTI link" | |
84 | |
85 | |
86 | |
87 | |
88 VAR app_handle "Application communication handle" L | |
89 | |
90 | |
91 VAR ipproto "IP protocol identifier" B | |
92 | |
93 VAL @p_tcpip - VAL_ipproto@ | |
94 | |
95 VAR request_id "Request ID" L | |
96 | |
97 | |
98 VAR event_type "Type of the event" L | |
99 | |
100 VAL @p_tcpip - VAL_event_type@ | |
101 | |
102 VAR result "Result code" B | |
103 | |
104 VAL @p_tcpip - VAL_result@ | |
105 | |
106 VAR socket "Socket descriptor" L | |
107 | |
108 | |
109 VAR port "Port number" S | |
110 | |
111 | |
112 VAR ipaddr "IP address" L | |
113 | |
114 | |
115 VAR hostname "Name of the host" B | |
116 | |
117 | |
118 VAR new_socket "Socket descriptor" L | |
119 | |
120 | |
121 VAR mtu_size "MTU size" S | |
122 | |
123 | |
124 VAR if_up "Interface Configuration direction" B | |
125 | |
126 VAL @p_tcpip - VAL_if_up@ | |
127 | |
128 VAR dnsaddr1 "IP address of first DNS server" L | |
129 | |
130 | |
131 VAR dnsaddr2 "IP address of second DNS server" L | |
132 | |
133 | |
134 VAR link_id "DTI link identifier" L | |
135 | |
136 | |
137 VAR entity_name "DTI neighbor entity name" L | |
138 | |
139 | |
140 VAR dti_direction "Direction of DTI connection" B | |
141 | |
142 VAL @p_tcpip - VAL_dti_direction@ | |
143 | |
144 VAR dti_conn "Indicates to connect or disconnect DTI link" B | |
145 | |
146 VAL @p_tcpip - VAL_dti_conn@ | |
147 | |
148 VAR data "Address of payload data" L | |
149 | |
150 | |
151 VAR window "Flow control window size" L | |
152 | |
153 | |
154 VAR buflen "Data buffer length" S | |
155 | |
156 | |
157 VAR msg_p "Message pointer" L | |
158 | |
159 | |
160 VAR msg_id "Message ID" L | |
161 | |
162 | |
163 | |
164 | |
165 | |
166 | |
167 | |
168 | |
169 ; TCPIP_INITIALIZE_REQ 0x80000048 | |
170 ; TCPIP_INITIALIZE_CNF 0x80004048 | |
171 ; TCPIP_SHUTDOWN_REQ 0x80010048 | |
172 ; TCPIP_SHUTDOWN_CNF 0x80014048 | |
173 ; TCPIP_IFCONFIG_REQ 0x80020048 | |
174 ; TCPIP_IFCONFIG_CNF 0x80024048 | |
175 ; TCPIP_DTI_REQ 0x80030048 | |
176 ; TCPIP_DTI_CNF 0x80034048 | |
177 ; TCPIP_CREATE_REQ 0x80040048 | |
178 ; TCPIP_CREATE_CNF 0x80044048 | |
179 ; TCPIP_CLOSE_REQ 0x80050048 | |
180 ; TCPIP_CLOSE_CNF 0x80054048 | |
181 ; TCPIP_BIND_REQ 0x80060048 | |
182 ; TCPIP_BIND_CNF 0x80064048 | |
183 ; TCPIP_LISTEN_REQ 0x80070048 | |
184 ; TCPIP_LISTEN_CNF 0x80074048 | |
185 ; TCPIP_CONNECT_REQ 0x80080048 | |
186 ; TCPIP_CONNECT_CNF 0x80084048 | |
187 ; TCPIP_DATA_REQ 0x80090048 | |
188 ; TCPIP_DATA_CNF 0x80094048 | |
189 ; TCPIP_DATA_IND 0x800A4048 | |
190 ; TCPIP_DATA_RES 0x800A0048 | |
191 ; TCPIP_SOCKNAME_REQ 0x800B0048 | |
192 ; TCPIP_SOCKNAME_CNF 0x800B4048 | |
193 ; TCPIP_PEERNAME_REQ 0x800C0048 | |
194 ; TCPIP_PEERNAME_CNF 0x800C4048 | |
195 ; TCPIP_HOSTINFO_REQ 0x800D0048 | |
196 ; TCPIP_HOSTINFO_CNF 0x800D4048 | |
197 ; TCPIP_MTU_SIZE_REQ 0x800E0048 | |
198 ; TCPIP_MTU_SIZE_CNF 0x800E4048 | |
199 ; TCPIP_CONNECT_IND 0x800F4048 | |
200 ; TCPIP_CONN_CLOSED_IND 0x80104048 | |
201 ; TCPIP_ERROR_IND 0x80114048 | |
202 ; TCPIP_INTERNAL_IND 0x800F0048 | |
203 | |
204 | |
205 | |
206 PRIM TCPIP_INITIALIZE_REQ 0x80000048 | |
207 { | |
208 } | |
209 | |
210 | |
211 | |
212 | |
213 | |
214 | |
215 PRIM TCPIP_INITIALIZE_CNF 0x80004048 | |
216 { | |
217 result ; Result code | |
218 } | |
219 | |
220 | |
221 | |
222 | |
223 | |
224 | |
225 PRIM TCPIP_SHUTDOWN_REQ 0x80010048 | |
226 { | |
227 } | |
228 | |
229 | |
230 | |
231 | |
232 | |
233 | |
234 PRIM TCPIP_SHUTDOWN_CNF 0x80014048 | |
235 { | |
236 result ; Result code | |
237 } | |
238 | |
239 | |
240 | |
241 | |
242 | |
243 | |
244 PRIM TCPIP_IFCONFIG_REQ 0x80020048 | |
245 { | |
246 if_up ; Direction of interface transition (coming up or going down) | |
247 mtu_size ; MTU size of interface (unused when interface goes down) | |
248 ipaddr ; IP address of interface (unused when interface goes down) | |
249 dnsaddr1 ; First DNS address (unused when interface goes down) | |
250 dnsaddr2 ; Second DNS address (unused when interface goes down) | |
251 } | |
252 | |
253 | |
254 | |
255 | |
256 | |
257 | |
258 PRIM TCPIP_IFCONFIG_CNF 0x80024048 | |
259 { | |
260 result ; Result code | |
261 } | |
262 | |
263 | |
264 | |
265 | |
266 | |
267 | |
268 PRIM TCPIP_DTI_REQ 0x80030048 | |
269 { | |
270 dti_conn ; DTI connect | |
271 entity_name ; Neighbor entity name | |
272 link_id ; DTI link identifier | |
273 dti_direction ; DTI link direction | |
274 } | |
275 | |
276 | |
277 | |
278 | |
279 | |
280 | |
281 PRIM TCPIP_DTI_CNF 0x80034048 | |
282 { | |
283 dti_conn ; DTI connect | |
284 link_id ; DTI link identifier | |
285 } | |
286 | |
287 | |
288 | |
289 | |
290 | |
291 | |
292 PRIM TCPIP_CREATE_REQ 0x80040048 | |
293 { | |
294 app_handle ; Application communication handle | |
295 ipproto ; IP protocol type | |
296 request_id ; Request ID (arbitrary value chosen by the application) | |
297 } | |
298 | |
299 | |
300 | |
301 | |
302 | |
303 | |
304 PRIM TCPIP_CREATE_CNF 0x80044048 | |
305 { | |
306 event_type ; Type of the event as passed to the application (TCPIP_CREATE_CNF) | |
307 result ; Result code | |
308 socket ; Descriptor of new socket (if result is TCPIP_RESULT_OK) | |
309 request_id ; Request ID as passed in TCPIP_CREATE_REQ | |
310 } | |
311 | |
312 | |
313 | |
314 | |
315 | |
316 | |
317 PRIM TCPIP_CLOSE_REQ 0x80050048 | |
318 { | |
319 app_handle ; Application communication handle | |
320 socket ; Socket descriptor | |
321 } | |
322 | |
323 | |
324 | |
325 | |
326 | |
327 | |
328 PRIM TCPIP_CLOSE_CNF 0x80054048 | |
329 { | |
330 event_type ; Type of the event as passed to the application (TCPIP_CLOSE_CNF) | |
331 result ; Result code | |
332 socket ; Socket descriptor | |
333 } | |
334 | |
335 | |
336 | |
337 | |
338 | |
339 | |
340 PRIM TCPIP_BIND_REQ 0x80060048 | |
341 { | |
342 app_handle ; Application communication handle | |
343 socket ; Socket descriptor | |
344 port ; Port number to bind the socket to | |
345 } | |
346 | |
347 | |
348 | |
349 | |
350 | |
351 | |
352 PRIM TCPIP_BIND_CNF 0x80064048 | |
353 { | |
354 event_type ; Type of the event as passed to the application (TCPIP_BIND_CNF) | |
355 result ; Result code | |
356 socket ; Socket descriptor | |
357 } | |
358 | |
359 | |
360 | |
361 | |
362 | |
363 | |
364 PRIM TCPIP_LISTEN_REQ 0x80070048 | |
365 { | |
366 app_handle ; Application communication handle | |
367 socket ; Socket descriptor | |
368 } | |
369 | |
370 | |
371 | |
372 | |
373 | |
374 | |
375 PRIM TCPIP_LISTEN_CNF 0x80074048 | |
376 { | |
377 event_type ; Type of the event as passed to the application (TCPIP_LISTEN_CNF) | |
378 result ; Result code | |
379 socket ; Socket descriptor | |
380 } | |
381 | |
382 | |
383 | |
384 | |
385 | |
386 | |
387 PRIM TCPIP_CONNECT_REQ 0x80080048 | |
388 { | |
389 app_handle ; Application communication handle | |
390 socket ; Socket descriptor | |
391 ipaddr ; IP address of remote peer to connect to | |
392 port ; Port number of remote peer to connect to | |
393 } | |
394 | |
395 | |
396 | |
397 | |
398 | |
399 | |
400 PRIM TCPIP_CONNECT_CNF 0x80084048 | |
401 { | |
402 event_type ; Type of the event as passed to the application (TCPIP_CONNECT_CNF) | |
403 result ; Result code | |
404 socket ; Socket descriptor | |
405 } | |
406 | |
407 | |
408 | |
409 | |
410 | |
411 | |
412 PRIM TCPIP_DATA_REQ 0x80090048 | |
413 { | |
414 app_handle ; Application communication handle | |
415 socket ; Socket descriptor | |
416 ipaddr ; Destination IP address | |
417 port ; Destination port number | |
418 buflen ; Data buffer length | |
419 data ; Payload data | |
420 } | |
421 | |
422 | |
423 | |
424 | |
425 | |
426 | |
427 PRIM TCPIP_DATA_CNF 0x80094048 | |
428 { | |
429 event_type ; Type of the event as passed to the application (TCPIP_DATA_CNF) | |
430 result ; Result code | |
431 socket ; Socket descriptor | |
432 window ; Flow control window size | |
433 } | |
434 | |
435 | |
436 | |
437 | |
438 | |
439 | |
440 PRIM TCPIP_DATA_IND 0x800A4048 | |
441 { | |
442 event_type ; Type of the event as passed to the application (TCPIP_DATA_IND) | |
443 result ; Result code | |
444 socket ; Socket descriptor | |
445 ipaddr ; Source IP address | |
446 port ; Source port number | |
447 buflen ; Data buffer length | |
448 data ; Payload data | |
449 } | |
450 | |
451 | |
452 | |
453 | |
454 | |
455 | |
456 PRIM TCPIP_DATA_RES 0x800A0048 | |
457 { | |
458 app_handle ; Application communication handle | |
459 socket ; Socket descriptor | |
460 window ; Flow control window size | |
461 } | |
462 | |
463 | |
464 | |
465 | |
466 | |
467 | |
468 PRIM TCPIP_SOCKNAME_REQ 0x800B0048 | |
469 { | |
470 app_handle ; Application communication handle | |
471 socket ; Socket descriptor | |
472 } | |
473 | |
474 | |
475 | |
476 | |
477 | |
478 | |
479 PRIM TCPIP_SOCKNAME_CNF 0x800B4048 | |
480 { | |
481 event_type ; Type of the event as passed to the application (TCPIP_SOCKNAME_CNF) | |
482 result ; Result code | |
483 socket ; Socket descriptor | |
484 ipaddr ; IP address of socket | |
485 port ; Port number of socket | |
486 } | |
487 | |
488 | |
489 | |
490 | |
491 | |
492 | |
493 PRIM TCPIP_PEERNAME_REQ 0x800C0048 | |
494 { | |
495 app_handle ; Application communication handle | |
496 socket ; Socket descriptor | |
497 } | |
498 | |
499 | |
500 | |
501 | |
502 | |
503 | |
504 PRIM TCPIP_PEERNAME_CNF 0x800C4048 | |
505 { | |
506 event_type ; Type of the event as passed to the application (TCPIP_PEERNAME_CNF) | |
507 result ; Result code | |
508 socket ; Socket descriptor | |
509 ipaddr ; IP address of remote peer | |
510 port ; Port number of remote peer | |
511 } | |
512 | |
513 | |
514 | |
515 | |
516 | |
517 | |
518 PRIM TCPIP_HOSTINFO_REQ 0x800D0048 | |
519 { | |
520 app_handle ; Application communication handle | |
521 ipaddr ; IP address of the host | |
522 hostname [TCPIP_HNAMELEN] ; Full-qualified domain name of the host | |
523 request_id ; Request ID (arbitrary value chosen by the application) | |
524 } | |
525 | |
526 | |
527 | |
528 | |
529 | |
530 | |
531 PRIM TCPIP_HOSTINFO_CNF 0x800D4048 | |
532 { | |
533 event_type ; Type of the event as passed to the application (TCPIP_SOCKNAME_CNF) | |
534 result ; Result code | |
535 socket ; Socket descriptor (unused) | |
536 hostname [TCPIP_HNAMELEN] ; Full-qualified domain name of the host | |
537 ipaddr ; IP address of the host | |
538 request_id ; Request ID as passed by in TCPIP_HOSTINFO_REQ | |
539 } | |
540 | |
541 | |
542 | |
543 | |
544 | |
545 | |
546 PRIM TCPIP_MTU_SIZE_REQ 0x800E0048 | |
547 { | |
548 app_handle ; Application communication handle | |
549 socket ; Socket descriptor | |
550 } | |
551 | |
552 | |
553 | |
554 | |
555 | |
556 | |
557 PRIM TCPIP_MTU_SIZE_CNF 0x800E4048 | |
558 { | |
559 event_type ; Type of the event as passed to the application (TCPIP_MTU_SIZE_CNF) | |
560 result ; Result code | |
561 socket ; Socket descriptor | |
562 mtu_size ; MTU size | |
563 } | |
564 | |
565 | |
566 | |
567 | |
568 | |
569 | |
570 PRIM TCPIP_CONNECT_IND 0x800F4048 | |
571 { | |
572 event_type ; Type of the event as passed to the application (TCPIP_CONNECT_IND) | |
573 result ; Result code (TCPIP_RESULT_OK) | |
574 socket ; Socket on which the connection has been accepted | |
575 new_socket ; New socket allocated for the connection | |
576 ipaddr ; IP address of the remote peer | |
577 port ; Port number on the remote side | |
578 } | |
579 | |
580 | |
581 | |
582 | |
583 | |
584 | |
585 PRIM TCPIP_CONN_CLOSED_IND 0x80104048 | |
586 { | |
587 event_type ; Type of the event as passed to the application (TCPIP_CONN_CLOSED_IND) | |
588 result ; Result code (TCPIP_RESULT_OK) | |
589 socket ; Socket of the connection that has been closed | |
590 } | |
591 | |
592 | |
593 | |
594 | |
595 | |
596 | |
597 PRIM TCPIP_ERROR_IND 0x80114048 | |
598 { | |
599 event_type ; Type of the event as passed to the application (TCPIP_ERROR_IND) | |
600 result ; Result code (one of TCPIP_RESULT_CONN_RESET, TCPIP_RESULT_CONN_ABORTED, or TCPIP_RESULT_UNREACHABLE) | |
601 socket ; Socket for which the error occured | |
602 } | |
603 | |
604 | |
605 | |
606 | |
607 | |
608 | |
609 PRIM TCPIP_INTERNAL_IND 0x800F0048 | |
610 { | |
611 msg_p ; Message pointer | |
612 msg_id ; Message ID | |
613 } | |
614 | |
615 | |
616 | |
617 | |
618 | |
619 | |
620 | |
621 | |
622 |