summaryrefslogtreecommitdiff
path: root/share/man/man4
diff options
context:
space:
mode:
authorJason McIntyre <jmc@cvs.openbsd.org>2005-06-09 21:23:52 +0000
committerJason McIntyre <jmc@cvs.openbsd.org>2005-06-09 21:23:52 +0000
commit2533377214d75a85d46ea5afe5505c4fd5b11cea (patch)
treef6c2dd8201afe5afe62209b7676010679af74a47 /share/man/man4
parent1315bc15dca66b7e70ce96f2b0bca76d7f5288e2 (diff)
no more ns;
ok henning@
Diffstat (limited to 'share/man/man4')
-rw-r--r--share/man/man4/Makefile4
-rw-r--r--share/man/man4/spp.4192
2 files changed, 2 insertions, 194 deletions
diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 38b6a1ad20c..9b1af5d2a8b 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-# $OpenBSD: Makefile,v 1.300 2005/06/08 04:22:14 henning Exp $
+# $OpenBSD: Makefile,v 1.301 2005/06/09 21:23:51 jmc Exp $
MAN= aac.4 ac97.4 acphy.4 addcom.4 adv.4 aha.4 ahb.4 ahc.4 ahd.4 \
aic.4 amdpm.4 ami.4 amphy.4 an.4 aria.4 ast.4 atalk.4 \
@@ -25,7 +25,7 @@ MAN= aac.4 ac97.4 acphy.4 addcom.4 adv.4 aha.4 ahb.4 ahc.4 ahd.4 \
pms.4 ppb.4 ppp.4 pppoe.4 pty.4 puc.4 qsphy.4 radio.4 raid.4 ral.4 \
random.4 ray.4 rd.4 re.4 rgephy.4 rl.4 rln.4 rlphy.4 route.4 rt.4 \
rtfps.4 rtii.4 rtw.4 safe.4 san.4 sbus.4 scsi.4 sd.4 ses.4 sf.4 \
- sf2r.4 sfr.4 siop.4 sis.4 sk.4 sl.4 sm.4 speaker.4 spp.4 sppp.4 \
+ sf2r.4 sfr.4 siop.4 sis.4 sk.4 sl.4 sm.4 speaker.4 sppp.4 \
sqphy.4 ss.4 st.4 ste.4 stge.4 sti.4 stp.4 sv.4 \
systrace.4 tb.4 tcic.4 tcp.4 termios.4 ti.4 tl.4 \
tlphy.4 tqphy.4 trm.4 trunk.4 tty.4 tun.4 twe.4 txp.4 \
diff --git a/share/man/man4/spp.4 b/share/man/man4/spp.4
deleted file mode 100644
index 1302a7b6776..00000000000
--- a/share/man/man4/spp.4
+++ /dev/null
@@ -1,192 +0,0 @@
-.\" $OpenBSD: spp.4,v 1.9 2005/06/09 08:40:49 jmc Exp $
-.\" $NetBSD: spp.4,v 1.3 1994/11/30 16:22:33 jtc Exp $
-.\"
-.\" Copyright (c) 1985, 1991, 1993
-.\" The Regents of the University of California. All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\" notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\" notice, this list of conditions and the following disclaimer in the
-.\" documentation and/or other materials provided with the distribution.
-.\" 3. Neither the name of the University nor the names of its contributors
-.\" may be used to endorse or promote products derived from this software
-.\" without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
-.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
-.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\" @(#)spp.4 8.2 (Berkeley) 4/19/94
-.\"
-.Dd April 19, 1994
-.Dt SPP 4
-.Os
-.Sh NAME
-.Nm spp
-.Nd Xerox Sequenced Packet Protocol
-.Sh SYNOPSIS
-.Fd #include <sys/socket.h>
-.Fd #include <netns/ns.h>
-.Fd #include <netns/sp.h>
-.Ft int
-.Fn socket AF_NS SOCK_STREAM 0
-.Ft int
-.Fn socket AF_NS SOCK_SEQPACKET 0
-.Sh DESCRIPTION
-The
-.Tn SPP
-protocol provides a reliable, flow-controlled, two-way
-transmission of data.
-It is a byte-stream protocol used to support the
-.Dv SOCK_STREAM
-abstraction.
-.Tn SPP
-uses the standard
-.Tn NS Ns (tm)
-address formats.
-.Pp
-Sockets utilizing the
-.Tn SPP
-protocol are either
-.Dq active
-or
-.Dq passive .
-Active sockets initiate connections to passive
-sockets.
-By default
-.Tn SPP
-sockets are created active; to create a
-passive socket the
-.Xr listen 2
-system call must be used
-after binding the socket with the
-.Xr bind 2
-system call.
-Only
-passive sockets may use the
-.Xr accept 2
-call to accept incoming connections.
-Only active sockets may use the
-.Xr connect 2
-call to initiate connections.
-.Pp
-Passive sockets may
-.Dq underspecify
-their location to match
-incoming connection requests from multiple networks.
-This technique, termed
-.Dq wildcard addressing ,
-allows a single
-server to provide service to clients on multiple networks.
-To create a socket which listens on all networks, the
-.Tn NS
-address of all zeroes must be bound.
-The
-.Tn SPP
-port may still be specified
-at this time; if the port is not specified the system will assign one.
-Once a connection has been established the socket's address is
-fixed by the peer entity's location.
-The address assigned to the socket is the address associated with the network
-interface through which packets are being transmitted and received.
-Normally this address corresponds to the peer entity's network.
-.Pp
-If the
-.Dv SOCK_SEQPACKET
-socket type is specified,
-each packet received has the actual 12 byte sequenced packet header
-left for the user to inspect:
-.Bd -literal -offset indent
-struct sphdr {
- u_char sp_cc; /* connection control */
-#define SP_EM 0x10 /* end of message */
- u_char sp_dt; /* datastream type */
- u_short sp_sid;
- u_short sp_did;
- u_short sp_seq;
- u_short sp_ack;
- u_short sp_alo;
-};
-.Ed
-.Pp
-This facilitates the implementation of higher level Xerox protocols
-which make use of the data stream type field and the end of message bit.
-Conversely, the user is required to supply a 12 byte header,
-the only part of which inspected is the data stream type and end of message
-fields.
-.Pp
-For either socket type,
-packets received with the Attention bit sent are interpreted as
-out of band data.
-Data sent with
-.Dq send(..., ..., ..., Dv MSG_OOB )
-cause the attention bit to be set.
-.Sh DIAGNOSTICS
-A socket operation may fail with one of the following errors returned:
-.Bl -tag -width [EADDRNOTAVAIL]
-.It Bq Er EISCONN
-when trying to establish a connection on a socket which
-already has one;
-.It Bq Er ENOBUFS
-when the system runs out of memory for
-an internal data structure;
-.It Bq Er ETIMEDOUT
-when a connection was dropped
-due to excessive retransmissions;
-.It Bq Er ECONNRESET
-when the remote peer
-forces the connection to be closed;
-.It Bq Er ECONNREFUSED
-when the remote
-peer actively refuses connection establishment (usually because
-no process is listening to the port);
-.It Bq Er EADDRINUSE
-when an attempt
-is made to create a socket with a port which has already been
-allocated;
-.It Bq Er EADDRNOTAVAIL
-when an attempt is made to create a
-socket with a network address for which no network interface
-exists.
-.El
-.Sh SOCKET OPTIONS
-.Bl -tag -width SO_DEFAULT_HEADERS
-.It Dv SO_DEFAULT_HEADERS
-when set, this determines the data stream type and whether
-the end of message bit is to be set on every ensuing packet.
-.It Dv SO_MTU
-This specifies the maximum amount of user data in a single packet.
-The default is 576 bytes - sizeof(struct spidp).
-This quantity affects windowing \- increasing it without increasing
-the amount of buffering in the socket will lower the number of unread
-packets accepted.
-Anything larger than the default will not be forwarded by a bona fide
-.Tn XEROX
-product internetwork router.
-The data argument for the setsockopt call must be
-an unsigned short.
-.El
-.Sh SEE ALSO
-.Xr netintro 4
-.Sh HISTORY
-The
-.Nm
-protocol appeared in
-.Bx 4.3 .
-.Sh BUGS
-There should be some way to reflect record boundaries in
-a stream.
-For stream mode, there should be an option to get the data stream type of
-the record the user process is about to receive.