Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
TORRUS_DEVDISCOVER(1)		     torrus		   TORRUS_DEVDISCOVER(1)

NAME
     devdiscover - Performs SNMP discovery and generates Torrus XML configura-
     tion file.

SYNOPSIS
     torrus devdiscover [--in=XMLFILE] [options...] [XMLFILES]

DESCRIPTION
     devdiscover performs SNMP discovery using the XMLFILE for the discovery in-
     structions. It generates a corresponding Torrus XML configuration file. See
     Torrus SNMP Discovery User Guide for details.

     The generic input file, or device discovery XML (DDX), may be generated by
     the genddx utility, and then edited and maintained manually.  Multiple in-
     put files may be specified by several instances of --in option, or simply
     as arguments.

     Input file name is searched in the current directory, and then in /usr/lo-
     cal/etc/torrus/discovery/.

OPTIONS
     --mkdir
	 Creates "data-dir" directories.

     --limit=REGEXP
	 Limits the discovery to the output files matching the regular expres-
	 sion REGEXP.

     --forcebundle
	 With this option enabled, "devdiscover" will write the bundle file even
	 if some of the bundle members were not created because of errors.

     --fallback=INTEGER
	 Requires --forcebundle. In case if an SNMP device is not available, the
	 bundle file will include an older version of the XML output file, pro-
	 vided that it exists and it is not older than the specified number of
	 days.

     --threads=INTEGER
	 If the threads are enabled in the local Perl, this option determins how
	 many parallel discovery threads are to be executed.  The discovery jobs
	 are distributed per output files, thus it makes sence to use threads
	 only when there are many output files defined in a single DDX file.

     --verbose
	 Prints extra information.

     --debug
	 Prints debugging information.

     --snmpdebug
	 Prints SNMP protocol details

FILES
     /usr/local/etc/torrus/conf/devdiscover-siteconfig.pl
	 devdiscover site configuration file.

SEE ALSO
     torrus(1), torrus_genddx(1)

NOTES
     See Torrus SNMP Discovery User Guide for more details at Torrus home page:
     http://torrus.org

AUTHOR
     Stanislav Sinyagin <ssinyagin@k-open.com>

torrus 2.09			   2026-08-30		   TORRUS_DEVDISCOVER(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=torrus_devdiscover&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help