Commit | Line | Data |
---|---|---|
15637ed4 RG |
1 | .\" Copyright (c) 1990, 1991 The Regents of the University of California. |
2 | .\" All rights reserved. | |
3 | .\" | |
4 | .\" Redistribution and use in source and binary forms, with or without | |
5 | .\" modification, are permitted provided that the following conditions | |
6 | .\" are met: | |
7 | .\" 1. Redistributions of source code must retain the above copyright | |
8 | .\" notice, this list of conditions and the following disclaimer. | |
9 | .\" 2. Redistributions in binary form must reproduce the above copyright | |
10 | .\" notice, this list of conditions and the following disclaimer in the | |
11 | .\" documentation and/or other materials provided with the distribution. | |
12 | .\" 3. All advertising materials mentioning features or use of this software | |
13 | .\" must display the following acknowledgement: | |
14 | .\" This product includes software developed by the University of | |
15 | .\" California, Berkeley and its contributors. | |
16 | .\" 4. Neither the name of the University nor the names of its contributors | |
17 | .\" may be used to endorse or promote products derived from this software | |
18 | .\" without specific prior written permission. | |
19 | .\" | |
20 | .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND | |
21 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
22 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
23 | .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
24 | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
25 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
26 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
27 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
28 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
29 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
30 | .\" SUCH DAMAGE. | |
31 | .\" | |
32 | .\" @(#)iso.4 6.2 (Berkeley) 3/28/91 | |
33 | .\" | |
34 | .Dd March 28, 1991 | |
35 | .Dt ISO 4 | |
36 | .Os | |
37 | .Sh NAME | |
38 | .Nm iso | |
39 | .Nd | |
40 | .Tn ISO | |
41 | protocol family | |
42 | .Sh SYNOPSIS | |
43 | .Fd #include <sys/types.h> | |
44 | .Fd #include <netiso/iso.h> | |
45 | .Sh DESCRIPTION | |
46 | The | |
47 | .Tn ISO | |
48 | protocol family is a collection of protocols | |
49 | that uses the | |
50 | .Tn ISO | |
51 | address format. | |
52 | The | |
53 | .Tn ISO | |
54 | family provides protocol support for the | |
55 | .Dv SOCK_SEQPACKET | |
56 | abstraction through the | |
57 | .Tn TP | |
58 | protocol | |
59 | .Pf ( Tn ISO | |
60 | 8073), | |
61 | for the | |
62 | .Dv SOCK_DGRAM | |
63 | abstraction through the connectionless transport | |
64 | protocol | |
65 | .Pf ( Tn ISO | |
66 | 8602), | |
67 | and for the | |
68 | .Dv SOCK_RAW | |
69 | abstraction | |
70 | by providing direct access (for debugging) to the | |
71 | .Tn CLNP | |
72 | .Pf ( Tn ISO | |
73 | 8473) network layer protocol. | |
74 | .Sh ADDRESSING | |
75 | .Tn ISO | |
76 | addresses are based upon | |
77 | .Tn ISO | |
78 | 8348/AD2, | |
79 | .%T "Addendum to the Network Service Definition Covering Network Layer Addressing." | |
80 | .Pp | |
81 | Sockets bound to the OSI protocol family use | |
82 | the following address structure: | |
83 | .Bd -literal | |
84 | struct iso_addr { | |
85 | u_char isoa_len; /* length, not including this byte */ | |
86 | char isoa_genaddr[20]; /* general opaque address */ | |
87 | }; | |
88 | ||
89 | struct sockaddr_iso { | |
90 | u_char siso_len; /* size of this sockaddr */ | |
91 | u_char siso_family; /* addressing domain, AF_ISO */ | |
92 | u_char siso_plen; /* presentation selector length */ | |
93 | u_char siso_slen; /* session selector length */ | |
94 | u_char siso_tlen; /* transport selector length */ | |
95 | struct iso_addr siso_addr; /* network address */ | |
96 | u_char siso_pad[6]; /* space for gosip v2 SELs */ | |
97 | }; | |
98 | #define siso_nlen siso_addr.isoa_len | |
99 | #define siso_data siso_addr.isoa_genaddr | |
100 | .Ed | |
101 | .Pp | |
102 | The fields of this structure are: | |
103 | .Bl -tag -width Ds | |
104 | .It Ar siso_len: | |
105 | Length of the entire address structure, in bytes, which may grow to | |
106 | be longer than the 32 bytes show above. | |
107 | .It Ar siso_family: | |
108 | Identifies the domain: | |
109 | .Dv AF_ISO . | |
110 | .It Ar siso_tlen: | |
111 | Length of the transport selector. | |
112 | .It Ar siso_slen: | |
113 | Length of the session selector. | |
114 | This is not currently supported by the kernel and is provided as | |
115 | a convenience for user level programs. | |
116 | .It Ar siso_plen: | |
117 | Length of the presentation selector. | |
118 | This is not currently supported by the kernel and is provided as | |
119 | a convenience for user level programs. | |
120 | .It Ar siso_addr: | |
121 | The network part of the address, described below. | |
122 | .El | |
123 | .Sh TRANSPORT ADDRESSING | |
124 | .Pp | |
125 | An | |
126 | .Tn ISO | |
127 | transport address is similar to an Internet address in that | |
128 | it contains a network-address portion and a portion that the | |
129 | transport layer uses to multiplex its services among clients. | |
130 | In the Internet domain, this portion of the address is called a | |
131 | .Em port . | |
132 | In the | |
133 | .Tn ISO | |
134 | domain, this is called a | |
135 | .Em transport selector | |
136 | (also known at one time as a | |
137 | .Em transport suffix ) . | |
138 | While ports are always 16 bits, | |
139 | transport selectors may be | |
140 | of (almost) arbitrary size. | |
141 | .Pp | |
142 | Since the C language does not provide conveninent variable | |
143 | length structures, we have separated the selector lengths | |
144 | from the data themselves. | |
145 | The network address and various selectors are stored contiguously, | |
146 | with the network address first, then the transport selector, and so | |
147 | on. Thus, if you had a nework address of less then 20 bytes, | |
148 | the transport selector would encroach on space normally reserved | |
149 | for the network address. | |
150 | .Pp | |
151 | .Sh NETWORK ADDRESSING. | |
152 | .Tn ISO | |
153 | network addresses are limited to 20 bytes in length. | |
154 | .Tn ISO | |
155 | network addresses can take any format. | |
156 | .Sh PROTOCOLS | |
157 | The | |
158 | .Tn ARGO | |
159 | 1.0 implementation of the | |
160 | .Tn ISO | |
161 | protocol family comprises | |
162 | the Connectionless-Mode Network Protocol | |
163 | .Pq Tn CLNP , | |
164 | and the Transport Protocol | |
165 | .Pq Tn TP , | |
166 | classes 4 and 0, | |
167 | and | |
168 | .Tn X.25 . | |
169 | .Tn TP | |
170 | is used to support the | |
171 | .Dv SOCK_SEQPACKET | |
172 | abstraction. | |
173 | A raw interface to | |
174 | .Tn CLNP | |
175 | is available | |
176 | by creating an | |
177 | .Tn ISO | |
178 | socket of type | |
179 | .Dv SOCK_RAW . | |
180 | This is used for | |
181 | .Tn CLNP | |
182 | debugging only. | |
183 | .Sh SEE ALSO | |
184 | .Xr tp 4 , | |
185 | .Xr clnp 4 , | |
186 | .Xr cltp 4 | |
187 | .Sh HISTORY | |
188 | The | |
189 | .Nm | |
190 | protocol family implementation | |
191 | .Ud |