blob: 9b1d6d14567260625186ab317c26c07f89dce45a [file] [log] [blame]
Gaurav Agrawal28920d82017-10-06 17:39:42 +05301submodule ietf-snmp-target {
2
3 belongs-to ietf-snmp {
4 prefix snmp;
5 }
6
7 import ietf-inet-types {
8 prefix inet;
9 }
10
11 include ietf-snmp-common;
12
13 organization
14 "IETF NETMOD (NETCONF Data Modeling Language) Working Group";
15
16 contact
17 "WG Web: <http://tools.ietf.org/wg/netmod/>
18 WG List: <mailto:netmod@ietf.org>
19
20 WG Chair: Thomas Nadeau
21 <mailto:tnadeau@lucidvision.com>
22
23 WG Chair: Juergen Schoenwaelder
24 <mailto:j.schoenwaelder@jacobs-university.de>
25
26 Editor: Martin Bjorklund
27 <mailto:mbj@tail-f.com>
28
29 Editor: Juergen Schoenwaelder
30 <mailto:j.schoenwaelder@jacobs-university.de>";
31
32 description
33 "This submodule contains a collection of YANG definitions
34 for configuring SNMP targets.
35
36 Copyright (c) 2014 IETF Trust and the persons identified as
37 authors of the code. All rights reserved.
38
39 Redistribution and use in source and binary forms, with or
40 without modification, is permitted pursuant to, and subject
41 to the license terms contained in, the Simplified BSD License
42 set forth in Section 4.c of the IETF Trust's Legal Provisions
43 Relating to IETF Documents
44 (http://trustee.ietf.org/license-info).
45 This version of this YANG module is part of RFC 7407; see
46 the RFC itself for full legal notices.";
47
48 reference
49 "RFC 3413: Simple Network Management Protocol (SNMP)
50 Applications";
51
52 revision 2014-12-10 {
53 description
54 "Initial revision.";
55 reference
56 "RFC 7407: A YANG Data Model for SNMP Configuration";
57 }
58
59 augment /snmp:snmp {
60
61 list target {
62 key name;
63 description
64 "List of targets.";
65 reference
66 "RFC 3413: Simple Network Management Protocol (SNMP)
67 Applications.
68 SNMP-TARGET-MIB.snmpTargetAddrTable";
69
70 leaf name {
71 type snmp:identifier;
72 description
73 "Identifies the target.";
74 reference
75 "RFC 3413: Simple Network Management Protocol (SNMP)
76 Applications.
77 SNMP-TARGET-MIB.snmpTargetAddrName";
78 }
79 choice transport {
80 mandatory true;
81 description
82 "Transport address of the target.
83
84 The snmpTargetAddrTDomain and snmpTargetAddrTAddress
85 objects are mapped to transport-specific YANG nodes. Each
86 transport is configured as a separate case in this
87 choice. Submodules providing configuration for additional
88 transports are expected to augment this choice.";
89
90 reference
91 "RFC 3413: Simple Network Management Protocol (SNMP)
92 Applications.
93 SNMP-TARGET-MIB.snmpTargetAddrTDomain
94 SNMP-TARGET-MIB.snmpTargetAddrTAddress";
95 case udp {
96 reference
97 "RFC 3417: Transport Mappings for the Simple Network
98 Management Protocol (SNMP).
99 SNMPv2-TM.snmpUDPDomain
100 RFC 3419: Textual Conventions for Transport Addresses.
101 TRANSPORT-ADDRESS-MIB.transportDomainUdpIpv4
102 TRANSPORT-ADDRESS-MIB.transportDomainUdpIpv4z
103 TRANSPORT-ADDRESS-MIB.transportDomainUdpIpv6
104 TRANSPORT-ADDRESS-MIB.transportDomainUdpIpv6z";
105 container udp {
106 leaf ip {
107 type inet:ip-address;
108 mandatory true;
109 reference
110 "RFC 3413: Simple Network Management Protocol (SNMP).
111 SNMP-TARGET-MIB.snmpTargetAddrTAddress";
112 }
113 leaf port {
114 type inet:port-number;
115 default 162;
116 description
117 "UDP port number.";
118 reference
119 "RFC 3413: Simple Network Management Protocol (SNMP).
120 SNMP-TARGET-MIB.snmpTargetAddrTAddress";
121 }
122 leaf prefix-length {
123 type uint8;
124 description
125 "The value of this leaf must match the value of
126 ../snmp:ip. If ../snmp:ip contains an IPv4 address,
127 this leaf must be less than or equal to 32. If it
128 contains an IPv6 address, it must be less than or
129 equal to 128.
130
131 Note that the prefix-length is currently only used
132 by the Community-based Security Model to filter
133 incoming messages. Furthermore, the prefix-length
134 filtering does not cover all possible filters
135 supported by the corresponding MIB object.";
136
137 reference
138 "RFC 3584: Coexistence between Version 1, Version 2,
139 and Version 3 of the Internet-standard
140 Network Management Framework.
141 SNMP-COMMUNITY-MIB.snmpTargetAddrTMask";
142 }
143 }
144 }
145 }
146 leaf-list tag {
147 type snmp:tag-value;
148 description
149 "List of tag values used to select target addresses.";
150 reference
151 "RFC 3413: Simple Network Management Protocol (SNMP).
152 Applications.
153 SNMP-TARGET-MIB.snmpTargetAddrTagList";
154 }
155 leaf timeout {
156 type uint32;
157 units "0.01 seconds";
158 default 1500;
159 description
160 "Needed only if this target can receive
161 InformRequest-PDUs.";
162 reference
163 "RFC 3413: Simple Network Management Protocol (SNMP).
164 Applications.
165 SNMP-TARGET-MIB.snmpTargetAddrTimeout";
166 }
167 leaf retries {
168 type uint8;
169 default 3;
170 description
171 "Needed only if this target can receive
172 InformRequest-PDUs.";
173 reference
174 "RFC 3413: Simple Network Management Protocol (SNMP).
175 Applications.
176 SNMP-TARGET-MIB.snmpTargetAddrRetryCount";
177 }
178 leaf target-params {
179 type snmp:identifier;
180 mandatory true;
181 reference
182 "RFC 3413: Simple Network Management Protocol (SNMP).
183 Applications.
184 SNMP-TARGET-MIB.snmpTargetAddrParams";
185 }
186 }
187
188 list target-params {
189 key name;
190 description
191 "List of target parameters.";
192 reference
193 "RFC 3413: Simple Network Management Protocol (SNMP).
194 Applications.
195 SNMP-TARGET-MIB.snmpTargetParamsTable";
196
197 leaf name {
198 type snmp:identifier;
199 }
200 choice params {
201 description
202 "This choice is augmented with case nodes containing
203 configuration parameters specific to the security model.";
204 }
205 }
206 }
207}