home *** CD-ROM | disk | FTP | other *** search
/ Thomson (Residential) / TGSTPv7203.iso / mac / SNMP_MIBs / extended / INET-ADDRESS-MIB.mib < prev    next >
Text File  |  2008-02-08  |  7KB  |  182 lines
  1.    INET-ADDRESS-MIB DEFINITIONS ::= BEGIN
  2.  
  3.  
  4.    IMPORTS
  5.      MODULE-IDENTITY, mib-2 FROM SNMPv2-SMI
  6.      TEXTUAL-CONVENTION     FROM SNMPv2-TC;
  7.  
  8.    inetAddressMIB MODULE-IDENTITY
  9.      LAST-UPDATED "200006080000Z"
  10.      ORGANIZATION
  11.          "IETF Operations and Management Area"
  12.      CONTACT-INFO
  13.          "Mike Daniele
  14.           Compaq Computer Corporation
  15.           110 Spit Brook Rd
  16.           Nashua, NH  03062, USA
  17.  
  18.           Phone: +1 603 884-1423
  19.           EMail: daniele@zk3.dec.com
  20.  
  21.           Brian Haberman
  22.           Nortel Networks
  23.           4039 Emperor Blvd., Suite 200
  24.           Durham, NC  27703, USA
  25.  
  26.           Phone: +1 919 992-4439
  27.           EMail: haberman@nortelnetworks.com
  28.  
  29.           Shawn A. Routhier
  30.           Wind River Systems, Inc.
  31.           1 Tara Blvd, Suite 403
  32.           Nashua, NH  03062, USA
  33.  
  34.           Phone: +1 603 897-2000
  35.           EMail: sar@epilogue.com
  36.  
  37.           Juergen Schoenwaelder
  38.           TU Braunschweig
  39.           Bueltenweg 74/75
  40.           38106 Braunschweig, Germany
  41.  
  42.           Phone: +49 531 391-3289
  43.           EMail: schoenw@ibr.cs.tu-bs.de
  44.  
  45.           Send comments to mibs@ops.ietf.org."
  46.  
  47.    DESCRIPTION
  48.      "This MIB module defines textual conventions for
  49.       representing Internet addresses. An Internet
  50.       address can be an IPv4 address, an IPv6 address
  51.       or a DNS domain name."
  52.  
  53.    REVISION     "200006080000Z"
  54.    DESCRIPTION
  55.        "Initial version, published as RFC 2851."
  56.    ::= { mib-2 76 }
  57.  
  58.    InetAddressType ::= TEXTUAL-CONVENTION
  59.      STATUS      current
  60.      DESCRIPTION
  61.          "A value that represents a type of Internet address.
  62.  
  63.           unknown(0)  An unknown address type. This value MUST
  64.                       be used if the value of the corresponding
  65.                       InetAddress object is a zero-length string.
  66.                       It may also be used to indicate an IP address
  67.                       which is not in one of the formats defined
  68.                       below.
  69.  
  70.           ipv4(1)     An IPv4 address as defined by the
  71.                       InetAddressIPv4 textual convention.
  72.  
  73.           ipv6(2)     An IPv6 address as defined by the
  74.                       InetAddressIPv6 textual convention.
  75.  
  76.           dns(16)     A DNS domain name as defined by the
  77.                       InetAddressDNS textual convention.
  78.  
  79.           Each definition of a concrete InetAddressType value must be
  80.           accompanied by a definition of a textual convention for use
  81.           with that InetAddressType.
  82.  
  83.           The InetAddressType textual convention SHOULD NOT be subtyped
  84.           in object type definitions to support future extensions. It
  85.  
  86.           MAY be subtyped in compliance statements in order to require
  87.           only a subset of these address types for a compliant
  88.           implementation."
  89.      SYNTAX      INTEGER {
  90.                      unknown(0),
  91.                      ipv4(1),    -- these named numbers are aligned
  92.                      ipv6(2),    -- with AddressFamilyNumbers from
  93.                      dns(16)     -- IANA-ADDRESS-FAMILY-NUMBERS-MIB
  94.                  }
  95.  
  96.    InetAddress ::= TEXTUAL-CONVENTION
  97.      STATUS       current
  98.      DESCRIPTION
  99.          "Denotes a generic Internet address.
  100.  
  101.           An InetAddress value is always interpreted within the
  102.           context of an InetAddressType value. The InetAddressType
  103.           object which defines the context must be registered
  104.           immediately before the object which uses the InetAddress
  105.           textual convention. In other words, the object identifiers
  106.           for the InetAddressType object and the InetAddress object
  107.           MUST have the same length and the last sub-identifier of
  108.           the InetAddressType object MUST be 1 less than the last
  109.           sub-identifier of the InetAddress object.
  110.  
  111.           When this textual convention is used as the syntax of an
  112.           index object, there may be issues with the limit of 128
  113.           sub-identifiers specified in SMIv2, STD 58. In this case,
  114.           the OBJECT-TYPE declaration MUST include a 'SIZE' clause
  115.           to limit the number of potential instance sub-identifiers."
  116.      SYNTAX      OCTET STRING (SIZE (0..255))
  117.  
  118.    InetAddressIPv4 ::= TEXTUAL-CONVENTION
  119.      DISPLAY-HINT "1d.1d.1d.1d"
  120.      STATUS       current
  121.      DESCRIPTION
  122.          "Represents an IPv4 network address:
  123.  
  124.             octets   contents         encoding
  125.              1-4     IP address       network-byte order
  126.  
  127.           The corresponding InetAddressType value is ipv4(1)."
  128.      SYNTAX       OCTET STRING (SIZE (4))
  129.  
  130.    InetAddressIPv6 ::= TEXTUAL-CONVENTION
  131.      DISPLAY-HINT "2x:2x:2x:2x:2x:2x:2x:2x%4d"
  132.      STATUS       current
  133.      DESCRIPTION
  134.  
  135.          "Represents an IPv6 network address:
  136.  
  137.             octets   contents         encoding
  138.              1-16    IPv6 address     network-byte order
  139.             17-20    scope identifier network-byte order
  140.  
  141.           The corresponding InetAddressType value is ipv6(2).
  142.  
  143.           The scope identifier (bytes 17-20) MUST NOT be present
  144.           for global IPv6 addresses. For non-global IPv6 addresses
  145.           (e.g. link-local or site-local addresses), the scope
  146.           identifier MUST always be present. It contains a link
  147.           identifier for link-local and a site identifier for
  148.           site-local IPv6 addresses.
  149.  
  150.           The scope identifier MUST disambiguate identical address
  151.           values. For link-local addresses, the scope identifier will
  152.           typically be the interface index (ifIndex as defined in the
  153.           IF-MIB, RFC 2233) of the interface on which the address is
  154.           configured.
  155.  
  156.           The scope identifier may contain the special value 0
  157.           which refers to the default scope. The default scope
  158.           may be used in cases where the valid scope identifier
  159.           is not known (e.g., a management application needs to
  160.           write a site-local InetAddressIPv6 address without
  161.           knowing the site identifier value). The default scope
  162.           SHOULD NOT be used as an easy way out in cases where
  163.           the scope identifier for a non-global IPv6 is known."
  164.      SYNTAX       OCTET STRING (SIZE (16|20))
  165.  
  166.    InetAddressDNS ::= TEXTUAL-CONVENTION
  167.      DISPLAY-HINT "255a"
  168.      STATUS       current
  169.      DESCRIPTION
  170.          "Represents a DNS domain name. The name SHOULD be
  171.           fully qualified whenever possible.
  172.  
  173.           The corresponding InetAddressType is dns(16).
  174.  
  175.           The DESCRIPTION clause of InetAddress objects that
  176.           may have InetAddressDNS values must fully describe
  177.           how (and when) such names are to be resolved to IP
  178.           addresses."
  179.      SYNTAX       OCTET STRING (SIZE (1..255))
  180.  
  181.    END
  182.