DISMAN-NSLOOKUP-MIB DEFINITIONS ::= BEGIN

IMPORTS

    MODULE-IDENTITY, OBJECT-TYPE,

    Unsigned32, mib-2, Integer32

        FROM SNMPv2-SMI                  -- RFC2578

    RowStatus

        FROM SNMPv2-TC                   -- RFC2579

    MODULE-COMPLIANCE, OBJECT-GROUP

        FROM SNMPv2-CONF                 -- RFC2580

    SnmpAdminString

        FROM SNMP-FRAMEWORK-MIB          -- RFC3411

    InetAddressType, InetAddress

        FROM INET-ADDRESS-MIB;           -- RFC4001

 lookupMIB MODULE-IDENTITY

    LAST-UPDATED "200606130000Z"         -- 13 June 2006

    ORGANIZATION "IETF Distributed Management Working Group"

    CONTACT-INFO

        "Juergen Quittek

        NEC Europe Ltd.

        Network Laboratories

        Kurfuersten-Anlage 36

        69115 Heidelberg

        Germany

        Phone: +49 6221 4342-115

        Email: quittek@netlab.nec.de"

    DESCRIPTION

        "The Lookup MIB (DISMAN-NSLOOKUP-MIB) enables determination

        of either the name(s) corresponding to a host address or of

        the address(es) associated with a host name at a remote

        host.

        Copyright (C) The Internet Society (2006).  This version of

        this MIB module is part of RFC 4560; see the RFC itself for

        full legal notices."

     --  Revision history

     REVISION     "200606130000Z"         -- 13 June 2006

     DESCRIPTION

         "Updated version, published as RFC 4560.

             - Replaced references to RFC 2575 by RFC 3415

             - Replaced references to RFC 2571 by RFC 3411

             - Replaced references to RFC 2851 by RFC 4001

             - Added value enabled(1) to SYNTAX clause of

               lookupCtlOperStatus

             - Added lookupMinimumCompliance

             - Defined semantics of value 0 for object

               lookupPurgeTime

             - Added DEFVAL { unknown } to object

               lookupCtlTargetAddressType OBJECT-TYPE"

     REVISION     "200009210000Z"         -- 21 September 2000

     DESCRIPTION

         "Initial version, published as RFC 2925."

    ::= { mib-2 82 }

 -- Top level structure of the MIB

 lookupObjects        OBJECT IDENTIFIER ::= { lookupMIB 1 }

 lookupConformance    OBJECT IDENTIFIER ::= { lookupMIB 2 }

 -- Simple Object Definitions

 lookupMaxConcurrentRequests OBJECT-TYPE

    SYNTAX      Unsigned32

    UNITS       "requests"

    MAX-ACCESS  read-write

    STATUS      current

    DESCRIPTION

       "The maximum number of concurrent active lookup requests

       that are allowed within an agent implementation.  A value

       of 0 for this object implies that there is no limit for

       the number of concurrent active requests in effect.

       The limit applies only to new requests being activated.

       When a new value is set, the agent will continue processing

       all the requests already active, even if their number

       exceed the limit just imposed."

    DEFVAL { 10 }

    ::= { lookupObjects 1 }

 lookupPurgeTime OBJECT-TYPE

    SYNTAX      Unsigned32 (0..86400)

    UNITS       "seconds"

    MAX-ACCESS  read-write

    STATUS      current

    DESCRIPTION

       "The amount of time to wait before automatically

       deleting an entry in the lookupCtlTable and any

       dependent lookupResultsTable entries

       after the lookup operation represented by a

       lookupCtlEntry has been completed.

       A lookupCtEntry is considered complete

       when its lookupCtlOperStatus object has a

       value of completed(3).

       A value of 0 indicates that automatic deletion

       of entries is disabled."

    DEFVAL { 900 }  -- 15 minutes as default

    ::= { lookupObjects 2 }

 -- Lookup Control Table

 lookupCtlTable OBJECT-TYPE

    SYNTAX      SEQUENCE OF LookupCtlEntry

    MAX-ACCESS  not-accessible

    STATUS      current

    DESCRIPTION

        "Defines the Lookup Control Table for providing

        the capability of performing a lookup operation

        for a symbolic host name or for a host address

        from a remote host."

   ::= { lookupObjects 3 }

 lookupCtlEntry OBJECT-TYPE

    SYNTAX      LookupCtlEntry

    MAX-ACCESS  not-accessible

    STATUS      current

    DESCRIPTION

        "Defines an entry in the lookupCtlTable.  A

        lookupCtlEntry is initially indexed by

        lookupCtlOwnerIndex, which is a type of SnmpAdminString,

        a textual convention that allows for the use of the SNMPv3

        View-Based Access Control Model (RFC 3415, VACM)

        and that also allows a management application to identify

        its entries.  The second index element,

        lookupCtlOperationName, enables the same

        lookupCtlOwnerIndex entity to have multiple outstanding

        requests.  The value of lookupCtlTargetAddressType

        determines which lookup function to perform."

    INDEX {

             lookupCtlOwnerIndex,

             lookupCtlOperationName

          }

    ::= { lookupCtlTable 1 }

 LookupCtlEntry ::=

    SEQUENCE {

        lookupCtlOwnerIndex         SnmpAdminString,

        lookupCtlOperationName      SnmpAdminString,

        lookupCtlTargetAddressType  InetAddressType,

        lookupCtlTargetAddress      InetAddress,

        lookupCtlOperStatus         INTEGER,

        lookupCtlTime               Unsigned32,

        lookupCtlRc                 Integer32,

        lookupCtlRowStatus          RowStatus

    }

 lookupCtlOwnerIndex OBJECT-TYPE

    SYNTAX      SnmpAdminString (SIZE(0..32))

    MAX-ACCESS  not-accessible

    STATUS      current

    DESCRIPTION

       "To facilitate the provisioning of access control by a

       security administrator using the View-Based Access

       Control Model (RFC 2575, VACM) for tables in which

       multiple users may need to create or

       modify entries independently, the initial index is used as

       an 'owner index'.  Such an initial index has a syntax of

       SnmpAdminString and can thus be trivially mapped to a

       securityName or groupName defined in VACM, in

       accordance with a security policy.

       When used in conjunction with such a security policy all

       entries in the table belonging to a particular user (or

       group) will have the same value for this initial index.

       For a given user's entries in a particular table, the

       object identifiers for the information in these entries

       will have the same subidentifiers (except for the

       'column' subidentifier) up to the end of the encoded

       owner index.  To configure VACM to permit access to this

       portion of the table, one would create

       vacmViewTreeFamilyTable entries with the value of

       vacmViewTreeFamilySubtree including the owner index

       portion, and vacmViewTreeFamilyMask 'wildcarding' the

       column subidentifier.  More elaborate configurations

       are possible."

    ::= { lookupCtlEntry 1 }

 lookupCtlOperationName OBJECT-TYPE

    SYNTAX      SnmpAdminString (SIZE(0..32))

    MAX-ACCESS  not-accessible

    STATUS      current

    DESCRIPTION

        "The name of a lookup operation.  This is locally unique,

        within the scope of an lookupCtlOwnerIndex."

    ::= { lookupCtlEntry 2 }

 lookupCtlTargetAddressType OBJECT-TYPE

    SYNTAX      InetAddressType

    MAX-ACCESS  read-create

    STATUS      current

    DESCRIPTION

        "Specifies the type of address for performing a

        lookup operation for a symbolic host name or for a host

        address from a remote host.

        Specification of dns(16) as the value for this object

        means that a function such as, for example, getaddrinfo()

        or gethostbyname() should be performed to return one or

        more numeric addresses.  Use of a value of either ipv4(1)

        or ipv6(2) means that a functions such as, for example,

        getnameinfo() or gethostbyaddr() should be used to return

        the symbolic names associated with a host."

    DEFVAL { unknown }

    ::= { lookupCtlEntry 3 }

 lookupCtlTargetAddress OBJECT-TYPE

    SYNTAX      InetAddress

    MAX-ACCESS  read-create

    STATUS      current

    DESCRIPTION

        "Specifies the address used for a resolver lookup at a

        remote host.  The corresponding lookupCtlTargetAddressType

        objects determines its type, as well as the function

        that can be requested.

        A value for this object MUST be set prior to

        transitioning its corresponding lookupCtlEntry to

        active(1) via lookupCtlRowStatus."

    ::= { lookupCtlEntry 4 }

 lookupCtlOperStatus OBJECT-TYPE

    SYNTAX      INTEGER {

                   enabled(1),    -- operation is active

                   notStarted(2), -- operation has not started

                   completed(3)   -- operation is done

                }

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        "Reflects the operational state of an lookupCtlEntry:

           enabled(1)    - Operation is active.

           notStarted(2) - Operation has not been enabled.

           completed(3)  - Operation has been completed.

         An operation is automatically enabled(1) when its

         lookupCtlRowStatus object is transitioned to active(1)

         status.  Until this occurs, lookupCtlOperStatus MUST

         report a value of notStarted(2).  After the lookup

         operation is completed (success or failure), the value

         for lookupCtlOperStatus MUST be transitioned to

         completed(3)."

    ::= { lookupCtlEntry 5 }

 lookupCtlTime OBJECT-TYPE

    SYNTAX      Unsigned32

    UNITS       "milliseconds"

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        "Reports the number of milliseconds that a lookup

        operation required to be completed at a remote host.

        Completed means operation failure as well as

        success."

    ::= { lookupCtlEntry 6 }

 lookupCtlRc OBJECT-TYPE

    SYNTAX      Integer32

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        "The system-specific return code from a lookup

        operation.  All implementations MUST return a value

        of 0 for this object when the remote lookup

        operation succeeds.  A non-zero value for this

        objects indicates failure.  It is recommended that

        implementations return the error codes that are

        generated by the lookup function used."

    ::= { lookupCtlEntry 7 }

 lookupCtlRowStatus OBJECT-TYPE

    SYNTAX      RowStatus

    MAX-ACCESS  read-create

    STATUS      current

    DESCRIPTION

        "This object allows entries to be created and deleted

        in the lookupCtlTable.

        A remote lookup operation is started when an

        entry in this table is created via an SNMP set

        request and the entry is activated.  This

        occurs by setting the value of this object

        to CreateAndGo(4) during row creation or

        by setting this object to active(1) after

        the row is created.

        A value MUST be specified for lookupCtlTargetAddress

        prior to the acceptance of a transition to active(1) state.

        A remote lookup operation starts when its entry

        first becomes active(1).  Transitions in and

        out of active(1) state have no effect on the

        operational behavior of a remote lookup

        operation, with the exception that deletion of

        an entry in this table by setting its RowStatus

        object to destroy(6) will stop an active

        remote lookup operation.

        The operational state of a remote lookup operation

        can be determined by examination of its

        lookupCtlOperStatus object."

    REFERENCE

        "See definition of RowStatus in RFC 2579,

        'Textual Conventions for SMIv2.'"

    ::= { lookupCtlEntry 8 }

-- Lookup Results Table

 lookupResultsTable OBJECT-TYPE

    SYNTAX      SEQUENCE OF LookupResultsEntry

    MAX-ACCESS  not-accessible

    STATUS      current

    DESCRIPTION

        "Defines the Lookup Results Table for providing

        the capability of determining the results of a

        operation at a remote host.

        One or more entries are added to the

        lookupResultsTable when a lookup operation,

        as reflected by an lookupCtlEntry, is completed

        successfully.  All entries related to a

        successful lookup operation MUST be added

        to the lookupResultsTable at the same time

        that the associating lookupCtlOperStatus

        object is transitioned to completed(2).

        The number of entries added depends on the

        results determined for a particular lookup

        operation.  All entries associated with an

        lookupCtlEntry are removed when the

        lookupCtlEntry is deleted.

        A remote host can be multi-homed and have more than one IP

        address associated with it (returned by lookup function),

        or it can have more than one symbolic name (returned

        by lookup function).

        A function such as, for example, getnameinfo() or

        gethostbyaddr() is called with a host address as its

        parameter and is used primarily to determine a symbolic

        name to associate with the host address.  Entries in the

        lookupResultsTable MUST be made for each host name

        returned.  If the function identifies an 'official host

        name,' then this symbolic name MUST be assigned a

        lookupResultsIndex of 1.

        A function such as, for example, getaddrinfo() or

        gethostbyname() is called with a symbolic host name and is

        used primarily to retrieve a host address.  The entries

        MUST be stored in the order that they are retrieved from

        the lookup function.  lookupResultsIndex 1 MUST be

        assigned to the first entry."

   ::= { lookupObjects 4 }

 lookupResultsEntry OBJECT-TYPE

    SYNTAX      LookupResultsEntry

    MAX-ACCESS  not-accessible

    STATUS      current

    DESCRIPTION

        "Defines an entry in the lookupResultsTable.  The

        first two index elements identify the

        lookupCtlEntry that a lookupResultsEntry belongs

        to.  The third index element selects a single

        lookup operation result."

    INDEX {

             lookupCtlOwnerIndex,

             lookupCtlOperationName,

             lookupResultsIndex

          }

    ::= { lookupResultsTable 1 }

 LookupResultsEntry ::=

    SEQUENCE {

        lookupResultsIndex        Unsigned32,

        lookupResultsAddressType  InetAddressType,

        lookupResultsAddress      InetAddress

     }

 lookupResultsIndex OBJECT-TYPE

    SYNTAX      Unsigned32 (1..'ffffffff'h)

    MAX-ACCESS  not-accessible

    STATUS      current

    DESCRIPTION

        "Entries in the lookupResultsTable are created when

        the result of a lookup operation is determined.

        Entries MUST be stored in the lookupResultsTable in

        the order that they are retrieved.  Values assigned

        to lookupResultsIndex MUST start at 1 and increase

        consecutively."

    ::= { lookupResultsEntry 1 }

 lookupResultsAddressType OBJECT-TYPE

    SYNTAX      InetAddressType

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        "Indicates the type of result of a remote lookup

        operation.  A value of unknown(0) implies either that

        the operation hasn't been started or that

        it has failed."

    ::= { lookupResultsEntry 2 }

 lookupResultsAddress OBJECT-TYPE

    SYNTAX      InetAddress

    MAX-ACCESS  read-only

    STATUS      current

    DESCRIPTION

        "Reflects a result for a remote lookup operation

        as per the value of lookupResultsAddressType.

        The address type (InetAddressType) that relates to

        this object is specified by the corresponding value

        of lookupResultsAddress."

    ::= { lookupResultsEntry 3 }

 -- Conformance information

 -- Compliance statements

 lookupCompliances OBJECT IDENTIFIER ::= { lookupConformance 1 }

 lookupGroups      OBJECT IDENTIFIER ::= { lookupConformance 2 }

 -- Compliance statements

 lookupCompliance MODULE-COMPLIANCE

    STATUS  current

    DESCRIPTION

            "The compliance statement for SNMP entities that

            fully implement the DISMAN-NSLOOKUP-MIB."

    MODULE  -- this module

        MANDATORY-GROUPS { lookupGroup }

        OBJECT lookupMaxConcurrentRequests

        MIN-ACCESS  read-only

        DESCRIPTION

            "The agent is not required to support set

            operations to this object."

        OBJECT lookupPurgeTime

        MIN-ACCESS  read-only

        DESCRIPTION

            "The agent is not required to support a set

            operation to this object."

    ::= { lookupCompliances 1 }

 lookupMinimumCompliance MODULE-COMPLIANCE

    STATUS  current

    DESCRIPTION

            "The minimum compliance statement for SNMP entities

            that implement the minimal subset of the

            DISMAN-NSLOOKUP-MIB.  Implementors might choose this

            subset for small devices with limited resources."

    MODULE  -- this module

        MANDATORY-GROUPS { lookupGroup }

        OBJECT lookupMaxConcurrentRequests

        MIN-ACCESS  read-only

        DESCRIPTION

            "The agent is not required to support set

            operations to this object."

        OBJECT lookupPurgeTime

        MIN-ACCESS  read-only

        DESCRIPTION

            "The agent is not required to support a set

            operation to this object."

        OBJECT lookupCtlRowStatus

        MIN-ACCESS  read-only

        DESCRIPTION

            "Write access is not required.  If write access is

            not supported, then at least one entry in the

            lookupCtlTable MUST be established already when the SNMP

            agent starts offering access to the NSLOOKUP-MIB module.

            If, in such a case, only a single entry is offered, then

            it is RECOMMENDED that this entry use strings with a

            length of 0 for both of its two index objects."

    ::= { lookupCompliances 2 }

 -- MIB groupings

 lookupGroup OBJECT-GROUP

   OBJECTS {

             lookupMaxConcurrentRequests,

             lookupPurgeTime,

             lookupCtlOperStatus,

             lookupCtlTargetAddressType,

             lookupCtlTargetAddress,

             lookupCtlTime,

             lookupCtlRc,

             lookupCtlRowStatus,

             lookupResultsAddressType,

             lookupResultsAddress

           }

   STATUS  current

   DESCRIPTION

       "The group of objects that constitute the remote

       Lookup operation."

    ::= { lookupGroups 1 }

END