mirror of
https://gitlab.nic.cz/labs/bird.git
synced 2024-12-22 09:41:54 +00:00
SNMP: User documentation, grammar improvements
This commit is contained in:
Vojtech Vilimek
parent
6e95cc521e
commit
305f873c6e
349
doc/bird.sgml
349
doc/bird.sgml
@ -548,7 +548,7 @@ include "tablename.conf";;
|
||||
<cf><m/name/</cf>). You can learn more about configuring protocols in
|
||||
their own chapters. When <cf>from <m/name2/</cf> expression is used,
|
||||
initial protocol options are taken from protocol or template
|
||||
<cf><m/name2/</cf> You can run more than one instance of most protocols
|
||||
<cf><m/name2/</cf>. You can run more than one instance of most protocols
|
||||
(like RIP or BGP). By default, no instances are configured.
|
||||
|
||||
<tag><label id="opt-template">template rip|ospf|bgp|<m/.../ [<m/name/ [from <m/name2/]] { <m>protocol options</m> }</tag>
|
||||
@ -5432,16 +5432,355 @@ protocol static {
|
||||
<label id="snmp">
|
||||
|
||||
<p>The Simple Network Management Protocol is protocol for collecting and
|
||||
managing network devices.
|
||||
managing network devices. Managed information is divided into so called MIBs --
|
||||
Management Information Bases. Each MIB describe information and semantics it
|
||||
provides. The SNMP architecture is very flexible, some MIB are standartized by
|
||||
IETF, others published by independent third parties.
|
||||
|
||||
<p>The BIRD SNMP support is achieved by an additional component -- a SNMP deamon
|
||||
acting as AgentX master agent. Currently we only support TCP connection.
|
||||
<p>The BIRD SNMP support is achieved by an additional component -- a SNMP daemon
|
||||
with AgentX protocol support. The SNMP daemon acts as an AgentX master agent and
|
||||
deal with user authentication, access control and managing MIB regions in OID
|
||||
tree. BIRD instance acts as AgentX subagent, register configurated MIBs and
|
||||
provides queried data. The AgentX communication protocol between master agent
|
||||
and subagents does not consider security what so ever. It is therefore upon the
|
||||
user to use the AgentX in a secure way. This can be achieved either by using
|
||||
Unix Domain sockets on same host or by using secure tunnel. Note that following
|
||||
sections containing pieces of Net-SNMP configuraiton are only meant as a helper
|
||||
for cold start, or as a pointer what to search for, not as full reference. For
|
||||
full reference consult the original manpages.
|
||||
|
||||
<p>An example of SNMP protocol configuration.
|
||||
<sect1>SNMP Daemon configuration
|
||||
<p>We recommend you to use Net-SNMP implementation of daemon and utilities, quick
|
||||
guide below assume that. Net-SNMP implementation is quite popular so you should
|
||||
find it's packages inside your distribution package manager.
|
||||
|
||||
<sect2>Example snmpd configuration
|
||||
<p>
|
||||
<code>
|
||||
# file /etc/snmp/snmpd.conf
|
||||
# minimal SNMPv3 config
|
||||
agentx master
|
||||
agentaddress udp:192.0.2.64
|
||||
agentXSocket tcp:198.51.100.2
|
||||
|
||||
createUser snmp_name MD5 example_pass
|
||||
rwuser snmp_name noauth
|
||||
</code>
|
||||
|
||||
<sect2>AgentX Enabling
|
||||
<p>
|
||||
<code>
|
||||
# File /etc/snmp/snmpd.conf
|
||||
agentx master
|
||||
agentXSocket [unix:|tcp:|tcp6:]<address>[,...]
|
||||
agentXPerms <sockperms> [<dirperms> [<user>|<uid> [<group>|<gid>]]]
|
||||
agentaddress [<trasport-type>:]<trasport-address>[,...]
|
||||
</code>
|
||||
|
||||
<descrip>
|
||||
<tag><label id="snmpd-agentx-master">agentx master</tag>
|
||||
SNMP daemon will enable AgentX functionality and start listening on
|
||||
configured AgentX address.
|
||||
|
||||
|
||||
<tag><label id="snmpd-agentxsocket">agentXSocket
|
||||
[unix:|tcp:|tcp6:]<m/trasport-address/[,...] </tag>
|
||||
|
||||
Define address to listen for AgentX subagent. Use one of <cf>unix:,
|
||||
tcp:, tcp6:</cf> transport type. Other transport type are not supported
|
||||
by BIRD and also not mentioned in AgentX RFC, see <rfc id="2741">.
|
||||
Default: Unix Domain socket <file>/var/run/agentx/master</file>.
|
||||
|
||||
|
||||
<tag><label id="snmpd-agentxperms">agentXPerms <m/sockperms/
|
||||
[<m/dirperms/ [<m/user/|<m/uid/ [<m/group/|<m/gid/]]]</tag>
|
||||
|
||||
Define common permissions for AgentX listening Unix Domain sockets. Both
|
||||
<m/sockperms/ and <m/dirperms/ must be octal digits like for
|
||||
<m/chmod(1)/. Option <m/user/ is string and <m/uid/ is numeric user id.
|
||||
Same for <m/group/ and <m/gid/.
|
||||
|
||||
|
||||
<tag><label id="snmpd-agentaddress">agentaddress
|
||||
[<m/transport-type/:]<m/trasport-address/[,...]</tag>
|
||||
|
||||
Define address, or list of addresses, to listen for SNMP requests (send
|
||||
for example by <it/snmpwalk(1)/). You most likely want <m/trasport-type/ to
|
||||
be one from <cf/udp:/, <cf/udp6:/, <cf/tcp:/, <cf/tcp6:/, <cf/unix:/,
|
||||
<cf/ssh:/ but Net-SNMP support even more transport types.
|
||||
Value <m/transport-address/ define address, Net-SNMP should be able to
|
||||
derive <m/trasport-type/ from <m/transport-address/. Beware that for
|
||||
Unix Domain socket derivation to work, the path must start with /. Also
|
||||
note that the working directory of snmpd daemon is filesystem root.
|
||||
Default: UDP on all IPv4 interfaces on port 161. (e.g.
|
||||
<cf>agentaddress udp6:localhost:161</cf>,
|
||||
<cf>agentaddress tcp:192.0.2.1</cf>,
|
||||
<cf>agentaddress /var/run/mydir/agentx_master</cf>,
|
||||
<cf>agentaddress localhost,/p/u1,/p/u2</cf>).
|
||||
</descrip>
|
||||
|
||||
<sect2>Configure access
|
||||
<p>You can use the SNMPv3 USM module for user authorization, or use simpler older
|
||||
version SNMPv1/SNMPv2c with authentication by community. Other means of
|
||||
authorization are also possible (e.g. external Kerberos) but out of scope of
|
||||
this guide.
|
||||
|
||||
<sect3>SNMPv3 USM
|
||||
<p>
|
||||
<code>
|
||||
# file /etc/snmp/snmpd.conf (continuation)
|
||||
createUser [-e <engineid>] <username> (MD5|SHA|SHA-512|SHA-384|SHA-256|SHA-224) <authpassphrase> [DES|AES] [<pass>]
|
||||
rwuser [-s secmodel] <user> [noauth|auth|priv [<oid> | -V <view> [<context>]]]
|
||||
rouser [-s secmodel] <user> [noauth|auth|priv [<oid> | -V <view> [<context>]]]
|
||||
</code>
|
||||
|
||||
<descrip>
|
||||
<tag><label id="snmpd-createuser">createUser [-e <m/engineid/]
|
||||
<m/username/ (MD5|SHA|SHA-512|SHA-384|SHA-256|SHA-224)
|
||||
<m/authpassphrase/ [DES|AES] [<m/privpassphrase/] </tag>
|
||||
|
||||
Create user with in order specified username, authentication type,
|
||||
authentication password, private protocol and private password. If the
|
||||
private password is not used, it fallbacks to same password as the
|
||||
authentication one.
|
||||
|
||||
|
||||
<tag><label id="snmpd-rwuser">rwuser [-s <m/secmodel/] <m/user/
|
||||
[noauth|auth|priv [<m/oid/ | -V <m/view/ [<m/context/]]]</tag>
|
||||
|
||||
Give user with selected security level read-write permissions
|
||||
to the defined <m/oid/ OID subtree or <m/view/ view,
|
||||
see <ref id="snmp_view" name="view definition">. Security level
|
||||
<cf>noauth</cf> does not require authentication, <cf>auth</cf> requires
|
||||
authentication and <cf>priv</cf> authentication with enforced message
|
||||
encryption. View is a Net-SNMP construct to name and group set of OID
|
||||
subtrees with optional context. Contexts are currently not supported by
|
||||
BIRD.
|
||||
|
||||
|
||||
<tag><label id="snmpd-rouser">rouser [-s <m/secmodel/] <m/user/
|
||||
[noauth|auth|priv [<m/oid/ | -V <m/view/ [<m/context/]]]</tag>
|
||||
|
||||
Same as <cf>rwuser</cf> but only with read permissions.
|
||||
</descrip>
|
||||
|
||||
<sect3>SNMPv1/SNMPv2c community-based
|
||||
<p>
|
||||
<code>
|
||||
# file /etc/snmp/snmpd.conf (continuation)
|
||||
rwcommunity <community> [<source> [<oid> | -V <view> [<context>]]]
|
||||
rocommunity <community> [<source> [<oid> | -V <view> [<context>]]]
|
||||
rwcommunity6 <community> [<source> [<oid> | -V <view> [<context>]]]
|
||||
rocommunity6 <community> [<source> [<oid> | -V <view> [<context>]]]
|
||||
view <vname> (include|exclude) <oid> [<mask>]
|
||||
</code>
|
||||
|
||||
<descrip>
|
||||
<tag><label id="snmpd-rwcommunity">rwcommunity <m/community/ [<m/source/
|
||||
[<m/oid/ | -V <m/view/ [<m/context/]]]</tag>
|
||||
|
||||
Create a community with read-write permissions named <m/community/.
|
||||
Option <m/source/ is used to restrict senders of request, use
|
||||
<cf>"default"</cf> as a placeholder in doubts. You can also restrict
|
||||
accessible regions of OID tree to OID subtree of <m/oid/ or named
|
||||
<m/view/, otherwise the access is unrestricted to the whole OID tree.
|
||||
Contexts are currently not supported by BIRD.
|
||||
|
||||
|
||||
<tag><label id="snmpd-rocommunity">rocommunity <m/community/> [<m/source/
|
||||
[<m/oid/ | -V <m/view/ [<m/context/]]]</tag>
|
||||
|
||||
Same as <cf>rwcommunity</cf> but only with read permissions.
|
||||
|
||||
|
||||
<tag><label id="snmpd-rwcommunity6">rwcommunity6 <m/community/
|
||||
[<m/source/ [<m/oid/ | -V <m/view/ [<m/context/]]] </tag>
|
||||
|
||||
Is <cf>rwcommunity</cf> for packet received using IPv6.
|
||||
|
||||
<tag><label id="snmpd-rocommunity6">rocommunity6 <m/community/
|
||||
[<m/source/ [<m/oid/ | -V <m/view/ [<m/context/]]]</tag>
|
||||
|
||||
Same as <cf>rwcommunity6</cf> but only with read permissions.
|
||||
|
||||
<tag><label id="snmpd-view">view <m/vname/ (include|exclude) <m/oid/ [<m/mask/]</tag>
|
||||
Define a named grouping of OIDs. May be used multiple times with same
|
||||
<m/vname/.
|
||||
</descrip>
|
||||
|
||||
|
||||
<sect1>BIRD SNMP configuration
|
||||
<p>
|
||||
<code>
|
||||
protocol snmp [<name>] {
|
||||
agentx master address (default|<unix_path>|<ip> [port <port>]);
|
||||
subagent description <text>;
|
||||
source address <ip>;
|
||||
registration priority <num>;
|
||||
message timeout <time>;
|
||||
start delay time <time>;
|
||||
verbose <switch>;
|
||||
|
||||
mib bgp4 {
|
||||
local as <num>;
|
||||
local router id <ip4>;
|
||||
peer <name>;
|
||||
};
|
||||
}
|
||||
</code>
|
||||
|
||||
<descrip>
|
||||
<tag><label id="snmp-master">agentx master address
|
||||
(default|<m/unix_path/|<m/ip/ [port <m/port/])</tag>
|
||||
|
||||
Address of AgentX master. Default is <cf>"/var/run/agentx/master"</cf>.
|
||||
String option <m/unix_path/ select transport over Unix Domain sockets
|
||||
with selected path address. Option <m/ip/ select transport over TCP.
|
||||
|
||||
Default port for TCP transmission is 705.
|
||||
|
||||
<tag><label id="snmp-descr">subagent description <m/text/</tag>
|
||||
Short string describing the subagent. Default: "bird".
|
||||
|
||||
<tag><label id="snmp-src-addr">source address <m/ip/</tag>
|
||||
For TCP based AgentX communication sets socket's source address.
|
||||
|
||||
<tag><label id="snmp-reg-priority">registration priority <m/number/</tag>
|
||||
Set AgentX registration priority for all MIBs. Lower values have higher
|
||||
priority. Valid interval 0-255. Default: 127.
|
||||
|
||||
<tag><label id="snmp-msg-timeout">message timeout <m/time/ s|ms</tag>
|
||||
Set timeout for all AgentX messages. With 1 second granurality with
|
||||
values from interval 0-255. Default: 15 s.
|
||||
|
||||
<tag><label id="snmp-start-delay">start delay time <m/time/ s|ms</tag>
|
||||
Wait <m/time/ before sending first packet after protocol start.
|
||||
|
||||
<tag><label id="snmp-verbose">verbose <m/switch/</tag>
|
||||
Enable logging of events connected to AgentX master pinging. Default:
|
||||
verbose logging is disabled.
|
||||
|
||||
<tag><label id="snmp-bgp4-mib">mib bgp4</tag>
|
||||
Enable BGP4-MIB which is defined in <rfc id="4273">. The support is
|
||||
limited to BGP4-MIB::bgpPeerTable; the BGP4-MIB::bgpRcvdPathAttrTable,
|
||||
BGP4-MIB::bgpPathAttrTable, traps and notifications are not supported.
|
||||
|
||||
<tag><label id="snmp-bgp4-local-as">local as <m/number/</tag>
|
||||
Specify Local As for BGP4 MIB (BGP4-MIB::bgpLocalAs.0). This option is
|
||||
required.
|
||||
|
||||
<tag><label id="snmp-bgp4-router-id">local router id <m/IPv4 address/</tag>
|
||||
Specify Router ID for BGP4 MIB (BGP4-MIB::bgpLocalIdentifier.0). This
|
||||
option is required.
|
||||
|
||||
<tag><label id="snmp-bgp4-peer">peer <m/name/</tag>
|
||||
Make information about BGP protocol <m/name/ accessible. This protocol
|
||||
must over IPv4 (this limitation is introduced by the BGP4-MIB). May
|
||||
be used multiple times.
|
||||
</descrip>
|
||||
|
||||
<sect2>An example SNMP protocol configuration
|
||||
<p>
|
||||
<code>
|
||||
protocol bgp ibgp1 {
|
||||
local as 2;
|
||||
router id 192.0.2.1;
|
||||
/* ... */
|
||||
}
|
||||
|
||||
protocol bgp ibgp2 {
|
||||
local as 4;
|
||||
router id 192.0.2.128;
|
||||
/* ... */
|
||||
}
|
||||
|
||||
protocol snmp snmp1 {
|
||||
agentx master address 198.51.100.2;
|
||||
|
||||
mib bgp4 {
|
||||
local as 2;
|
||||
local router id 192.0.2.1;
|
||||
peer ibgp1;
|
||||
peer ibgp2;
|
||||
}
|
||||
}
|
||||
</code>
|
||||
|
||||
<sect1>Accessing MIB data
|
||||
<p>To save some keystrokes and to avoid putting passwords in shell history, you
|
||||
could use common configuration file for all Net-SNMP command line utilities.
|
||||
Here is an example:
|
||||
|
||||
<code>
|
||||
# file ~/.snmp/snmp.conf
|
||||
defVersion (1|2c|3)
|
||||
defCommunity <community>
|
||||
defSecurityName <username>
|
||||
defAuthType (MD5|SHA|SHA-512|SHA-384|SHA-256|SHA-224)
|
||||
defAuthPassphrase <authpass>
|
||||
defPrivType (DES|AES)
|
||||
defPrivPassphrase <privpass>
|
||||
clientaddr [<transport-type>:]<transport-address>
|
||||
</code>
|
||||
|
||||
<descrip>
|
||||
<tag><label id="snmpcmd-version">defVersion (1|2c|3)</tag>
|
||||
Select version of SNMP packets, must follow
|
||||
<file>/etc/snmp/snmpd.conf</file>. Use only if community/view based
|
||||
configuration.
|
||||
|
||||
<tag><label id="snmpcmd-community">defCommunity <m/community/</tag>
|
||||
Use by default given community. Use only for SNMP version 1 and 2c as
|
||||
community as kind of a username for these versions.
|
||||
|
||||
<tag><label id="snmpcmd-authtype">defAuthType
|
||||
(MD5|SHA|SHA-512|SHA-384|SHA-256|SHA-224)</tag>
|
||||
|
||||
Select authentication type.
|
||||
|
||||
|
||||
<tag><label id="snmpcmd-authpass">defAuthPassphrase <m/authpass/</tag>
|
||||
Set authentication password.
|
||||
|
||||
<tag><label id="snmpcmd-privtype">defPrivType (DES|AES)</tag>
|
||||
Select private protocols.
|
||||
|
||||
<tag><label id="snmpcmd-privpass">defPrivPassphrase <m/privpass/</tag>
|
||||
Set private password used for encryption.
|
||||
|
||||
|
||||
<tag><label id="snmpcmd-clientaddr">clientaddr
|
||||
[<m/transport-type/:]<m/transport-address/</tag>
|
||||
|
||||
SNMP command line utility equivalent to <cf>agentaddress</cf> daemon
|
||||
option.
|
||||
</descrip>
|
||||
|
||||
<p>For further information, see <it/snmp.conf(5)/.
|
||||
|
||||
<p>Example of configuration for Net-SNMP utils.
|
||||
<code>
|
||||
# SNMPv3
|
||||
defVersion 3
|
||||
defSecurityName snmp_name
|
||||
defSecurityLevel noAuthNoPriv
|
||||
defAuthType MD5
|
||||
defAuthPassphrase example_pass
|
||||
</code>
|
||||
|
||||
<code>
|
||||
$ # <snmputil> <master-address> <oid>[ <oid> [...]]
|
||||
$ snmpget 192.0.2.64 BGP4-MIB::bgpLocalAs.0
|
||||
$ snmpgetnext 192.0.2.64 BGP4-MIB::bgpPeerState BGP4-MIB::bgpPeerAdminStatus
|
||||
$ snmpwalk 192.0.2.64 BGP4-MIB::bgp
|
||||
$ snmptable 192.0.2.64 BGP4-MIB::bgpPeerTable
|
||||
</code>
|
||||
|
||||
<p>We recommend you to check manpages for Net-SNMP utilities mentioned above,
|
||||
such as <it/snmp_config(5)/, <it/snmpd.conf(5)/, <it/snmpd(8)/,
|
||||
<it/snmp.conf(5)/, <it/snmpcmds(1)/, <it/snmpget(1)/, <it/snmpgetnext(1)/,
|
||||
<it/snmpbulkget(1)/, <it/snmpwalk(1)/, <it/snmptable(1)/.
|
||||
|
||||
<chapt>Conclusions
|
||||
<label id="conclusion">
|
||||
|
||||
|
||||
5
doc/snmp.conf.example
Normal file
5
doc/snmp.conf.example
Normal file
@ -0,0 +1,5 @@
|
||||
defSecurityName snmp_name
|
||||
defAuthType MD5
|
||||
defAuthPassphrase test_pass
|
||||
defSecurityLevel noAuthNoPriv
|
||||
defVersion 3
|
||||
18
doc/snmpd.conf.example
Normal file
18
doc/snmpd.conf.example
Normal file
@ -0,0 +1,18 @@
|
||||
#
|
||||
# snmpd configuration file
|
||||
#
|
||||
|
||||
# SNMP connection address
|
||||
agentaddress 127.0.0.1
|
||||
|
||||
# enable AgentX protocol
|
||||
master agentx
|
||||
|
||||
# AgentX connection address
|
||||
agentXSocket tcp:localhost:705
|
||||
|
||||
|
||||
# Create example user
|
||||
createUser snmp_name MD5 test_pass
|
||||
rwuser snmp_name noauth
|
||||
|
||||
@ -749,12 +749,14 @@ bgp4_next_peer(struct mib_walk_state *state, struct snmp_pdu *c)
|
||||
void
|
||||
snmp_bgp4_show_info(struct snmp_proto *p)
|
||||
{
|
||||
/* TODO: Use special code (not -1006) for printing MIB, or BGP4-MIB data?
|
||||
* don't forget add it into doc/reply_code */
|
||||
cli_msg(-1006, " BGP4-MIB");
|
||||
cli_msg(-1006, " Local AS %u", p->bgp4_local_as);
|
||||
cli_msg(-1006, " Local router id %R", p->bgp4_local_id);
|
||||
cli_msg(-1006, " BGP peers");
|
||||
|
||||
if (p->bgp_hash.count == 0)
|
||||
if (p->bgp_hash.count == 0 || !snmp_is_active(p))
|
||||
{
|
||||
cli_msg(-1006, " <no peers available>");
|
||||
}
|
||||
@ -767,7 +769,7 @@ snmp_bgp4_show_info(struct snmp_proto *p)
|
||||
cli_msg(-1006, " Protocol name: %s", peer->bgp_proto->p.name);
|
||||
cli_msg(-1006, " Remote IPv4 address: %I4", peer->peer_ip);
|
||||
cli_msg(-1006, " Remote router id %R", peer->bgp_proto->remote_id);
|
||||
// TODO: add local ip addr
|
||||
/* TODO: add peer connection local ip */
|
||||
}
|
||||
HASH_WALK_END;
|
||||
}
|
||||
|
||||
@ -31,6 +31,7 @@ snmp_proto:
|
||||
|
||||
snmp_proto_item:
|
||||
proto_item
|
||||
| bgp4_mib
|
||||
| SOURCE ADDRESS ipa { SNMP_CFG->local_ip = $3; }
|
||||
| AGENTX MASTER ADDRESS DEFAULT {
|
||||
if (SNMP_CFG->trans_type != SNMP_TRANS_DEFAULT)
|
||||
@ -47,15 +48,20 @@ snmp_proto_item:
|
||||
}
|
||||
| AGENTX MASTER ADDRESS ipa {
|
||||
if (SNMP_CFG->trans_type != SNMP_TRANS_DEFAULT)
|
||||
cf_error("Duplicit option remote address");
|
||||
cf_error("Duplicit option agentx master address");
|
||||
|
||||
SNMP_CFG->master_ip = $4;
|
||||
SNMP_CFG->trans_type = SNMP_TRANS_TCP;
|
||||
}
|
||||
| AGENTX MASTER PORT expr {
|
||||
/* TODO better grammar name (maybe: AX MSTR ADDRESS ipa / ADDRESS ipa [PORT] expr) */
|
||||
if (($4 < 1) || ($4 > 65535)) cf_error("Invalid port number");
|
||||
SNMP_CFG->master_port = $4;
|
||||
| AGENTX MASTER ADDRESS ipa PORT expr {
|
||||
if (SNMP_CFG->trans_type != SNMP_TRANS_DEFAULT)
|
||||
cf_error("Duplicit option agentx master address");
|
||||
|
||||
if (($6 < 1) || ($6 > UINT16_MAX)) cf_error("Invalid port number");
|
||||
|
||||
SNMP_CFG->master_ip = $4;
|
||||
SNMP_CFG->trans_type = SNMP_TRANS_TCP;
|
||||
SNMP_CFG->master_port = $6;
|
||||
}
|
||||
| SUBAGENT DESCRIPTION text {
|
||||
if (strlen($3) > UINT16_MAX - 1) cf_error("Description is too long");
|
||||
@ -89,8 +95,8 @@ snmp_proto_item:
|
||||
;
|
||||
|
||||
bgp4_mib:
|
||||
BGP4 MIB '{' bgp4_mib_items '}'
|
||||
| MIB BGP4 '{' bgp4_mib_items '}'
|
||||
MIB BGP4 '{' bgp4_mib_items '}'
|
||||
| BGP4 MIB '{' bgp4_mib_items '}'
|
||||
;
|
||||
|
||||
bgp4_mib_items:
|
||||
@ -136,7 +142,6 @@ bgp4_mib_peer: PEER symbol
|
||||
snmp_proto_opts:
|
||||
/* empty */
|
||||
| snmp_proto_opts snmp_proto_item ';'
|
||||
| snmp_proto_opts bgp4_mib
|
||||
;
|
||||
|
||||
snmp_proto_start: proto_start SNMP
|
||||
@ -151,8 +156,8 @@ snmp_proto_start: proto_start SNMP
|
||||
SNMP_CFG->master_port = SNMP_PORT;
|
||||
SNMP_CFG->master_path = agentx_master_addr;
|
||||
SNMP_CFG->trans_type = SNMP_TRANS_DEFAULT;
|
||||
SNMP_CFG->bgp4_local_id = 0;
|
||||
SNMP_CFG->bgp4_local_as = 0;
|
||||
SNMP_CFG->bgp4_local_id = 0;
|
||||
SNMP_CFG->verbose = 0;
|
||||
|
||||
SNMP_CFG->description = "bird";
|
||||
|
||||
@ -11,10 +11,11 @@
|
||||
* DOC: Simple Network Management Protocol
|
||||
*
|
||||
* The SNMP protocol is divided into several parts: |snmp.c| which implements
|
||||
* the BIRD intergration, |subagent.c| contains functions for creating and
|
||||
* parsing packets, |bgp4_mib.c| takes care of the bgp MIB subtree of standard
|
||||
* BGP4-MIB and |snmp_utils.c| which is collections of helper functions for
|
||||
* working with OIDs, VarBinds.
|
||||
* integration with BIRD core, |subagent.c| provides AgentX subagent behaviour
|
||||
* as well as functions for creating and parsing packets. In file |mib_tree.c|
|
||||
* is implemented OID prefix tree for storing supported MIBs. File |bgp4_mib.c|
|
||||
* implements parts of BGP4-MIB, |snmp_utils.c| is collection of helper
|
||||
* functions for whole SNMP protocol.
|
||||
*
|
||||
* Althrough called SNMP the BIRD does not implement SNMP directly but acts as
|
||||
* an AgentX subagent. AgentX subagent connects to AgentX master agent that
|
||||
@ -40,6 +41,9 @@
|
||||
*
|
||||
*
|
||||
*
|
||||
*/
|
||||
|
||||
/*
|
||||
* SNMP State Machine
|
||||
*
|
||||
* States with main transitions
|
||||
|
||||
@ -390,8 +390,8 @@ snmp_put_fbyte(byte *buf, u8 data)
|
||||
|
||||
/**
|
||||
* snmp_oid_compare - find the lexicographical order relation between @left and @right
|
||||
* @left: left object id relation operant
|
||||
* @right: right object id relation operant
|
||||
* @left: left object id relation operand
|
||||
* @right: right object id relation operand
|
||||
*
|
||||
* both @left and @right has to be non-blank.
|
||||
* function returns 0 if left == right,
|
||||
|
||||
Loading…
Reference in New Issue
Block a user