home *** CD-ROM | disk | FTP | other *** search
/ PC World 2005 December / PCWorld_2005-12_cd.bin / software / vyzkuste / trikyhackeru / trikyhackeru.exe / ethereal-setup-0.10.13.exe / snmp / mibs / DISMAN-NSLOOKUP-MIB.txt < prev    next >
Text File  |  2004-08-25  |  16KB  |  491 lines
  1. DISMAN-NSLOOKUP-MIB DEFINITIONS ::= BEGIN
  2.  
  3. IMPORTS
  4.     MODULE-IDENTITY, OBJECT-TYPE,
  5.     Unsigned32, mib-2, Integer32
  6.         FROM SNMPv2-SMI                  -- RFC2578
  7.     RowStatus
  8.         FROM SNMPv2-TC                   -- RFC2579
  9.     MODULE-COMPLIANCE, OBJECT-GROUP
  10.         FROM SNMPv2-CONF                 -- RFC2580
  11.     SnmpAdminString
  12.         FROM SNMP-FRAMEWORK-MIB          -- RFC2571
  13.  
  14.  
  15.  
  16.  
  17.  
  18.     InetAddressType, InetAddress
  19.         FROM INET-ADDRESS-MIB;           -- RFC2851
  20.  
  21.  
  22.  lookupMIB MODULE-IDENTITY
  23.     LAST-UPDATED "200009210000Z"         -- 21 September 2000
  24.     ORGANIZATION "IETF Distributed Management Working Group"
  25.     CONTACT-INFO
  26.         "Kenneth White
  27.  
  28.         International Business Machines Corporation
  29.         Network Computing Software Division
  30.         Research Triangle Park, NC, USA
  31.  
  32.         E-mail: wkenneth@us.ibm.com"
  33.     DESCRIPTION
  34.         "The Lookup MIB (DISMAN-NSLOOKUP-MIB) enables determination
  35.         of either the name(s) corresponding to a host address or of
  36.         the address(es) associated with a host name at a remote host."
  37.  
  38.      --  Revision history
  39.  
  40.      REVISION     "200009210000Z"         -- 21 September 2000
  41.      DESCRIPTION
  42.          "Initial version, published as RFC 2925."
  43.  
  44.     ::= { mib-2 82 }
  45.  
  46.  -- Top level structure of the MIB
  47.  
  48.  lookupObjects        OBJECT IDENTIFIER ::= { lookupMIB 1 }
  49.  lookupConformance    OBJECT IDENTIFIER ::= { lookupMIB 2 }
  50.  
  51.  -- Simple Object Definitions
  52.  
  53.  lookupMaxConcurrentRequests OBJECT-TYPE
  54.     SYNTAX      Unsigned32
  55.     UNITS       "requests"
  56.     MAX-ACCESS  read-write
  57.     STATUS      current
  58.     DESCRIPTION
  59.        "The maximum number of concurrent active lookup requests
  60.        that are allowed within an agent implementation.  A value
  61.        of 0 for this object implies that there is no limit for
  62.        the number of concurrent active requests in effect."
  63.     DEFVAL { 10 }
  64.     ::= { lookupObjects 1 }
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  lookupPurgeTime OBJECT-TYPE
  72.     SYNTAX      Unsigned32 (0..86400)
  73.     UNITS       "seconds"
  74.     MAX-ACCESS  read-write
  75.     STATUS      current
  76.     DESCRIPTION
  77.        "The amount of time to wait before automatically
  78.        deleting an entry in the lookupCtlTable and any
  79.        dependent lookupResultsTable entries
  80.        after the lookup operation represented by an
  81.        lookupCtlEntry has completed.
  82.  
  83.        An lookupCtEntry is considered complete
  84.        when its lookupCtlOperStatus object has a
  85.        value of completed(3)."
  86.     DEFVAL { 900 }  -- 15 minutes as default
  87.     ::= { lookupObjects 2 }
  88.  
  89.  -- Lookup Control Table
  90.  
  91.  lookupCtlTable OBJECT-TYPE
  92.     SYNTAX      SEQUENCE OF LookupCtlEntry
  93.     MAX-ACCESS  not-accessible
  94.     STATUS      current
  95.     DESCRIPTION
  96.         "Defines the Lookup Control Table for providing
  97.         the capability of performing a lookup operation,
  98.         gethostbyname or gethostbyaddr, from a remote host."
  99.    ::= { lookupObjects 3 }
  100.  
  101.  lookupCtlEntry OBJECT-TYPE
  102.     SYNTAX      LookupCtlEntry
  103.     MAX-ACCESS  not-accessible
  104.     STATUS      current
  105.     DESCRIPTION
  106.         "Defines an entry in the lookupCtlTable.  A
  107.         lookupCtlEntry is initially indexed by
  108.         lookupCtlOwnerIndex, which is of type SnmpAdminString,
  109.         a textual convention that allows for use of the SNMPv3
  110.         View-Based Access Control Model (RFC 2575 [11], VACM)
  111.         and also allows an management application to identify
  112.         its entries.  The second index element,
  113.         lookupCtlOperationName, enables the same
  114.         lookupCtlOwnerIndex entity to have multiple outstanding
  115.         requests.
  116.  
  117.         The value of lookupCtlTargetAddressType determines which
  118.         lookup function to perform.  Specification of dns(16)
  119.  
  120.  
  121.  
  122.  
  123.  
  124.         as the value of this index implies that the gethostbyname
  125.         function should be performed to determine the numeric
  126.         addresses associated with a symbolic name via
  127.         lookupResultsTable entries.  Use of a value of either
  128.         ipv4(1) or ipv6(2) implies that the gethostbyaddr function
  129.         should be performed to determine the symbolic name(s)
  130.         associated with a numeric address at a remote host."
  131.     INDEX {
  132.              lookupCtlOwnerIndex,
  133.              lookupCtlOperationName
  134.           }
  135.     ::= { lookupCtlTable 1 }
  136.  
  137.  LookupCtlEntry ::=
  138.     SEQUENCE {
  139.         lookupCtlOwnerIndex         SnmpAdminString,
  140.         lookupCtlOperationName      SnmpAdminString,
  141.         lookupCtlTargetAddressType  InetAddressType,
  142.         lookupCtlTargetAddress      InetAddress,
  143.         lookupCtlOperStatus         INTEGER,
  144.         lookupCtlTime               Unsigned32,
  145.         lookupCtlRc                 Integer32,
  146.         lookupCtlRowStatus          RowStatus
  147.     }
  148.  
  149.  lookupCtlOwnerIndex OBJECT-TYPE
  150.     SYNTAX      SnmpAdminString (SIZE(0..32))
  151.     MAX-ACCESS  not-accessible
  152.     STATUS      current
  153.     DESCRIPTION
  154.        "To facilitate the provisioning of access control by a
  155.        security administrator using the View-Based Access
  156.        Control Model (RFC 2575, VACM) for tables in which
  157.        multiple users may need to independently create or
  158.        modify entries, the initial index is used as an 'owner
  159.        index'.  Such an initial index has a syntax of
  160.        SnmpAdminString, and can thus be trivially mapped to a
  161.        securityName or groupName as defined in VACM, in
  162.        accordance with a security policy.
  163.  
  164.        When used in conjunction with such a security policy all
  165.        entries in the table belonging to a particular user (or
  166.        group) will have the same value for this initial index.
  167.        For a given user's entries in a particular table, the
  168.        object identifiers for the information in these entries
  169.        will have the same subidentifiers (except for the
  170.        'column' subidentifier) up to the end of the encoded
  171.        owner index. To configure VACM to permit access to this
  172.  
  173.  
  174.  
  175.  
  176.  
  177.        portion of the table, one would create
  178.        vacmViewTreeFamilyTable entries with the value of
  179.        vacmViewTreeFamilySubtree including the owner index
  180.        portion, and vacmViewTreeFamilyMask 'wildcarding' the
  181.        column subidentifier.  More elaborate configurations
  182.        are possible."
  183.     ::= { lookupCtlEntry 1 }
  184.  
  185.  lookupCtlOperationName OBJECT-TYPE
  186.     SYNTAX      SnmpAdminString (SIZE(0..32))
  187.     MAX-ACCESS  not-accessible
  188.     STATUS      current
  189.     DESCRIPTION
  190.         "The name of a lookup operation.  This is locally unique,
  191.         within the scope of an lookupCtlOwnerIndex."
  192.     ::= { lookupCtlEntry 2 }
  193.  
  194.  lookupCtlTargetAddressType OBJECT-TYPE
  195.     SYNTAX      InetAddressType
  196.     MAX-ACCESS  read-create
  197.     STATUS      current
  198.     DESCRIPTION
  199.         "Specifies the type of address for either performing a
  200.         gethostbyname or a gethostbyaddr function at a remote host.
  201.         Specification of dns(16) as the value for this object
  202.         means that the gethostbyname function should be performed
  203.         to return one or more numeric addresses.  Use of a value
  204.         of either ipv4(1) or ipv6(2) means that the gethostbyaddr
  205.         function should be used to return the symbolic names
  206.         associated with a remote host."
  207.     ::= { lookupCtlEntry 3 }
  208.  
  209.  lookupCtlTargetAddress OBJECT-TYPE
  210.     SYNTAX      InetAddress
  211.     MAX-ACCESS  read-create
  212.     STATUS      current
  213.     DESCRIPTION
  214.         "Specifies the address used for a resolver lookup at a
  215.         remote host.  The corresponding lookupCtlAddressType
  216.         objects determines its type as well as the function
  217.         that can be requested.
  218.  
  219.         A value for this object MUST be set prior to
  220.         transitioning its corresponding lookupCtlEntry to
  221.         active(1) via lookupCtlRowStatus."
  222.     ::= { lookupCtlEntry 4 }
  223.  
  224.  lookupCtlOperStatus OBJECT-TYPE
  225.  
  226.  
  227.  
  228.  
  229.  
  230.     SYNTAX      INTEGER {
  231.                    notStarted(2), -- operation has not started
  232.                    completed(3)   -- operation is done
  233.                 }
  234.     MAX-ACCESS  read-only
  235.     STATUS      current
  236.     DESCRIPTION
  237.         "Reflects the operational state of an lookupCtlEntry:
  238.  
  239.            enabled(1)    - Operation is active.
  240.            notStarted(2) - Operation has not been enabled.
  241.            completed(3)  - Operation has completed.
  242.  
  243.          An operation is automatically enabled(1) when its
  244.          lookupCtlRowStatus object is transitioned to active(1)
  245.          status.  Until this occurs lookupCtlOperStatus MUST
  246.          report a value of notStarted(2).  After the lookup
  247.          operation completes (success or failure) the value
  248.          for lookupCtlOperStatus MUST be transitioned to
  249.          completed(3)."
  250.     ::= { lookupCtlEntry 5 }
  251.  
  252.  lookupCtlTime OBJECT-TYPE
  253.     SYNTAX      Unsigned32
  254.     UNITS       "milliseconds"
  255.     MAX-ACCESS  read-only
  256.     STATUS      current
  257.     DESCRIPTION
  258.         "Reports the number of milliseconds that a lookup
  259.         operation required to be completed at a remote host.
  260.         Completed means operation failure as well as
  261.         success."
  262.     ::= { lookupCtlEntry 6 }
  263.  
  264.  lookupCtlRc OBJECT-TYPE
  265.     SYNTAX      Integer32
  266.     MAX-ACCESS  read-only
  267.     STATUS      current
  268.     DESCRIPTION
  269.         "The system specific return code from a lookup
  270.         operation.  All implementations MUST return a value
  271.         of 0 for this object when the remote lookup
  272.         operation succeeds.  A non-zero value for this
  273.         objects indicates failure.  It is recommended that
  274.         implementations that support errno use it as the
  275.         value of this object to aid a management
  276.         application in determining the cause of failure."
  277.     ::= { lookupCtlEntry 7 }
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  lookupCtlRowStatus OBJECT-TYPE
  284.     SYNTAX      RowStatus
  285.     MAX-ACCESS  read-create
  286.     STATUS      current
  287.     DESCRIPTION
  288.         "This object allows entries to be created and deleted
  289.         in the lookupCtlTable.
  290.  
  291.         A remote lookup operation is started when an
  292.         entry in this table is created via an SNMP SET
  293.         request and the entry is activated.  This
  294.         occurs by setting the value of this object
  295.         to CreateAndGo(4) during row creation or
  296.         by setting this object to active(1) after
  297.         the row is created.
  298.  
  299.         A value MUST be specified for lookupCtlTargetAddress
  300.         prior to a transition to active(1) state being
  301.         accepted.
  302.  
  303.         A remote lookup operation starts when its entry
  304.         first becomes active(1).  Transitions in and
  305.         out of active(1) state have no effect on the
  306.         operational behavior of a remote lookup
  307.         operation, with the exception that deletion of
  308.         an entry in this table by setting its RowStatus
  309.         object to destroy(6) will stop an active
  310.         remote lookup operation.
  311.  
  312.         The operational state of a remote lookup operation
  313.         can be determined by examination of its
  314.         lookupCtlOperStatus object."
  315.     REFERENCE
  316.         "See definition of RowStatus in RFC 2579,
  317.         'Textual Conventions for SMIv2.'"
  318.     ::= { lookupCtlEntry 8 }
  319.  
  320.  
  321. -- Lookup Results Table
  322.  
  323.  lookupResultsTable OBJECT-TYPE
  324.     SYNTAX      SEQUENCE OF LookupResultsEntry
  325.     MAX-ACCESS  not-accessible
  326.     STATUS      current
  327.     DESCRIPTION
  328.         "Defines the Lookup Results Table for providing
  329.         the capability of determining the results of a
  330.         operation at a remote host.
  331.  
  332.  
  333.  
  334.  
  335.  
  336.         One or more entries are added to the
  337.         lookupResultsTable when a lookup operation,
  338.         as reflected by an lookupCtlEntry, completes
  339.         successfully.  All entries related to a
  340.         successful lookup operation MUST be added
  341.         to the lookupResultsTable at the same time
  342.         that the associating lookupCtlOperStatus
  343.         object is transitioned to completed(2).
  344.  
  345.         The number of entries added depends on the
  346.         results determined for a particular lookup
  347.         operation.  All entries associated with an
  348.         lookupCtlEntry are removed when the
  349.         lookupCtlEntry is deleted.
  350.  
  351.         A remote host can be multi-homed and have more
  352.         than one IP address associated with it
  353.         (gethostbyname results) and/or it can have more
  354.         than one symbolic name (gethostbyaddr results).
  355.  
  356.         The gethostbyaddr function is called with a
  357.         host address as its parameter and is used
  358.         primarily to determine a symbolic name to
  359.         associate with the host address.  Entries in
  360.         the lookupResultsTable MUST be made for each
  361.         host name returned.  The official host name MUST
  362.         be assigned a lookupResultsIndex of 1.
  363.  
  364.         The gethostbyname function is called with a
  365.         symbolic host name and is used primarily to
  366.         retrieve a host address.  If possible the
  367.         primary host address SHOULD be assigned a
  368.         lookupResultsIndex of 1."
  369.    ::= { lookupObjects 4 }
  370.  
  371.  lookupResultsEntry OBJECT-TYPE
  372.     SYNTAX      LookupResultsEntry
  373.     MAX-ACCESS  not-accessible
  374.     STATUS      current
  375.     DESCRIPTION
  376.         "Defines an entry in the lookupResultsTable.  The
  377.         first two index elements identify the
  378.         lookupCtlEntry that a lookupResultsEntry belongs
  379.         to.  The third index element selects a single
  380.         lookup operation result."
  381.     INDEX {
  382.              lookupCtlOwnerIndex,
  383.              lookupCtlOperationName,
  384.  
  385.  
  386.  
  387.  
  388.  
  389.              lookupResultsIndex
  390.           }
  391.     ::= { lookupResultsTable 1 }
  392.  
  393.  LookupResultsEntry ::=
  394.     SEQUENCE {
  395.         lookupResultsIndex        Unsigned32,
  396.         lookupResultsAddressType  InetAddressType,
  397.         lookupResultsAddress      InetAddress
  398.      }
  399.  
  400.  lookupResultsIndex OBJECT-TYPE
  401.     SYNTAX      Unsigned32 (1..'ffffffff'h)
  402.     MAX-ACCESS  not-accessible
  403.     STATUS      current
  404.     DESCRIPTION
  405.         "Entries in the lookupResultsTable are created when
  406.         the result of a lookup operation is determined.
  407.  
  408.         Entries MUST be stored in the lookupResultsTable in
  409.         the order that they are retrieved.  Values assigned
  410.         to lookupResultsIndex MUST start at 1 and increase
  411.         in order."
  412.     ::= { lookupResultsEntry 1 }
  413.  
  414.  lookupResultsAddressType OBJECT-TYPE
  415.     SYNTAX      InetAddressType
  416.     MAX-ACCESS  read-only
  417.     STATUS      current
  418.     DESCRIPTION
  419.         "Indicates the type of result of a remote lookup
  420.         operation.  A value of unknown(0) implies that
  421.         either the operation hasn't been started or that
  422.         it has failed."
  423.     ::= { lookupResultsEntry 2 }
  424.  
  425.  lookupResultsAddress OBJECT-TYPE
  426.     SYNTAX      InetAddress
  427.     MAX-ACCESS  read-only
  428.     STATUS      current
  429.     DESCRIPTION
  430.         "Reflects a result for a remote lookup operation
  431.         as per the value of lookupResultsAddressType."
  432.     ::= { lookupResultsEntry 3 }
  433.  
  434.  
  435.  -- Conformance information
  436.  -- Compliance statements
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  lookupCompliances OBJECT IDENTIFIER ::= { lookupConformance 1 }
  443.  lookupGroups      OBJECT IDENTIFIER ::= { lookupConformance 2 }
  444.  
  445.  -- Compliance statements
  446.  
  447.  lookupCompliance MODULE-COMPLIANCE
  448.     STATUS  current
  449.     DESCRIPTION
  450.             "The compliance statement for the DISMAN-NSLOOKUP-MIB."
  451.     MODULE  -- this module
  452.         MANDATORY-GROUPS {
  453.                             lookupGroup
  454.                           }
  455.  
  456.         OBJECT lookupMaxConcurrentRequests
  457.         MIN-ACCESS  read-only
  458.         DESCRIPTION
  459.             "The agent is not required to support SET
  460.             operations to this object."
  461.  
  462.         OBJECT lookupPurgeTime
  463.         MIN-ACCESS  read-only
  464.         DESCRIPTION
  465.             "The agent is not required to support a SET
  466.             operation to this object."
  467.     ::= { lookupCompliances 1 }
  468.  
  469.  -- MIB groupings
  470.  
  471.  lookupGroup OBJECT-GROUP
  472.    OBJECTS {
  473.              lookupMaxConcurrentRequests,
  474.              lookupPurgeTime,
  475.              lookupCtlOperStatus,
  476.              lookupCtlTargetAddressType,
  477.              lookupCtlTargetAddress,
  478.              lookupCtlTime,
  479.              lookupCtlRc,
  480.              lookupCtlRowStatus,
  481.              lookupResultsAddressType,
  482.              lookupResultsAddress
  483.            }
  484.    STATUS  current
  485.    DESCRIPTION
  486.        "The group of objects that comprise the remote
  487.        Lookup operation."
  488.     ::= { lookupGroups 1 }
  489.  
  490. END
  491.