prpath
Section: User Commands (1)
Updated: local
Index
Return to Main Contents
NAME
prpath
SYNOPSIS
prpath
[options] [[<as-no>] <destination-specification>]
DESCRIPTION
prpath enumerates a list of paths between <as-no>
and <destination-specification>.
<destination-specification> can be an AS number,
an IP address or an address prefix.
If <as-no> is not specified it is deduced for your
system from the IP address of your host and IRR. If no
<destination-specification> is given prpath goes into a command loop where
it inputs <destination-specification> from stdin, one at a line.
prpath ignores error and warning messages due to communication to the
database server or parsing policy objects.
Please see -ignore_errors and -report_errors options below.
IRRToolSet COMMON OPTIONS
-
- -help
-
Print summary of command-line options and abort.
- -T [whois_query | whois_response | input | all]
-
Trace the argument. Useful for debugging.
- -D <integer>
-
Print debugging messages of debug channel <integer>
(if compiled with DEBUG defined).
- -version
-
Print the version number and quit.
- -h <host-name>
-
Establish a whois connection to host <host-name>.
The default is whois.radb.net.
- -p <port-no>
-
Establish a whois connection to port <port-no>.
The default is 43.
- -protocol <protocol>
-
Use the <protocol> to connect to the IRR server. <protocol> can be irrd(rawhoisd), ripe(bird), and ripe_perl. The default is irrd. The ripe_perl option should be used with the old ripe server.
- -s <source-list>
-
Consider the sources specified in the comma separated <source-list>.
If an object is defined in multiple sources in <source-list>,
prpath uses the definition first encountered in <source-list>
from left to right.
- -rusage
-
Print resource usage upon completion.
- -prompt <string>
-
Set the interactive prompt to <string>.
- -ignore_errors
-
Do not print error and warning messages due to communication to the
database server or parsing policy objects.
- -report_errors
-
Print error and warning messages due to communication to the
database server or parsing policy objects.
OTHER OPTIONS
-
- -as <as-no>
-
Use AS <as-no> as a source AS.
- -mpl <integer>
-
If the shortest path between the source and the destination is N hops,
report all paths that are shorter than N + <integer>.
ENVIRONMENT VARIABLES
-
- IRR_HOST
-
Specifies the IRR host to connect.
- IRR_PORT
-
Specifies the IRR port number to connect.
- IRR_SOURCES
-
Specifies the source list (comma separated) to consider.
Command line options take precedence over environment variables.
EXAMPLES
% ./prpath AS2914 193.85.128.0/24
Route:
NLRI: 193.85.128.0/24
Origins: AS2819
Communities: COMM_NSFNET
AS2819 AS286 AS2914
ERROR AND WARNING MESSAGES
Warning: No autnum record found for AS
-
The AS specified in nonexistent in the specified Database for specified soure list
Unable to lookup destination AS
-
If you do not specify which AS is destination AS, prpath tries to query IRR to get originating autnum. If route is non-existent, you get this error.
If you specify <ipv4_prefix> as <destination>, prpath will try to find origin of this prefix. If you specify <ipv4_address> as <destination>, prpath will try to find origin of prefix <ipv4_address>/32.
Unknown protocol!
-
Connection to IRR server failed. This can be caused by various reasons, see Errors manpage, IRR Communication errors.
For more error descriptions, please see
Errors manual page.
AUTHORS
Cengiz Alaettinoglu <cengiz@isi.edu>
Katie Petrusha <katie@ripe.net>
ACKNOWLEDGEMENTS
This is enhanced version of RIPE's prpath tool.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- IRRToolSet COMMON OPTIONS
-
- OTHER OPTIONS
-
- ENVIRONMENT VARIABLES
-
- EXAMPLES
-
- ERROR AND WARNING MESSAGES
-
- AUTHORS
-
- ACKNOWLEDGEMENTS
-
This document was created by
man2html,
using the manual pages.
Time: 09:48:54 GMT, July 03, 2002