share/man/man4/cltp.4

   1 .\"     $NetBSD: cltp.4,v 1.7 2003/04/16 13:35:17 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1990, 1991, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. Neither the name of the University nor the names of its contributors
  15 .\"    may be used to endorse or promote products derived from this software
  16 .\"    without specific prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28 .\" SUCH DAMAGE.
  29 .\"
  30 .\"     @(#)cltp.4      8.1 (Berkeley) 6/9/93
  31 .\"
  32 .Dd June 9, 1993
  33 .Dt CLTP 4
  34 .Os
  35 .Sh NAME
  36 .Nm cltp
  37 .Nd
  38 .Tn ISO
  39 Connectionless Transport Protocol
  40 .Sh SYNOPSIS
  41 .In sys/socket.h
  42 .In netiso/iso.h
  43 .Ft int
  44 .Fn socket AF_ISO SOCK_DGRAM 0
  45 .Sh DESCRIPTION
  46 .Tn CLTP
  47 is a simple, unreliable datagram protocol which is accessed
  48 via the
  49 .Dv SOCK_DGRAM
  50 abstraction for the
  51 .Tn ISO
  52 protocol family.
  53 .Tn CLTP
  54 sockets are connectionless, and are
  55 normally used with the
  56 .Xr sendto 2
  57 and
  58 .Xr recvfrom 2
  59 calls, though the
  60 .Xr connect 2
  61 call may also be used to fix the destination for future
  62 packets (in which case the
  63 .Xr recv 2
  64 or
  65 .Xr read 2
  66 and
  67 .Xr send 2
  68 or
  69 .Xr write 2
  70 system calls may be used).
  71 .Pp
  72 .Tn CLTP
  73 address formats are identical to those used by TP.
  74 In particular
  75 .Tn CLTP
  76 provides a service selector in addition
  77 to the normal
  78 .Tn ISO NSAP .
  79 Note that the
  80 .Tn CLTP
  81 selector
  82 space is separate from the TP selector space (i.e. a
  83 .Tn CLTP
  84 selector
  85 may not be
  86 .Dq connected
  87 to a TP selector).
  88 .Pp
  89 Options at the
  90 .Tn CLNP
  91 network level may be used with
  92 .Tn CLTP ;
  93 see
  94 .Xr clnp 4 .
  95 .Sh DIAGNOSTICS
  96 A socket operation may fail with one of the following errors returned:
  97 .Bl -tag -width [EADDRNOTAVAIL]
  98 .It Bq Er EISCONN
  99 when trying to establish a connection on a socket which
 100 already has one, or when trying to send a datagram with the destination
 101 address specified and the socket is already connected;
 102 .It Bq Er ENOTCONN
 103 when trying to send a datagram, but
 104 no destination address is specified, and the socket hasn't been
 105 connected;
 106 .It Bq Er ENOBUFS
 107 when the system runs out of memory for
 108 an internal data structure;
 109 .It Bq Er EADDRINUSE
 110 when an attempt
 111 is made to create a socket with a selector which has already been
 112 allocated;
 113 .It Bq Er EADDRNOTAVAIL
 114 when an attempt is made to create a
 115 socket with a network address for which no network interface
 116 exists.
 117 .El
 118 .Sh SEE ALSO
 119 .Xr getsockopt 2 ,
 120 .Xr recv 2 ,
 121 .Xr send 2 ,
 122 .Xr socket 2 ,
 123 .Xr clnp 4 ,
 124 .Xr intro 4 ,
 125 .Xr iso 4