1Munin::Node::SNMPConfigU(s3e)r Contributed Perl DocumentaMtuinoinn::Node::SNMPConfig(3)
2
3
4

NAME

6       Munin::Node::SNMPConfig - Subroutines providing munin-node-configure's
7       SNMP scanning capabilities.
8

SYNOPSIS

10         my $snmp = Munin::Node::SNMPConfig->new(
11               community => 'secret',
12               version   => 1,
13         );
14         $snmp->probe_hosts(\%plugins);
15

SUBROUTINES

17       new(%arguments)
18           Constructor.  Valid arguments are:
19
20           hosts
21               The list of hosts to scan, in a format understood by
22               Munin::Node::Configure::HostEnumeration.  Required.
23
24           port
25               Port to connect to.  Default is 161.
26
27           version
28               The SNMP version to use.  Default is '2c'.
29
30           community
31               The community string to use for SNMP version 1 or 2c.  Default
32               is 'public'.
33
34           domain
35               The Transport Domain to use for exchanging SNMP messages. The
36               default is UDP/IPv4. Possible values: 'udp', 'udp4',
37               'udp/ipv4'; 'udp6', 'udp/ipv6'; 'tcp', 'tcp4', 'tcp/ipv4';
38               'tcp6', 'tcp/ipv6'.
39
40           username
41               The SNMPv3 username to use.
42
43           authpassword
44               SNMPv3 Authentication password.  Optional when encryption is
45               also enabled, in which case defaults to the privacy password
46               ("privpassword").  The password is sent encrypted (one way
47               hash) over the network.
48
49           authprotocol
50               SNMPv3 Authentication protocol.  One of 'md5' or 'sha'
51               (HMAC-MD5-96, RFC1321 and SHA-1/HMAC-SHA-96, NIST FIPS PIB 180,
52               RFC2264).  The default is 'md5'.
53
54           privpassword
55               SNMPv3 Privacy password to enable encryption.  An empty ('')
56               password is considered as no password and will not enable
57               encryption.
58
59               Privacy requires a v3privprotocol as well as a v3authprotocol
60               and a v3authpassword, but all of these are defaulted (to 'des',
61               'md5', and the v3privpassword value, respectively) and may
62               therefore be left unspecified.
63
64           privprotocol
65               If the v3privpassword is set this setting controls what kind of
66               encryption is used to achieve privacy in the session.  Only the
67               very weak 'des' encryption method is supported officially.  The
68               default is 'des'.
69
70               The implementing perl module (Net::SNMP) also supports '3des'
71               (CBC-3DES-EDE aka Triple-DES, NIST FIPS 46-3) as specified in
72               IETF draft-reeder-snmpv3-usm-3desede.  Whether or not this
73               works with any particular device, we do not know.
74
75       run_probes($plugins)
76           Connects to each host in turn, and checks which plugins it
77           supports, based on the OIDs they reported during snmpconf.  If all
78           the requirements are fulfilled, it will added to the corresponding
79           plugin's suggestions list.
80
81           $plugins should be a Munin::Node::Configure::PluginList object.
82
83
84
85perl v5.36.1                      2023-11-06        Munin::Node::SNMPConfig(3)
Impressum