Blob Blame History Raw
<?xml version="1.0" encoding="UTF-8"?>
<submodule name="ietf-snmp-community"
           xmlns="urn:ietf:params:xml:ns:yang:yin:1"
           xmlns:snmp="urn:ietf:params:xml:ns:yang:ietf-snmp"
           xmlns:nacm="urn:ietf:params:xml:ns:yang:ietf-netconf-acm">
  <belongs-to module="ietf-snmp">
    <prefix value="snmp"/>
  </belongs-to>
  <import module="ietf-netconf-acm">
    <prefix value="nacm"/>
  </import>
  <include module="ietf-snmp-common"/>
  <include module="ietf-snmp-target"/>
  <include module="ietf-snmp-proxy"/>
  <organization>
    <text>IETF NETMOD (NETCONF Data Modeling Language) Working Group</text>
  </organization>
  <contact>
    <text>WG Web:   &lt;http://tools.ietf.org/wg/netmod/&gt;
WG List:  &lt;mailto:netmod@ietf.org&gt;

WG Chair: Thomas Nadeau
          &lt;mailto:tnadeau@lucidvision.com&gt;

WG Chair: Juergen Schoenwaelder
          &lt;mailto:j.schoenwaelder@jacobs-university.de&gt;
Editor:   Martin Bjorklund
          &lt;mailto:mbj@tail-f.com&gt;

Editor:   Juergen Schoenwaelder
          &lt;mailto:j.schoenwaelder@jacobs-university.de&gt;</text>
  </contact>
  <description>
    <text>This submodule contains a collection of YANG definitions
for configuring community-based SNMP.

Copyright (c) 2014 IETF Trust and the persons identified as
authors of the code.  All rights reserved.

Redistribution and use in source and binary forms, with or
without modification, is permitted pursuant to, and subject
to the license terms contained in, the Simplified BSD License
set forth in Section 4.c of the IETF Trust's Legal Provisions
Relating to IETF Documents
(http://trustee.ietf.org/license-info).

This version of this YANG module is part of RFC 7407; see
the RFC itself for full legal notices.</text>
  </description>
  <reference>
    <text>RFC 3584: Coexistence between Version 1, Version 2, and
  Version 3 of the Internet-standard Network
  Management Framework</text>
  </reference>
  <revision date="2015-01-23">
    <description>
        <text>When expression of augment '/snmp:snmp/snmp:target' with
       non-existing leaves removed.</text>
    </description>
    <reference>
      <text>RFC 7407 Errata</text>
    </reference>
  </revision>
  <revision date="2014-12-10">
    <description>
      <text>Initial revision.</text>
    </description>
    <reference>
      <text>RFC 7407: A YANG Data Model for SNMP Configuration</text>
    </reference>
  </revision>
  <augment target-node="/snmp:snmp">
    <list name="community">
      <key value="index"/>
      <description>
        <text>List of communities.</text>
      </description>
      <reference>
        <text>RFC 3584: Coexistence between Version 1, Version 2,
  and Version 3 of the Internet-standard
  Network Management Framework.
  SNMP-COMMUNITY-MIB.snmpCommunityTable</text>
      </reference>
      <leaf name="index">
        <type name="snmp:identifier"/>
        <description>
          <text>Index into the community list.</text>
        </description>
        <reference>
          <text>RFC 3584: Coexistence between Version 1, Version 2,
  and Version 3 of the Internet-standard
  Network Management Framework.
  SNMP-COMMUNITY-MIB.snmpCommunityIndex</text>
        </reference>
      </leaf>
      <choice name="name">
        <nacm:default-deny-all/>
        <description>
          <text>The community name, specified as either a string or
a binary value.  The binary name is used when the
community name contains characters that are not legal
in a string.

If not set, the value of 'security-name' is operationally
used as the snmpCommunityName.</text>
        </description>
        <reference>
          <text>RFC 3584: Coexistence between Version 1, Version 2,
  and Version 3 of the Internet-standard
  Network Management Framework.
  SNMP-COMMUNITY-MIB.snmpCommunityName</text>
        </reference>
        <leaf name="text-name">
          <type name="string"/>
          <description>
            <text>A community name that can be represented as a
YANG string.</text>
          </description>
        </leaf>
        <leaf name="binary-name">
          <type name="binary"/>
          <description>
            <text>A community name represented as a binary value.</text>
          </description>
        </leaf>
      </choice>
      <leaf name="security-name">
        <type name="snmp:security-name"/>
        <mandatory value="true"/>
        <nacm:default-deny-all/>
        <description>
          <text>The snmpCommunitySecurityName of this entry.</text>
        </description>
        <reference>
          <text>RFC 3584: Coexistence between Version 1, Version 2,
  and Version 3 of the Internet-standard
  Network Management Framework.
  SNMP-COMMUNITY-MIB.snmpCommunitySecurityName</text>
        </reference>
      </leaf>
      <leaf name="engine-id">
        <if-feature name="snmp:proxy"/>
        <type name="snmp:engine-id"/>
        <description>
          <text>If not set, the value of the local SNMP engine is
operationally used by the device.</text>
        </description>
        <reference>
          <text>RFC 3584: Coexistence between Version 1, Version 2,
  and Version 3 of the Internet-standard
  Network Management Framework.
  SNMP-COMMUNITY-MIB.snmpCommunityContextEngineID</text>
        </reference>
      </leaf>
      <leaf name="context">
        <type name="snmp:context-name"/>
        <default value=""/>
        <description>
          <text>The context in which management information is accessed
when using the community string specified by this entry.</text>
        </description>
        <reference>
          <text>RFC 3584: Coexistence between Version 1, Version 2,
  and Version 3 of the Internet-standard
  Network Management Framework.
  SNMP-COMMUNITY-MIB.snmpCommunityContextName</text>
        </reference>
      </leaf>
      <leaf name="target-tag">
        <type name="snmp:tag-value"/>
        <description>
          <text>Used to limit access for this community to the specified
targets.

Implementations MAY restrict the values of this leaf
to be one of the available values of /snmp/target/tag in
a valid configuration.</text>
        </description>
        <reference>
          <text>RFC 3584: Coexistence between Version 1, Version 2,
  and Version 3 of the Internet-standard
  Network Management Framework.
  SNMP-COMMUNITY-MIB.snmpCommunityTransportTag</text>
        </reference>
      </leaf>
    </list>
  </augment>
  <grouping name="v1-target-params">
    <container name="v1">
      <description>
        <text>SNMPv1 parameters type.
Represents snmpTargetParamsMPModel '0',
snmpTargetParamsSecurityModel '1', and
snmpTargetParamsSecurityLevel 'noAuthNoPriv'.</text>
      </description>
      <leaf name="security-name">
        <type name="snmp:security-name"/>
        <mandatory value="true"/>
        <description>
          <text>Implementations MAY restrict the values of this leaf
to be one of the available values of
/snmp/community/security-name in a valid configuration.</text>
        </description>
        <reference>
          <text>RFC 3413: Simple Network Management Protocol (SNMP).
  Applications.
  SNMP-TARGET-MIB.snmpTargetParamsSecurityName</text>
        </reference>
      </leaf>
    </container>
  </grouping>
  <grouping name="v2c-target-params">
    <container name="v2c">
      <description>
        <text>SNMPv2 community parameters type.
Represents snmpTargetParamsMPModel '1',
snmpTargetParamsSecurityModel '2', and
snmpTargetParamsSecurityLevel 'noAuthNoPriv'.</text>
      </description>
      <leaf name="security-name">
        <type name="snmp:security-name"/>
        <mandatory value="true"/>
        <description>
          <text>Implementations MAY restrict the values of this leaf
to be one of the available values of
/snmp/community/security-name in a valid configuration.</text>
        </description>
        <reference>
          <text>RFC 3413: Simple Network Management Protocol (SNMP).
  Applications.
  SNMP-TARGET-MIB.snmpTargetParamsSecurityName</text>
        </reference>
      </leaf>
    </container>
  </grouping>
  <augment target-node="/snmp:snmp/snmp:target-params/snmp:params">
    <case name="v1">
      <uses name="v1-target-params"/>
    </case>
    <case name="v2c">
      <uses name="v2c-target-params"/>
    </case>
  </augment>
  <augment target-node="/snmp:snmp/snmp:target">
    <leaf name="mms">
      <type name="union">
        <type name="enumeration">
          <enum name="unknown">
            <value value="0"/>
          </enum>
        </type>
        <type name="int32">
          <range value="484..max"/>
        </type>
      </type>
      <default value="484"/>
      <description>
        <text>The maximum message size.</text>
      </description>
      <reference>
        <text>RFC 3584: Coexistence between Version 1, Version 2,
  and Version 3 of the Internet-standard
  Network Management Framework.
  SNMP-COMMUNITY-MIB.snmpTargetAddrMMS</text>
      </reference>
    </leaf>
  </augment>
</submodule>