Browse Source

Plan 9 from Bell Labs 2013-10-03

David du Colombier 10 years ago
parent
commit
9314de7eb7
2 changed files with 150 additions and 0 deletions
  1. 3 0
      sys/lib/tmac/tmac.an
  2. 147 0
      sys/man/3/sdp

+ 3 - 0
sys/lib/tmac/tmac.an

@@ -119,6 +119,9 @@
 ..
 .deSH
 .PD
+.\" avoid a lone heading at page bottom
+.br
+.ne 3v
 .}X 0 "\\$1"
 .nr)E 2
 \&\Xhtml <H4>\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6\Xhtml </H4>

+ 147 - 0
sys/man/3/sdp

@@ -0,0 +1,147 @@
+.TH SDP 3
+.SH NAME
+sdp \- secure datagram protocol
+.SH SYNOPSIS
+.nf
+.B bind -a #E\fIspec\fP /net
+.sp 0.3v
+.B /net/sdp/clone
+.B /net/sdp/log
+.BI /net/sdp/ n
+.BI /net/sdp/ n /data
+.BI /net/sdp/ n /control
+.BI /net/sdp/ n /ctl
+.BI /net/sdp/ n /rstats
+.BI /net/sdp/ n /stats
+.BI /net/sdp/ n /status
+\&...
+.fi
+.SH DESCRIPTION
+The
+.I sdp
+device provides the interface to the Secure Datagram Protocol (SDP).
+SDP (un)compresses and (de-)encrypts packets.
+.I Spec
+is an integer from 0 to 15 identifying a stack.
+Each stack is independent of all others:
+the only information transfer between them is via programs that
+mount multiple stacks.
+Normally a system uses only one stack.
+However multiple stacks can be used for debugging
+new networks or implementing firewalls or proxy
+services.
+.PP
+The top level directory contains a
+.B clone
+file, a
+.B log
+file, and subdirectories numbered from zero to the number of connections
+opened for this protocol.
+.PP
+Opening the
+.B clone
+file reserves a connection.  The file descriptor returned from the
+.IR open (2)
+will point to the control file,
+.BR ctl ,
+of the newly allocated connection.
+Reading
+.B ctl
+returns a text
+string representing the number of the
+connection.
+Connections may be used either to listen for incoming calls
+or to initiate calls to other machines.
+.PP
+A connection is controlled by writing text strings to the associated
+.B ctl
+file.
+After a connection has been established data may be read from
+and written to
+.BR data .
+A connection can be actively established using the
+.B connect
+message (see also
+.IR dial (2)).
+A connection can be established passively by first
+using an
+.B announce
+message (see
+.IR dial (2))
+to bind to a local port and then
+opening the
+.B listen
+file (see
+.IR dial (2))
+to receive incoming calls.
+.PP
+The following control messages are supported:
+.TF "outsecret \fIsecret
+.PD
+.TP
+.BI accept " file"
+Accept an incoming encrypted connection on
+.IR file ,
+typically a
+.B data
+file.
+.TP
+.BI dial " file"
+Initiate a new encrypted connection on
+.IR file ,
+typically a UDP
+.B data
+file.
+.TP
+.BI drop " permil"
+Randomly drop approximately one of every
+.I permil
+output packets,
+thus simulating network errors.
+.TP
+.BI cipher " algorithm"
+Use ciphering
+.IR algorithm ;
+choices are
+.LR null ,
+.LR des_56_cbc ,
+.LR rc4_128 ,
+and
+.LR rc4_256 .
+.TP
+.BI auth " algorithm"
+Use authentication
+.IR algorithm ;
+choices are
+.LR null ,
+.LR hmac_sha1_96 ,
+and
+.LR hmac_md5_96 .
+.TP
+.BI comp " algorithm"
+Use compression
+.IR algorithm ;
+choices are
+.L null
+and
+.LR thwack .
+.TP
+.BI insecret " secret"
+Use
+.I secret
+to decrypt incoming packets.
+.TP
+.BI outsecret " secret"
+Use
+.I secret
+to encrypt outgoing packets.
+.
+.SH "SEE ALSO"
+.IR dial (2),
+.IR ip (3)
+.br
+.IR "Robust Data Compression of Network Packets" ,
+Sean Dorward and Sean Quilan, Bell Labs, Lucent Technologies,
+.BR http://plan9.bell-labs.com/who/seanq/networkcomp.pdf .
+.SH SOURCE
+.B /sys/src/9/port/devsdp.c