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
       configuration file.

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

DESCRIPTION
       devdiscover performs SNMP discovery using the XMLFILE for the discovery
       instructions. 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	input 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/local/etc/torrus/discovery/.

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

       --limit=REGEXP
	   Limits  the	discovery  to  the  output  files matching the regular
	   expression 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,  provided  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			  2025-04-18		 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+14.3.quarterly>

home | help