Adding upstream version 0.8.0.upstream/0.8.0upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 111 insertions, 0 deletions

diff --git a/tools/rtrclient.1 b/tools/rtrclient.1
new file mode 100644
index 0000000..f9123a4
--- /dev/null
+++ b/tools/rtrclient.1
@@ -0,0 +1,111 @@
+.\"
+.\" This file is part of RTRlib.
+.\"
+.\" This file is subject to the terms and conditions of the MIT license.
+.\" See the file LICENSE in the top level directory for more details.
+.\"
+.\" Website: http://rtrlib.realmv6.org/
+.\"
+.TH "rtrclient" "1"
+.SH NAME
+rtrclient \- rtr rpki client
+.SH SYNOPSIS
+.B rtrclient
+[\fB\-kph\fR]
+.I SOCKETS\fR...
+.SH SOCKETS
+.B tcp
+[\fB\-kpb \fIbindaddr\fR]
+.IR HOST
+.IR PORT
+.br
+.B ssh
+[\fB\-kpb \fIbindaddr\fR]
+.IR HOST
+.IR PORT
+.IR USERNAME
+(\fIPRIVATE_KEY\fR|\fIPASSWORD\fR)
+[\fIHOST_KEY\fR]
+.SH DESCRIPTION
+\fBrtrclient\fR connects to an RPKI/RTR cache server and prints prefix, origin AS, and router key updates.
+\fBrtrclient\fR can use plain tcp or ssh transport to connect to an RPKI/RTR cache server.
+The amount is not limited and different transport types can be mixed arbitrarily.
+.LP
+For \fBtcp\fR you must specify the \fIHOST\fR and \fIPORT\fR.
+.LP
+For \fBssh\fR you must specify the \fIHOST\fR, \fIPORT\fR, \fIUSERNAME\fR and a file containing the \fIPRIVATE_KEY\fR or a \fIPASSWORD\fR.
+By default the rtrclient will try to guess which of the two was entered. If you want to explicitly specify this see \fB-w\fR and \fB-s\fR.
+You may specify a file containing a list of \fIHOST_KEY\fRs, in the well known
+.B SSH_KNOWN_HOSTS
+file format. See \fIsshd(8)\fR for details.
+.SH OPTIONS
+\fB-b \fIbindaddr\fR
+.RS 4
+Set explicit bind address
+.RE
+.B -h
+.RS 4
+Print help message
+.RE
+\fB-k\fR
+.RS 4
+Print information about router key updates
+.RE
+\fB-p\fR
+.RS 4
+Print information about prefix and origin AS updates
+.RE
+\fB-s\fR
+.RS 4
+Print information about connection status updates
+.RE
+\fB-e\fR
+.RS 4
+Export ROAs after completing synchronisation and exit
+.RE
+\fB-t\fR
+.RS 4
+Select template for pfx export. May be a build in template (see \fB-l\fR) or a file path to a custom template (see \fBTEMPLATES\fR)
+.RE
+\fB-l\fR
+.RS 4
+Print available templates and exit. Prints specified templated, when used with -t.
+.RE
+\fB-o\fR
+.RS 4
+Output file for export
+.RE
+\fB-w\fR
+.RS 4
+force ssh authentication information to be interpreted as a password
+.RE
+\fB-s\fR
+.RS 4
+force ssh authentication information to be interpreted as a private key
+.SH TEMPLATES
+Templates can be used to export ROA information in a custom format. They are written in the \fBmustache\fR(\fIhttps://mustache.github.io/\fR) templating language.
+
+A template should contain a section called \fBroas\fR which may contain the variables \fBprefix\fR, \fBlength\fR, \fBmaxlen\fR and \fBorigin\fR.
+The content of this section is expanded for every entry in the ROA table. The special variable \fBlast\fR is true for the last entry of the prefix table. See the json template for a usage example.
+.SH EXAMPLES
+Print prefix and origin AS updates from a tcp based server
+.PP
+.nf
+.RS
+rtrclient tcp -k rpki.example.com 323
+.RE
+.fi
+.PP
+Print prefix and router key updates from a ssh based server
+.PP
+.nf
+.RS
+rtrclient ssh -k -p rpki.example.com 22 rtr-ssh ~/.ssh/id_rsa ~/.ssh/known_hosts
+.RE
+.fi
+.PP
+Use multiple rtr server, print prefix updates for some
+.PP
+.nf
+.RS
+rtrclient tcp -p rpki.example.com 323 tcp rpki2.example.com 323 ssh -p rpki.example.com 22 rtr-ssh ~/.ssh/id_rsa