NAME

       rtrclient - rtr rpki client

SYNOPSIS

       rtrclient [-kph] SOCKETS...

SOCKETS

       tcp [-kpb bindaddr] HOST PORT
       ssh [-kpb bindaddr] HOST PORT USERNAME (PRIVATE_KEY|PASSWORD) [HOST_KEY]

DESCRIPTION

       rtrclient  connects  to  an  RPKI/RTR  cache server and prints prefix, origin AS, and router key updates.
       rtrclient 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.

       For tcp you must specify the HOST and PORT.

       For  ssh  you  must specify the HOST, PORT, USERNAME and a file containing the PRIVATE_KEY or a PASSWORD.
       By default the rtrclient will try to guess which of the two  was  entered.  If  you  want  to  explicitly
       specify  this  see  -w  and -s.  You may specify a file containing a list of HOST_KEYs, in the well known
       SSH_KNOWN_HOSTS file format. See sshd(8) for details.

OPTIONS

       -b bindaddr
           Set explicit bind address
       -h
           Print help message
       -k
           Print information about router key updates
       -p
           Print information about prefix and origin AS updates
       -s
           Print information about connection status updates
       -e
           Export ROAs after completing synchronisation and exit
       -t
           Select template for pfx export. May be a build in template (see -l)  or  a  file  path  to  a  custom
           template (see TEMPLATES)
       -l
           Print available templates and exit. Prints specified templated, when used with -t.
       -o
           Output file for export
       -w
           force ssh authentication information to be interpreted as a password
       -s
           force ssh authentication information to be interpreted as a private key

TEMPLATES

       Templates  can  be  used  to  export  ROA  information  in  a  custom  format.  They  are  written in the
       mustache(https://mustache.github.io/) templating language.

       A template should contain a section called roas which may contain the variables  prefix,  length,  maxlen
       and  origin.   The  content  of  this  section  is expanded for every entry in the ROA table. The special
       variable last is true for the last entry of the prefix table. See the json template for a usage example.

EXAMPLES

       Print prefix and origin AS updates from a tcp based server

              rtrclient tcp -k rpki.example.com 323

       Print prefix and router key updates from a ssh based server

              rtrclient ssh -k -p rpki.example.com 22 rtr-ssh ~/.ssh/id_rsa ~/.ssh/known_hosts

       Use multiple rtr server, print prefix updates for some

              rtrclient tcp -p rpki.example.com 323 tcp rpki2.example.com 323 ssh -p rpki.example.com 22 rtr-ssh ~/.ssh/id_rsa

                                                                                                    rtrclient(1)