share/man/man7d/ticlts.7d

   1 '\" te
   2 .\" Copyright 2000, Sun Microsystems, Inc.  All Rights Reserved.
   3 .\" Copyright 1989 AT&T
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH TICLTS 7D "Jul 3, 1990"
   8 .SH NAME
   9 ticlts, ticots, ticotsord \- loopback transport providers
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 #include <sys/ticlts.h>
  14 .fi
  15
  16 .LP
  17 .nf
  18 #include <sys/ticots.h>
  19 .fi
  20
  21 .LP
  22 .nf
  23 #include <sys/ticotsord.h>
  24 .fi
  25
  26 .SH DESCRIPTION
  27 .sp
  28 .LP
  29 The devices known as \fBticlts\fR, \fBticots\fR, and \fBticotsord\fR  are
  30 ``loopback transport providers,'' that is, stand-alone networks at the
  31 transport level. Loopback transport providers are transport providers in every
  32 sense except one: only one host (the local machine) is ``connected to'' a
  33 loopback network. Loopback transports present a \fBTPI\fR (STREAMS-level)
  34 interface to application processes and are intended to be accessed via the
  35 \fBTLI\fR (application-level) interface. They are implemented as clone devices
  36 and support address spaces consisting of ``flex-addresses,'' that is, arbitrary
  37 sequences of octets of length > 0, represented by a \fBnetbuf\fR structure.
  38 .sp
  39 .LP
  40 \fBticlts\fR is a datagram-mode transport provider. It offers (connectionless)
  41 service of type \fBT_CLTS\fR. Its default address size is
  42 \fBTCL_DEFAULTADDRSZ\fR. \fBticlts\fR prints the following error messages (see
  43 \fBt_rcvuderr\fR(3NSL)):
  44 .sp
  45 .ne 2
  46 .na
  47 \fBTCL_BADADDR\fR
  48 .ad
  49 .RS 20n
  50 bad address specification
  51 .RE
  52
  53 .sp
  54 .ne 2
  55 .na
  56 \fBTCL_BADOPT\fR
  57 .ad
  58 .RS 20n
  59 bad option specification
  60 .RE
  61
  62 .sp
  63 .ne 2
  64 .na
  65 \fBTCL_NOPEER\fR
  66 .ad
  67 .RS 20n
  68 bound
  69 .RE
  70
  71 .sp
  72 .ne 2
  73 .na
  74 \fBTCL_PEERBADSTATE\fR
  75 .ad
  76 .RS 20n
  77 peer in wrong state
  78 .RE
  79
  80 .sp
  81 .LP
  82 \fBticots\fR is a virtual circuit-mode transport provider. It offers
  83 (connection-oriented) service of type \fBT_COTS\fR. Its default address size is
  84 \fBTCO_DEFAULTADDRSZ\fR. \fBticots\fR prints the following disconnect messages
  85 (see  \fBt_rcvdis\fR(3NSL)):
  86 .sp
  87 .ne 2
  88 .na
  89 \fBTCO_NOPEER\fR
  90 .ad
  91 .RS 25n
  92 no listener on destination address
  93 .RE
  94
  95 .sp
  96 .ne 2
  97 .na
  98 \fBTCO_PEERNOROOMONQ\fR
  99 .ad
 100 .RS 25n
 101 peer has no room on connect queue
 102 .RE
 103
 104 .sp
 105 .ne 2
 106 .na
 107 \fBTCO_PEERBADSTATE\fR
 108 .ad
 109 .RS 25n
 110 peer in wrong state
 111 .RE
 112
 113 .sp
 114 .ne 2
 115 .na
 116 \fBTCO_PEERINITIATED\fR
 117 .ad
 118 .RS 25n
 119 peer-initiated disconnect
 120 .RE
 121
 122 .sp
 123 .ne 2
 124 .na
 125 \fBTCO_PROVIDERINITIATED\fR
 126 .ad
 127 .RS 25n
 128 provider-initiated disconnect
 129 .RE
 130
 131 .sp
 132 .LP
 133 \fBticotsord\fR is a virtual circuit-mode transport provider, offering service
 134 of type  \fBT_COTS_ORD\fR (connection-oriented service with orderly release).
 135 Its default address size is \fBTCOO_DEFAULTADDRSZ\fR. \fBticotsord\fR prints
 136 the following disconnect messages (see \fBt_rcvdis\fR(3NSL)):
 137 .sp
 138 .ne 2
 139 .na
 140 \fBTCOO_NOPEER\fR
 141 .ad
 142 .RS 26n
 143 no listener on destination address
 144 .RE
 145
 146 .sp
 147 .ne 2
 148 .na
 149 \fBTCOO_PEERNOROOMONQ\fR
 150 .ad
 151 .RS 26n
 152 peer has no room on connect queue
 153 .RE
 154
 155 .sp
 156 .ne 2
 157 .na
 158 \fBTCOO_PEERBADSTATE\fR
 159 .ad
 160 .RS 26n
 161 peer in wrong state
 162 .RE
 163
 164 .sp
 165 .ne 2
 166 .na
 167 \fBTCOO_PEERINITIATED\fR
 168 .ad
 169 .RS 26n
 170 provider-initiated disconnect
 171 .RE
 172
 173 .sp
 174 .ne 2
 175 .na
 176 \fBTCOO_PROVIDERINITIATED\fR
 177 .ad
 178 .RS 26n
 179 peer-initiated disconnect
 180 .RE
 181
 182 .SH USAGE
 183 .sp
 184 .LP
 185 Loopback transports support a local \fBIPC\fR mechanism through the \fBTLI\fR
 186 interface. Applications implemented in a transport provider-independent manner
 187 on a client-server model using this \fBIPC\fR are transparently transportable
 188 to networked environments.
 189 .sp
 190 .LP
 191 Transport provider-independent applications must not include the headers listed
 192 in the synopsis section above. In particular, the options are (like all
 193 transport provider options) provider dependent.
 194 .sp
 195 .LP
 196 \fBticlts\fR and \fBticots\fR support the same service types (\fBT_CLTS\fR and
 197 \fBT_COTS\fR) supported by the \fBOSI\fR transport-level model.
 198 .sp
 199 .LP
 200 \fBticotsord\fR supports the same service type (\fBT_COTSORD\fR) supported by
 201 the \fBTCP/IP\fR model.
 202 .SH FILES
 203 .sp
 204 .LP
 205 \fB/dev/ticlts\fR
 206 .sp
 207 .LP
 208 \fB/dev/ticots\fR
 209 .sp
 210 .LP
 211 \fB/dev/ticotsord\fR
 212 .SH SEE ALSO
 213 .sp
 214 .LP
 215 \fBt_rcvdis\fR(3NSL), \fBt_rcvuderr\fR(3NSL)