module SNMP-TARGET-MIB {

    yang-version 1;

    namespace
      "urn:ietf:params:xml:ns:yang:smiv2:SNMP-TARGET-MIB";

    prefix SNMP-TARGET-MIB;

    import SNMP-FRAMEWORK-MIB {
      prefix snmp-framework;
    }
    import SNMPv2-TC {
      prefix snmpv2-tc;
    }
    import ietf-yang-smiv2 {
      prefix smiv2;
    }
    import ietf-yang-types {
      prefix yang;
    }

    organization "IETF SNMPv3 Working Group";

    contact
      "WG-email:   snmpv3@lists.tislabs.com
    Subscribe:  majordomo@lists.tislabs.com
                In message body:  subscribe snmpv3
    
    Chair:      Russ Mundy
    
    
    
    
    
                Trusted Information Systems
    Postal:     3060 Washington Rd
                Glenwood MD 21738
                USA
    EMail:      mundy@tislabs.com
    Phone:      +1-301-854-6889
    
    Co-editor:  David B. Levi
                SNMP Research, Inc.
    Postal:     3001 Kimberlin Heights Road
                Knoxville, TN 37920-9716
    EMail:      levi@snmp.com
    Phone:      +1 423 573 1434
    
    Co-editor:  Paul Meyer
                Secure Computing Corporation
    Postal:     2675 Long Lake Road
                Roseville, MN 55113
    EMail:      paul_meyer@securecomputing.com
    Phone:      +1 651 628 1592
    
    Co-editor:  Bob Stewart
                Cisco Systems, Inc.
    Postal:     170 West Tasman Drive
                San Jose, CA 95134-1706
    EMail:      bstewart@cisco.com
    Phone:      +1 603 654 2686";

    description
      "This MIB module defines MIB objects which provide
    mechanisms to remotely configure the parameters used
    by an SNMP entity for the generation of SNMP messages.";

    revision "1998-08-04" {
      description
        "Clarifications, published as
      RFC2573.";
    }

    revision "1997-07-14" {
      description
        "The initial revision, published as RFC2273.";
    }

    smiv2:alias "snmpTargetMIB" {
      smiv2:oid "1.3.6.1.6.3.12";
    }
    smiv2:alias "snmpTargetObjects" {
      smiv2:oid "1.3.6.1.6.3.12.1";
    }
    smiv2:alias "snmpTargetConformance" {
      smiv2:oid "1.3.6.1.6.3.12.3";
    }
    smiv2:alias "snmpTargetCompliances" {
      smiv2:oid "1.3.6.1.6.3.12.3.1";
    }
    smiv2:alias "snmpTargetGroups" {
      smiv2:oid "1.3.6.1.6.3.12.3.2";
    }

    typedef SnmpTagValue {
      type string {
        smiv2:display-hint "255a";
      }
      description
        "An octet string containing a tag value.
      Tag values are preferably in human-readable form.
      
      
      
      
      
      
      To facilitate internationalization, this information
      is represented using the ISO/IEC IS 10646-1 character
      set, encoded as an octet string using the UTF-8
      character encoding scheme described in RFC 2279.
      
      Since additional code points are added by amendments
      to the 10646 standard from time to time,
      implementations must be prepared to encounter any code
      point from 0x00000000 to 0x7fffffff.
      
      The use of control codes should be avoided, and certain
      control codes are not allowed as described below.
      
      For code points not directly supported by user
      interface hardware or software, an alternative means
      of entry and display, such as hexadecimal, may be
      provided.
      
      For information encoded in 7-bit US-ASCII, the UTF-8
      representation is identical to the US-ASCII encoding.
      
      Note that when this TC is used for an object that
      is used or envisioned to be used as an index, then a
      SIZE restriction must be specified so that the number
      of sub-identifiers for any object instance does not
      exceed the limit of 128, as defined by [RFC1905].
      
      An object of this type contains a single tag value
      which is used to select a set of entries in a table.
      
      A tag value is an arbitrary string of octets, but
      may not contain a delimiter character.  Delimiter
      characters are defined to be one of the following:
      
          -  An ASCII space character (0x20).
      
          -  An ASCII TAB character (0x09).
      
          -  An ASCII carriage return (CR) character (0x0D).
      
          -  An ASCII line feed (LF) character (0x0B).
      
      Delimiter characters are used to separate tag values
      in a tag list.  An object of this type may only
      contain a single tag value, and so delimiter
      characters are not allowed in a value of this type.
      
      Some examples of valid tag values are:
      
      
      
      
      
          - 'acme'
      
          - 'router'
      
          - 'host'
      
      The use of a tag value to select table entries is
      application and MIB specific.";
    }

    typedef SnmpTagList {
      type string {
        smiv2:display-hint "255a";
      }
      description
        "An octet string containing a list of tag values.
      Tag values are preferably in human-readable form.
      
      To facilitate internationalization, this information
      is represented using the ISO/IEC IS 10646-1 character
      set, encoded as an octet string using the UTF-8
      character encoding scheme described in RFC 2279.
      
      Since additional code points are added by amendments
      to the 10646 standard from time to time,
      implementations must be prepared to encounter any code
      point from 0x00000000 to 0x7fffffff.
      
      The use of control codes should be avoided, except as
      described below.
      
      For code points not directly supported by user
      interface hardware or software, an alternative means
      of entry and display, such as hexadecimal, may be
      provided.
      
      For information encoded in 7-bit US-ASCII, the UTF-8
      representation is identical to the US-ASCII encoding.
      
      An object of this type contains a list of tag values
      which are used to select a set of entries in a table.
      
      A tag value is an arbitrary string of octets, but
      may not contain a delimiter character.  Delimiter
      characters are defined to be one of the following:
      
          -  An ASCII space character (0x20).
      
          -  An ASCII TAB character (0x09).
      
      
      
      
      
          -  An ASCII carriage return (CR) character (0x0D).
      
          -  An ASCII line feed (LF) character (0x0B).
      
      Delimiter characters are used to separate tag values
      in a tag list.  Only a single delimiter character may
      occur between two tag values.  A tag value may not
      have a zero length.  These constraints imply certain
      restrictions on the contents of this object:
      
          - There cannot be a leading or trailing delimiter
            character.
      
          - There cannot be multiple adjacent delimiter
            characters.
      
      Some examples of valid tag lists are:
      
          - An empty string
      
          - 'acme router'
      
          - 'host managerStation'
      
      Note that although a tag value may not have a length of
      zero, an empty string is still valid.  This indicates
      an empty list (i.e. there are no tag values in the list).
      
      The use of the tag list to select table entries is
      application and MIB specific.  Typically, an application
      will provide one or more tag values, and any entry
      which contains some combination of these tag values
      will be selected.";
    }

    container SNMP-TARGET-MIB {
      config false;
      container snmpTargetObjects {
        smiv2:oid "1.3.6.1.6.3.12.1";
        leaf snmpTargetSpinLock {
          smiv2:max-access "read-write";
          smiv2:oid "1.3.6.1.6.3.12.1.1";
          type snmpv2-tc:TestAndIncr;
          description
            "This object is used to facilitate modification of table
          entries in the SNMP-TARGET-MIB module by multiple
          
          
          
          
          
          managers.  In particular, it is useful when modifying
          the value of the snmpTargetAddrTagList object.
          
          The procedure for modifying the snmpTargetAddrTagList
          object is as follows:
          
              1.  Retrieve the value of snmpTargetSpinLock and
                  of snmpTargetAddrTagList.
          
              2.  Generate a new value for snmpTargetAddrTagList.
          
              3.  Set the value of snmpTargetSpinLock to the
                  retrieved value, and the value of
                  snmpTargetAddrTagList to the new value.  If
                  the set fails for the snmpTargetSpinLock
                  object, go back to step 1.";
        }

        leaf snmpUnavailableContexts {
          smiv2:max-access "read-only";
          smiv2:oid "1.3.6.1.6.3.12.1.4";
          type yang:counter32;
          description
            "The total number of packets received by the SNMP
          engine which were dropped because the context
          contained in the message was unavailable.";
        }

        leaf snmpUnknownContexts {
          smiv2:max-access "read-only";
          smiv2:oid "1.3.6.1.6.3.12.1.5";
          type yang:counter32;
          description
            "The total number of packets received by the SNMP
          engine which were dropped because the context
          contained in the message was unknown.";
        }
      }  // container snmpTargetObjects

      container snmpTargetAddrTable {
        smiv2:oid "1.3.6.1.6.3.12.1.2";
        description
          "A table of transport addresses to be used in the generation
        of SNMP messages.";
        list snmpTargetAddrEntry {
          smiv2:implied "snmpTargetAddrName";
          smiv2:oid "1.3.6.1.6.3.12.1.2.1";
          key "snmpTargetAddrName";
          description
            "A transport address to be used in the generation
          of SNMP operations.
          
          Entries in the snmpTargetAddrTable are created and
          deleted using the snmpTargetAddrRowStatus object.";
          leaf snmpTargetAddrName {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.6.3.12.1.2.1.1";
            type snmp-framework:SnmpAdminString {
              length "1..32";
            }
            description
              "The locally arbitrary, but unique identifier associated
            with this snmpTargetAddrEntry.";
          }

          leaf snmpTargetAddrTDomain {
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.2.1.2";
            type snmpv2-tc:TDomain;
            description
              "This object indicates the transport type of the address
            contained in the snmpTargetAddrTAddress object.";
          }

          leaf snmpTargetAddrTAddress {
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.2.1.3";
            type snmpv2-tc:TAddress;
            description
              "This object contains a transport address.  The format of
            this address depends on the value of the
            snmpTargetAddrTDomain object.";
          }

          leaf snmpTargetAddrTimeout {
            smiv2:defval "1500";
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.2.1.4";
            type snmpv2-tc:TimeInterval;
            description
              "This object should reflect the expected maximum round
            trip time for communicating with the transport address
            defined by this row.  When a message is sent to this
            address, and a response (if one is expected) is not
            received within this time period, an implementation
            may assume that the response will not be delivered.
            
            Note that the time interval that an application waits
            for a response may actually be derived from the value
            of this object.  The method for deriving the actual time
            interval is implementation dependent.  One such method
            
            
            
            
            
            is to derive the expected round trip time based on a
            particular retransmission algorithm and on the number
            of timeouts which have occurred.  The type of message may
            also be considered when deriving expected round trip
            times for retransmissions.  For example, if a message is
            being sent with a securityLevel that indicates both
            authentication and privacy, the derived value may be
            increased to compensate for extra processing time spent
            during authentication and encryption processing.";
          }

          leaf snmpTargetAddrRetryCount {
            smiv2:defval "3";
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.2.1.5";
            type int32 {
              range "0..255";
            }
            description
              "This object specifies a default number of retries to be
            attempted when a response is not received for a generated
            message.  An application may provide its own retry count,
            in which case the value of this object is ignored.";
          }

          leaf snmpTargetAddrTagList {
            smiv2:defval "";
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.2.1.6";
            type SnmpTagList;
            description
              "This object contains a list of tag values which are
            used to select target addresses for a particular
            operation.";
          }

          leaf snmpTargetAddrParams {
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.2.1.7";
            type snmp-framework:SnmpAdminString {
              length "1..32";
            }
            description
              "The value of this object identifies an entry in the
            snmpTargetParamsTable.  The identified entry
            contains SNMP parameters to be used when generating
            messages to be sent to this transport address.";
          }

          leaf snmpTargetAddrStorageType {
            smiv2:defval "nonVolatile";
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.2.1.8";
            type snmpv2-tc:StorageType;
            description
              "The storage type for this conceptual row.";
          }

          leaf snmpTargetAddrRowStatus {
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.2.1.9";
            type snmpv2-tc:RowStatus;
            description
              "The status of this conceptual row.
            
            To create a row in this table, a manager must
            set this object to either createAndGo(4) or
            createAndWait(5).
            
            Until instances of all corresponding columns are
            appropriately configured, the value of the
            corresponding instance of the snmpTargetAddrRowStatus
            column is 'notReady'.
            
            In particular, a newly created row cannot be made
            active until the corresponding instances of
            snmpTargetAddrTDomain, snmpTargetAddrTAddress, and
            snmpTargetAddrParams have all been set.
            
            The following objects may not be modified while the
            value of this object is active(1):
                - snmpTargetAddrTDomain
                - snmpTargetAddrTAddress
            An attempt to set these objects while the value of
            snmpTargetAddrRowStatus is active(1) will result in
            an inconsistentValue error.";
          }
        }  // list snmpTargetAddrEntry
      }  // container snmpTargetAddrTable

      container snmpTargetParamsTable {
        smiv2:oid "1.3.6.1.6.3.12.1.3";
        description
          "A table of SNMP target information to be used
        in the generation of SNMP messages.";
        list snmpTargetParamsEntry {
          smiv2:implied "snmpTargetParamsName";
          smiv2:oid "1.3.6.1.6.3.12.1.3.1";
          key "snmpTargetParamsName";
          description
            "A set of SNMP target information.
          
          Entries in the snmpTargetParamsTable are created and
          deleted using the snmpTargetParamsRowStatus object.";
          leaf snmpTargetParamsName {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.6.3.12.1.3.1.1";
            type snmp-framework:SnmpAdminString {
              length "1..32";
            }
            description
              "The locally arbitrary, but unique identifier associated
            with this snmpTargetParamsEntry.";
          }

          leaf snmpTargetParamsMPModel {
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.3.1.2";
            type snmp-framework:SnmpMessageProcessingModel;
            description
              "The Message Processing Model to be used when generating
            SNMP messages using this entry.";
          }

          leaf snmpTargetParamsSecurityModel {
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.3.1.3";
            type snmp-framework:SnmpSecurityModel {
              range "1..2147483647";
            }
            description
              "The Security Model to be used when generating SNMP
            messages using this entry.  An implementation may
            choose to return an inconsistentValue error if an
            attempt is made to set this variable to a value
            for a security model which the implementation does
            
            
            
            
            
            not support.";
          }

          leaf snmpTargetParamsSecurityName {
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.3.1.4";
            type snmp-framework:SnmpAdminString;
            description
              "The securityName which identifies the Principal on
            whose behalf SNMP messages will be generated using
            this entry.";
          }

          leaf snmpTargetParamsSecurityLevel {
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.3.1.5";
            type snmp-framework:SnmpSecurityLevel;
            description
              "The Level of Security to be used when generating
            SNMP messages using this entry.";
          }

          leaf snmpTargetParamsStorageType {
            smiv2:defval "nonVolatile";
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.3.1.6";
            type snmpv2-tc:StorageType;
            description
              "The storage type for this conceptual row.";
          }

          leaf snmpTargetParamsRowStatus {
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.6.3.12.1.3.1.7";
            type snmpv2-tc:RowStatus;
            description
              "The status of this conceptual row.
            
            To create a row in this table, a manager must
            set this object to either createAndGo(4) or
            createAndWait(5).
            
            Until instances of all corresponding columns are
            appropriately configured, the value of the
            corresponding instance of the snmpTargetParamsRowStatus
            column is 'notReady'.
            
            In particular, a newly created row cannot be made
            
            
            
            
            
            active until the corresponding
            snmpTargetParamsMPModel,
            snmpTargetParamsSecurityModel,
            snmpTargetParamsSecurityName,
            and snmpTargetParamsSecurityLevel have all been set.
            The following objects may not be modified while the
            value of this object is active(1):
                - snmpTargetParamsMPModel
                - snmpTargetParamsSecurityModel
                - snmpTargetParamsSecurityName
                - snmpTargetParamsSecurityLevel
            An attempt to set these objects while the value of
            snmpTargetParamsRowStatus is active(1) will result in
            an inconsistentValue error.";
          }
        }  // list snmpTargetParamsEntry
      }  // container snmpTargetParamsTable
    }  // container SNMP-TARGET-MIB
  }  // module SNMP-TARGET-MIB