.\"// $Id: rpslcheck.1,v 4.13 2006/06/08 15:16:26 shane Exp $ .\"// Copyright (c) 2001,2002 RIPE NCC .\"// .\"// All Rights Reserved .\"// .\"// Permission to use, copy, modify, and distribute this software and its .\"// documentation for any purpose and without fee is hereby granted, .\"// provided that the above copyright notice appear in all copies and that .\"// both that copyright notice and this permission notice appear in .\"// supporting documentation, and that the name of the author not be .\"// used in advertising or publicity pertaining to distribution of the .\"// software without specific, written prior permission. .\"// .\"// THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING .\"// ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS; IN NO EVENT SHALL .\"// AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY .\"// DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN .\"// AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\"// OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\"// .\"// .\"// Copyright (c) 1994 by the University of Southern California .\"// and/or the International Business Machines Corporation. .\"// All rights reserved. .\"// .\"// Permission to use, copy, modify, and distribute this software and .\"// its documentation in source and binary forms for lawful .\"// non-commercial purposes and without fee is hereby granted, provided .\"// that the above copyright notice appear in all copies and that both .\"// the copyright notice and this permission notice appear in supporting .\"// documentation, and that any documentation, advertising materials, .\"// and other materials related to such distribution and use acknowledge .\"// that the software was developed by the University of Southern .\"// California, Information Sciences Institute and/or the International .\"// Business Machines Corporation. The name of the USC or IBM may not .\"// be used to endorse or promote products derived from this software .\"// without specific prior written permission. .\"// .\"// NEITHER THE UNIVERSITY OF SOUTHERN CALIFORNIA NOR INTERNATIONAL .\"// BUSINESS MACHINES CORPORATION MAKES ANY REPRESENTATIONS ABOUT .\"// THE SUITABILITY OF THIS SOFTWARE FOR ANY PURPOSE. THIS SOFTWARE IS .\"// PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, .\"// INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF .\"// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND .\"// NON-INFRINGEMENT. .\"// .\"// IN NO EVENT SHALL USC, IBM, OR ANY OTHER CONTRIBUTOR BE LIABLE FOR ANY .\"// SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES, WHETHER IN CONTRACT, .\"// TORT, OR OTHER FORM OF ACTION, ARISING OUT OF OR IN CONNECTION WITH, .\"// THE USE OR PERFORMANCE OF THIS SOFTWARE. .\"// .\"// Questions concerning this software should be directed to .\"// irrtoolset@ripe.net. .\"// .\"// Author(s): Cengiz Alaettinoglu .\"// Katie Petrusha .\" .\" .TH rpslcheck 1 local .SH NAME rpslcheck .SH SYNOPSIS .B rpslcheck .RI [ flags ]\ [] .SH DESCRIPTION .PP rpslcheck syntax-checks any RPSL object. If the object passes rpslcheck's syntax check it will not cause errors to any of the tools in IRRToolSet, such as RtConfig. However, the syntax constraints of a particular IRR can differ from the ones in RPSL. .PP The input can be supplied via "-as " option (only AS-numbers). If no option is specified the object is expected as a standard input. The input can contain multiple objects. .PP Future versions of this tool will generate better error messages and do more than just syntax checking. .SH IRRToolSet COMMON OPTIONS .RS .IP -help Print summary of command-line options and abort. .IP "\-T [whois_query | whois_response | input | all]" Trace the argument. Useful for debugging. .IP "\-D " Print debugging messages of debug channel (if compiled with DEBUG defined). .IP "\-version" Print the version number and quit. .IP "\-h " Establish a whois connection to host . The default is whois.radb.net .IP "\-p " Establish a whois connection to port . The default is 43. .IP "\-protocol " Use the to connect to the IRR server. 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. .IP "\-s " Consider the sources specified in the comma separated . If an object is defined in multiple sources in , prcheck uses the definition first encountered in from left to right. .IP \-rusage Print resource usage upon completion. .IP "\-ignore_errors" Do not print error and warning messages due to communication to the database server or parsing policy objects. .IP "\-report_errors" Print error and warning messages due to communication to the database server or parsing policy objects. .RE .SH OTHER OPTIONS .RS .IP "\-as " Syntax check the aut-num object for . If this option is not supplied, stdin is parsed. .IP "\-echo" Print the aut-num object before matching. .RE .SH ENVIRONMENT VARIABLES .RS .IP IRR_HOST Specifies the IRR host to connect. .IP IRR_PORT Specifies the IRR port number to connect. .IP IRR_SOURCES Specifies the source list (comma separated) to consider. .RE .PP Command line options take precedence over environment variables. .SH EXAMPLES .PP .nf % ./rpslcheck Congratulations no errors were found in parsing AS226 % rpslcheck AS3130 Congratulations no errors were found in parsing AS3130 % rpslcheck AS86 Error: *it: AS701 192.41.177.6/32 192.41.177.249 (pref=MED) ANY Error: ^^^^^^^^^^^^^^ .fi .PP .SH ERROR AND WARNING MESSAGES Error: no object for AS .RS .PP Aut-num object for is not found in specified IRR for specified source. You could mistype the source, hostname or AS-number, or the object is truly non-existent. .PP .RE For more error descriptions, please see .B IRR-Errors manual page. .SH AUTHORS Cengiz Alaettinoglu Katie Petrusha