|
Packit Service |
9ccfef |
DISMAN-NSLOOKUP-MIB DEFINITIONS ::= BEGIN
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
IMPORTS
|
|
Packit Service |
9ccfef |
MODULE-IDENTITY, OBJECT-TYPE,
|
|
Packit Service |
9ccfef |
Unsigned32, mib-2, Integer32
|
|
Packit Service |
9ccfef |
FROM SNMPv2-SMI -- RFC2578
|
|
Packit Service |
9ccfef |
RowStatus
|
|
Packit Service |
9ccfef |
FROM SNMPv2-TC -- RFC2579
|
|
Packit Service |
9ccfef |
MODULE-COMPLIANCE, OBJECT-GROUP
|
|
Packit Service |
9ccfef |
FROM SNMPv2-CONF -- RFC2580
|
|
Packit Service |
9ccfef |
SnmpAdminString
|
|
Packit Service |
9ccfef |
FROM SNMP-FRAMEWORK-MIB -- RFC3411
|
|
Packit Service |
9ccfef |
InetAddressType, InetAddress
|
|
Packit Service |
9ccfef |
FROM INET-ADDRESS-MIB; -- RFC4001
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupMIB MODULE-IDENTITY
|
|
Packit Service |
9ccfef |
LAST-UPDATED "200606130000Z" -- 13 June 2006
|
|
Packit Service |
9ccfef |
ORGANIZATION "IETF Distributed Management Working Group"
|
|
Packit Service |
9ccfef |
CONTACT-INFO
|
|
Packit Service |
9ccfef |
"Juergen Quittek
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
NEC Europe Ltd.
|
|
Packit Service |
9ccfef |
Network Laboratories
|
|
Packit Service |
9ccfef |
Kurfuersten-Anlage 36
|
|
Packit Service |
9ccfef |
69115 Heidelberg
|
|
Packit Service |
9ccfef |
Germany
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
Phone: +49 6221 4342-115
|
|
Packit Service |
9ccfef |
Email: quittek@netlab.nec.de"
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"The Lookup MIB (DISMAN-NSLOOKUP-MIB) enables determination
|
|
Packit Service |
9ccfef |
of either the name(s) corresponding to a host address or of
|
|
Packit Service |
9ccfef |
the address(es) associated with a host name at a remote
|
|
Packit Service |
9ccfef |
host.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
Copyright (C) The Internet Society (2006). This version of
|
|
Packit Service |
9ccfef |
this MIB module is part of RFC 4560; see the RFC itself for
|
|
Packit Service |
9ccfef |
full legal notices."
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
-- Revision history
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
REVISION "200606130000Z" -- 13 June 2006
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"Updated version, published as RFC 4560.
|
|
Packit Service |
9ccfef |
- Replaced references to RFC 2575 by RFC 3415
|
|
Packit Service |
9ccfef |
- Replaced references to RFC 2571 by RFC 3411
|
|
Packit Service |
9ccfef |
- Replaced references to RFC 2851 by RFC 4001
|
|
Packit Service |
9ccfef |
- Added value enabled(1) to SYNTAX clause of
|
|
Packit Service |
9ccfef |
lookupCtlOperStatus
|
|
Packit Service |
9ccfef |
- Added lookupMinimumCompliance
|
|
Packit Service |
9ccfef |
- Defined semantics of value 0 for object
|
|
Packit Service |
9ccfef |
lookupPurgeTime
|
|
Packit Service |
9ccfef |
- Added DEFVAL { unknown } to object
|
|
Packit Service |
9ccfef |
lookupCtlTargetAddressType OBJECT-TYPE"
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
REVISION "200009210000Z" -- 21 September 2000
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"Initial version, published as RFC 2925."
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
::= { mib-2 82 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
-- Top level structure of the MIB
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupObjects OBJECT IDENTIFIER ::= { lookupMIB 1 }
|
|
Packit Service |
9ccfef |
lookupConformance OBJECT IDENTIFIER ::= { lookupMIB 2 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
-- Simple Object Definitions
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupMaxConcurrentRequests OBJECT-TYPE
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
SYNTAX Unsigned32
|
|
Packit Service |
9ccfef |
UNITS "requests"
|
|
Packit Service |
9ccfef |
MAX-ACCESS read-write
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"The maximum number of concurrent active lookup requests
|
|
Packit Service |
9ccfef |
that are allowed within an agent implementation. A value
|
|
Packit Service |
9ccfef |
of 0 for this object implies that there is no limit for
|
|
Packit Service |
9ccfef |
the number of concurrent active requests in effect.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
The limit applies only to new requests being activated.
|
|
Packit Service |
9ccfef |
When a new value is set, the agent will continue processing
|
|
Packit Service |
9ccfef |
all the requests already active, even if their number
|
|
Packit Service |
9ccfef |
exceed the limit just imposed."
|
|
Packit Service |
9ccfef |
DEFVAL { 10 }
|
|
Packit Service |
9ccfef |
::= { lookupObjects 1 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupPurgeTime OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX Unsigned32 (0..86400)
|
|
Packit Service |
9ccfef |
UNITS "seconds"
|
|
Packit Service |
9ccfef |
MAX-ACCESS read-write
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"The amount of time to wait before automatically
|
|
Packit Service |
9ccfef |
deleting an entry in the lookupCtlTable and any
|
|
Packit Service |
9ccfef |
dependent lookupResultsTable entries
|
|
Packit Service |
9ccfef |
after the lookup operation represented by a
|
|
Packit Service |
9ccfef |
lookupCtlEntry has been completed.
|
|
Packit Service |
9ccfef |
A lookupCtEntry is considered complete
|
|
Packit Service |
9ccfef |
when its lookupCtlOperStatus object has a
|
|
Packit Service |
9ccfef |
value of completed(3).
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
A value of 0 indicates that automatic deletion
|
|
Packit Service |
9ccfef |
of entries is disabled."
|
|
Packit Service |
9ccfef |
DEFVAL { 900 } -- 15 minutes as default
|
|
Packit Service |
9ccfef |
::= { lookupObjects 2 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
-- Lookup Control Table
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupCtlTable OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX SEQUENCE OF LookupCtlEntry
|
|
Packit Service |
9ccfef |
MAX-ACCESS not-accessible
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"Defines the Lookup Control Table for providing
|
|
Packit Service |
9ccfef |
the capability of performing a lookup operation
|
|
Packit Service |
9ccfef |
for a symbolic host name or for a host address
|
|
Packit Service |
9ccfef |
from a remote host."
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
::= { lookupObjects 3 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupCtlEntry OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX LookupCtlEntry
|
|
Packit Service |
9ccfef |
MAX-ACCESS not-accessible
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"Defines an entry in the lookupCtlTable. A
|
|
Packit Service |
9ccfef |
lookupCtlEntry is initially indexed by
|
|
Packit Service |
9ccfef |
lookupCtlOwnerIndex, which is a type of SnmpAdminString,
|
|
Packit Service |
9ccfef |
a textual convention that allows for the use of the SNMPv3
|
|
Packit Service |
9ccfef |
View-Based Access Control Model (RFC 3415, VACM)
|
|
Packit Service |
9ccfef |
and that also allows a management application to identify
|
|
Packit Service |
9ccfef |
its entries. The second index element,
|
|
Packit Service |
9ccfef |
lookupCtlOperationName, enables the same
|
|
Packit Service |
9ccfef |
lookupCtlOwnerIndex entity to have multiple outstanding
|
|
Packit Service |
9ccfef |
requests. The value of lookupCtlTargetAddressType
|
|
Packit Service |
9ccfef |
determines which lookup function to perform."
|
|
Packit Service |
9ccfef |
INDEX {
|
|
Packit Service |
9ccfef |
lookupCtlOwnerIndex,
|
|
Packit Service |
9ccfef |
lookupCtlOperationName
|
|
Packit Service |
9ccfef |
}
|
|
Packit Service |
9ccfef |
::= { lookupCtlTable 1 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
LookupCtlEntry ::=
|
|
Packit Service |
9ccfef |
SEQUENCE {
|
|
Packit Service |
9ccfef |
lookupCtlOwnerIndex SnmpAdminString,
|
|
Packit Service |
9ccfef |
lookupCtlOperationName SnmpAdminString,
|
|
Packit Service |
9ccfef |
lookupCtlTargetAddressType InetAddressType,
|
|
Packit Service |
9ccfef |
lookupCtlTargetAddress InetAddress,
|
|
Packit Service |
9ccfef |
lookupCtlOperStatus INTEGER,
|
|
Packit Service |
9ccfef |
lookupCtlTime Unsigned32,
|
|
Packit Service |
9ccfef |
lookupCtlRc Integer32,
|
|
Packit Service |
9ccfef |
lookupCtlRowStatus RowStatus
|
|
Packit Service |
9ccfef |
}
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupCtlOwnerIndex OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX SnmpAdminString (SIZE(0..32))
|
|
Packit Service |
9ccfef |
MAX-ACCESS not-accessible
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"To facilitate the provisioning of access control by a
|
|
Packit Service |
9ccfef |
security administrator using the View-Based Access
|
|
Packit Service |
9ccfef |
Control Model (RFC 2575, VACM) for tables in which
|
|
Packit Service |
9ccfef |
multiple users may need to create or
|
|
Packit Service |
9ccfef |
modify entries independently, the initial index is used as
|
|
Packit Service |
9ccfef |
an 'owner index'. Such an initial index has a syntax of
|
|
Packit Service |
9ccfef |
SnmpAdminString and can thus be trivially mapped to a
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
securityName or groupName defined in VACM, in
|
|
Packit Service |
9ccfef |
accordance with a security policy.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
When used in conjunction with such a security policy all
|
|
Packit Service |
9ccfef |
entries in the table belonging to a particular user (or
|
|
Packit Service |
9ccfef |
group) will have the same value for this initial index.
|
|
Packit Service |
9ccfef |
For a given user's entries in a particular table, the
|
|
Packit Service |
9ccfef |
object identifiers for the information in these entries
|
|
Packit Service |
9ccfef |
will have the same subidentifiers (except for the
|
|
Packit Service |
9ccfef |
'column' subidentifier) up to the end of the encoded
|
|
Packit Service |
9ccfef |
owner index. To configure VACM to permit access to this
|
|
Packit Service |
9ccfef |
portion of the table, one would create
|
|
Packit Service |
9ccfef |
vacmViewTreeFamilyTable entries with the value of
|
|
Packit Service |
9ccfef |
vacmViewTreeFamilySubtree including the owner index
|
|
Packit Service |
9ccfef |
portion, and vacmViewTreeFamilyMask 'wildcarding' the
|
|
Packit Service |
9ccfef |
column subidentifier. More elaborate configurations
|
|
Packit Service |
9ccfef |
are possible."
|
|
Packit Service |
9ccfef |
::= { lookupCtlEntry 1 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupCtlOperationName OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX SnmpAdminString (SIZE(0..32))
|
|
Packit Service |
9ccfef |
MAX-ACCESS not-accessible
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"The name of a lookup operation. This is locally unique,
|
|
Packit Service |
9ccfef |
within the scope of an lookupCtlOwnerIndex."
|
|
Packit Service |
9ccfef |
::= { lookupCtlEntry 2 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupCtlTargetAddressType OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX InetAddressType
|
|
Packit Service |
9ccfef |
MAX-ACCESS read-create
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"Specifies the type of address for performing a
|
|
Packit Service |
9ccfef |
lookup operation for a symbolic host name or for a host
|
|
Packit Service |
9ccfef |
address from a remote host.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
Specification of dns(16) as the value for this object
|
|
Packit Service |
9ccfef |
means that a function such as, for example, getaddrinfo()
|
|
Packit Service |
9ccfef |
or gethostbyname() should be performed to return one or
|
|
Packit Service |
9ccfef |
more numeric addresses. Use of a value of either ipv4(1)
|
|
Packit Service |
9ccfef |
or ipv6(2) means that a functions such as, for example,
|
|
Packit Service |
9ccfef |
getnameinfo() or gethostbyaddr() should be used to return
|
|
Packit Service |
9ccfef |
the symbolic names associated with a host."
|
|
Packit Service |
9ccfef |
DEFVAL { unknown }
|
|
Packit Service |
9ccfef |
::= { lookupCtlEntry 3 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupCtlTargetAddress OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX InetAddress
|
|
Packit Service |
9ccfef |
MAX-ACCESS read-create
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"Specifies the address used for a resolver lookup at a
|
|
Packit Service |
9ccfef |
remote host. The corresponding lookupCtlTargetAddressType
|
|
Packit Service |
9ccfef |
objects determines its type, as well as the function
|
|
Packit Service |
9ccfef |
that can be requested.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
A value for this object MUST be set prior to
|
|
Packit Service |
9ccfef |
transitioning its corresponding lookupCtlEntry to
|
|
Packit Service |
9ccfef |
active(1) via lookupCtlRowStatus."
|
|
Packit Service |
9ccfef |
::= { lookupCtlEntry 4 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupCtlOperStatus OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX INTEGER {
|
|
Packit Service |
9ccfef |
enabled(1), -- operation is active
|
|
Packit Service |
9ccfef |
notStarted(2), -- operation has not started
|
|
Packit Service |
9ccfef |
completed(3) -- operation is done
|
|
Packit Service |
9ccfef |
}
|
|
Packit Service |
9ccfef |
MAX-ACCESS read-only
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"Reflects the operational state of an lookupCtlEntry:
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
enabled(1) - Operation is active.
|
|
Packit Service |
9ccfef |
notStarted(2) - Operation has not been enabled.
|
|
Packit Service |
9ccfef |
completed(3) - Operation has been completed.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
An operation is automatically enabled(1) when its
|
|
Packit Service |
9ccfef |
lookupCtlRowStatus object is transitioned to active(1)
|
|
Packit Service |
9ccfef |
status. Until this occurs, lookupCtlOperStatus MUST
|
|
Packit Service |
9ccfef |
report a value of notStarted(2). After the lookup
|
|
Packit Service |
9ccfef |
operation is completed (success or failure), the value
|
|
Packit Service |
9ccfef |
for lookupCtlOperStatus MUST be transitioned to
|
|
Packit Service |
9ccfef |
completed(3)."
|
|
Packit Service |
9ccfef |
::= { lookupCtlEntry 5 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupCtlTime OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX Unsigned32
|
|
Packit Service |
9ccfef |
UNITS "milliseconds"
|
|
Packit Service |
9ccfef |
MAX-ACCESS read-only
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"Reports the number of milliseconds that a lookup
|
|
Packit Service |
9ccfef |
operation required to be completed at a remote host.
|
|
Packit Service |
9ccfef |
Completed means operation failure as well as
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
success."
|
|
Packit Service |
9ccfef |
::= { lookupCtlEntry 6 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupCtlRc OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX Integer32
|
|
Packit Service |
9ccfef |
MAX-ACCESS read-only
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"The system-specific return code from a lookup
|
|
Packit Service |
9ccfef |
operation. All implementations MUST return a value
|
|
Packit Service |
9ccfef |
of 0 for this object when the remote lookup
|
|
Packit Service |
9ccfef |
operation succeeds. A non-zero value for this
|
|
Packit Service |
9ccfef |
objects indicates failure. It is recommended that
|
|
Packit Service |
9ccfef |
implementations return the error codes that are
|
|
Packit Service |
9ccfef |
generated by the lookup function used."
|
|
Packit Service |
9ccfef |
::= { lookupCtlEntry 7 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupCtlRowStatus OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX RowStatus
|
|
Packit Service |
9ccfef |
MAX-ACCESS read-create
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"This object allows entries to be created and deleted
|
|
Packit Service |
9ccfef |
in the lookupCtlTable.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
A remote lookup operation is started when an
|
|
Packit Service |
9ccfef |
entry in this table is created via an SNMP set
|
|
Packit Service |
9ccfef |
request and the entry is activated. This
|
|
Packit Service |
9ccfef |
occurs by setting the value of this object
|
|
Packit Service |
9ccfef |
to CreateAndGo(4) during row creation or
|
|
Packit Service |
9ccfef |
by setting this object to active(1) after
|
|
Packit Service |
9ccfef |
the row is created.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
A value MUST be specified for lookupCtlTargetAddress
|
|
Packit Service |
9ccfef |
prior to the acceptance of a transition to active(1) state.
|
|
Packit Service |
9ccfef |
A remote lookup operation starts when its entry
|
|
Packit Service |
9ccfef |
first becomes active(1). Transitions in and
|
|
Packit Service |
9ccfef |
out of active(1) state have no effect on the
|
|
Packit Service |
9ccfef |
operational behavior of a remote lookup
|
|
Packit Service |
9ccfef |
operation, with the exception that deletion of
|
|
Packit Service |
9ccfef |
an entry in this table by setting its RowStatus
|
|
Packit Service |
9ccfef |
object to destroy(6) will stop an active
|
|
Packit Service |
9ccfef |
remote lookup operation.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
The operational state of a remote lookup operation
|
|
Packit Service |
9ccfef |
can be determined by examination of its
|
|
Packit Service |
9ccfef |
lookupCtlOperStatus object."
|
|
Packit Service |
9ccfef |
REFERENCE
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
"See definition of RowStatus in RFC 2579,
|
|
Packit Service |
9ccfef |
'Textual Conventions for SMIv2.'"
|
|
Packit Service |
9ccfef |
::= { lookupCtlEntry 8 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
-- Lookup Results Table
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupResultsTable OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX SEQUENCE OF LookupResultsEntry
|
|
Packit Service |
9ccfef |
MAX-ACCESS not-accessible
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"Defines the Lookup Results Table for providing
|
|
Packit Service |
9ccfef |
the capability of determining the results of a
|
|
Packit Service |
9ccfef |
operation at a remote host.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
One or more entries are added to the
|
|
Packit Service |
9ccfef |
lookupResultsTable when a lookup operation,
|
|
Packit Service |
9ccfef |
as reflected by an lookupCtlEntry, is completed
|
|
Packit Service |
9ccfef |
successfully. All entries related to a
|
|
Packit Service |
9ccfef |
successful lookup operation MUST be added
|
|
Packit Service |
9ccfef |
to the lookupResultsTable at the same time
|
|
Packit Service |
9ccfef |
that the associating lookupCtlOperStatus
|
|
Packit Service |
9ccfef |
object is transitioned to completed(2).
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
The number of entries added depends on the
|
|
Packit Service |
9ccfef |
results determined for a particular lookup
|
|
Packit Service |
9ccfef |
operation. All entries associated with an
|
|
Packit Service |
9ccfef |
lookupCtlEntry are removed when the
|
|
Packit Service |
9ccfef |
lookupCtlEntry is deleted.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
A remote host can be multi-homed and have more than one IP
|
|
Packit Service |
9ccfef |
address associated with it (returned by lookup function),
|
|
Packit Service |
9ccfef |
or it can have more than one symbolic name (returned
|
|
Packit Service |
9ccfef |
by lookup function).
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
A function such as, for example, getnameinfo() or
|
|
Packit Service |
9ccfef |
gethostbyaddr() is called with a host address as its
|
|
Packit Service |
9ccfef |
parameter and is used primarily to determine a symbolic
|
|
Packit Service |
9ccfef |
name to associate with the host address. Entries in the
|
|
Packit Service |
9ccfef |
lookupResultsTable MUST be made for each host name
|
|
Packit Service |
9ccfef |
returned. If the function identifies an 'official host
|
|
Packit Service |
9ccfef |
name,' then this symbolic name MUST be assigned a
|
|
Packit Service |
9ccfef |
lookupResultsIndex of 1.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
A function such as, for example, getaddrinfo() or
|
|
Packit Service |
9ccfef |
gethostbyname() is called with a symbolic host name and is
|
|
Packit Service |
9ccfef |
used primarily to retrieve a host address. The entries
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
MUST be stored in the order that they are retrieved from
|
|
Packit Service |
9ccfef |
the lookup function. lookupResultsIndex 1 MUST be
|
|
Packit Service |
9ccfef |
assigned to the first entry."
|
|
Packit Service |
9ccfef |
::= { lookupObjects 4 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupResultsEntry OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX LookupResultsEntry
|
|
Packit Service |
9ccfef |
MAX-ACCESS not-accessible
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"Defines an entry in the lookupResultsTable. The
|
|
Packit Service |
9ccfef |
first two index elements identify the
|
|
Packit Service |
9ccfef |
lookupCtlEntry that a lookupResultsEntry belongs
|
|
Packit Service |
9ccfef |
to. The third index element selects a single
|
|
Packit Service |
9ccfef |
lookup operation result."
|
|
Packit Service |
9ccfef |
INDEX {
|
|
Packit Service |
9ccfef |
lookupCtlOwnerIndex,
|
|
Packit Service |
9ccfef |
lookupCtlOperationName,
|
|
Packit Service |
9ccfef |
lookupResultsIndex
|
|
Packit Service |
9ccfef |
}
|
|
Packit Service |
9ccfef |
::= { lookupResultsTable 1 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
LookupResultsEntry ::=
|
|
Packit Service |
9ccfef |
SEQUENCE {
|
|
Packit Service |
9ccfef |
lookupResultsIndex Unsigned32,
|
|
Packit Service |
9ccfef |
lookupResultsAddressType InetAddressType,
|
|
Packit Service |
9ccfef |
lookupResultsAddress InetAddress
|
|
Packit Service |
9ccfef |
}
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupResultsIndex OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX Unsigned32 (1..'ffffffff'h)
|
|
Packit Service |
9ccfef |
MAX-ACCESS not-accessible
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"Entries in the lookupResultsTable are created when
|
|
Packit Service |
9ccfef |
the result of a lookup operation is determined.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
Entries MUST be stored in the lookupResultsTable in
|
|
Packit Service |
9ccfef |
the order that they are retrieved. Values assigned
|
|
Packit Service |
9ccfef |
to lookupResultsIndex MUST start at 1 and increase
|
|
Packit Service |
9ccfef |
consecutively."
|
|
Packit Service |
9ccfef |
::= { lookupResultsEntry 1 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupResultsAddressType OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX InetAddressType
|
|
Packit Service |
9ccfef |
MAX-ACCESS read-only
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
"Indicates the type of result of a remote lookup
|
|
Packit Service |
9ccfef |
operation. A value of unknown(0) implies either that
|
|
Packit Service |
9ccfef |
the operation hasn't been started or that
|
|
Packit Service |
9ccfef |
it has failed."
|
|
Packit Service |
9ccfef |
::= { lookupResultsEntry 2 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupResultsAddress OBJECT-TYPE
|
|
Packit Service |
9ccfef |
SYNTAX InetAddress
|
|
Packit Service |
9ccfef |
MAX-ACCESS read-only
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"Reflects a result for a remote lookup operation
|
|
Packit Service |
9ccfef |
as per the value of lookupResultsAddressType.
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
The address type (InetAddressType) that relates to
|
|
Packit Service |
9ccfef |
this object is specified by the corresponding value
|
|
Packit Service |
9ccfef |
of lookupResultsAddress."
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
::= { lookupResultsEntry 3 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
-- Conformance information
|
|
Packit Service |
9ccfef |
-- Compliance statements
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupCompliances OBJECT IDENTIFIER ::= { lookupConformance 1 }
|
|
Packit Service |
9ccfef |
lookupGroups OBJECT IDENTIFIER ::= { lookupConformance 2 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
-- Compliance statements
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupCompliance MODULE-COMPLIANCE
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"The compliance statement for SNMP entities that
|
|
Packit Service |
9ccfef |
fully implement the DISMAN-NSLOOKUP-MIB."
|
|
Packit Service |
9ccfef |
MODULE -- this module
|
|
Packit Service |
9ccfef |
MANDATORY-GROUPS { lookupGroup }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
OBJECT lookupMaxConcurrentRequests
|
|
Packit Service |
9ccfef |
MIN-ACCESS read-only
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"The agent is not required to support set
|
|
Packit Service |
9ccfef |
operations to this object."
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
OBJECT lookupPurgeTime
|
|
Packit Service |
9ccfef |
MIN-ACCESS read-only
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"The agent is not required to support a set
|
|
Packit Service |
9ccfef |
operation to this object."
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
::= { lookupCompliances 1 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupMinimumCompliance MODULE-COMPLIANCE
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"The minimum compliance statement for SNMP entities
|
|
Packit Service |
9ccfef |
that implement the minimal subset of the
|
|
Packit Service |
9ccfef |
DISMAN-NSLOOKUP-MIB. Implementors might choose this
|
|
Packit Service |
9ccfef |
subset for small devices with limited resources."
|
|
Packit Service |
9ccfef |
MODULE -- this module
|
|
Packit Service |
9ccfef |
MANDATORY-GROUPS { lookupGroup }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
OBJECT lookupMaxConcurrentRequests
|
|
Packit Service |
9ccfef |
MIN-ACCESS read-only
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"The agent is not required to support set
|
|
Packit Service |
9ccfef |
operations to this object."
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
OBJECT lookupPurgeTime
|
|
Packit Service |
9ccfef |
MIN-ACCESS read-only
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"The agent is not required to support a set
|
|
Packit Service |
9ccfef |
operation to this object."
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
OBJECT lookupCtlRowStatus
|
|
Packit Service |
9ccfef |
MIN-ACCESS read-only
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"Write access is not required. If write access is
|
|
Packit Service |
9ccfef |
not supported, then at least one entry in the
|
|
Packit Service |
9ccfef |
lookupCtlTable MUST be established already when the SNMP
|
|
Packit Service |
9ccfef |
agent starts offering access to the NSLOOKUP-MIB module.
|
|
Packit Service |
9ccfef |
If, in such a case, only a single entry is offered, then
|
|
Packit Service |
9ccfef |
it is RECOMMENDED that this entry use strings with a
|
|
Packit Service |
9ccfef |
length of 0 for both of its two index objects."
|
|
Packit Service |
9ccfef |
::= { lookupCompliances 2 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
-- MIB groupings
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupGroup OBJECT-GROUP
|
|
Packit Service |
9ccfef |
OBJECTS {
|
|
Packit Service |
9ccfef |
lookupMaxConcurrentRequests,
|
|
Packit Service |
9ccfef |
lookupPurgeTime,
|
|
Packit Service |
9ccfef |
lookupCtlOperStatus,
|
|
Packit Service |
9ccfef |
lookupCtlTargetAddressType,
|
|
Packit Service |
9ccfef |
lookupCtlTargetAddress,
|
|
Packit Service |
9ccfef |
lookupCtlTime,
|
|
Packit Service |
9ccfef |
lookupCtlRc,
|
|
Packit Service |
9ccfef |
lookupCtlRowStatus,
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
lookupResultsAddressType,
|
|
Packit Service |
9ccfef |
lookupResultsAddress
|
|
Packit Service |
9ccfef |
}
|
|
Packit Service |
9ccfef |
STATUS current
|
|
Packit Service |
9ccfef |
DESCRIPTION
|
|
Packit Service |
9ccfef |
"The group of objects that constitute the remote
|
|
Packit Service |
9ccfef |
Lookup operation."
|
|
Packit Service |
9ccfef |
::= { lookupGroups 1 }
|
|
Packit Service |
9ccfef |
|
|
Packit Service |
9ccfef |
END
|