idnits 2.17.1 draft-ietf-psamp-mib-06.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** It looks like you're using RFC 3978 boilerplate. You should update this to the boilerplate described in the IETF Trust License Policy document (see https://trustee.ietf.org/license-info), which is required now. -- Found old boilerplate from RFC 3978, Section 5.1 on line 16. -- Found old boilerplate from RFC 3978, Section 5.5 on line 2130. -- Found old boilerplate from RFC 3979, Section 5, paragraph 1 on line 2107. -- Found old boilerplate from RFC 3979, Section 5, paragraph 2 on line 2114. -- Found old boilerplate from RFC 3979, Section 5, paragraph 3 on line 2120. ** This document has an original RFC 3978 Section 5.4 Copyright Line, instead of the newer IETF Trust Copyright according to RFC 4748. ** This document has an original RFC 3978 Section 5.5 Disclaimer, instead of the newer disclaimer which includes the IETF Trust according to RFC 4748. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- == No 'Intended status' indicated for this document; assuming Proposed Standard Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- No issues found here. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the RFC 3978 Section 5.4 Copyright Line does not match the current year -- The document seems to lack a disclaimer for pre-RFC5378 work, but may have content which was first submitted before 10 November 2008. If you have contacted all the original authors and they are all willing to grant the BCP78 rights to the IETF Trust, then this is fine, and you can ignore this comment. If not, you may need to add the pre-RFC5378 disclaimer. (See the Legal Provisions document at https://trustee.ietf.org/license-info for more information.) -- The document date (June 23, 2006) is 6518 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) == Missing Reference: '1-9' is mentioned on line 353, but not defined == Missing Reference: '0-9' is mentioned on line 353, but not defined == Missing Reference: '0-9a-f' is mentioned on line 1436, but not defined == Missing Reference: '-x' is mentioned on line 1436, but not defined == Unused Reference: 'I-D.ietf-ipfix-protocol' is defined on line 2041, but no explicit reference was found in the text == Unused Reference: 'I-D.dietz-ipfix-mib' is defined on line 2046, but no explicit reference was found in the text == Outdated reference: A later version (-13) exists of draft-ietf-psamp-framework-10 ** Downref: Normative reference to an Informational draft: draft-ietf-psamp-framework (ref. 'I-D.ietf-psamp-framework') == Outdated reference: A later version (-11) exists of draft-ietf-psamp-sample-tech-07 == Outdated reference: A later version (-09) exists of draft-ietf-psamp-protocol-05 == Outdated reference: A later version (-26) exists of draft-ietf-ipfix-protocol-20 == Outdated reference: A later version (-01) exists of draft-dietz-ipfix-mib-00 -- Possible downref: Normative reference to a draft: ref. 'I-D.dietz-ipfix-mib' == Outdated reference: A later version (-11) exists of draft-ietf-psamp-info-04 Summary: 4 errors (**), 0 flaws (~~), 14 warnings (==), 8 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Network Working Group T. Dietz, Ed. 3 Internet-Draft NEC Europte Ltd. 4 Expires: December 25, 2006 B. Claise 5 Cisco Systems 6 June 23, 2006 8 Definitions of Managed Objects for Packet Sampling 9 11 Status of this Memo 13 By submitting this Internet-Draft, each author represents that any 14 applicable patent or other IPR claims of which he or she is aware 15 have been or will be disclosed, and any of which he or she becomes 16 aware will be disclosed, in accordance with Section 6 of BCP 79. 18 Internet-Drafts are working documents of the Internet Engineering 19 Task Force (IETF), its areas, and its working groups. Note that 20 other groups may also distribute working documents as Internet- 21 Drafts. 23 Internet-Drafts are draft documents valid for a maximum of six months 24 and may be updated, replaced, or obsoleted by other documents at any 25 time. It is inappropriate to use Internet-Drafts as reference 26 material or to cite them other than as "work in progress." 28 The list of current Internet-Drafts can be accessed at 29 http://www.ietf.org/ietf/1id-abstracts.txt. 31 The list of Internet-Draft Shadow Directories can be accessed at 32 http://www.ietf.org/shadow.html. 34 This Internet-Draft will expire on December 25, 2006. 36 Copyright Notice 38 Copyright (C) The Internet Society (2006). 40 Abstract 42 This memo defines managed objects for sampling and filtering 43 techniques for IP packet selection. These objects provide 44 information about managed nodes supporting packet sampling, including 45 packet sampling capabilities and configuration. They also allow to 46 configure packet sampling concerning the IP interface at which 47 packets are sampled and the packet selections methods used for 48 sampling. 50 Table of Contents 52 1. Open Issues/TODOs . . . . . . . . . . . . . . . . . . . . . . 3 54 2. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 56 3. PSAMP Documents Overview . . . . . . . . . . . . . . . . . . . 3 58 4. The Internet-Standard Management Framework . . . . . . . . . . 4 60 5. Structure of the PSAMP MIB module . . . . . . . . . . . . . . 4 61 5.1. The Sampling Group . . . . . . . . . . . . . . . . . . . . 5 62 5.1.1. Selecting All Packets . . . . . . . . . . . . . . . . 5 63 5.1.2. Systematic Count-based Sampling . . . . . . . . . . . 6 64 5.1.3. Systematic Time-based Sampling . . . . . . . . . . . . 6 65 5.1.4. Random n-out-of-N Sampling . . . . . . . . . . . . . . 6 66 5.1.5. Uniform Probabilistic Sampling . . . . . . . . . . . . 6 67 5.1.6. Non-Uniform Probabilistic Sampling . . . . . . . . . . 7 68 5.1.7. Flow State Sampling . . . . . . . . . . . . . . . . . 7 69 5.2. The Filtering Methods Group . . . . . . . . . . . . . . . 7 70 5.2.1. Match Filtering . . . . . . . . . . . . . . . . . . . 7 71 5.2.2. Hash Filtering . . . . . . . . . . . . . . . . . . . . 7 72 5.2.3. Router State Filtering . . . . . . . . . . . . . . . . 8 73 5.3. The Hash Functions Group . . . . . . . . . . . . . . . . . 9 75 6. Definition . . . . . . . . . . . . . . . . . . . . . . . . . . 10 77 7. Security Considerations . . . . . . . . . . . . . . . . . . . 43 79 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 43 81 9. Acknowledgment . . . . . . . . . . . . . . . . . . . . . . . . 43 83 10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 43 84 10.1. Normative References . . . . . . . . . . . . . . . . . . . 43 85 10.2. Informative References . . . . . . . . . . . . . . . . . . 44 87 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 45 88 Intellectual Property and Copyright Statements . . . . . . . . . . 46 90 1. Open Issues/TODOs 91 o Align MIB with other drafts, esp. the Sampling Techniques one. 92 o Is the selecting all method mandatory for all implementations? 93 o Describe row status objects to writable tables. 94 o Elaborate conformance statements. 95 o Add option template id to each parameter set for exporting option 96 data. 97 o Check data type for "microseconds", protocol type, port, template 98 id and maybe some others. 99 o Need to achieve a common layout and naming on the different MIB 100 parts. 101 o Elaborate security considerations, particularly concerning SET 102 operations. 104 2. Introduction 106 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 107 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 108 document are to be interpreted as described in RFC 2119 [RFC2119]. 110 This document is a product of the Packet Sampling (PSAMP) working 111 group. Its purpose is to define standards-based MIB modules for 112 monitoring and configuring PSAMP devices performing packet selection 113 by sampling, filtering and hashing. 115 It is assumed that packet sampling is performed according to the 116 framework defined in [I-D.ietf-psamp-framework]. Packet selection 117 methods considered in the MIB module are specified in [I-D.ietf- 118 psamp-sample-tech]. Configuration of the export of packet samples to 119 a collector is modeled according to [I-D.ietf-psamp-protocol]. The 120 exporter uses the IPFIX protocol as specified in [I-D.ietf-ipfix- 121 protocol]. 123 The MIB presented here is a module of the IPFIX MIB [I-D.dietz-ipfix- 124 mib]. It starts at an Object ID in the IPFIX MIB and imports the 125 textual conventions defined there. 127 3. PSAMP Documents Overview 129 PSAMP Framework: [I-D.ietf-psamp-framework] "A Framework for Packet 130 Selection and Reporting" The document describes the PSAMP 131 framework for network elements to select subsets of packets by 132 statistical and other methods, and to export a stream of reports 133 on the selected packets to a collector. Definitions of 134 terminology and the use of the terms "must", "should" and "may" in 135 this document are informational only. 137 PSAMP Sampling Techniques: [I-D.ietf-psamp-sample-tech] "Sampling and 138 Filtering Techniques for IP Packet Selection", describes the set 139 of packet selection techniques supported by PSAMP. 141 PSAMP MIB: "Definitions of Managed Objects for Packet Sampling" (this 142 document) describes the PSAMP Management Information Base. 144 PSAMP Protocol: [I-D.ietf-psamp-protocol] "Packet Sampling (PSAMP) 145 Protocol Specifications" specifies the export of packet 146 information from a PSAMP Exporting Process to a PSAMP Colleting 147 Process. 149 PSAMP Information Model: [I-D.ietf-psamp-info] "Information Model for 150 Packet Sampling Exports" defines an information and data model for 151 PSAMP. 153 Section 5 describes the structure of the PSAMP MIB module and section 154 6 contains the formal definition. Security issues are finally 155 discussed in section 7. 157 4. The Internet-Standard Management Framework 159 For a detailed overview of the documents that describe the current 160 Internet-Standard Management Framework, please refer to section 7 of 161 RFC 3410 [RFC3410]. 163 Managed objects are accessed via a virtual information store, termed 164 the Management Information Base or MIB. MIB objects are generally 165 accessed through the Simple Network Management Protocol (SNMP). 166 Objects in the MIB are defined using the mechanisms defined in the 167 Structure of Management Information (SMI). This memo specifies a MIB 168 module that is compliant to the SMIv2, which is described in STD 58, 169 RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 170 [RFC2580]. 172 5. Structure of the PSAMP MIB module 174 The PSAMP MIB module is structure according to the sample techniques 175 document [I-D.ietf-psamp-sample-tech]. The main structure follows 176 the building blocks of the PSAMP framework [I-D.ietf-psamp- 177 framework], describing sampling/filtering at an observation point 178 then exporting the collected information to one or more collectors. 179 The objects needed for exporting the information and describing and 180 configuring the selection methods used in the metering process are 181 already defined in the IPFIX MIB Exporter Module [I-D.dietz-ipfix- 182 mib]. 184 The PSAMP MIB Module contains parameter sets for the sampling and 185 filtering methods described in [I-D.ietf-psamp-sample-tech]. The 186 sampling and filtering methods and their parameter sets are 187 controlled by three groups of objects: The sampling group, the 188 filtering group and the hash functions group. The sampling group and 189 the filtering group define the parameters for the sampling and 190 filtering methods. The hash functions group defines the available 191 hash functions for hash based filtering. Finally we have the 192 statistics group that represent all objects collecting the optional 193 statistical values like packets observed by a hash function or 194 reports sent to a collector. 196 In the next sections we will briefly describe every object group and 197 its usage. 199 5.1. The Sampling Group 201 The first group of objects contains information about sampling 202 methods. Each sampling method is covered by an individual sub-tree 203 of this group. The following objects are defined for each method 204 except the first: a sub-group of objects indicating specific 205 capabilities and limits of the method that may be empty if no 206 capabilities or limits are available, and a sub-group specifying sets 207 of parameters in a table. Each row in the parameter set table 208 uniquely specifies all parameters of a packet sampling instance of 209 the method. Also all parameters sets contain a row status. 211 Methods and parameters of methods are specified in [I-D.ietf-psamp- 212 sample-tech]. The PSAMP MIB document specifies all methods defined 213 in the sample tech document. If some object need further 214 specification then OBJECT IDENTIFIERS are used as pointers to 215 functions or parameters that are out of the scope of this document. 216 They can be implemented in a vendor specific way or may be documented 217 in another document or a later version of this document. An 218 implementer may specify e.g., one or more functions used for non- 219 uniform probabilistic sampling. The seven methods specified in this 220 document are selecting all, systematic count-based sampling, 221 systematic time-based sampling, random n-out-of-N sampling, uniform 222 probabilistic sampling, non-uniform probabilistic sampling and flow 223 state sampling. 225 5.1.1. Selecting All Packets 227 This trivial packet selection method is alway available. If it is 228 applied, all packets will be selected. 230 5.1.2. Systematic Count-based Sampling 232 The systematic count-based sampling method has two capability 233 objects: The psampSampCountBasedMaxInterval object indicates the 234 maximum sampling interval in packets supported by the implementation, 235 whereas psampSampCountBasedMaxSpacing indicates the maximum spacing 236 in packets supported by the implementation. 238 Finally the psampSampCountBasedParamSetTable contains two parameters: 239 the sampling interval length and the spacing specified in numbers of 240 packets. 242 5.1.3. Systematic Time-based Sampling 244 The systematic time-based sampling method has two capability objects: 245 psampSampTimeBasedMaxInterval indicates the maximum sampling interval 246 in microseconds supported by the implementation, whereas 247 psampSampTimeBasedMaxSpacing indicates the maximum spacing in 248 microseconds supported by the implementation. 250 Finally the psampSampTimeBasedParamSetTable contains two parameters: 251 the sampling interval length and the spacing specified in 252 microseconds. 254 5.1.4. Random n-out-of-N Sampling 256 The random n-out-of-N sampling method has two capability objects: 257 psampSampRandOutOfNMaxPopulation specifying the maximum population N, 258 and psampSampRandOutOfNMaxSample the maximum size of n supported by 259 the implementation. 261 The random n-out-of-N sampling method has also two parameter objects 262 in the psampSampRandOutOfNParamSetTable. The first one is 263 psampSampRandOutOfNPopulation and gives the number of elements N in 264 the parent population. The second psampSampRandOutOfNSample gives 265 the number of elements n taken from the parent population N. With 266 these two parameters you sample n packets out of N. 268 5.1.5. Uniform Probabilistic Sampling 270 The uniform probabilistic sampling method has no capabilities and 271 only one parameter in the psampSampUniProbParamSetTable, the 272 psampSampUniProbProbability. This object gives the probability that 273 a packet is sampled. The probability is equal for every packet. The 274 given value must be divided by 4294967295 (=2^32-1), so a value of 0 275 means no packet is sampled (probability is 0) and a value of 276 4294967295 means every packet is sampled (probability is 1). 278 5.1.6. Non-Uniform Probabilistic Sampling 280 The non-uniform probabilistic sampling method has also no 281 capabilities defined. The psampSampNonUniProbParamSetTable contains 282 two parameters, the psampSampNonUniProbFunction and the 283 psampSampNonUniProbFuncParam. Those two objects point to the 284 function that computes the probability that a packet is sampled and 285 the parameters used for that function. The definition of the 286 function and its parameters is implementation dependent and beyond 287 the scope of this document. 289 5.1.7. Flow State Sampling 291 The capabilities and parameter set of the flow state sampling method 292 are equal to those of the non-uniform probabilistic sampling method. 293 There are no capabilities defined and the 294 psampSampFlowStateParamSetTable hold two parameters pointing to the 295 flow state function and the parameters used by the flow state 296 function (psampSampFlowStateFunction and 297 psampSampFlowStateFuncParam). Again the function and its parameters 298 are implementation dependent and beyond the scope of this document. 300 5.2. The Filtering Methods Group 302 The second group contains information about the filtering methods. 303 This group is build up similarly to the sampling methods group. It 304 currently contains three filtering methods, the match filtering, the 305 hash filtering and the router state filtering. 307 5.2.1. Match Filtering 309 The match filtering method has no capabilities defined and contains 310 four parameters in the psampFilterMatchParamSetTable: The 311 psampFilterMatchFieldId contain the PSAMP or IPFIX field id defined 312 in the information model as reference what to match. The 313 psampFilterMatchStartValue and psampFilterMatchStopValue contain the 314 start and stop value to match the content against. In this way you 315 can match e.g., a range x-z of transport protocol ports by specifying 316 the field id that represents the transport protocol port and giving x 317 as start value and y as stop value. If a single value should be 318 matched than start and stop value must be equal. A mask 319 psampFilterMatchMask can be applied if it is applicable for the field 320 id. The encoding of the values is dependent on the field id and has 321 to be done according to the PSAMP protocol document. 323 5.2.2. Hash Filtering 325 Capabilities are not specified for the hash filtering method. But 326 according to the sample tech document [I-D.ietf-psamp-sample-tech] 327 ten parameters are defined in the psampFilterHashParamSetTable. The 328 psampFilterHashAddrType specifies the address type to hash - either 329 IPv4 or IPv6. Then psampFilterHashHeaderBits specifies a bit mask 330 applied to the packet header selecting the bits to hash from the 331 packet header. Then psampFilterHashPayloadBytes gives the number of 332 payload bytes that should be included in the hashing. The final bits 333 that are selected from the payload bytes are masked with the 334 psampFilterHashPayloadBits. 336 The above parameters specified what gets feed into the hash function. 337 The following parameters specify the hash function itself. The 338 psampFilterHashFunction points to a hash function and 339 psampFilterHashFuncParam point to a function specific parameter set 340 for the hashing function. The number of input and output bits for 341 the hash function is specified with psampFilterHashInputBits and 342 psampFilterHashOutputBits. Finally the output may be masked with the 343 psampFilterHashOutputMask. The results gained by applying all those 344 parameters are then compared with the psampFilterHashSelection. The 345 psampFilterHashSelection contains the hash value ranges or single 346 hash values that get selected. The psampFilterHashSelection is a 347 human readable string containing only the ASCII characters 0-9, a-f, 348 comma(,) and dash(-). The ASCII string is defined as follows: 350 selections := selection | selections,selection 351 selection := range | value 352 range := value-value 353 value := 0x[0-9,a-f]* | [1-9][0-9]* 355 The two hash functions given in the sample tech document can be 356 referenced within this parameter set table and are also contained in 357 this PSAMP MIB document. 359 5.2.3. Router State Filtering 361 The router state filtering does also not specify any capabilities. 362 The parameter table psampFilterRStateParamSetTable contains six 363 parameters to specify the router state to filter against. The first 364 object psampFilterRStateFunction defines one of nine functions that 365 may be used as router state. 367 other: an other router state function that is not defined here. Then 368 psampFilterRStateVendorFunc points to the implementation specific 369 function that is used. 371 ingressIf: packets that enter the probe at the interface specified by 372 psampFilterRStateIfIndex are matched. 374 egressIf: packets that leave the probe at the interface specified by 375 psampFilterRStateIfIndex are matched. 377 aclViolation: packets that violate the access control list are 378 matched. 380 rpfFailure: packets for that the reverse path forwarding fails are 381 matched. 383 noResources: packets for that not enough resources are allocated will 384 be matched. 386 noRoute: packets that could not be routed further are matched. 388 originAS: packets that originate in an autonomous system specified by 389 the range of psampFilterRStateStartAS and psampFilterRStateStopAS 390 are matched. 392 destAS: packets whose destination is in an autonomous system 393 specified by the range of psampFilterRStateStartAS and 394 psampFilterRStateStopAS are matched. 396 The parameter psampFilterRStateIfIndex defaults to 0 if not used. 397 The parameters psampFilterRStateStartAS and psampFilterRStateStopAS 398 default to 0 if they are not used. If a single autonomous system 399 number should be matched psampFilterRStateStopAS remains 0. 401 5.3. The Hash Functions Group 403 The hash function group specifies the two hash functions defined in 404 the sample tech document [I-D.ietf-psamp-sample-tech]. The hash 405 functions are defined here so that they can be referenced by the hash 406 filter above. The design of the hash function part of the MIB SHOULD 407 be taken as a guideline for vendor specific hash function 408 definitions. 410 The two hash functions IPSX and Bob have both an empty parameter set 411 table since they both take now additional parameters than those 412 specified in the hash filter method. Other hash functions of course 413 could specify additional parameters. 415 6. Definition 417 PSAMP-MIB DEFINITIONS ::= BEGIN 419 IMPORTS 420 MODULE-IDENTITY, OBJECT-TYPE, Integer32, Unsigned32, mib-2 421 FROM SNMPv2-SMI -- RFC2578 422 TEXTUAL-CONVENTION, DateAndTime, DisplayString, RowStatus, 423 TruthValue 424 FROM SNMPv2-TC -- RFC2579 425 MODULE-COMPLIANCE, OBJECT-GROUP 426 FROM SNMPv2-CONF -- RFC2580 427 InterfaceIndexOrZero 428 FROM IF-MIB -- RFC2863 429 InetAddressType, InetAddress, InetAutonomousSystemNumber 430 FROM INET-ADDRESS-MIB -- RFC3291 431 PsampMethodAvailability, ipfixMIB, ipfixGroupMetering, 432 ipfixGroupReporting 433 FROM IPFIX-EXPORTER-MIB; 435 psampMIB MODULE-IDENTITY 436 LAST-UPDATED "200606221200Z" -- 22 June 2006 437 ORGANIZATION "IETF Packet Sampling Working Group" 438 CONTACT-INFO 439 "WG charter: 440 http://www.ietf.org/html.charters/psamp-charter.html 442 Mailing Lists: 443 General Discussion: psamp@ops.ietf.org 444 To Subscribe: psamp-request@ops.ietf.org 445 In Body: subscribe 446 Archive: https://ops.ietf.org/lists/psamp/ 448 Editor: 449 Thomas Dietz 450 NEC Europe Ltd. 451 Network Laboratories 452 Kurfuersten-Anlage 36 453 69115 Heidelberg 454 Germany 455 Phone: +49 6221 90511-28 456 Email: dietz@netlab.nec.de" 457 DESCRIPTION 458 "The PSAMP MIB defines managed objects for packet sampling. 459 These objects provide information about managed nodes 460 supporting packet sampling, including packet sampling 461 capabilities, configuration and statistics. 463 Copyright (C) The Internet Society (2006). This version 464 of this MIB module is part of RFC yyyy; see the RFC 465 itself for full legal notices." 466 -- RFC Ed.: replace yyyy with actual RFC number & remove this notice 468 -- Revision history 470 REVISION "200606221200Z" -- 22 June 2006 471 DESCRIPTION 472 "Initial version, published as RFC yyyy." 473 -- RFC Ed.: replace yyyy with actual RFC number & remove this notice 475 ::= { ipfixMIB 3 } 477 -- Top level structure of the MIB 479 psampObjects OBJECT IDENTIFIER ::= { psampMIB 1 } 480 psampConformance OBJECT IDENTIFIER ::= { psampMIB 2 } 482 --================================================================== 483 -- Packet selection sampling methods group of objects 484 --================================================================== 486 psampSamplingMethods OBJECT IDENTIFIER ::= { psampObjects 1 } 488 --================================================================== 489 --* Method 0: Selecting All Packets 490 --================================================================== 492 psampSelectAll OBJECT IDENTIFIER ::= { psampSamplingMethods 0 } 494 psampSelectAllAvail OBJECT-TYPE 495 SYNTAX PsampMethodAvailability 496 MAX-ACCESS read-only 497 STATUS current 498 DESCRIPTION 499 "When retrieved, this object indicates the availability of 500 the trivial method of selecting all packets." 501 DEFVAL { available } 502 ::= { psampSelectAll 1 } 504 --================================================================== 505 --* Method 1: Systematic Count-based Sampling 506 --================================================================== 508 psampSampCountBased OBJECT IDENTIFIER ::= { psampSamplingMethods 1 } 510 psampSampCountBasedAvail OBJECT-TYPE 511 SYNTAX PsampMethodAvailability 512 MAX-ACCESS read-only 513 STATUS current 514 DESCRIPTION 515 "When retrieved, this object indicates the availability of 516 systematic count-based sampling at the managed node." 517 DEFVAL { notAvailable } 518 ::= { psampSampCountBased 1 } 520 -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ 522 psampSampCountBasedCap OBJECT IDENTIFIER 523 ::= { psampSampCountBased 2 } 525 psampSampCountBasedMaxInterval OBJECT-TYPE 526 SYNTAX Unsigned32 527 UNITS "number of packets" 528 MAX-ACCESS read-only 529 STATUS current 530 DESCRIPTION 531 "When retrieved, this object indicates the maximum number 532 that can be specified for the sampling interval." 533 ::= { psampSampCountBasedCap 1 } 535 psampSampCountBasedMaxSpacing OBJECT-TYPE 536 SYNTAX Unsigned32 537 UNITS "number of packets" 538 MAX-ACCESS read-only 539 STATUS current 540 DESCRIPTION 541 "When retrieved, this object indicates the maximum number 542 that can be specified for the sampling spacing." 543 ::= { psampSampCountBasedCap 2 } 545 -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ 547 psampSampCountBasedParamSetTable OBJECT-TYPE 548 SYNTAX SEQUENCE OF 549 PsampSampCountBasedParamSetEntry 550 MAX-ACCESS not-accessible 551 STATUS current 552 DESCRIPTION 553 "This table lists configurations of systematic count-based 554 packet sampling. A parameter set describing a 555 configuration contains two parameters: the sampling 556 interval length and the spacing." 557 ::= { psampSampCountBased 3 } 559 psampSampCountBasedParamSetEntry OBJECT-TYPE 560 SYNTAX PsampSampCountBasedParamSetEntry 561 MAX-ACCESS not-accessible 562 STATUS current 563 DESCRIPTION 564 "Defines an entry in the psampSampCountBasedParamSetTable." 565 INDEX { psampSampCountBasedIndex } 566 ::= { psampSampCountBasedParamSetTable 1 } 568 PsampSampCountBasedParamSetEntry ::= 569 SEQUENCE { 570 psampSampCountBasedIndex Integer32, 571 psampSampCountBasedInterval Unsigned32, 572 psampSampCountBasedSpacing Unsigned32, 573 psampSampCountBasedRowStatus RowStatus 574 } 576 psampSampCountBasedIndex OBJECT-TYPE 577 SYNTAX Integer32 (1..2147483647) 578 MAX-ACCESS not-accessible 579 STATUS current 580 DESCRIPTION 581 "The index of this parameter set in the 582 psampSampCountBasedParamSetTable. It is used in entries of 583 the psampInstanceTable as reference to this parameter set." 584 ::= { psampSampCountBasedParamSetEntry 1 } 586 psampSampCountBasedInterval OBJECT-TYPE 587 SYNTAX Unsigned32 588 UNITS "number of packets" 589 MAX-ACCESS read-create 590 STATUS current 591 DESCRIPTION 592 "When retrieved, this object specifies the sampling interval 593 for systematic count-based sampling." 594 REFERENCE 595 "PSAMP-SAMPLE-TECH, Section 5.1" 596 -- Editor Note: get reference right! 597 ::= { psampSampCountBasedParamSetEntry 2 } 599 psampSampCountBasedSpacing OBJECT-TYPE 600 SYNTAX Unsigned32 601 UNITS "number of packets" 602 MAX-ACCESS read-create 603 STATUS current 604 DESCRIPTION 605 "When retrieved, this object specifies the sampling spacing 606 for systematic count-based sampling." 608 REFERENCE 609 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 610 -- Editor Note: get reference right! 611 ::= { psampSampCountBasedParamSetEntry 3 } 613 psampSampCountBasedRowStatus OBJECT-TYPE 614 SYNTAX RowStatus 615 MAX-ACCESS read-create 616 STATUS current 617 DESCRIPTION 618 "The status of this row of the table." 619 ::= { psampSampCountBasedParamSetEntry 4 } 621 --================================================================== 622 --* Method 2: Systematic Time-based Sampling 623 --================================================================== 625 psampSampTimeBased OBJECT IDENTIFIER ::= { psampSamplingMethods 2 } 627 psampSampTimeBasedAvail OBJECT-TYPE 628 SYNTAX PsampMethodAvailability 629 MAX-ACCESS read-only 630 STATUS current 631 DESCRIPTION 632 "When retrieved, this object indicates the availability of 633 systematic time-based sampling at the managed node." 634 DEFVAL { notAvailable } 635 ::= { psampSampTimeBased 1 } 637 -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ 639 psampSampTimeBasedCap OBJECT IDENTIFIER 640 ::= { psampSampTimeBased 2 } 642 psampSampTimeBasedMaxInterval OBJECT-TYPE 643 SYNTAX Unsigned32 644 UNITS "microseconds" 645 MAX-ACCESS read-only 646 STATUS current 647 DESCRIPTION 648 "When retrieved, this object indicates the maximum number 649 that can be specified for the sampling interval." 650 ::= { psampSampTimeBasedCap 1 } 652 psampSampTimeBasedMaxSpacing OBJECT-TYPE 653 SYNTAX Unsigned32 654 UNITS "microseconds" 655 MAX-ACCESS read-only 656 STATUS current 657 DESCRIPTION 658 "When retrieved, this object indicates the maximum number 659 that can be specified for the sampling spacing." 660 ::= { psampSampTimeBasedCap 2 } 662 -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ 664 psampSampTimeBasedParamSetTable OBJECT-TYPE 665 SYNTAX SEQUENCE OF 666 PsampSampTimeBasedParamSetEntry 667 MAX-ACCESS not-accessible 668 STATUS current 669 DESCRIPTION 670 "This table lists configurations of systematic time-based 671 packet sampling. A parameter set describing a configuration 672 contains two parameters: the sampling interval length and 673 the spacing." 674 ::= { psampSampTimeBased 3 } 676 psampSampTimeBasedParamSetEntry OBJECT-TYPE 677 SYNTAX PsampSampTimeBasedParamSetEntry 678 MAX-ACCESS not-accessible 679 STATUS current 680 DESCRIPTION 681 "Defines an entry in the psampSampTimeBasedParamSetTable." 682 INDEX { psampSampTimeBasedIndex } 683 ::= { psampSampTimeBasedParamSetTable 1 } 685 PsampSampTimeBasedParamSetEntry ::= 686 SEQUENCE { 687 psampSampTimeBasedIndex Integer32, 688 psampSampTimeBasedInterval Unsigned32, 689 psampSampTimeBasedSpacing Unsigned32, 690 psampSampTimeBasedRowStatus RowStatus 691 } 693 psampSampTimeBasedIndex OBJECT-TYPE 694 SYNTAX Integer32 (1..2147483647) 695 MAX-ACCESS not-accessible 696 STATUS current 697 DESCRIPTION 698 "The index of this parameter set in the 699 psampSampTimeBasedParameterSetTable. It is used in entries 700 of the psampInstanceTable as reference to this parameter 701 set." 702 ::= { psampSampTimeBasedParamSetEntry 1 } 704 psampSampTimeBasedInterval OBJECT-TYPE 705 SYNTAX Unsigned32 706 UNITS "microseconds" 707 MAX-ACCESS read-create 708 STATUS current 709 DESCRIPTION 710 "When retrieved, this object specifies a sampling interval 711 for systematic time-based sampling." 712 REFERENCE 713 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 714 -- Editor Note: get reference right! 715 ::= { psampSampTimeBasedParamSetEntry 2 } 717 psampSampTimeBasedSpacing OBJECT-TYPE 718 SYNTAX Unsigned32 719 UNITS "microseconds" 720 MAX-ACCESS read-create 721 STATUS current 722 DESCRIPTION 723 "When retrieved, this object specifies a sampling spacing 724 for systematic time-based sampling." 725 REFERENCE 726 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 727 -- Editor Note: get reference right! 728 ::= { psampSampTimeBasedParamSetEntry 3 } 730 psampSampTimeBasedRowStatus OBJECT-TYPE 731 SYNTAX RowStatus 732 MAX-ACCESS read-create 733 STATUS current 734 DESCRIPTION 735 "The status of this row of the table." 736 ::= { psampSampTimeBasedParamSetEntry 4 } 738 --================================================================== 739 --* Method 3: Random n-out-of-N Sampling 740 --================================================================== 742 psampSampRandOutOfN OBJECT IDENTIFIER ::= { psampSamplingMethods 3 } 744 psampSampRandOutOfNAvail OBJECT-TYPE 745 SYNTAX PsampMethodAvailability 746 MAX-ACCESS read-only 747 STATUS current 748 DESCRIPTION 749 "When retrieved, this object indicates the availability of 750 random n-out-of-N sampling at the managed node." 751 DEFVAL { notAvailable } 752 ::= { psampSampRandOutOfN 1 } 754 -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ 756 psampSampRandOutOfNCap OBJECT IDENTIFIER 757 ::= { psampSampRandOutOfN 2 } 759 psampSampRandOutOfNMaxPopulation OBJECT-TYPE 760 SYNTAX Unsigned32 761 UNITS "number of packets" 762 MAX-ACCESS read-only 763 STATUS current 764 DESCRIPTION 765 "When retrieved, this object indicates the maximum number 766 that can be specified for the population size." 767 ::= { psampSampRandOutOfNCap 1 } 769 psampSampRandOutOfNMaxSample OBJECT-TYPE 770 SYNTAX Unsigned32 771 UNITS "number of packets" 772 MAX-ACCESS read-only 773 STATUS current 774 DESCRIPTION 775 "When retrieved, this object indicates the maximum number 776 that can be specified for the sampling size." 777 ::= { psampSampRandOutOfNCap 2 } 779 -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ 781 psampSampRandOutOfNParamSetTable OBJECT-TYPE 782 SYNTAX SEQUENCE OF 783 PsampSampRandOutOfNParamSetEntry 784 MAX-ACCESS not-accessible 785 STATUS current 786 DESCRIPTION 787 "This table lists configurations of random n-out-of-N 788 sampling. A parameter set describing a configuration 789 contains a single parameter only: the sampling rate." 790 ::= { psampSampRandOutOfN 3 } 792 psampSampRandOutOfNParamSetEntry OBJECT-TYPE 793 SYNTAX PsampSampRandOutOfNParamSetEntry 794 MAX-ACCESS not-accessible 795 STATUS current 796 DESCRIPTION 797 "Defines an entry in the psampSampRandOutOfNParamSetTable." 798 INDEX { psampSampRandOutOfNIndex } 799 ::= { psampSampRandOutOfNParamSetTable 1 } 801 PsampSampRandOutOfNParamSetEntry ::= 802 SEQUENCE { 803 psampSampRandOutOfNIndex Integer32, 804 psampSampRandOutOfNPopulation Unsigned32, 805 psampSampRandOutOfNSample Unsigned32, 806 psampSampRandOutOfNRowStatus RowStatus 807 } 809 psampSampRandOutOfNIndex OBJECT-TYPE 810 SYNTAX Integer32 (1..2147483647) 811 MAX-ACCESS not-accessible 812 STATUS current 813 DESCRIPTION 814 "The index of this parameter set in the 815 psampSampRandOutOfNParamSetTable. It is used in entries of 816 the psampInstanceTable as reference to this parameter set." 817 ::= { psampSampRandOutOfNParamSetEntry 1 } 819 psampSampRandOutOfNPopulation OBJECT-TYPE 820 SYNTAX Unsigned32 821 UNITS "packets" 822 MAX-ACCESS read-create 823 STATUS current 824 DESCRIPTION 825 "When retrieved, this object specifies the number of elements 826 in the parent population of the sampling algorithm." 827 REFERENCE 828 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 829 -- Editor Note: get reference right! 830 ::= { psampSampRandOutOfNParamSetEntry 2 } 832 psampSampRandOutOfNSample OBJECT-TYPE 833 SYNTAX Unsigned32 834 UNITS "packets" 835 MAX-ACCESS read-create 836 STATUS current 837 DESCRIPTION 838 "When retrieved, this object specifies the number of 839 elements that are sampled from the parent population of the 840 sampling algorithm." 841 REFERENCE 842 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 843 -- Editor Note: get reference right! 844 ::= { psampSampRandOutOfNParamSetEntry 3 } 846 psampSampRandOutOfNRowStatus OBJECT-TYPE 847 SYNTAX RowStatus 848 MAX-ACCESS read-create 849 STATUS current 850 DESCRIPTION 851 "The status of this row of the table." 852 ::= { psampSampRandOutOfNParamSetEntry 4 } 854 --================================================================== 855 --* Method 4: Uniform Probabilistic Sampling 856 --================================================================== 858 psampSampUniProb OBJECT IDENTIFIER ::= { psampSamplingMethods 4 } 860 psampSampUniProbAvail OBJECT-TYPE 861 SYNTAX PsampMethodAvailability 862 MAX-ACCESS read-only 863 STATUS current 864 DESCRIPTION 865 "When retrieved, this object indicates the availability of 866 random uniform probabilistic sampling at the managed node." 867 DEFVAL { notAvailable } 868 ::= { psampSampUniProb 1 } 870 psampSampUniProbCap OBJECT IDENTIFIER 871 ::= { psampSampUniProb 2 } 873 -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ 875 -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ 877 psampSampUniProbParamSetTable OBJECT-TYPE 878 SYNTAX SEQUENCE OF 879 PsampSampUniProbParamSetEntry 880 MAX-ACCESS not-accessible 881 STATUS current 882 DESCRIPTION 883 "This table lists configurations of random probabilistic 884 sampling. A parameter set describing a configuration 885 contains a single parameter only: the sampling rate." 886 ::= { psampSampUniProb 3 } 888 psampSampUniProbParamSetEntry OBJECT-TYPE 889 SYNTAX PsampSampUniProbParamSetEntry 890 MAX-ACCESS not-accessible 891 STATUS current 892 DESCRIPTION 893 "Defines an entry in the psampSampUniProbParamSetTable." 894 INDEX { psampSampUniProbIndex } 895 ::= { psampSampUniProbParamSetTable 1 } 897 PsampSampUniProbParamSetEntry ::= 898 SEQUENCE { 899 psampSampUniProbIndex Integer32, 900 psampSampUniProbProbability Unsigned32, 901 psampSampUniProbRowStatus RowStatus 902 } 904 psampSampUniProbIndex OBJECT-TYPE 905 SYNTAX Integer32 (1..2147483647) 906 MAX-ACCESS not-accessible 907 STATUS current 908 DESCRIPTION 909 "The index of this parameter set in the 910 psampSampUniProbParameterSetTable. It is used in entries of 911 the psampInstanceTable as reference to this parameter set." 912 ::= { psampSampUniProbParamSetEntry 1 } 914 psampSampUniProbProbability OBJECT-TYPE 915 SYNTAX Unsigned32 (0..4294967295) 916 UNITS "packets" 917 MAX-ACCESS read-create 918 STATUS current 919 DESCRIPTION 920 "When retrieved, this object specifies the number of 921 elements in the parent population of the sampling 922 algorithm." 923 REFERENCE 924 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 925 -- Editor Note: get reference right! 926 ::= { psampSampUniProbParamSetEntry 2 } 928 psampSampUniProbRowStatus OBJECT-TYPE 929 SYNTAX RowStatus 930 MAX-ACCESS read-create 931 STATUS current 932 DESCRIPTION 933 "The status of this row of the table." 934 ::= { psampSampUniProbParamSetEntry 3 } 936 --================================================================== 937 --* Method 5: Non-Uniform Probabilistic Sampling 938 --================================================================== 940 psampSampNonUniProb OBJECT IDENTIFIER ::= { psampSamplingMethods 5 } 942 psampSampNonUniProbAvail OBJECT-TYPE 943 SYNTAX PsampMethodAvailability 944 MAX-ACCESS read-only 945 STATUS current 946 DESCRIPTION 947 "When retrieved, this object indicates the availability of 948 random non-uniform probabilistic sampling at the managed 949 node." 950 DEFVAL { notAvailable } 951 ::= { psampSampNonUniProb 1 } 953 -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ 955 -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ 957 psampSampNonUniProbParamSetTable OBJECT-TYPE 958 SYNTAX SEQUENCE OF 959 PsampSampNonUniProbParamSetEntry 960 MAX-ACCESS not-accessible 961 STATUS current 962 DESCRIPTION 963 "This table lists configurations of random probabilistic 964 sampling. A parameter set describing a configuration 965 contains a single parameter only: the sampling rate." 966 ::= { psampSampNonUniProb 3 } 968 psampSampNonUniProbParamSetEntry OBJECT-TYPE 969 SYNTAX PsampSampNonUniProbParamSetEntry 970 MAX-ACCESS not-accessible 971 STATUS current 972 DESCRIPTION 973 "Defines an entry in the psampSampNonUniProbParamSetTable." 974 INDEX { psampSampNonUniProbIndex } 975 ::= { psampSampNonUniProbParamSetTable 1 } 977 PsampSampNonUniProbParamSetEntry ::= 978 SEQUENCE { 979 psampSampNonUniProbIndex Integer32, 980 psampSampNonUniProbFunction OBJECT IDENTIFIER, 981 psampSampNonUniProbFuncParam OBJECT IDENTIFIER, 982 psampSampNonUniProbRowStatus RowStatus 983 } 985 psampSampNonUniProbIndex OBJECT-TYPE 986 SYNTAX Integer32 (1..2147483647) 987 MAX-ACCESS not-accessible 988 STATUS current 989 DESCRIPTION 990 "The index of this parameter set in the 991 psampSampNonUniProbParameterSetTable. It is used in entries 992 of the psampInstanceTable as reference to this parameter 993 set." 994 ::= { psampSampNonUniProbParamSetEntry 1 } 996 psampSampNonUniProbFunction OBJECT-TYPE 997 SYNTAX OBJECT IDENTIFIER 998 MAX-ACCESS read-create 999 STATUS current 1000 DESCRIPTION 1001 "When retrieved, this object specifies the function that is 1002 used to compute the probability for sampling." 1003 REFERENCE 1004 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 1005 -- Editor Note: get reference right! 1006 ::= { psampSampNonUniProbParamSetEntry 2 } 1008 psampSampNonUniProbFuncParam OBJECT-TYPE 1009 SYNTAX OBJECT IDENTIFIER 1010 MAX-ACCESS read-create 1011 STATUS current 1012 DESCRIPTION 1013 "When retrieved, this object specifies the parameter set for 1014 the function specified with psampSampNonUniProbFunction 1015 that is used to compute the probability for sampling." 1016 REFERENCE 1017 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 1018 -- Editor Note: get reference right! 1019 ::= { psampSampNonUniProbParamSetEntry 3 } 1021 psampSampNonUniProbRowStatus OBJECT-TYPE 1022 SYNTAX RowStatus 1023 MAX-ACCESS read-create 1024 STATUS current 1025 DESCRIPTION 1026 "The status of this row of the table." 1027 ::= { psampSampNonUniProbParamSetEntry 4 } 1029 --================================================================== 1030 --* Method 6: Flow State Sampling 1031 --================================================================== 1033 psampSampFlowState OBJECT IDENTIFIER ::= { psampSamplingMethods 6 } 1035 psampSampFlowStateAvail OBJECT-TYPE 1036 SYNTAX PsampMethodAvailability 1037 MAX-ACCESS read-only 1038 STATUS current 1039 DESCRIPTION 1040 "When retrieved, this object indicates the availability of 1041 flow state sampling at the managed node." 1042 DEFVAL { notAvailable } 1043 ::= { psampSampFlowState 1 } 1045 -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1047 -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ 1049 psampSampFlowStateParamSetTable OBJECT-TYPE 1050 SYNTAX SEQUENCE OF 1051 PsampSampFlowStateParamSetEntry 1052 MAX-ACCESS not-accessible 1053 STATUS current 1054 DESCRIPTION 1055 "This table lists configurations of random probabilistic 1056 sampling. A parameter set describing a configuration 1057 contains a single parameter only: the sampling rate." 1058 ::= { psampSampFlowState 3 } 1060 psampSampFlowStateParamSetEntry OBJECT-TYPE 1061 SYNTAX PsampSampFlowStateParamSetEntry 1062 MAX-ACCESS not-accessible 1063 STATUS current 1064 DESCRIPTION 1065 "Defines an entry in the psampSampFlowStateParamSetTable." 1066 INDEX { psampSampFlowStateIndex } 1067 ::= { psampSampFlowStateParamSetTable 1 } 1069 PsampSampFlowStateParamSetEntry ::= 1070 SEQUENCE { 1071 psampSampFlowStateIndex Integer32, 1072 psampSampFlowStateFunction OBJECT IDENTIFIER, 1073 psampSampFlowStateFuncParam OBJECT IDENTIFIER, 1074 psampSampFlowStateRowStatus RowStatus 1075 } 1077 psampSampFlowStateIndex OBJECT-TYPE 1078 SYNTAX Integer32 (1..2147483647) 1079 MAX-ACCESS not-accessible 1080 STATUS current 1081 DESCRIPTION 1082 "The index of this parameter set in the 1083 psampSampFlowStateParameterSetTable. It is used in entries 1084 of the psampInstanceTable as reference to this parameter 1085 set." 1086 ::= { psampSampFlowStateParamSetEntry 1 } 1088 psampSampFlowStateFunction OBJECT-TYPE 1089 SYNTAX OBJECT IDENTIFIER 1090 MAX-ACCESS read-create 1091 STATUS current 1092 DESCRIPTION 1093 "When retrieved, this object specifies the function that is 1094 used to check the flow state for sampling." 1095 REFERENCE 1096 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 1097 -- Editor Note: get reference right! 1098 ::= { psampSampFlowStateParamSetEntry 2 } 1100 psampSampFlowStateFuncParam OBJECT-TYPE 1101 SYNTAX OBJECT IDENTIFIER 1102 MAX-ACCESS read-create 1103 STATUS current 1104 DESCRIPTION 1105 "When retrieved, this object specifies the parameter set for 1106 the function specified with psampSampFlowStateFunction that 1107 is used to determine the packet that is to be sampled." 1108 REFERENCE 1109 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 1110 -- Editor Note: get reference right! 1111 ::= { psampSampFlowStateParamSetEntry 3 } 1113 psampSampFlowStateRowStatus OBJECT-TYPE 1114 SYNTAX RowStatus 1115 MAX-ACCESS read-create 1116 STATUS current 1117 DESCRIPTION 1118 "The status of this row of the table." 1119 ::= { psampSampFlowStateParamSetEntry 4 } 1121 --================================================================== 1122 -- Packet selection filtering methods group of objects 1123 --================================================================== 1125 psampFilteringMethods OBJECT IDENTIFIER ::= { psampObjects 2 } 1127 --================================================================== 1128 --* Method 0: Match filtering 1129 --================================================================== 1131 psampFilterMatch OBJECT IDENTIFIER ::= { psampFilteringMethods 0 } 1133 psampFilterMatchAvail OBJECT-TYPE 1134 SYNTAX PsampMethodAvailability 1135 MAX-ACCESS read-only 1136 STATUS current 1137 DESCRIPTION 1138 "When retrieved, this object indicates the availability of 1139 match filtering at the managed node." 1140 DEFVAL { notAvailable } 1141 ::= { psampFilterMatch 1 } 1143 -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1145 -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ 1147 psampFilterMatchParamSetTable OBJECT-TYPE 1148 SYNTAX SEQUENCE OF 1149 PsampFilterMatchParamSetEntry 1150 MAX-ACCESS not-accessible 1151 STATUS current 1152 DESCRIPTION 1153 "This table lists configurations of match filtering. The 1154 match filtering is based on the IPFIX/PSAMP Information 1155 Elements. The parameter set contains the Field Id, a value 1156 or value range and a mask." 1157 ::= { psampFilterMatch 3 } 1159 psampFilterMatchParamSetEntry OBJECT-TYPE 1160 SYNTAX PsampFilterMatchParamSetEntry 1161 MAX-ACCESS not-accessible 1162 STATUS current 1163 DESCRIPTION 1164 "Defines an entry in the psampFilterMatchParamSetTable." 1165 INDEX { psampFilterMatchIndex } 1166 ::= { psampFilterMatchParamSetTable 1 } 1168 PsampFilterMatchParamSetEntry ::= 1169 SEQUENCE { 1170 psampFilterMatchIndex Integer32, 1171 psampFilterMatchFieldId Integer32, 1172 psampFilterMatchStartValue OCTET STRING, 1173 psampFilterMatchStopValue OCTET STRING, 1174 psampFilterMatchMask OCTET STRING, 1175 psampFilterMatchRowStatus RowStatus 1176 } 1178 psampFilterMatchIndex OBJECT-TYPE 1179 SYNTAX Integer32 (1..2147483647) 1180 MAX-ACCESS not-accessible 1181 STATUS current 1182 DESCRIPTION 1183 "The index of this parameter set in the 1184 psampFilterMatchParameterSetTable. It is used in entries of 1185 the psampInstanceTable as reference to this parameter set." 1186 ::= { psampFilterMatchParamSetEntry 1 } 1188 psampFilterMatchFieldId OBJECT-TYPE 1189 SYNTAX Integer32 (1..2147483647) 1190 MAX-ACCESS read-create 1191 STATUS current 1192 DESCRIPTION 1193 "The id of the field that is encoded as the FieldId defined 1194 in the IPFIX/PSAMP Information Models." 1195 REFERENCE 1196 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1, ipfix and 1197 psamp info model!!" 1198 -- Editor Note: get reference right! 1199 ::= { psampFilterMatchParamSetEntry 2 } 1201 psampFilterMatchStartValue OBJECT-TYPE 1202 SYNTAX OCTET STRING 1203 MAX-ACCESS read-create 1204 STATUS current 1205 DESCRIPTION 1206 "The value of the field or the start of the value range if 1207 psampFilterMatchStopValue is not equal to this value. The 1208 data type and its encoding is the same as in PSAMP-PROTO." 1209 REFERENCE 1210 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1, PROTO!!" 1211 -- Editor Note: get reference right! 1212 ::= { psampFilterMatchParamSetEntry 3 } 1214 psampFilterMatchStopValue OBJECT-TYPE 1215 SYNTAX OCTET STRING 1216 MAX-ACCESS read-create 1217 STATUS current 1218 DESCRIPTION 1219 "The final value of a value range. It should be equal to 1220 psampFilterMatchStartValue if a single value should be 1221 encoded. The data type and its encoding is the same as in 1222 PSAMP-PROTO." 1223 REFERENCE 1224 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1, PROTO!!" 1225 -- Editor Note: get reference right! 1226 ::= { psampFilterMatchParamSetEntry 4 } 1228 psampFilterMatchMask OBJECT-TYPE 1229 SYNTAX OCTET STRING 1230 MAX-ACCESS read-create 1231 STATUS current 1232 DESCRIPTION 1233 "The value of the field is a mask like the netmask for IP 1234 addresses if this is applicable for the given field Id 1235 psampFilterMatchFieldId or empty if not. The data type and 1236 its encoding is the same as in PSAMP-PROTO." 1237 REFERENCE 1238 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1, PROTO!!" 1239 -- Editor Note: get reference right! 1240 DEFVAL { ''H } 1241 ::= { psampFilterMatchParamSetEntry 5 } 1243 psampFilterMatchRowStatus OBJECT-TYPE 1244 SYNTAX RowStatus 1245 MAX-ACCESS read-create 1246 STATUS current 1247 DESCRIPTION 1248 "The status of this row of the table." 1249 ::= { psampFilterMatchParamSetEntry 6 } 1251 --================================================================== 1252 --* Method 1: Hash filtering 1253 --================================================================== 1255 psampFilterHash OBJECT IDENTIFIER ::= { psampFilteringMethods 1 } 1257 psampFilterHashAvail OBJECT-TYPE 1258 SYNTAX PsampMethodAvailability 1259 MAX-ACCESS read-only 1260 STATUS current 1261 DESCRIPTION 1262 "When retrieved, this object indicates the availability of 1263 hash filtering at the managed node." 1264 DEFVAL { notAvailable } 1265 ::= { psampFilterHash 1 } 1267 psampFilterHashCapabilities OBJECT IDENTIFIER 1268 ::= { psampFilterHash 2 } 1270 -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1272 -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ 1274 psampFilterHashParamSetTable OBJECT-TYPE 1275 SYNTAX SEQUENCE OF 1276 PsampFilterHashParamSetEntry 1277 MAX-ACCESS not-accessible 1278 STATUS current 1279 DESCRIPTION 1280 "This table lists configurations of hash filtering. A 1281 parameter set describing a configuration contains ten 1282 parameter describing the hash function, the input bits feed 1283 into the hash function and the output of the function." 1284 ::= { psampFilterHash 3 } 1286 psampFilterHashParamSetEntry OBJECT-TYPE 1287 SYNTAX PsampFilterHashParamSetEntry 1288 MAX-ACCESS not-accessible 1289 STATUS current 1290 DESCRIPTION 1291 "Defines an entry in the psampFilterHashParamSetTable." 1292 INDEX { psampFilterHashIndex } 1293 ::= { psampFilterHashParamSetTable 1 } 1295 PsampFilterHashParamSetEntry ::= 1296 SEQUENCE { 1297 psampFilterHashIndex Integer32, 1298 psampFilterHashAddrType InetAddressType, 1299 psampFilterHashHeaderBits OCTET STRING, 1300 psampFilterHashPayloadBytes Integer32, 1301 psampFilterHashPayloadBits OCTET STRING, 1302 psampFilterHashFunction OBJECT IDENTIFIER, 1303 psampFilterHashFuncParam OBJECT IDENTIFIER, 1304 psampFilterHashInputBits Integer32, 1305 psampFilterHashOutputBits Integer32, 1306 psampFilterHashOutputMask OCTET STRING, 1307 psampFilterHashSelection DisplayString, 1308 psampFilterHashRowStatus RowStatus 1309 } 1311 psampFilterHashIndex OBJECT-TYPE 1312 SYNTAX Integer32 (1..2147483647) 1313 MAX-ACCESS not-accessible 1314 STATUS current 1315 DESCRIPTION 1316 "The index of this parameter set in the 1317 psampFilterHashParamSetTable. It is used in entries of the 1318 psampInstanceTable as reference to this parameter set." 1319 ::= { psampFilterHashParamSetEntry 1 } 1321 psampFilterHashAddrType OBJECT-TYPE 1322 SYNTAX InetAddressType 1323 MAX-ACCESS read-create 1324 STATUS current 1325 DESCRIPTION 1326 "The address type the hash function is applied to (either 1327 IPv4 or IPv6 packets)." 1328 REFERENCE 1329 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 1330 -- Editor Note: get reference right! 1331 ::= { psampFilterHashParamSetEntry 2 } 1333 psampFilterHashHeaderBits OBJECT-TYPE 1334 SYNTAX OCTET STRING (SIZE (40)) 1335 MAX-ACCESS read-create 1336 STATUS current 1337 DESCRIPTION 1338 "The object specifies the header bits used for hashing. The 1339 size is 40 bytes but when psampFilterHashAddrType is IPv4 1340 then only the first 20 bytes are used." 1341 REFERENCE 1342 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 1343 -- Editor Note: get reference right! 1344 ::= { psampFilterHashParamSetEntry 3 } 1346 psampFilterHashPayloadBytes OBJECT-TYPE 1347 SYNTAX Integer32 (0..2147483647) 1348 MAX-ACCESS read-create 1349 STATUS current 1350 DESCRIPTION 1351 "The number of bytes of payload used as input to the hash 1352 function." 1353 REFERENCE 1354 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 1355 -- Editor Note: get reference right! 1356 ::= { psampFilterHashParamSetEntry 4 } 1358 psampFilterHashPayloadBits OBJECT-TYPE 1359 SYNTAX OCTET STRING 1360 MAX-ACCESS read-create 1361 STATUS current 1362 DESCRIPTION 1363 "The object specifies the payload bits used for hashing. The 1364 size depends on the value of psampFilterHashPayloadBytes." 1365 REFERENCE 1366 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 1367 -- Editor Note: get reference right! 1368 ::= { psampFilterHashParamSetEntry 5 } 1370 psampFilterHashFunction OBJECT-TYPE 1371 SYNTAX OBJECT IDENTIFIER 1372 MAX-ACCESS read-create 1373 STATUS current 1374 DESCRIPTION 1375 "When retrieved, this object specifies the the hash function 1376 executed by the current filtering method." 1378 ::= { psampFilterHashParamSetEntry 6 } 1380 psampFilterHashFuncParam OBJECT-TYPE 1381 SYNTAX OBJECT IDENTIFIER 1382 MAX-ACCESS read-create 1383 STATUS current 1384 DESCRIPTION 1385 "When retrieved, this object specifies the the paramters 1386 used in addition to those specified in this table." 1387 ::= { psampFilterHashParamSetEntry 7 } 1389 psampFilterHashInputBits OBJECT-TYPE 1390 SYNTAX Integer32 (1..2147483647) 1391 MAX-ACCESS read-create 1392 STATUS current 1393 DESCRIPTION 1394 "The number of bits used as input key to the hash function. 1395 Usually this should be in the form of 2^x." 1396 REFERENCE 1397 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 1398 -- Editor Note: get reference right! 1399 ::= { psampFilterHashParamSetEntry 8 } 1401 psampFilterHashOutputBits OBJECT-TYPE 1402 SYNTAX Integer32 (1..2147483647) 1403 MAX-ACCESS read-create 1404 STATUS current 1405 DESCRIPTION 1406 "The number of bits that form the output value of the hash 1407 function. Usually this should be in the form of 2^x." 1408 REFERENCE 1409 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 1410 -- Editor Note: get reference right! 1411 ::= { psampFilterHashParamSetEntry 9 } 1413 psampFilterHashOutputMask OBJECT-TYPE 1414 SYNTAX OCTET STRING 1415 MAX-ACCESS read-create 1416 STATUS current 1417 DESCRIPTION 1418 "The mask applied to the output bits of the hash function. 1419 If less hash values are needed the number of hashes can be 1420 reduced by masking the output value. The size is dependent 1421 on the number of output bits. If the output mask is empty 1422 then no mask is applied." 1423 REFERENCE 1424 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 1425 -- Editor Note: get reference right! 1426 DEFVAL { ''H } 1427 ::= { psampFilterHashParamSetEntry 10 } 1429 psampFilterHashSelection OBJECT-TYPE 1430 SYNTAX DisplayString 1431 MAX-ACCESS read-create 1432 STATUS current 1433 DESCRIPTION 1434 "This object represents the hash values that select a 1435 packet. It is represented in a human readable form. The 1436 only allowed characters are [0-9a-f,-x]. A single hash 1437 value is represented by its decimal ASCII notation or if 1438 prefixed with 0x by its hexadecimal ASCII notation. A range 1439 can be given by hash_value - hash_value and several single 1440 values or ranges are separated by , (comma). So, if you 1441 with to select hash values 0, 5 - 10 and 250-255 you could 1442 specify: 0,5-10,0xfa-0xff" 1443 REFERENCE 1444 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 1445 -- Editor Note: get reference right! 1446 ::= { psampFilterHashParamSetEntry 11 } 1448 psampFilterHashRowStatus OBJECT-TYPE 1449 SYNTAX RowStatus 1450 MAX-ACCESS read-create 1451 STATUS current 1452 DESCRIPTION 1453 "The status of this row of the table." 1454 ::= { psampFilterHashParamSetEntry 12 } 1456 --================================================================== 1457 --* Method 2: Router State filtering 1458 --================================================================== 1460 psampFilterRState OBJECT IDENTIFIER ::= { psampFilteringMethods 2 } 1462 psampFilterRStateAvail OBJECT-TYPE 1463 SYNTAX PsampMethodAvailability 1464 MAX-ACCESS read-only 1465 STATUS current 1466 DESCRIPTION 1467 "When retrieved, this object indicates the availability of 1468 router state filtering at the managed node." 1469 DEFVAL { notAvailable } 1470 ::= { psampFilterRState 1 } 1472 -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1473 -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ 1475 psampFilterRStateParamSetTable OBJECT-TYPE 1476 SYNTAX SEQUENCE OF 1477 PsampFilterRStateParamSetEntry 1478 MAX-ACCESS not-accessible 1479 STATUS current 1480 DESCRIPTION 1481 "This table lists configurations of router state filtering. 1482 A parameter set describing a configuration contains six 1483 parameters: the router state function executed, and then 1484 some parameters that are used dependent on the router state 1485 function, like interface index or autonomous system number 1486 range." 1487 ::= { psampFilterRState 3 } 1489 psampFilterRStateParamSetEntry OBJECT-TYPE 1490 SYNTAX PsampFilterRStateParamSetEntry 1491 MAX-ACCESS not-accessible 1492 STATUS current 1493 DESCRIPTION 1494 "Defines an entry in the psampFilterRStateParamSetTable." 1495 INDEX { psampFilterRStateIndex } 1496 ::= { psampFilterRStateParamSetTable 1 } 1498 PsampFilterRStateParamSetEntry ::= 1499 SEQUENCE { 1500 psampFilterRStateIndex Integer32, 1501 psampFilterRStateFunction INTEGER, 1502 psampFilterRStateNegate TruthValue, 1503 psampFilterRStateIfIndex InterfaceIndexOrZero, 1504 psampFilterRStateStartAS InetAutonomousSystemNumber, 1505 psampFilterRStateStopAS InetAutonomousSystemNumber, 1506 psampFilterRStateVendorFunc OBJECT IDENTIFIER, 1507 psampFilterRStateRowStatus RowStatus 1508 } 1510 psampFilterRStateIndex OBJECT-TYPE 1511 SYNTAX Integer32 (1..2147483647) 1512 MAX-ACCESS not-accessible 1513 STATUS current 1514 DESCRIPTION 1515 "The index of this parameter set in the 1516 psampFilterRStateParameterSetTable. 1517 It is used in entries of the psampInstanceTable as 1518 reference to this parameter set." 1519 ::= { psampFilterRStateParamSetEntry 1 } 1521 psampFilterRStateFunction OBJECT-TYPE 1522 SYNTAX INTEGER { 1523 other (1), 1524 ingressIf (2), 1525 egressIf (3), 1526 aclViolation (4), 1527 rpfFailure (5), 1528 noResources (6), 1529 noRoute (7), 1530 originAS (8), 1531 destAS (9) 1532 } 1533 MAX-ACCESS read-create 1534 STATUS current 1535 DESCRIPTION 1536 "This object indicates which function is applied to the 1537 router state. The validity of the following objects depends 1538 on the function selected here. The psampFilterRStateIfIndex 1539 is only valid if the function is ingressIf or egressIf. The 1540 psampFilterRstateStartAS/StopAS objects are only valid if 1541 the function is originAS or destAS. The 1542 psampFilterRStateVendor object is only valid if the function 1543 other is chosen. Then it point to a vendor specific 1544 function." 1545 REFERENCE 1546 "draft-ietf-psamp-sample-tech-04.txt, Section 5.1" 1547 -- Editor Note: get reference right! 1548 ::= { psampFilterRStateParamSetEntry 2 } 1550 psampFilterRStateNegate OBJECT-TYPE 1551 SYNTAX TruthValue 1552 MAX-ACCESS read-create 1553 STATUS current 1554 DESCRIPTION 1555 "If set to true this object will negate the output of the 1556 psampFilterRStateFunction." 1557 DEFVAL { false } 1558 ::= { psampFilterRStateParamSetEntry 3 } 1560 psampFilterRStateIfIndex OBJECT-TYPE 1561 SYNTAX InterfaceIndexOrZero 1562 MAX-ACCESS read-create 1563 STATUS current 1564 DESCRIPTION 1565 "Used if the function is egressIf or ingressIf. Selects 1566 the packet if the egressIf/ingressIf is the same as the 1567 interface indicated by this object. If the object is not 1568 used it contains a value of 0." 1570 DEFVAL { 0 } 1571 ::= { psampFilterRStateParamSetEntry 4 } 1573 psampFilterRStateStartAS OBJECT-TYPE 1574 SYNTAX InetAutonomousSystemNumber 1575 MAX-ACCESS read-create 1576 STATUS current 1577 DESCRIPTION 1578 "Used if the function is originAS or destAS. Selects the 1579 packet if the AS Number lies in the range of 1580 psampFilterRStateStartAS and psampFilterRStateStopAS. If 1581 the object is not used it default to 0." 1582 DEFVAL { 0 } 1583 ::= { psampFilterRStateParamSetEntry 5 } 1585 psampFilterRStateStopAS OBJECT-TYPE 1586 SYNTAX InetAutonomousSystemNumber 1587 MAX-ACCESS read-create 1588 STATUS current 1589 DESCRIPTION 1590 "Used if the function is originAS or destAS. Selects the 1591 packet if the AS Number lies in the range of 1592 psampFilterRStateStartAS and psampFilterRStateStopAS. If 1593 psampFilterRStateStartAS is not 0 and this object is 0 then 1594 the range is single value, the value given in 1595 psampFilterRStateStartAS." 1596 DEFVAL { 0 } 1597 ::= { psampFilterRStateParamSetEntry 6 } 1599 psampFilterRStateVendorFunc OBJECT-TYPE 1600 SYNTAX OBJECT IDENTIFIER 1601 MAX-ACCESS read-create 1602 STATUS current 1603 DESCRIPTION 1604 "Used if the function is any other than those defined here. 1605 In this case a vendor specific router state function is 1606 used. If the object is not used it defaults to 1607 psampFilterRState." 1608 DEFVAL { psampFilterRState } 1609 ::= { psampFilterRStateParamSetEntry 7 } 1611 psampFilterRStateRowStatus OBJECT-TYPE 1612 SYNTAX RowStatus 1613 MAX-ACCESS read-create 1614 STATUS current 1615 DESCRIPTION 1616 "The status of this row of the table." 1617 ::= { psampFilterRStateParamSetEntry 8 } 1619 --================================================================== 1620 -- Hash Function Group 1621 --================================================================== 1623 psampHashFunctions OBJECT IDENTIFIER ::= { psampObjects 3 } 1625 --================================================================== 1626 --* Hash Function 0: IPSX 1627 --================================================================== 1629 psampHashIPSX OBJECT IDENTIFIER ::= { psampHashFunctions 0 } 1631 psampHashIPSXAvail OBJECT-TYPE 1632 SYNTAX PsampMethodAvailability 1633 MAX-ACCESS read-only 1634 STATUS current 1635 DESCRIPTION 1636 "When retrieved, this object indicates the availability of 1637 the IPSX hash function at the managed node." 1638 DEFVAL { notAvailable } 1639 ::= { psampHashIPSX 1 } 1641 -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1643 -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ 1645 psampHashIPSXParamSetTable OBJECT-TYPE 1646 SYNTAX SEQUENCE OF 1647 PsampHashIPSXParamSetEntry 1648 MAX-ACCESS not-accessible 1649 STATUS current 1650 DESCRIPTION 1651 "This table lists configurations the IPSX hash function. 1652 Since this hash function takes no additional parameters the 1653 table if available contains only one entry indicating that 1654 the functions exists and can be referenced by the 1655 psampFilterHashParamSetTable." 1656 ::= { psampHashIPSX 3 } 1658 psampHashIPSXParamSetEntry OBJECT-TYPE 1659 SYNTAX PsampHashIPSXParamSetEntry 1660 MAX-ACCESS not-accessible 1661 STATUS current 1662 DESCRIPTION 1663 "Defines an entry in the psampHashIPSXParamSetTable." 1664 INDEX { psampHashIPSXIndex } 1665 ::= { psampHashIPSXParamSetTable 1 } 1667 PsampHashIPSXParamSetEntry ::= 1668 SEQUENCE { 1669 psampHashIPSXIndex Integer32, 1670 psampHashIPSXRowStatus RowStatus 1671 } 1673 psampHashIPSXIndex OBJECT-TYPE 1674 SYNTAX Integer32 (1..2147483647) 1675 MAX-ACCESS not-accessible 1676 STATUS current 1677 DESCRIPTION 1678 "The index of this parameter set in the 1679 psampHashIPSXParameterSetTable. It is used in entries of 1680 the psampFilterHashParamSetTable as reference to this 1681 parameter set." 1682 ::= { psampHashIPSXParamSetEntry 1 } 1684 psampHashIPSXRowStatus OBJECT-TYPE 1685 SYNTAX RowStatus 1686 MAX-ACCESS read-create 1687 STATUS current 1688 DESCRIPTION 1689 "The status of this row of the table." 1690 ::= { psampHashIPSXParamSetEntry 2 } 1692 --================================================================== 1693 --* Hash Function 1: Bob 1694 --================================================================== 1696 psampHashBob OBJECT IDENTIFIER ::= { psampHashFunctions 1 } 1698 psampHashBobAvail OBJECT-TYPE 1699 SYNTAX PsampMethodAvailability 1700 MAX-ACCESS read-only 1701 STATUS current 1702 DESCRIPTION 1703 "When retrieved, this object indicates the availability of 1704 the Bob hash function at the managed node." 1705 DEFVAL { notAvailable } 1706 ::= { psampHashBob 1 } 1708 -- Capabilities ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1710 -- Parameter Set Table +++++++++++++++++++++++++++++++++++++++++++++ 1712 psampHashBobParamSetTable OBJECT-TYPE 1713 SYNTAX SEQUENCE OF 1714 PsampHashBobParamSetEntry 1716 MAX-ACCESS not-accessible 1717 STATUS current 1718 DESCRIPTION 1719 "This table lists configurations the Bob hash function. 1720 Since this hash function takes no additional parameters the 1721 table if available contains only one entry indicating that 1722 the functions exists and can be referenced by the 1723 psampFilterHashParamSetTable." 1724 ::= { psampHashBob 3 } 1726 psampHashBobParamSetEntry OBJECT-TYPE 1727 SYNTAX PsampHashBobParamSetEntry 1728 MAX-ACCESS not-accessible 1729 STATUS current 1730 DESCRIPTION 1731 "Defines an entry in the psampHashBobParamSetTable." 1732 INDEX { psampHashBobIndex } 1733 ::= { psampHashBobParamSetTable 1 } 1735 PsampHashBobParamSetEntry ::= 1736 SEQUENCE { 1737 psampHashBobIndex Integer32, 1738 psampHashBobRowStatus RowStatus 1739 } 1741 psampHashBobIndex OBJECT-TYPE 1742 SYNTAX Integer32 (1..2147483647) 1743 MAX-ACCESS not-accessible 1744 STATUS current 1745 DESCRIPTION 1746 "The index of this parameter set in the 1747 psampHashBobParameterSetTable. It is used in entries of the 1748 psampFilterHashParamSetTable as reference to this parameter 1749 set." 1750 ::= { psampHashBobParamSetEntry 1 } 1752 psampHashBobRowStatus OBJECT-TYPE 1753 SYNTAX RowStatus 1754 MAX-ACCESS read-create 1755 STATUS current 1756 DESCRIPTION 1757 "The status of this row of the table." 1758 ::= { psampHashBobParamSetEntry 2 } 1760 --================================================================== 1761 -- Conformance information 1762 --================================================================== 1763 psampCompliances OBJECT IDENTIFIER ::= { psampConformance 1 } 1764 psampGroups OBJECT IDENTIFIER ::= { psampConformance 2 } 1766 --================================================================== 1767 -- Compliance statements 1768 --================================================================== 1770 psampCompliance MODULE-COMPLIANCE 1771 STATUS current 1772 DESCRIPTION 1773 "An implementation that complies to this module must 1774 implement the objects defined in the mandatory groups 1775 ipfixGroupMetering and ipfixGroupReporting. The 1776 implementation of all other objects depends on the 1777 implementation of the corresponding functionality in the 1778 equipment." 1779 MODULE -- this module 1780 MANDATORY-GROUPS { 1781 psampGroupSelectAll, 1782 ipfixGroupMetering, 1783 ipfixGroupReporting 1784 } 1785 GROUP psampGroupSampCountBased 1786 DESCRIPTION 1787 "These objects must be implemented if the corresponding 1788 sampling function is implemented in the equipment." 1789 GROUP psampGroupSampTimeBased 1790 DESCRIPTION 1791 "These objects must be implemented if the corresponding 1792 sampling function is implemented in the equipment." 1793 GROUP psampGroupSampRandOutOfN 1794 DESCRIPTION 1795 "These objects must be implemented if the corresponding 1796 sampling function is implemented in the equipment." 1797 GROUP psampGroupSampUniProb 1798 DESCRIPTION 1799 "These objects must be implemented if the corresponding 1800 sampling function is implemented in the equipment." 1801 GROUP psampGroupSampNonUniProb 1802 DESCRIPTION 1803 "These objects must be implemented if the corresponding 1804 sampling function is implemented in the equipment." 1805 GROUP psampGroupSampFlowState 1806 DESCRIPTION 1807 "These objects must be implemented if the corresponding 1808 sampling function is implemented in the equipment." 1809 GROUP psampGroupFilterMatch 1810 DESCRIPTION 1811 "These objects must be implemented if the corresponding 1812 filter function is implemented in the equipment." 1813 GROUP psampGroupFilterHash 1814 DESCRIPTION 1815 "These objects must be implemented if the corresponding 1816 filter function is implemented in the equipment." 1817 GROUP psampGroupFilterRState 1818 DESCRIPTION 1819 "These objects must be implemented if the corresponding 1820 filter function is implemented in the equipment." 1821 GROUP psampGroupHashIPSX 1822 DESCRIPTION 1823 "These objects must be implemented if the corresponding 1824 hash function is implemented in the equipment." 1825 GROUP psampGroupHashBob 1826 DESCRIPTION 1827 "These objects must be implemented if the corresponding 1828 hash function is implemented in the equipment." 1829 ::= { psampCompliances 1 } 1831 --================================================================== 1832 -- MIB groupings 1833 --================================================================== 1835 psampGroupSelectAll OBJECT-GROUP 1836 OBJECTS { 1837 psampSelectAllAvail 1838 } 1839 STATUS current 1840 DESCRIPTION 1841 "The select all Method that must be present on all PSAMP 1842 complient devices." 1843 ::= { psampGroups 1 } 1845 psampGroupSampCountBased OBJECT-GROUP 1846 OBJECTS { 1847 psampSampCountBasedAvail, 1848 psampSampCountBasedMaxInterval, 1849 psampSampCountBasedMaxSpacing, 1850 psampSampCountBasedInterval, 1851 psampSampCountBasedSpacing, 1852 psampSampCountBasedRowStatus 1853 } 1854 STATUS current 1855 DESCRIPTION 1856 "These objects are needed if count based sampling is 1857 implemented." 1858 ::= { psampGroups 2 } 1860 psampGroupSampTimeBased OBJECT-GROUP 1861 OBJECTS { 1862 psampSampTimeBasedAvail, 1863 psampSampTimeBasedMaxInterval, 1864 psampSampTimeBasedMaxSpacing, 1865 psampSampTimeBasedInterval, 1866 psampSampTimeBasedSpacing, 1867 psampSampTimeBasedRowStatus 1868 } 1869 STATUS current 1870 DESCRIPTION 1871 "These objects are needed if time based sampling is 1872 implemented." 1873 ::= { psampGroups 3 } 1875 psampGroupSampRandOutOfN OBJECT-GROUP 1876 OBJECTS { 1877 psampSampRandOutOfNAvail, 1878 psampSampRandOutOfNMaxPopulation, 1879 psampSampRandOutOfNMaxSample, 1880 psampSampRandOutOfNPopulation, 1881 psampSampRandOutOfNSample, 1882 psampSampRandOutOfNRowStatus 1883 } 1884 STATUS current 1885 DESCRIPTION 1886 "These objects are needed if random n-out-of-N sampling is 1887 implemented." 1888 ::= { psampGroups 4 } 1890 psampGroupSampUniProb OBJECT-GROUP 1891 OBJECTS { 1892 psampSampUniProbAvail, 1893 psampSampUniProbProbability, 1894 psampSampUniProbRowStatus 1895 } 1896 STATUS current 1897 DESCRIPTION 1898 "These objects are needed if uniform probabilistic sampling 1899 is implemented." 1900 ::= { psampGroups 5 } 1902 psampGroupSampNonUniProb OBJECT-GROUP 1903 OBJECTS { 1904 psampSampNonUniProbAvail, 1905 psampSampNonUniProbFunction, 1906 psampSampNonUniProbFuncParam, 1907 psampSampNonUniProbRowStatus 1909 } 1910 STATUS current 1911 DESCRIPTION 1912 "These objects are needed if non-uniform probabilistic 1913 sampling is implemented." 1914 ::= { psampGroups 6 } 1916 psampGroupSampFlowState OBJECT-GROUP 1917 OBJECTS { 1918 psampSampFlowStateAvail, 1919 psampSampFlowStateFunction, 1920 psampSampFlowStateFuncParam, 1921 psampSampFlowStateRowStatus 1922 } 1923 STATUS current 1924 DESCRIPTION 1925 "These objects are needed if flow state sampling is 1926 implemented." 1927 ::= { psampGroups 7 } 1929 psampGroupFilterMatch OBJECT-GROUP 1930 OBJECTS { 1931 psampFilterMatchAvail, 1932 psampFilterMatchFieldId, 1933 psampFilterMatchStartValue, 1934 psampFilterMatchStopValue, 1935 psampFilterMatchMask, 1936 psampFilterMatchRowStatus 1937 } 1938 STATUS current 1939 DESCRIPTION 1940 "These objects are needed if match filtering is implemented." 1941 ::= { psampGroups 8 } 1943 psampGroupFilterHash OBJECT-GROUP 1944 OBJECTS { 1945 psampFilterHashAvail, 1946 psampFilterHashAddrType, 1947 psampFilterHashHeaderBits, 1948 psampFilterHashPayloadBytes, 1949 psampFilterHashPayloadBits, 1950 psampFilterHashFunction, 1951 psampFilterHashFuncParam, 1952 psampFilterHashInputBits, 1953 psampFilterHashOutputBits, 1954 psampFilterHashOutputMask, 1955 psampFilterHashSelection, 1956 psampFilterHashRowStatus 1958 } 1959 STATUS current 1960 DESCRIPTION 1961 "These objects are needed if hash filtering is implemented." 1962 ::= { psampGroups 9 } 1964 psampGroupFilterRState OBJECT-GROUP 1965 OBJECTS { 1966 psampFilterRStateAvail, 1967 psampFilterRStateFunction, 1968 psampFilterRStateNegate, 1969 psampFilterRStateIfIndex, 1970 psampFilterRStateStartAS, 1971 psampFilterRStateStopAS, 1972 psampFilterRStateVendorFunc, 1973 psampFilterRStateRowStatus 1974 } 1975 STATUS current 1976 DESCRIPTION 1977 "These objects are needed if router state filtering is 1978 implemented." 1979 ::= { psampGroups 10 } 1981 psampGroupHashIPSX OBJECT-GROUP 1982 OBJECTS { 1983 psampHashIPSXAvail, 1984 psampHashIPSXRowStatus 1985 } 1986 STATUS current 1987 DESCRIPTION 1988 "These objects are needed if the IPSX hash function is 1989 implemented." 1990 ::= { psampGroups 11 } 1992 psampGroupHashBob OBJECT-GROUP 1993 OBJECTS { 1994 psampHashBobAvail, 1995 psampHashBobRowStatus 1996 } 1997 STATUS current 1998 DESCRIPTION 1999 "These objects are needed if the Bob hash function is 2000 implemented." 2001 ::= { psampGroups 12 } 2003 END 2005 7. Security Considerations 2007 There are a number of management objects defined in this MIB module 2008 with a MAX-ACCESS clause of read-write and/or read-create. Such 2009 objects may be considered sensitive or vulnerable in some network 2010 environments. The support for SET operations in a non-secure 2011 environment without proper protection can have a negative effect on 2012 network operations. 2014 8. IANA Considerations 2016 This document requires no assignment to be made by IANA. 2018 9. Acknowledgment 2020 This document is a product of the PSAMP working group. 2022 10. References 2024 10.1. Normative References 2026 [I-D.ietf-psamp-framework] 2027 Duffield, N., "A Framework for Packet Selection and 2028 Reporting", draft-ietf-psamp-framework-10 (work in 2029 progress), January 2005. 2031 [I-D.ietf-psamp-sample-tech] 2032 Zseby, T., "Sampling and Filtering Techniques for IP 2033 Packet Selection", draft-ietf-psamp-sample-tech-07 (work 2034 in progress), July 2005. 2036 [I-D.ietf-psamp-protocol] 2037 Claise, B., "Packet Sampling (PSAMP) Protocol 2038 Specifications", draft-ietf-psamp-protocol-05 (work in 2039 progress), April 2006. 2041 [I-D.ietf-ipfix-protocol] 2042 Claise, B., "IPFIX Protocol Specification", 2043 draft-ietf-ipfix-protocol-20 (work in progress), 2044 April 2006. 2046 [I-D.dietz-ipfix-mib] 2047 Dietz, T., Kobayashi, A., and B. Claise, "Definitions of 2048 Managed Objects for IP Flow Information Export", 2049 draft-dietz-ipfix-mib-00 (work in progress), June 2006. 2051 [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. 2052 Schoenwaelder, Ed., "Structure of Management Information 2053 Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. 2055 [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. 2056 Schoenwaelder, Ed., "Textual Conventions for SMIv2", 2057 STD 58, RFC 2579, April 1999. 2059 [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 2060 "Conformance Statements for SMIv2", STD 58, RFC 2580, 2061 April 1999. 2063 10.2. Informative References 2065 [I-D.ietf-psamp-info] 2066 Dietz, T., "Information Model for Packet Sampling 2067 Exports", draft-ietf-psamp-info-04 (work in progress), 2068 March 2006. 2070 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 2071 Requirement Levels", BCP 14, RFC 2119, March 1997. 2073 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 2074 "Introduction and Applicability Statements for Internet- 2075 Standard Management Framework", RFC 3410, December 2002. 2077 Authors' Addresses 2079 Thomas Dietz (editor) 2080 NEC Europte Ltd. 2081 Network Laboratories 2082 Kurfuersten-Anlage 36 2083 Heidelberg 69115 2084 DE 2086 Phone: +49 6221 4342-128 2087 Email: dietz@netlab.nec.de 2089 Benoit Claise 2090 Cisco Systems 2091 De Kleetlaan 6a b1 2092 Degem 1831 2093 BE 2095 Phone: +32 2 704 5622 2096 Email: bclaise@cisco.com 2098 Intellectual Property Statement 2100 The IETF takes no position regarding the validity or scope of any 2101 Intellectual Property Rights or other rights that might be claimed to 2102 pertain to the implementation or use of the technology described in 2103 this document or the extent to which any license under such rights 2104 might or might not be available; nor does it represent that it has 2105 made any independent effort to identify any such rights. Information 2106 on the procedures with respect to rights in RFC documents can be 2107 found in BCP 78 and BCP 79. 2109 Copies of IPR disclosures made to the IETF Secretariat and any 2110 assurances of licenses to be made available, or the result of an 2111 attempt made to obtain a general license or permission for the use of 2112 such proprietary rights by implementers or users of this 2113 specification can be obtained from the IETF on-line IPR repository at 2114 http://www.ietf.org/ipr. 2116 The IETF invites any interested party to bring to its attention any 2117 copyrights, patents or patent applications, or other proprietary 2118 rights that may cover technology that may be required to implement 2119 this standard. Please address the information to the IETF at 2120 ietf-ipr@ietf.org. 2122 Disclaimer of Validity 2124 This document and the information contained herein are provided on an 2125 "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS 2126 OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET 2127 ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, 2128 INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE 2129 INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED 2130 WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 2132 Copyright Statement 2134 Copyright (C) The Internet Society (2006). This document is subject 2135 to the rights, licenses and restrictions contained in BCP 78, and 2136 except as set forth therein, the authors retain all their rights. 2138 Acknowledgment 2140 Funding for the RFC Editor function is currently provided by the 2141 Internet Society.