1 .\" Copyright (c) 2014, Kevin Lo.
2 .\" All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
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.
13 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 .Nd Lightweight User Datagram Protocol
38 .Fn socket AF_INET SOCK_DGRAM IPPROTO_UDPLITE
42 protocol provides a partial checksum which allows
43 corrupted packets to be transmitted to the receiving
45 This has advantages for some types of multimedia
46 transport that may be able to make use of slightly
47 damaged datagrams, rather than having them discarded
48 by lower-layer protocols.
51 supports a number of socket options which can be set with
55 .Bl -tag -width ".Dv UDPLITE_SEND_CSCOV"
56 .It Dv UDPLITE_SEND_CSCOV
57 This option sets the sender checksum coverage.
58 A value of zero indicates that all sent packets will have
59 full checksum coverage.
60 A value of 8 to 65535 limits the checksum coverage of all sent packets
62 .It Dv UDPLITE_RECV_CSCOV
63 This option is the receiver-side analogue.
64 A value of zero instructs the kernel to drop all received packets
65 not having full checksum coverage.
66 A value of 8 to 65535 instructs the kernel to drop all received
67 packets with a partial checksum coverage smaller than the value specified.
70 A socket operation may fail with one of the following errors returned:
73 when trying to establish a connection on a socket which
74 already has one, or when trying to send a datagram with the destination
75 address specified and the socket is already connected;
77 when trying to send a datagram, but
78 no destination address is specified, and the socket has not been
81 when the system runs out of memory for
82 an internal data structure;
85 is made to create a socket with a port which has already been
87 .It Bq Er EADDRNOTAVAIL
88 when an attempt is made to create a
89 socket with a network address for which no network interface