#!/bin/sh # This is `snmp2.18' (part 18 of snmp2). # Do not concatenate these parts, unpack them in order with `/bin/sh'. # File `snmp2/mib.txt' is being continued... # touch -am 1231235999 $$.touch >/dev/null 2>&1 if test ! -f 1231235999 && test -f $$.touch; then shar_touch=touch else shar_touch=: echo echo 'WARNING: not restoring timestamps. Consider getting and' echo "installing GNU \`touch', distributed in GNU File Utilities..." echo fi rm -f 1231235999 $$.touch # if test ! -r _sharseq.tmp; then echo 'Please unpack part 1 first!' exit 1 fi shar_sequence=`cat _sharseq.tmp` if test "$shar_sequence" != 18; then echo "Please unpack part $shar_sequence next!" exit 1 fi if test ! -f _sharnew.tmp; then echo 'x - still skipping snmp2/mib.txt' else echo 'x - continuing file snmp2/mib.txt' sed 's/^X//' << 'SHAR_EOF' >> 'snmp2/mib.txt' && X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of octets transmitted to this address X since it was added to the hostTable (excluding X framing bits but including FCS octets), except for X those octets in packets that contained errors." X ::= { hostEntry 6 } X X hostOutOctets OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of octets transmitted by this address X since it was added to the hostTable (excluding X framing bits but including FCS octets), including X those octets in packets that contained errors." X ::= { hostEntry 7 } X X hostOutErrors OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of error packets transmitted by this X address since this host was added to the hostTable." X ::= { hostEntry 8 } X X hostOutBroadcastPkts OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of good packets transmitted by this X address that were directed to the broadcast address X since this host was added to the hostTable." X ::= { hostEntry 9 } X X hostOutMulticastPkts OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X X X "The number of good packets transmitted by this X address that were directed to a multicast address X since this host was added to the hostTable. X Note that this number does not include packets X directed to the broadcast address." X ::= { hostEntry 10 } X X -- host Time Table X X hostTimeTable OBJECT-TYPE X SYNTAX SEQUENCE OF HostTimeEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of time-ordered host table entries." X ::= { hosts 3 } X X hostTimeEntry OBJECT-TYPE X SYNTAX HostTimeEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A collection of statistics for a particular host X that has been discovered on an interface of this X device. This collection includes the relative X ordering of the creation time of this object." X INDEX { hostTimeIndex, hostTimeCreationOrder } X ::= { hostTimeTable 1 } X X HostTimeEntry ::= SEQUENCE { X hostTimeAddress OCTET STRING, X hostTimeCreationOrder INTEGER (1..65535), X hostTimeIndex INTEGER (1..65535), X hostTimeInPkts Counter, X hostTimeOutPkts Counter, X hostTimeInOctets Counter, X hostTimeOutOctets Counter, X hostTimeOutErrors Counter, X hostTimeOutBroadcastPkts Counter, X hostTimeOutMulticastPkts Counter X } X X hostTimeAddress OBJECT-TYPE X SYNTAX OCTET STRING X ACCESS read-only X STATUS mandatory X DESCRIPTION X X X "The physical address of this host." X ::= { hostTimeEntry 1 } X X hostTimeCreationOrder OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-only X STATUS mandatory X DESCRIPTION X "An index that uniquely identifies an entry in X the hostTime table among those entries associated X with the same hostControlEntry. This index shall X be between 1 and N, where N is the value of X the associated hostControlTableSize. The ordering X of the indexes is based on the order of each entry's X insertion into the table, in which entries added X earlier have a lower index value than entries added X later. Thus the management station has the ability X to learn of new entries added to this table without X downloading the entire table. X X It is important to note that the index for a X particular entry may change as an (earlier) entry X is deleted from the table. Because this order may X change, management stations should make use of the X hostControlLastDeleteTime variable in the X hostControlEntry associated with the relevant X portion of the hostTimeTable. By observing X this variable, the management station may detect X the circumstances where a download of the table X may have missed entries, and where a previous X association between a value of hostTimeCreationOrder X and a hostTimeEntry may no longer hold." X ::= { hostTimeEntry 2 } X X hostTimeIndex OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The set of collected host statistics of which X this entry is a part. The set of hosts X identified by a particular value of this X index is associated with the hostControlEntry X as identified by the same value of hostControlIndex." X ::= { hostTimeEntry 3 } X X X hostTimeInPkts OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of packets without errors transmitted to X this address since it was added to the hostTimeTable." X ::= { hostTimeEntry 4 } X X hostTimeOutPkts OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of packets including errors transmitted X by this address since it was added to the X hostTimeTable." X ::= { hostTimeEntry 5 } X X hostTimeInOctets OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of octets transmitted to this address X since it was added to the hostTimeTable (excluding X framing bits but including FCS octets), except for X those octets in packets that contained errors." X ::= { hostTimeEntry 6 } X X hostTimeOutOctets OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of octets transmitted by this address since X it was added to the hostTimeTable (excluding framing X bits but including FCS octets), including those X octets in packets that contained errors." X ::= { hostTimeEntry 7 } X X hostTimeOutErrors OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of error packets transmitted by this X address since this host was added to the X X X hostTimeTable." X ::= { hostTimeEntry 8 } X X hostTimeOutBroadcastPkts OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of good packets transmitted by this X address that were directed to the broadcast address X since this host was added to the hostTimeTable." X ::= { hostTimeEntry 9 } X X hostTimeOutMulticastPkts OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of good packets transmitted by this X address that were directed to a multicast address X since this host was added to the hostTimeTable. X Note that this number does not include packets X directed to the broadcast address." X ::= { hostTimeEntry 10 } X X -- The Host Top "N" Group X X -- Implementation of the Host Top N group is optional. X -- X -- The Host Top N group requires the implementation of the X -- host group. X -- X -- The Host Top N group is used to prepare reports that X -- describe the hosts that top a list ordered by one of X -- their statistics. The available statistics are samples X -- of one of their base statistics, over an interval X -- specified by the management station. Thus, these X -- statistics are rate based. The management X -- station also selects how many such hosts are reported. X X -- The hostTopNControlTable is used to initiate the generation X -- of such a report. The management station may select the X -- parameters of such a report, such as which interface, X -- which statistic, how many hosts, and the start and stop X -- times of the sampling. When the report is prepared, X -- entries are created in the hostTopNTable associated with X -- the relevant hostTopNControlEntry. These entries are X X X -- static for each report after it has been prepared. X X hostTopNControlTable OBJECT-TYPE X SYNTAX SEQUENCE OF HostTopNControlEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of top N host control entries." X ::= { hostTopN 1 } X X hostTopNControlEntry OBJECT-TYPE X SYNTAX HostTopNControlEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A set of parameters that control the creation of a X report of the top N hosts according to several X metrics." X INDEX { hostTopNControlIndex } X ::= { hostTopNControlTable 1 } X X HostTopNControlEntry ::= SEQUENCE { X hostTopNControlIndex INTEGER (1..65535), X hostTopNHostIndex INTEGER (1..65535), X hostTopNRateBase INTEGER, X hostTopNTimeRemaining INTEGER, X hostTopNDuration INTEGER, X hostTopNRequestedSize INTEGER, X hostTopNGrantedSize INTEGER, X hostTopNStartTime TimeTicks, X hostTopNOwner OwnerString, X hostTopNStatus INTEGER X } X X hostTopNControlIndex OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-only X STATUS mandatory X DESCRIPTION X "An index that uniquely identifies an entry X in the hostTopNControl table. Each such X entry defines one top N report prepared for X one interface." X ::= { hostTopNControlEntry 1 } X X hostTopNHostIndex OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-write X X X STATUS mandatory X DESCRIPTION X "The host table for which a top N report will be X prepared on behalf of this entry. The host table X identified by a particular value of this index is X associated with the same host table as identified X by the same value of hostIndex. X X This object may not be modified if the associated X hostTopNStatus object is equal to valid(1)." X ::= { hostTopNControlEntry 2 } X X hostTopNRateBase OBJECT-TYPE X SYNTAX INTEGER { X hostTopNInPkts(1), X hostTopNOutPkts(2), X hostTopNInOctets(3), X hostTopNOutOctets(4), X hostTopNOutErrors(5), X hostTopNOutBroadcastPkts(6), X hostTopNOutMulticastPkts(7) X } X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The variable for each host that the hostTopNRate X variable is based upon. X X This object may not be modified if the associated X hostTopNStatus object is equal to valid(1)." X ::= { hostTopNControlEntry 3 } X X hostTopNTimeRemaining OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The number of seconds left in the report currently X being collected. When this object is modified by X the management station, a new collection is started, X possibly aborting a currently running report. The X new value is used as the requested duration of this X report, which is loaded into the associated X hostTopNDuration object. X X When this object is set to a non-zero value, any X associated hostTopNEntries shall be made X inaccessible by the monitor. While the value of this X X X object is non-zero, it decrements by one per second X until it reaches zero. During this time, all X associated hostTopNEntries shall remain X inaccessible. At the time that this object X decrements to zero, the report is made X accessible in the hostTopNTable. Thus, the hostTopN X table needs to be created only at the end of the X collection interval." X DEFVAL { 0 } X ::= { hostTopNControlEntry 4 } X X hostTopNDuration OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of seconds that this report has collected X during the last sampling interval, or if this X report is currently being collected, the number X of seconds that this report is being collected X during this sampling interval. X X When the associated hostTopNTimeRemaining object is X set, this object shall be set by the probe to the X same value and shall not be modified until the next X time the hostTopNTimeRemaining is set. X X This value shall be zero if no reports have been X requested for this hostTopNControlEntry." X DEFVAL { 0 } X ::= { hostTopNControlEntry 5 } X X hostTopNRequestedSize OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The maximum number of hosts requested for the top N X table. X X When this object is created or modified, the probe X should set hostTopNGrantedSize as closely to this X object as is possible for the particular probe X implementation and available resources." X DEFVAL { 10 } X ::= { hostTopNControlEntry 6 } X X X hostTopNGrantedSize OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The maximum number of hosts in the top N table. X X When the associated hostTopNRequestedSize object is X created or modified, the probe should set this X object as closely to the requested value as is X possible for the particular implementation and X available resources. The probe must not lower this X value except as a result of a set to the associated X hostTopNRequestedSize object. X X Hosts with the highest value of hostTopNRate shall be X placed in this table in decreasing order of this rate X until there is no more room or until there are no more X hosts." X ::= { hostTopNControlEntry 7 } X X hostTopNStartTime OBJECT-TYPE X SYNTAX TimeTicks X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The value of sysUpTime when this top N report was X last started. In other words, this is the time that X the associated hostTopNTimeRemaining object was X modified to start the requested report." X ::= { hostTopNControlEntry 8 } X X hostTopNOwner OBJECT-TYPE X SYNTAX OwnerString X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The entity that configured this entry and is X therefore using the resources assigned to it." X ::= { hostTopNControlEntry 9 } X X hostTopNStatus OBJECT-TYPE X SYNTAX EntryStatus X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The status of this hostTopNControl entry. X X X If this object is not equal to valid(1), all X associated hostTopNEntries shall be deleted by X the agent." X ::= { hostTopNControlEntry 10 } X X hostTopNTable OBJECT-TYPE X SYNTAX SEQUENCE OF HostTopNEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of top N host entries." X ::= { hostTopN 2 } X X hostTopNEntry OBJECT-TYPE X SYNTAX HostTopNEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A set of statistics for a host that is part of a X top N report." X INDEX { hostTopNReport, hostTopNIndex } X ::= { hostTopNTable 1 } X X HostTopNEntry ::= SEQUENCE { X hostTopNReport INTEGER (1..65535), X hostTopNIndex INTEGER (1..65535), X hostTopNAddress OCTET STRING, X hostTopNRate INTEGER X } X X hostTopNReport OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-only X STATUS mandatory X DESCRIPTION X "This object identifies the top N report of which X this entry is a part. The set of hosts X identified by a particular value of this X object is part of the same report as identified X by the same value of the hostTopNControlIndex object." X ::= { hostTopNEntry 1 } X X hostTopNIndex OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-only X STATUS mandatory X DESCRIPTION X "An index that uniquely identifies an entry in X X X the hostTopN table among those in the same report. X This index is between 1 and N, where N is the X number of entries in this table. Increasing values X of hostTopNIndex shall be assigned to entries with X decreasing values of hostTopNRate until index N X is assigned to the entry with the lowest value of X hostTopNRate or there are no more hostTopNEntries." X ::= { hostTopNEntry 2 } X X hostTopNAddress OBJECT-TYPE X SYNTAX OCTET STRING X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The physical address of this host." X ::= { hostTopNEntry 3 } X X hostTopNRate OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The amount of change in the selected variable X during this sampling interval. The selected X variable is this host's instance of the object X selected by hostTopNRateBase." X ::= { hostTopNEntry 4 } X X -- The Matrix Group X X -- Implementation of the Matrix group is optional. X -- X -- The Matrix group consists of the matrixControlTable, X -- matrixSDTable and the matrixDSTable. These tables X -- store statistics for a particular conversation between X -- two addresses. As the device detects a new conversation, X -- including those to a non-unicast address, it creates a X -- new entry in both of the matrix tables. X -- It must only create new entries based on information X -- received in good packets. If the monitoring device finds X -- itself short of resources, it may delete entries as needed. X -- It is suggested that the device delete the least recently X -- used entries first. X X matrixControlTable OBJECT-TYPE X SYNTAX SEQUENCE OF MatrixControlEntry X ACCESS not-accessible X X X STATUS mandatory X DESCRIPTION X "A list of information entries for the X traffic matrix on each interface." X ::= { matrix 1 } X X matrixControlEntry OBJECT-TYPE X SYNTAX MatrixControlEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "Information about a traffic matrix on a X particular interface." X INDEX { matrixControlIndex } X ::= { matrixControlTable 1 } X X MatrixControlEntry ::= SEQUENCE { X matrixControlIndex INTEGER (1..65535), X matrixControlDataSource OBJECT IDENTIFIER, X matrixControlTableSize INTEGER, X matrixControlLastDeleteTime TimeTicks, X matrixControlOwner OwnerString, X matrixControlStatus INTEGER X } X X matrixControlIndex OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-only X STATUS mandatory X DESCRIPTION X "An index that uniquely identifies an entry in the X matrixControl table. Each such entry defines X a function that discovers conversations on a particular X interface and places statistics about them in the X matrixSDTable and the matrixDSTable on behalf of this X matrixControlEntry." X ::= { matrixControlEntry 1 } X X matrixControlDataSource OBJECT-TYPE X SYNTAX OBJECT IDENTIFIER X ACCESS read-write X STATUS mandatory X DESCRIPTION X "This object identifies the source of X the data from which this entry creates a traffic matrix. X This source can be any interface on this device. In X order to identify a particular interface, this object X shall identify the instance of the ifIndex object, X X X defined in [4,6], for the desired interface. For X example, if an entry were to receive data from X interface #1, this object would be set to ifIndex.1. X X The statistics in this group reflect all packets X on the local network segment attached to the X identified interface. X X This object may not be modified if the associated X matrixControlStatus object is equal to valid(1)." X ::= { matrixControlEntry 2 } X X matrixControlTableSize OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of matrixSDEntries in the matrixSDTable X for this interface. This must also be the value of X the number of entries in the matrixDSTable for this X interface." X ::= { matrixControlEntry 3 } X X matrixControlLastDeleteTime OBJECT-TYPE X SYNTAX TimeTicks X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The value of sysUpTime when the last entry X was deleted from the portion of the matrixSDTable X or matrixDSTable associated with this X matrixControlEntry. X If no deletions have occurred, this value shall be X zero." X ::= { matrixControlEntry 4 } X X matrixControlOwner OBJECT-TYPE X SYNTAX OwnerString X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The entity that configured this entry and is X therefore using the resources assigned to it." X ::= { matrixControlEntry 5 } X X matrixControlStatus OBJECT-TYPE X SYNTAX EntryStatus X ACCESS read-write X X X STATUS mandatory X DESCRIPTION X "The status of this matrixControl entry. X X If this object is not equal to valid(1), all X associated entries in the matrixSDTable and the X matrixDSTable shall be deleted by the agent." X ::= { matrixControlEntry 6 } X X matrixSDTable OBJECT-TYPE X SYNTAX SEQUENCE OF MatrixSDEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of traffic matrix entries indexed by X source and destination MAC address." X ::= { matrix 2 } X X matrixSDEntry OBJECT-TYPE X SYNTAX MatrixSDEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A collection of statistics for communications between X two addresses on a particular interface." X INDEX { matrixSDIndex, X matrixSDSourceAddress, matrixSDDestAddress } X ::= { matrixSDTable 1 } X X MatrixSDEntry ::= SEQUENCE { X matrixSDSourceAddress OCTET STRING, X matrixSDDestAddress OCTET STRING, X matrixSDIndex INTEGER (1..65535), X matrixSDPkts Counter, X matrixSDOctets Counter, X matrixSDErrors Counter X } X X matrixSDSourceAddress OBJECT-TYPE X SYNTAX OCTET STRING X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The source physical address." X ::= { matrixSDEntry 1 } X X X matrixSDDestAddress OBJECT-TYPE X SYNTAX OCTET STRING X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The destination physical address." X ::= { matrixSDEntry 2 } X X matrixSDIndex OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The set of collected matrix statistics of which X this entry is a part. The set of matrix statistics X identified by a particular value of this index X is associated with the same matrixControlEntry X as identified by the same value of matrixControlIndex." X ::= { matrixSDEntry 3 } X X matrixSDPkts OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of packets transmitted from the source X address to the destination address (this number X includes error packets)." X ::= { matrixSDEntry 4 } X X matrixSDOctets OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of octets (excluding framing bits but X including FCS octets) contained in all packets X transmitted from the source address to the X destination address." X ::= { matrixSDEntry 5 } X X matrixSDErrors OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of error packets transmitted from X the source address to the destination address." X X X ::= { matrixSDEntry 6 } X X -- Traffic matrix tables from destination to source X X matrixDSTable OBJECT-TYPE X SYNTAX SEQUENCE OF MatrixDSEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of traffic matrix entries indexed by X destination and source MAC address." X ::= { matrix 3 } X X matrixDSEntry OBJECT-TYPE X SYNTAX MatrixDSEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A collection of statistics for communications between X two address on a particular interface." X INDEX { matrixDSIndex, X matrixDSDestAddress, matrixDSSourceAddress } X ::= { matrixDSTable 1 } X X MatrixDSEntry ::= SEQUENCE { X matrixDSSourceAddress OCTET STRING, X matrixDSDestAddress OCTET STRING, X matrixDSIndex INTEGER (1..65535), X matrixDSPkts Counter, X matrixDSOctets Counter, X matrixDSErrors Counter X } X X matrixDSSourceAddress OBJECT-TYPE X SYNTAX OCTET STRING X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The source physical address." X ::= { matrixDSEntry 1 } X X matrixDSDestAddress OBJECT-TYPE X SYNTAX OCTET STRING X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The destination physical address." X X X ::= { matrixDSEntry 2 } X X matrixDSIndex OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The set of collected matrix statistics of which X this entry is a part. The set of matrix statistics X identified by a particular value of this index X is associated with the same matrixControlEntry X as identified by the same value of matrixControlIndex." X ::= { matrixDSEntry 3 } X X matrixDSPkts OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of packets transmitted from the source X address to the destination address (this number X includes error packets)." X ::= { matrixDSEntry 4 } X X matrixDSOctets OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of octets (excluding framing bits X but including FCS octets) contained in all packets X transmitted from the source address to the X destination address." X ::= { matrixDSEntry 5 } X X matrixDSErrors OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of error packets transmitted from X the source address to the destination address." X ::= { matrixDSEntry 6 } X X -- The Filter Group X X -- Implementation of the Filter group is optional. X X X -- X -- The Filter group allows packets to be captured with an X -- arbitrary filter expression. A logical data and X -- event stream or "channel" is formed by the packets X -- that match the filter expression. X -- X -- This filter mechanism allows the creation of an arbitrary X -- logical expression with which to filter packets. Each X -- filter associated with a channel is OR'ed with the others. X -- Within a filter, any bits checked in the data and status are X -- AND'ed with respect to other bits in the same filter. The X -- NotMask also allows for checking for inequality. Finally, X -- the channelAcceptType object allows for inversion of the X -- whole equation. X -- X -- The channel can be turned on or off, and can also X -- generate events when packets pass through it. X X filterTable OBJECT-TYPE X SYNTAX SEQUENCE OF FilterEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of packet filter entries." X ::= { filter 1 } X X filterEntry OBJECT-TYPE X SYNTAX FilterEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A set of parameters for a packet filter applied on a X particular interface." X INDEX { filterIndex } X ::= { filterTable 1 } X X FilterEntry ::= SEQUENCE { X filterIndex INTEGER (1..65535), X filterChannelIndex INTEGER (1..65535), X filterPktDataOffset INTEGER, X filterPktData OCTET STRING, X filterPktDataMask OCTET STRING, X filterPktDataNotMask OCTET STRING, X filterPktStatus INTEGER, X filterPktStatusMask INTEGER, X filterPktStatusNotMask INTEGER, X filterOwner OwnerString, X filterStatus INTEGER X X X } X X filterIndex OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-only X STATUS mandatory X DESCRIPTION X "An index that uniquely identifies an entry X in the filter table. Each such entry defines X one filter that is to be applied to every packet X received on an interface." X ::= { filterEntry 1 } X X filterChannelIndex OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-write X STATUS mandatory X DESCRIPTION X "This object identifies the channel of which this X filter is a part. The filters identified by a X particular value of this object are associated X with the same channel as identified by the same X value of the channelIndex object." X ::= { filterEntry 2 } X X filterPktDataOffset OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The offset from the beginning of each packet where X a match of packet data will be attempted. This offset X is measured from the point in the physical layer X packet after the framing bits, if any. For example, X in an Ethernet frame, this point is at the beginning X of the destination MAC address. X X This object may not be modified if the associated X filterStatus object is equal to valid(1)." X DEFVAL { 0 } X ::= { filterEntry 3 } X X filterPktData OBJECT-TYPE X SYNTAX OCTET STRING X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The data that is to be matched with the input packet. X X X For each packet received, this filter and the X accompanying filterPktDataMask and X filterPktDataNotMask will be adjusted for the X offset. The only bits relevant to this X match algorithm are those that have the corresponding X filterPktDataMask bit equal to one. The following X three rules are then applied to every packet: X X (1) If the packet is too short and does not have data X corresponding to part of the filterPktData, the X packet will fail this data match. X X (2) For each relevant bit from the packet with the X corresponding filterPktDataNotMask bit set to X zero, if the bit from the packet is not equal to X the corresponding bit from the filterPktData, X then the packet will fail this data match. X X (3) If for every relevant bit from the packet with the X corresponding filterPktDataNotMask bit set to one, X the bit from the packet is equal to the X corresponding bit from the filterPktData, then X the packet will fail this data match. X X Any packets that have not failed any of the three X matches above have passed this data match. X X This object may not be modified if the associated X filterStatus object is equal to valid(1)." X ::= { filterEntry 4 } X X filterPktDataMask OBJECT-TYPE X SYNTAX OCTET STRING X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The mask that is applied to the match process. X After adjusting this mask for the offset, only those X bits in the received packet that correspond to bits X set in this mask are relevant for further processing X by the match algorithm. The offset is applied to X filterPktDataMask in the same way it is applied to X the filter. For the purposes of the matching X algorithm, if the associated filterPktData object X is longer than this mask, this mask is conceptually X extended with '1' bits until it reaches the X length of the filterPktData object. X X X This object may not be modified if the associated X filterStatus object is equal to valid(1)." X ::= { filterEntry 5 } X X filterPktDataNotMask OBJECT-TYPE X SYNTAX OCTET STRING X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The inversion mask that is applied to the match X process. After adjusting this mask for the offset, X those relevant bits in the received packet that X correspond to bits cleared in this mask must all X be equal to their corresponding bits in the X filterPktData object for the packet to be accepted. X In addition, at least one of those relevant X bits in the received packet that correspond to bits X set in this mask must be different to its X corresponding bit in the filterPktData object. X X For the purposes of the matching algorithm, if X the associated filterPktData object is longer than X this mask, this mask is conceptually extended with X '0' bits until it reaches the length of the X filterPktData object. X X This object may not be modified if the associated X filterStatus object is equal to valid(1)." X ::= { filterEntry 6 } X X filterPktStatus OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The status that is to be matched with the input X packet. The only bits relevant to this match X algorithm are those that have the corresponding X filterPktStatusMask bit equal to one. X X The following two rules are then applied to every X packet: X X (1) For each relevant bit from the packet status X with the corresponding filterPktStatusNotMask X bit set to zero, if the bit from the packet X status is not equal to the corresponding bit X from the filterPktStatus, then the packet will X X X fail this status match. X X (2) If for every relevant bit from the packet status X with the corresponding filterPktStatusNotMask X bit set to one, the bit from the packet status X is equal to the corresponding bit from the X filterPktStatus, then the packet will fail X this status match. X X Any packets that have not failed either of the two X matches above have passed this status match. X X The value of the packet status is a sum. This sum X initially takes the value zero. Then, for each X error, E, that has been discovered in this packet, X 2 raised to a value representing E is added to the sum. X The errors and the bits that represent them are X dependent on the media type of the interface that X this channel is receiving packets from. X X The errors defined for a packet captured off of an X Ethernet interface are as follows: X X bit # Error X 0 Packet is longer than 1518 octets X 1 Packet is shorter than 64 octets X 2 Packet experienced a CRC or Alignment X error X X For example, an Ethernet fragment would have a X value of 6 (2^1 + 2^2). X X As this MIB is expanded to new media types, this X object will have other media-specific errors defined. X X For the purposes of this status matching algorithm, if X the packet status is longer than this X object, filterPktStatus this object is conceptually X extended with '0' bits until it reaches the size of X the packet status. X X This object may not be modified if the associated X filterStatus object is equal to valid(1)." X ::= { filterEntry 7 } X X filterPktStatusMask OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-write X X X STATUS mandatory X DESCRIPTION X "The mask that is applied to the status match process. X Only those bits in the received packet that correspond X to bits set in this mask are relevant for further X processing by the status match algorithm. For the X purposes of the matching algorithm, if the X associated filterPktStatus object is longer than X this mask, this mask is conceptually extended with X '1' bits until it reaches the size of the X filterPktStatus. In addition, if a packet status is X longer than this mask, this mask is conceptually X extended with '0' bits until it reaches the size of X the packet status. X X This object may not be modified if the associated X filterStatus object is equal to valid(1)." X ::= { filterEntry 8 } X X filterPktStatusNotMask OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The inversion mask that is applied to the status match X process. Those relevant bits in the received packet X status that correspond to bits cleared in this mask X must all be equal to their corresponding bits in the X filterPktStatus object for the packet to be accepted. X In addition, at least one of those relevant bits in the X received packet status that correspond to bits set in X this mask must be different to its corresponding bit X in the filterPktStatus object for the packet to be X accepted. X X For the purposes of the matching algorithm, if the X associated filterPktStatus object or a packet status X is longer than this mask, this mask is conceptually X extended with '0' bits until it reaches the longer of X the lengths of the filterPktStatus object and the X packet status. X X This object may not be modified if the associated X filterStatus object is equal to valid(1)." SHAR_EOF : || echo 'restore of snmp2/mib.txt failed' fi echo 'End of snmp2 part 18' echo 'File snmp2/mib.txt is continued in part 19' echo 19 > _sharseq.tmp exit 0