dist-hook::
echo $(VERSION) >$(distdir)/RELEASE
+## Manual page preamble.
+EXTRA_DIST += defs.man.in
+CLEANFILES += defs.man
+
## Additional build tools.
EXTRA_DIST += config/confsubst
CLEANFILES += tripectl.1
EXTRA_DIST += tripectl.1.in
-tripectl.1: tripectl.1.in Makefile
- $(confsubst) $(srcdir)/tripectl.1.in >$@.new $(SUBSTITUTIONS) && \
- mv $@.new $@
-
###----- That's all, folks --------------------------------------------------
.\" -*-nroff-*-
-.de VS
-.sp 1
-.RS
-.nf
-.ft B
-..
-.de VE
-.ft R
-.fi
-.RE
-.sp 1
-..
-.ie t \{\
-. if \n(.g \{\
-. fam P
-. \}
-.\}
+.\".
+.\" Manual for the administration client
+.\"
+.\" (c) 2008 Straylight/Edgeware
+.\"
+.
+.\"----- Licensing notice ---------------------------------------------------
+.\"
+.\" This file is part of Trivial IP Encryption (TrIPE).
+.\"
+.\" TrIPE is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 2 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" TrIPE is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with TrIPE; if not, write to the Free Software Foundation,
+.\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+.
+.\"--------------------------------------------------------------------------
+.so ../defs.man.in \" @@@PRE@@@
+.
+.\"--------------------------------------------------------------------------
.TH tripectl 1 "19 February 2001" "Straylight/Edgeware" "TrIPE: Trivial IP Encryption"
-.SH NAME
+.
+.\"--------------------------------------------------------------------------
+.SH "NAME"
+.
tripectl \- simple client for TrIPE
-.SH SYNOPSIS
+.
+.\"--------------------------------------------------------------------------
+.SH "SYNOPSIS"
+.
.B tripectl
.RB [ \-w ]
.RB [ \-\fIoptions ]
.IR program ]
.RB [ \-S
.IB arg , arg ,\fR...]
-.SH DESCRIPTION
+.
+.\"--------------------------------------------------------------------------
+.SH "DESCRIPTION"
+.
The
.B tripectl
program is a simple client which can be used, either interactively or
taken from the environment variable
.BR TRIPEDIR ;
if that's not defined either, a default default of
-.B "@configdir@"
+.B "*(/c"
is used.
.TP
.BI "\-a, \-\-admin-socket=" socket
environment variable
.BR TRIPESOCK ;
if that's not defined either, a default default of
-.B "@socketdir@/tripesock"
+.B "*(/s/tripesock"
is used.
.TP
.BI "\-P, \-\-pidfile=" pidfile
.PP
It's possible to communicate interactively with a newly-started server,
or to give it a command and quit, but this is seldom useful.
+.
+.\"--------------------------------------------------------------------------
.SH "SEE ALSO"
+.
.BR tripe\-admin (5),
.BR tripe (8).
.PP
.IR "The Trivial IP Encryption Protocol" ,
.IR "The Wrestlers Protocol" .
+.
+.\"--------------------------------------------------------------------------
.SH "AUTHOR"
+.
Mark Wooding, <mdw@distorted.org.uk>
+.
+.\"----- That's all, folks --------------------------------------------------
--- /dev/null
+.\" -*-nroff-*-
+.\"
+.\" Common definitions for TrIPE manpages
+.\"
+.\" (c) 2008 Straylight/Edgeware
+.\"
+.
+.\"----- Licensing notice ---------------------------------------------------
+.\"
+.\" This file is part of Trivial IP Encryption (TrIPE).
+.\"
+.\" TrIPE is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 2 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" TrIPE is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with TrIPE; if not, write to the Free Software Foundation,
+.\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+.
+.\"--------------------------------------------------------------------------
+.\" Preliminary definitions.
+.
+.\" String definitions and font selection.
+.ie t \{\
+. ds o \(bu
+. ds ss \s8\u
+. ds se \d\s0
+. if \n(.g \{\
+. fam P
+. \}
+.\}
+.el \{\
+. ds o o
+. ds ss ^
+. ds se
+.\}
+.
+.ds /c @configdir@
+.ds /s @socketdir@
+.
+.\" .hP TEXT -- start an indented paragraph with TEXT hanging off to the left
+.de hP
+.IP
+\h'-\w'\fB\\$1\ \fP'u'\fB\\$1\ \fP\c
+..
+.
+.\" .SP -- equivalent to .TP, but indicates item should be summarized
+.de SP
+.TP
+..
+.
+.\" .VS ... .VE -- present a code example
+.de VS
+.sp 1
+.RS
+.nf
+.ft B
+..
+.de VE
+.ft R
+.fi
+.RE
+.sp 1
+..
+.
+.\"----- That's all, folks --------------------------------------------------
## Manual pages.
man_MANS += tripe-keys.8 tripe-keys.conf.5
-EXTRA_DIST += tripe-keys.8 tripe-keys.conf.5
+CLEANFILES += tripe-keys.8 tripe-keys.conf.5
+EXTRA_DIST += tripe-keys.8.in tripe-keys.conf.5.in
## Examples.
EXTRA_DIST += tripe-keys.master
.\" -*-nroff-*-
.\".
-.de hP
-.IP
-\h'-\w'\fB\\$1\ \fP'u'\fB\\$1\ \fP\c
-..
-.de VS
-.sp 1
-.RS
-.nf
-.ft B
-..
-.de VE
-.ft R
-.fi
-.RE
-.sp 1
-..
-.ie t \{\
-. ds o \(bu
-. ds ss \s8\u
-. ds se \d\s0
-. if \n(.g \{\
-. fam P
-. \}
-.\}
-.el \{\
-. ds o o
-. ds ss ^
-. ds se
-.\}
+.\" Manual for the key-management tool
+.\"
+.\" (c) 2008 Straylight/Edgeware
+.\"
+.
+.\"----- Licensing notice ---------------------------------------------------
+.\"
+.\" This file is part of Trivial IP Encryption (TrIPE).
+.\"
+.\" TrIPE is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 2 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" TrIPE is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with TrIPE; if not, write to the Free Software Foundation,
+.\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+.
+.\"--------------------------------------------------------------------------
+.so ../defs.man.in \" @@@PRE@@@
+.
+.\"--------------------------------------------------------------------------
.TH tripe-keys 8 "14 September 2005" "Straylight/Edgeware" "TrIPE: Trivial IP Encryption"
+.
+.\"--------------------------------------------------------------------------
.SH "NAME"
+.
tripe-keys \- simple centralized key management for tripe
+.
+.\"--------------------------------------------------------------------------
.SH "SYNOPSIS"
+.
.B tripe-keys
.I operation
.IP "Operations supported:"
.B "rebuild"
.br
.B "clean"
+.
+.\"--------------------------------------------------------------------------
.SH "DESCRIPTION"
+.
The
.B tripe-keys
script implements a very simple, centralized key management system for
and their associated
.B .old
files.
+.
+.\"--------------------------------------------------------------------------
.SH "SEE ALSO"
+.
.BR key (1),
.BR tripe\-keys.conf (5),
.BR tripe (8).
+.
+.\"--------------------------------------------------------------------------
.SH "AUTHOR"
+.
Mark Wooding, <mdw@distorted.org.uk>
+.
+.\"----- That's all, folks --------------------------------------------------
.\" -*-nroff-*-
.\".
-.de hP
-.IP
-\h'-\w'\fB\\$1\ \fP'u'\fB\\$1\ \fP\c
-..
-.de VS
-.sp 1
-.RS
-.nf
-.ft B
-..
-.de VE
-.ft R
-.fi
-.RE
-.sp 1
-..
-.ie t \{\
-. ds o \(bu
-. ds ss \s8\u
-. ds se \d\s0
-. if \n(.g \{\
-. fam P
-. \}
-.\}
-.el \{\
-. ds o o
-. ds ss ^
-. ds se
-.\}
+.\" Manual for the key-management configuration files
+.\"
+.\" (c) 2008 Straylight/Edgeware
+.\"
+.
+.\"----- Licensing notice ---------------------------------------------------
+.\"
+.\" This file is part of Trivial IP Encryption (TrIPE).
+.\"
+.\" TrIPE is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 2 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" TrIPE is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with TrIPE; if not, write to the Free Software Foundation,
+.\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+.
+.\"--------------------------------------------------------------------------
+.so ../defs.man.in \" @@@PRE@@@
+.
+.\"--------------------------------------------------------------------------
.TH tripe-keys.conf 5 "14 September 2005" "Straylight/Edgeware" "TrIPE: Trivial IP Encryption"
+.
+.\"--------------------------------------------------------------------------
.SH "NAME"
+.
tripe-keys.conf \- configuration file format for tripe-keys
+.
+.\"--------------------------------------------------------------------------
.SH "DESCRIPTION"
+.
The
.B tripe-keys.master
or
.I conf-file
Filename for local repository configuration file. Default is
.IB basedir /tripe-keys.conf \fR.
+.
+.\"--------------------------------------------------------------------------
.SH "SEE ALSO"
+.
.BR tripe (8),
.BR tripe\-keys (8).
+.
+.\"--------------------------------------------------------------------------
.SH "AUTHOR"
+.
Mark Wooding, <mdw@distorted.org.uk>
+.
+.\"----- That's all, folks --------------------------------------------------
--- /dev/null
+#! /bin/sed -f
+
+/^\.TH/ {
+ i\
+.\\" -*-nroff-*-\
+.\\".\
+.\\" ###DESCRIPTION###\
+.\\"\
+.\\" (c) 2008 Straylight/Edgeware\
+.\\"\
+.\
+.\\"----- Licensing notice ---------------------------------------------------\
+.\\"\
+.\\" This file is part of Trivial IP Encryption (TrIPE).\
+.\\"\
+.\\" TrIPE is free software; you can redistribute it and/or modify\
+.\\" it under the terms of the GNU General Public License as published by\
+.\\" the Free Software Foundation; either version 2 of the License, or\
+.\\" (at your option) any later version.\
+.\\"\
+.\\" TrIPE is distributed in the hope that it will be useful,\
+.\\" but WITHOUT ANY WARRANTY; without even the implied warranty of\
+.\\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\
+.\\" GNU General Public License for more details.\
+.\\"\
+.\\" You should have received a copy of the GNU General Public License\
+.\\" along with TrIPE; if not, write to the Free Software Foundation,\
+.\\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.\
+.\
+.\\"--------------------------------------------------------------------------\
+.so ../defs.man.in \\"@@@PRE@@@\
+.\
+.\\"--------------------------------------------------------------------------
+ p
+}
+1,/^\.TH/ d
+/^\.SH/i\
+.\
+.\\"--------------------------------------------------------------------------
+/^\.SH/ a\
+.
+/^\.S[SH]/ {
+ /"/ ! s:^\(...\) \(.*\):\1 "\2":
+}
+$a\
+.\
+.\\"----- That's all, folks --------------------------------------------------
+s:@configdir@:\*(/c:g
+s:@socketdir@:\*(/s:g
CLEANFILES += tripemon.1
EXTRA_DIST += tripemon.1.in
-tripemon.1: tripemon.1.in Makefile
- $(confsubst) $(srcdir)/tripemon.1.in >$@.new $(SUBSTITUTIONS) && \
- mv $@.new $@
-
-
###----- That's all, folks --------------------------------------------------
.\" -*-nroff-*-
.\".
-.de hP
-.IP
-\h'-\w'\fB\\$1\ \fP'u'\fB\\$1\ \fP\c
-..
-.de VS
-.sp 1
-.RS
-.nf
-.ft B
-..
-.de VE
-.ft R
-.fi
-.RE
-.sp 1
-..
-.ie t \{\
-. ds o \(bu
-. ds ss \s8\u
-. ds se \d\s0
-. if \n(.g \{\
-. fam P
-. \}
-.\}
-.el \{\
-. ds o o
-. ds ss ^
-. ds se
-.\}
+.\" Manual for the graphical monitor
+.\"
+.\" (c) 2008 Straylight/Edgeware
+.\"
+.
+.\"----- Licensing notice ---------------------------------------------------
+.\"
+.\" This file is part of Trivial IP Encryption (TrIPE).
+.\"
+.\" TrIPE is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 2 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" TrIPE is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with TrIPE; if not, write to the Free Software Foundation,
+.\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+.
+.\"--------------------------------------------------------------------------
+.so ../defs.man.in \" @@@PRE@@@
+.
+.\"--------------------------------------------------------------------------
.TH tripemon 1 "4 October 2005" "Straylight/Edgeware" "TrIPE: Trivial IP Encryption"
+.
+.\"--------------------------------------------------------------------------
.SH "NAME"
+.
tripemon \- graphical monitor for tripe
+.
+.\"--------------------------------------------------------------------------
.SH "SYNOPSIS"
+.
.B tripemon
.RB [ \-d
.IR dir ]
.RB [ \-a
.IR socket ]
+.
+.\"--------------------------------------------------------------------------
.SH "DESCRIPTION"
+.
The
.B tripemon
program is a fairly simple graphical monitor program for TrIPE. It's
taken from the environment variable
.BR TRIPEDIR ;
if that's not defined either, a default default of
-.B @configdir@
+.B *(/c
is used.
.TP
.BI "\-a, \-\-admin-socket=" socket
The default socket is given by the environment variable
.BR TRIPESOCK ;
if that's not defined either, a default default of
-.B @socketdir@/tripesock
+.B *(/s/tripesock
is used.
+.
+.\"--------------------------------------------------------------------------
.SH "SEE ALSO"
+.
.BR tripectl (1),
.BR tripe\-admin (5),
.BR tripe (8).
+.
+.\"--------------------------------------------------------------------------
.SH "AUTHOR"
+.
Mark Wooding, <mdw@distorted.org.uk>
+.
+.\"----- That's all, folks --------------------------------------------------
pkstream_SOURCES = pkstream.c
man_MANS += pkstream.1
-EXTRA_DIST += pkstream.1
+CLEANFILES += pkstream.1
+EXTRA_DIST += pkstream.1.in
###----- That's all, folks --------------------------------------------------
.\" -*-nroff-*-
.\".
-.de hP
-.IP
-\h'-\w'\fB\\$1\ \fP'u'\fB\\$1\ \fP\c
-..
-.de VS
-.sp 1
-.RS
-.nf
-.ft B
-..
-.de VE
-.ft R
-.fi
-.RE
-.sp 1
-..
-.ie t \{\
-. ds o \(bu
-. ds ss \s8\u
-. ds se \d\s0
-. if \n(.g \{\
-. fam P
-. \}
-.\}
-.el \{\
-. ds o o
-. ds ss ^
-. ds se
-.\}
+.\" Manual for the simple packet streamer
+.\"
+.\" (c) 2008 Straylight/Edgeware
+.\"
+.
+.\"----- Licensing notice ---------------------------------------------------
+.\"
+.\" This file is part of Trivial IP Encryption (TrIPE).
+.\"
+.\" TrIPE is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 2 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" TrIPE is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with TrIPE; if not, write to the Free Software Foundation,
+.\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+.
+.\"--------------------------------------------------------------------------
+.so ../defs.man.in \" @@@PRE@@@
+.
+.\"--------------------------------------------------------------------------
.TH pkstream 1 "23 April 2003" "Straylight/Edgeware" "TrIPE: Trivial IP Encryption"
+.
+.\"--------------------------------------------------------------------------
.SH "NAME"
+.
pkstream \- forward UDP packets over streams
+.
+.\"--------------------------------------------------------------------------
.SH "SYNOPSIS"
+.
.B pkstream
.RB [ \-l
.IR port ]
.IB addr : port
.IB addr : port
+.
+.\"--------------------------------------------------------------------------
.SH "DESCRIPTION"
+.
The
.B pkstream
program forwards UDP packets over some kind of reliable stream. It
.I port
and forward packets over the TCP connection rather than using stdin and
stdout.
+.
+.\"--------------------------------------------------------------------------
.SH "Protocol"
+.
The stream protocol is very simple. Each packet is preceded by a
two-octet length field in network byte order. The length is number of
octets in the following packet (i.e., it does
include the length field itself). There is no padding between packets.
The only way a stream can be invalid is if it stops in the middle of a
packet.
+.
+.\"--------------------------------------------------------------------------
.SH "BUGS"
+.
The code hasn't been audited. It may contain security bugs. If you
find one, please inform the author
.IR immediately .
+.
+.\"--------------------------------------------------------------------------
.SH "SEE ALSO"
+.
.BR fw (1),
.BR ssh (1),
.BR stunnel (1),
.BR tripe (8).
+.
+.\"--------------------------------------------------------------------------
.SH "AUTHOR"
+.
Mark Wooding, <mdw@distorted.org.uk>
+.
+.\"----- That's all, folks --------------------------------------------------
tripe_mitm_SOURCES = tripe-mitm.c
man_MANS += tripe-mitm.8
-EXTRA_DIST += tripe-mitm.8
+CLEANFILES += tripe-mitm.8
+EXTRA_DIST += tripe-mitm.8.in
###----- That's all, folks --------------------------------------------------
.\" -*-nroff-*-
.\".
-.de hP
-.IP
-\h'-\w'\fB\\$1\ \fP'u'\fB\\$1\ \fP\c
-..
-.de VS
-.sp 1
-.RS
-.nf
-.ft B
-..
-.de VE
-.ft R
-.fi
-.RE
-.sp 1
-..
-.ie t \{\
-. ds o \(bu
-. ds ss \s8\u
-. ds se \d\s0
-. if \n(.g \{\
-. fam P
-. \}
-.\}
-.el \{\
-. ds o o
-. ds ss ^
-. ds se
-.\}
+.\" Manual for the malicious proxy
+.\"
+.\" (c) 2008 Straylight/Edgeware
+.\"
+.
+.\"----- Licensing notice ---------------------------------------------------
+.\"
+.\" This file is part of Trivial IP Encryption (TrIPE).
+.\"
+.\" TrIPE is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 2 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" TrIPE is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with TrIPE; if not, write to the Free Software Foundation,
+.\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+.
+.\"--------------------------------------------------------------------------
+.so ../defs.man.in \" @@@PRE@@@
+.
+.\"--------------------------------------------------------------------------
.TH tripe-mitm 8 "14 October 2003" "Straylight/Edgeware" "TrIPE: Trivial IP Encryption"
+.
+.\"--------------------------------------------------------------------------
.SH "NAME"
+.
tripe-mitm \- malicious proxy for TrIPE
+.
+.\"--------------------------------------------------------------------------
.SH "SYNOPSIS"
+.
.B tripe-mitm
.RB [ \-k
.IR keyring ]
.IR directive ...
+.
+.\"--------------------------------------------------------------------------
.SH "DESCRIPTION"
+.
The
.B tripe-mitm
program is a
again with a 1 in
.I p-corrupt
probability.
+.
+.\"--------------------------------------------------------------------------
.SH "BUGS"
+.
The parser is currently very primitive, and error handling is rather
poor. There are lots of pointless restrictions which wouldn't take very
long to fix. The program generally lacks polish. The program doesn't
understand the TrIPE protocol to a sufficient extent to really attack it
properly.
+.
+.\"--------------------------------------------------------------------------
.SH "SEE ALSO"
+.
.BR tripe (8).
+.
+.\"--------------------------------------------------------------------------
.SH "AUTHOR"
+.
Mark Wooding, <mdw@distorted.org.uk>
+.
+.\"----- That's all, folks --------------------------------------------------
CLEANFILES += tripe.8
EXTRA_DIST += tripe.8.in
-tripe.8: tripe.8.in Makefile
- $(confsubst) $(srcdir)/tripe.8.in >$@.new $(SUBSTITUTIONS) && \
- mv $@.new $@
-
## The admin protocol manual page.
man_MANS += tripe-admin.5
-EXTRA_DIST += tripe-admin.5.in make-summary
CLEANFILES += tripe-admin.5
+EXTRA_DIST += tripe-admin.5.in make-summary
-tripe-admin.5: tripe-admin.5.in make-summary
- awk -f $(srcdir)/make-summary <$(srcdir)/tripe-admin.5.in >$@.new
+tripe-admin.5: tripe-admin.5.in make-summary $(mandefs)
+ awk -f $(srcdir)/make-summary <$(srcdir)/tripe-admin.5.in >$@.tmp
+ $(mansubst) $@.tmp >$@.new
+ rm -f $@.tmp
mv $@.new $@
###----- That's all, folks --------------------------------------------------
/^\.\\\"\+sep$/ { sep = 1; }
/^\.\\\"\-sep$/ { sep = 0; }
/^\.\\\"\-opts$/ { opts = 0; lines[n] = lines[n] ".RE\n"; }
-/^\.SP/ { print; getline; lines[n] = lines[n] $0 "\n"; }
+/^\.SP/ { print ".TP"; getline; lines[n] = lines[n] $0 "\n"; }
/^\.TP/ { if (opts) { print; getline; lines[n] = lines[n] $0 "\n"; } }
/^\.SS/ { if (sep) lines[n] = lines[n] ".PP\n"; }
.\" -*-nroff-*-
+.\".
+.\" Manual for the administration protocol
+.\"
+.\" (c) 2008 Straylight/Edgeware
.\"
-.ie t \{\
-. if \n(.g \{\
-. fam P
-. \}
-.\}
.
-.de SP
-.TP
-..
+.\"----- Licensing notice ---------------------------------------------------
+.\"
+.\" This file is part of Trivial IP Encryption (TrIPE).
+.\"
+.\" TrIPE is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 2 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" TrIPE is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with TrIPE; if not, write to the Free Software Foundation,
+.\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+.
+.\"--------------------------------------------------------------------------
+.so ../defs.man.in \" @@@PRE@@@
+.
+.\"--------------------------------------------------------------------------
.TH tripe-admin 5 "18 February 2001" "Straylight/Edgeware" "TrIPE: Trivial IP Encryption"
-.SH NAME
+.
+.\"--------------------------------------------------------------------------
+.SH "NAME"
+.
tripe-admin \- administrator commands for TrIPE
-.SH DESCRIPTION
+.
+.\"--------------------------------------------------------------------------
+.SH "DESCRIPTION"
+.
This manual page describes the administration interface provided by the
.BR tripe (8)
daemon.
.PP
Lowercase key letters control individual message types. Uppercase key
letters control collections of message types.
+.
+.\"--------------------------------------------------------------------------
.SH "COMMAND REFERENCE"
+.
.\"* 10 Commands
The commands provided are:
.SP
Issues a
.B USER
warning to all interested administration clients.
+.
+.\"--------------------------------------------------------------------------
.SH "ERROR MESSAGES"
+.
.\"* 20 Error messages (FAIL codes)
The following
.B FAIL
.I tag
is not the tag for any outstanding background job. It may have just
finished.
+.
+.\"--------------------------------------------------------------------------
.SH "NOTIFICATIONS"
+.
.\"* 30 Notification broadcasts (NOTE codes)
The following notifications are sent to clients who request them.
.SP
An administration client issued a notification using the
.B NOTIFY
command.
+.
+.\"--------------------------------------------------------------------------
.SH "WARNINGS"
+.
.\"* 40 Warning broadcasts (WARN codes)
.\"+sep
There are many possible warnings. They are categorized according to
.BI "USER " tokens\fR...
An administration client issued a warning.
.\"-sep
+.
+.\"--------------------------------------------------------------------------
.SH "SUMMARY"
+.
.SS "Command responses"
.nf
.BI "BGDETACH " tag
.B OK
.fi
.\"= summary
+.
+.\"--------------------------------------------------------------------------
.SH "SEE ALSO"
+.
.BR tripectl (1),
.BR tripe (8).
.PP
.IR "The Trivial IP Encryption Protocol" .
+.
+.\"--------------------------------------------------------------------------
.SH "AUTHOR"
+.
Mark Wooding, <mdw@distorted.org.uk>
+.
+.\"----- That's all, folks --------------------------------------------------
.\" -*-nroff-*-
.\".
-.de hP
-.IP
-\h'-\w'\fB\\$1\ \fP'u'\fB\\$1\ \fP\c
-..
-.de VS
-.sp 1
-.RS
-.nf
-.ft B
-..
-.de VE
-.ft R
-.fi
-.RE
-.sp 1
-..
-.ie t \{\
-. ds o \(bu
-. ds ss \s8\u
-. ds se \d\s0
-. if \n(.g \{\
-. fam P
-. \}
-.\}
-.el \{\
-. ds o o
-. ds ss ^
-. ds se
-.\}
+.\" Manual for the server
+.\"
+.\" (c) 2008 Straylight/Edgeware
+.\"
+.
+.\"----- Licensing notice ---------------------------------------------------
+.\"
+.\" This file is part of Trivial IP Encryption (TrIPE).
+.\"
+.\" TrIPE is free software; you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation; either version 2 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" TrIPE is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with TrIPE; if not, write to the Free Software Foundation,
+.\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+.
+.\"--------------------------------------------------------------------------
+.so ../defs.man.in \" @@@PRE@@@
+.
+.\"--------------------------------------------------------------------------
.TH tripe 8 "10 February 2001" "Straylight/Edgeware" "TrIPE: Trivial IP Encryption"
+.
+.\"--------------------------------------------------------------------------
.SH "NAME"
+.
tripe \- a simple VPN daemon
+.
+.\"--------------------------------------------------------------------------
.SH "SYNOPSIS"
+.
.B tripe
.RB [ \-D ]
.RB [ \-d
.IR pub-keyring ]
.RB [ \-t
.IR key-tag ]
+.
+.\"--------------------------------------------------------------------------
.SH "DESCRIPTION"
+.
The
.B tripe
program is a server which can provide strong IP-level encryption and
It sets the directory named by the
.B TRIPEDIR
environment variable (or
-.B "@configdir@"
+.B "*(/c"
if the variable is unset) as the current directory.
.hP 2.
It acquires a UDP socket with an arbitrary kernel-selected port number.
the environment variable
.BR TRIPEDIR ;
if that's not specified, a default default of
-.B "@configdir@"
+.B "*(/c"
is used. Give a current directory of
.B .
if you don't want it to change directory at all.
environment variable
.BR TRIPESOCK ;
if that's not set either, then a default default of
-.B "@socketdir@/tripesock"
+.B "*(/s/tripesock"
is used instead.
.TP
.BI "\-T, \-\-trace=" trace-opts
all in lower-case. The name of the protocol it uses is `TrIPE', with
four capital letters and one lower-case. The name stands for `Trivial
IP Encryption'.
+.
+.\"--------------------------------------------------------------------------
.SH "BUGS"
+.
The code hasn't been audited. It may contain security bugs. If you
find one, please inform the author
.IR immediately .
+.
+.\"--------------------------------------------------------------------------
.SH "SEE ALSO"
+.
.BR key (1),
.BR tripectl (1),
.BR tripe\-admin (5).
.PP
.IR "The Trivial IP Encryption Protocol" ,
.IR "The Wrestlers Protocol" .
+.
+.\"--------------------------------------------------------------------------
.SH "AUTHOR"
+.
Mark Wooding, <mdw@distorted.org.uk>
+.
+.\"----- That's all, folks --------------------------------------------------
pidfile=$(pidfile) logfile=$(logfile) \
PYTHON=$(PYTHON)
+###--------------------------------------------------------------------------
+### Manpage substitutions.
+
+SUFFIXES += .1 .1.in
+SUFFIXES += .5 .5.in
+SUFFIXES += .7 .7.in
+SUFFIXES += .8 .8.in
+
+mandefs = $(top_builddir)/defs.man
+
+mansubst = sed \
+ -e '/@@@PRE@@@/ {' \
+ -e 'r$(mandefs)' \
+ -e 'd' \
+ -e '}'
+
+.1.in.1 .5.in.5 .7.in.7 .8.in.8: $(mandefs)
+ $(mansubst) $< >$@.new && mv $@.new $@
+
+$(mandefs): $(top_srcdir)/defs.man.in Makefile
+ $(confsubst) $(top_srcdir)/defs.man.in >$@.new $(SUBSTITUTIONS)
+ sed '/^\.$$/ d; /^\.\\"/ d' $@.new >$@.new2
+ rm -f $@.new
+ mv $@.new2 $@
+
###----- That's all, folks --------------------------------------------------