#!/bin/sh # This is `snmp2.17' (part 17 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" != 17; 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 total number of packets (including error X packets) received that were between X 128 and 255 octets in length inclusive X (excluding framing bits but including FCS octets)." X ::= { etherStatsEntry 16 } X X etherStatsPkts256to511Octets OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The total number of packets (including error X packets) received that were between X 256 and 511 octets in length inclusive X (excluding framing bits but including FCS octets)." X ::= { etherStatsEntry 17 } X X etherStatsPkts512to1023Octets OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The total number of packets (including error X packets) received that were between X 512 and 1023 octets in length inclusive X (excluding framing bits but including FCS octets)." X ::= { etherStatsEntry 18 } X X X etherStatsPkts1024to1518Octets OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The total number of packets (including error X packets) received that were between X 1024 and 1518 octets in length inclusive X (excluding framing bits but including FCS octets)." X ::= { etherStatsEntry 19 } X X etherStatsOwner 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 ::= { etherStatsEntry 20 } X X etherStatsStatus OBJECT-TYPE X SYNTAX EntryStatus X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The status of this etherStats entry." X ::= { etherStatsEntry 21 } X X -- The History Group X X -- Implementation of the History group is optional. X -- X -- The history group records periodic statistical samples from X -- a network and stores them for later retrieval. The X -- historyControl table stores configuration entries that each X -- define an interface, polling period, and other parameters. X -- Once samples are taken, their data is stored in an entry X -- in a media-specific table. Each such entry defines one X -- sample, and is associated with the historyControlEntry that X -- caused the sample to be taken. Currently the only media- X -- specific table defined is the etherHistoryTable, for X -- Ethernet networks. X -- X -- If the probe keeps track of the time of day, it should X -- start the first sample of the history at a time such that X -- when the next hour of the day begins, a sample is X -- started at that instant. This tends to make more X X X -- user-friendly reports, and enables comparison of reports X -- from different probes that have relatively accurate time X -- of day. X -- X -- The monitor is encouraged to add two history control entries X -- per monitored interface upon initialization that describe X -- a short term and a long term polling period. Suggested X -- parameters are 30 seconds for the short term polling X -- period and 30 minutes for the long term period. X X historyControlTable OBJECT-TYPE X SYNTAX SEQUENCE OF HistoryControlEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of history control entries." X ::= { history 1 } X X historyControlEntry OBJECT-TYPE X SYNTAX HistoryControlEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of parameters that set up a periodic X sampling of statistics." X INDEX { historyControlIndex } X ::= { historyControlTable 1 } X X HistoryControlEntry ::= SEQUENCE { X historyControlIndex INTEGER (1..65535), X historyControlDataSource OBJECT IDENTIFIER, X historyControlBucketsRequested INTEGER (1..65535), X historyControlBucketsGranted INTEGER (1..65535), X historyControlInterval INTEGER (1..3600), X historyControlOwner OwnerString, X historyControlStatus INTEGER X } X X historyControlIndex 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 historyControl table. Each such entry defines a X set of samples at a particular interval for an X interface on the device." X ::= { historyControlEntry 1 } X X X historyControlDataSource OBJECT-TYPE X SYNTAX OBJECT IDENTIFIER X ACCESS read-write X STATUS mandatory X DESCRIPTION X "This object identifies the source of the data for X which historical data was collected and X placed in a media-specific table on behalf of this X historyControlEntry. This source can be any X interface on this device. In order to identify X a particular interface, this object shall identify X the instance of the ifIndex object, defined X in [4,6], for the desired interface. For example, X if an entry were to receive data from interface #1, X 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 historyControlStatus object is equal to valid(1)." X ::= { historyControlEntry 2 } X X historyControlBucketsRequested OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The requested number of discrete time intervals X over which data is to be saved in the part of the X media-specific table associated with this X historyControl entry. X X When this object is created or modified, the probe X should set historyControlBucketsGranted as closely to X this object as is possible for the particular probe X implementation and available resources." X DEFVAL { 50 } X ::= { historyControlEntry 3 } X X historyControlBucketsGranted OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of discrete sampling intervals X over which data shall be saved in the part of X X X the media-specific table associated with this X historyControl entry. X X When the associated historyControlBucketsRequested X object is created or modified, the probe X should set this object as closely to the requested X value as is possible for the particular X probe implementation and available resources. The X probe must not lower this value except as a result X of a modification to the associated X historyControlBucketsRequested object. X X There will be times when the actual number of X buckets associated with this entry is less than X the value of this object. In this case, at the X end of each sampling interval, a new bucket will X be added to the media-specific table. X X When the number of buckets reaches the value of X this object and a new bucket is to be added to the X media-specific table, the oldest bucket associated X with this historyControlEntry shall be deleted by X the agent so that the new bucket can be added. X X When the value of this object changes to a value less X than the current value, entries are deleted X from the media-specific table associated with this X historyControlEntry. Enough of the oldest of these X entries shall be deleted by the agent so that their X number remains less than or equal to the new value of X this object. X X When the value of this object changes to a value X greater than the current value, the number of X associated media-specific entries may be allowed X to grow." X ::= { historyControlEntry 4 } X X historyControlInterval OBJECT-TYPE X SYNTAX INTEGER (1..3600) X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The interval in seconds over which the data is X sampled for each bucket in the part of the X media-specific table associated with this X historyControl entry. This interval can X be set to any number of seconds between 1 and X X X 3600 (1 hour). X X Because the counters in a bucket may overflow at their X maximum value with no indication, a prudent manager X will take into account the possibility of overflow X in any of the associated counters. It is important X to consider the minimum time in which any counter X could overflow on a particular media type and set X the historyControlInterval object to a value less X than this interval. This is typically most X important for the 'octets' counter in any X media-specific table. For example, on an Ethernet X network, the etherHistoryOctets counter could overflow X in about one hour at the Ethernet's maximum X utilization. X X This object may not be modified if the associated X historyControlStatus object is equal to valid(1)." X DEFVAL { 1800 } X ::= { historyControlEntry 5 } X X historyControlOwner OBJECT-TYPE X SYNTAX OwnerString X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The entity that configured this entry and is therefore X using the resources assigned to it." X ::= { historyControlEntry 6 } X X historyControlStatus OBJECT-TYPE X SYNTAX EntryStatus X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The status of this historyControl entry. X X Each instance of the media-specific table associated X with this historyControlEntry will be deleted by the X agent if this historyControlEntry is not equal to X valid(1)." X ::= { historyControlEntry 7 } X X -- Ether History table X X etherHistoryTable OBJECT-TYPE X SYNTAX SEQUENCE OF EtherHistoryEntry X X X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of Ethernet history entries." X ::= { history 2 } X X etherHistoryEntry OBJECT-TYPE X SYNTAX EtherHistoryEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "An historical sample of Ethernet statistics on a X particular Ethernet interface. This sample is X associated with the historyControlEntry which set X up the parameters for a regular collection of these X samples." X INDEX { etherHistoryIndex , etherHistorySampleIndex } X ::= { etherHistoryTable 1 } X X EtherHistoryEntry ::= SEQUENCE { X etherHistoryIndex INTEGER (1..65535), X etherHistorySampleIndex INTEGER, X etherHistoryIntervalStart TimeTicks, X etherHistoryDropEvents Counter, X etherHistoryOctets Counter, X etherHistoryPkts Counter, X etherHistoryBroadcastPkts Counter, X etherHistoryMulticastPkts Counter, X etherHistoryCRCAlignErrors Counter, X etherHistoryUndersizePkts Counter, X etherHistoryOversizePkts Counter, X etherHistoryFragments Counter, X etherHistoryJabbers Counter, X etherHistoryCollisions Counter, X etherHistoryUtilization INTEGER (0..10000) X } X X etherHistoryIndex OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The history of which this entry is a part. The X history identified by a particular value of this X index is the same history as identified X by the same value of historyControlIndex." X ::= { etherHistoryEntry 1 } X X X etherHistorySampleIndex OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-only X STATUS mandatory X DESCRIPTION X "An index that uniquely identifies the particular X sample this entry represents among all samples X associated with the same historyControlEntry. X This index starts at 1 and increases by one X as each new sample is taken." X ::= { etherHistoryEntry 2 } X X etherHistoryIntervalStart OBJECT-TYPE X SYNTAX TimeTicks X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The value of sysUpTime at the start of the interval X over which this sample was measured. If the probe X keeps track of the time of day, it should start X the first sample of the history at a time such that X when the next hour of the day begins, a sample is X started at that instant. Note that following this X rule may require the probe to delay collecting the X first sample of the history, as each sample must be X of the same interval. Also note that the sample which X is currently being collected is not accessible in this X table until the end of its interval." X ::= { etherHistoryEntry 3 } X X etherHistoryDropEvents OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The total number of events in which packets X were dropped by the probe due to lack of resources X during this interval. Note that this number is not X necessarily the number of packets dropped, it is just X the number of times this condition has been detected." X ::= { etherHistoryEntry 4 } X X etherHistoryOctets OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The total number of octets of data (including X X X those in bad packets) received on the X network (excluding framing bits but including X FCS octets)." X ::= { etherHistoryEntry 5 } X X etherHistoryPkts OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of packets (including error packets) X received during this sampling interval." X ::= { etherHistoryEntry 6 } X X etherHistoryBroadcastPkts OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of good packets received during this X sampling interval that were directed to the X broadcast address." X ::= { etherHistoryEntry 7 } X X etherHistoryMulticastPkts OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of good packets received during this X sampling interval that were directed to a X multicast address. Note that this number does not X include packets addressed to the broadcast address." X ::= { etherHistoryEntry 8 } X X etherHistoryCRCAlignErrors OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of packets received during this X sampling interval that had a length (excluding X framing bits but including FCS octets) between X 64 and 1518 octets, inclusive, but were not an X integral number of octets in length or had a X bad Frame Check Sequence (FCS)." X ::= { etherHistoryEntry 9 } X X X etherHistoryUndersizePkts OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of packets received during this X interval that were less than 64 octets long X (excluding framing bits but including FCS X octets) and were otherwise well formed." X ::= { etherHistoryEntry 10 } X X etherHistoryOversizePkts OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of packets received during this X interval that were longer than 1518 octets X (excluding framing bits but including FCS X octets) but were otherwise well formed." X ::= { etherHistoryEntry 11 } X X etherHistoryFragments OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The total number of packets received during this X sampling interval that were not an integral X number of octets in length or that X had a bad Frame Check Sequence (FCS), and X were less than 64 octets in length (excluding X framing bits but including FCS octets)." X ::= { etherHistoryEntry 12 } X X etherHistoryJabbers OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of packets received during this X interval that were longer than 1518 octets X (excluding framing bits but including FCS octets), X and were not an integral number of octets in X length or had a bad Frame Check Sequence (FCS)." X ::= { etherHistoryEntry 13 } X X X etherHistoryCollisions OBJECT-TYPE X SYNTAX Counter X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The best estimate of the total number of collisions X on this Ethernet segment during this interval." X ::= { etherHistoryEntry 14 } X X etherHistoryUtilization OBJECT-TYPE X SYNTAX INTEGER (0..10000) X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The best estimate of the mean physical layer X network utilization on this interface during this X interval, in hundredths of a percent." X ::= { etherHistoryEntry 15 } X X -- The Alarm Group X X -- Implementation of the Alarm group is optional. X -- X -- The Alarm Group requires the implementation of the Event X -- group. X -- X -- The Alarm group periodically takes statistical samples from X -- variables in the probe and compares them to thresholds X -- that have been configured. The alarm table stores X -- configuration entries that each define a variable, X -- polling period, and threshold parameters. If a sample is X -- found to cross the threshold values, an event is X -- generated. Only variables that resolve to an ASN.1 X -- primitive type of INTEGER (INTEGER, Counter, X -- Gauge, or TimeTicks) may be monitored in this way. X -- X -- This function has a hysteresis mechanism to limit the X -- generation of events. This mechanism generates one event X -- as a threshold is crossed in the appropriate direction. X -- No more events are generated for that threshold until the X -- opposite threshold is crossed. X -- X -- In the case of a sampling a deltaValue, a probe may X -- implement this mechanism with more precision if it takes X -- a delta sample twice per period, each time comparing the X -- sum of the latest two samples to the threshold. This X -- allows the detection of threshold crossings X X X -- that span the sampling boundary. Note that this does not X -- require any special configuration of the threshold value. X -- It is suggested that probes implement this more precise X -- algorithm. X X alarmTable OBJECT-TYPE X SYNTAX SEQUENCE OF AlarmEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of alarm entries." X ::= { alarm 1 } X X alarmEntry OBJECT-TYPE X SYNTAX AlarmEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of parameters that set up a periodic checking X for alarm conditions." X INDEX { alarmIndex } X ::= { alarmTable 1 } X X AlarmEntry ::= SEQUENCE { X alarmIndex INTEGER (1..65535), X alarmInterval INTEGER, X alarmVariable OBJECT IDENTIFIER, X alarmSampleType INTEGER, X alarmValue INTEGER, X alarmStartupAlarm INTEGER, X alarmRisingThreshold INTEGER, X alarmFallingThreshold INTEGER, X alarmRisingEventIndex INTEGER (1..65535), X alarmFallingEventIndex INTEGER (1..65535), X alarmOwner OwnerString, X alarmStatus INTEGER X } X X alarmIndex 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 alarm table. Each such entry defines a X diagnostic sample at a particular interval X for an object on the device." X ::= { alarmEntry 1 } X X X alarmInterval OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The interval in seconds over which the data is X sampled and compared with the rising and falling X thresholds. When setting this variable, care X should be given to ensure that the variable being X monitored will not exceed 2^31 - 1 and roll X over the alarmValue object during the interval. X X This object may not be modified if the associated X alarmStatus object is equal to valid(1)." X ::= { alarmEntry 2 } X X alarmVariable OBJECT-TYPE X SYNTAX OBJECT IDENTIFIER X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The object identifier of the particular variable to X be sampled. Only variables that resolve to an ASN.1 X primitive type of INTEGER (INTEGER, Counter, Gauge, X or TimeTicks) may be sampled. X X Because SNMP access control is articulated entirely X in terms of the contents of MIB views, no access X control mechanism exists that can restrict the value of X this object to identify only those objects that exist X in a particular MIB view. Because there is thus no X acceptable means of restricting the read access that X could be obtained through the alarm mechanism, the X probe must only grant write access to this object in X those views that have read access to all objects on X the probe. X X During a set operation, if the supplied variable X name is not available in the selected MIB view, a X badValue error must be returned. If at any time X the variable name of an established alarmEntry is X no longer available in the selected MIB view, the X probe must change the status of this alarmEntry X to invalid(4). X X This object may not be modified if the associated X alarmStatus object is equal to valid(1)." X ::= { alarmEntry 3 } X X X alarmSampleType OBJECT-TYPE X SYNTAX INTEGER { X absoluteValue(1), X deltaValue(2) X } X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The method of sampling the selected variable and X calculating the value to be compared against the X thresholds. If the value of this object is X absoluteValue(1), the value of the selected variable X will be compared directly with the thresholds at the X end of the sampling interval. If the value of this X object is deltaValue(2), the value of the selected X variable at the last sample will be subtracted from X the current value, and the difference compared with X the thresholds. X X This object may not be modified if the associated X alarmStatus object is equal to valid(1)." X ::= { alarmEntry 4 } X X alarmValue OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The value of the statistic during the last sampling X period. The value during the current sampling period X is not made available until the period is completed." X ::= { alarmEntry 5 } X X alarmStartupAlarm OBJECT-TYPE X SYNTAX INTEGER { X risingAlarm(1), X fallingAlarm(2), X risingOrFallingAlarm(3) X } X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The alarm that may be sent when this entry is first X set to valid. If the first sample after this entry X becomes valid is greater than or equal to the X risingThreshold and alarmStartupAlarm is equal to X risingAlarm(1) or risingOrFallingAlarm(3), then a X single rising alarm will be generated. If the first X X X sample after this entry becomes valid is less than X or equal to the fallingThreshold and X alarmStartupAlarm is equal to fallingAlarm(2) or X risingOrFallingAlarm(3), then a single falling X alarm will be generated. X X This object may not be modified if the associated X alarmStatus object is equal to valid(1)." X ::= { alarmEntry 6 } X X alarmRisingThreshold OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-write X STATUS mandatory X DESCRIPTION X "A threshold for the sampled statistic. When the X current sampled value is greater than or equal to X this threshold, and the value at the last sampling X interval was less than this threshold, a single X event will be generated. X A single event will also be generated if the first X sample after this entry becomes valid is greater X than or equal to this threshold and the associated X alarmStartupAlarm is equal to risingAlarm(1) or X risingOrFallingAlarm(3). X X After a rising event is generated, another such event X will not be generated until the sampled value X falls below this threshold and reaches the X alarmFallingThreshold. X X This object may not be modified if the associated X alarmStatus object is equal to valid(1)." X ::= { alarmEntry 7 } X X alarmFallingThreshold OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-write X STATUS mandatory X DESCRIPTION X "A threshold for the sampled statistic. When the X current sampled value is less than or equal to X this threshold, and the value at the last sampling X interval was greater than this threshold, a single X event will be generated. X A single event will also be generated if the first X sample after this entry becomes valid is less than or X equal to this threshold and the associated X X X alarmStartupAlarm is equal to fallingAlarm(2) or X risingOrFallingAlarm(3). X X After a falling event is generated, another such event X will not be generated until the sampled value X rises above this threshold and reaches the X alarmRisingThreshold. X X This object may not be modified if the associated X alarmStatus object is equal to valid(1)." X ::= { alarmEntry 8 } X X alarmRisingEventIndex OBJECT-TYPE X SYNTAX INTEGER (0..65535) X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The index of the eventEntry that is X used when a rising threshold is crossed. The X eventEntry identified by a particular value of X this index is the same as identified by the same value X of the eventIndex object. If there is no X corresponding entry in the eventTable, then X no association exists. In particular, if this value X is zero, no associated event will be generated, as X zero is not a valid event index. X X This object may not be modified if the associated X alarmStatus object is equal to valid(1)." X ::= { alarmEntry 9 } X X alarmFallingEventIndex OBJECT-TYPE X SYNTAX INTEGER (0..65535) X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The index of the eventEntry that is X used when a falling threshold is crossed. The X eventEntry identified by a particular value of X this index is the same as identified by the same value X of the eventIndex object. If there is no X corresponding entry in the eventTable, then X no association exists. In particular, if this value X is zero, no associated event will be generated, as X zero is not a valid event index. X X This object may not be modified if the associated X alarmStatus object is equal to valid(1)." X X X ::= { alarmEntry 10 } X X alarmOwner 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 ::= { alarmEntry 11 } X X alarmStatus OBJECT-TYPE X SYNTAX EntryStatus X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The status of this alarm entry." X ::= { alarmEntry 12 } X X -- The Host Group X X -- Implementation of the Host group is optional. X -- X -- The host group discovers new hosts on the network by X -- keeping a list of source and destination MAC Addresses seen X -- in good packets. For each of these addresses, the host X -- group keeps a set of statistics. The hostControlTable X -- controls which interfaces this function is performed on, X -- and contains some information about the process. On X -- behalf of each hostControlEntry, data is collected on an X -- interface and placed both the hostTable and the X -- hostTimeTable. If the monitoring device finds itself X -- short of resources, it may delete entries as needed. It X -- is suggested that the device delete the least recently X -- used entries first. X X -- The hostTable contains entries for each address X -- discovered on a particular interface. Each entry X -- contains statistical data about that host. This table X -- is indexed by the MAC address of the host, through X -- which a random access may be achieved. X X -- The hostTimeTable contains data in the same format as the X -- hostTable, and must contain the same set of hosts, but is X -- indexed using hostTimeCreationOrder rather than hostAddress. X -- The hostTimeCreationOrder is an integer which reflects X -- the relative order in which a particular entry was X X X -- discovered and thus inserted into the table. As this X -- order, and thus index, is among those entries currently X -- in the table, the index for a particular entry may change X -- if an (earlier) entry is deleted. Thus the association X -- between hostTimeCreationOrder and hostTimeEntry may be X -- broken at any time. X X -- The hostTimeTable has two important uses. The first is the X -- fast download of this potentially large table. Because the X -- index of this table runs from 1 to the size of the table, X -- inclusive, its values are predictable. This allows very X -- efficient packing of variables into SNMP PDU's and allows X -- a table transfer to have multiple packets outstanding. X -- These benefits increase transfer rates tremendously. X X -- The second use of the hostTimeTable is the efficient X -- discovery by the management station of new entries added X -- to the table. After the management station has X -- downloaded the entire table, it knows that new entries X -- will be added immediately after the end of the current X -- table. It can thus detect new entries there X -- and retrieve them easily. X X -- Because the association between hostTimeCreationOrder and X -- hostTimeEntry may be broken at any time, the management X -- station must monitor the related hostControlLastDeleteTime X -- object. When the management station thus detects a deletion, X -- it must assume that any such associations have been broken, X -- and invalidate any it has stored locally. This includes X -- restarting any download of the hostTimeTable that may have X -- been in progress, as well as rediscovering the end of the X -- hostTimeTable so that it may detect new entries. If the X -- management station does not detect the broken association, X -- it may continue to refer to a particular host by its X -- creationOrder while unwittingly retrieving the data X -- associated with another host entirely. If this happens X -- while downloading the host table, the management station X -- may fail to download all of the entries in the table. X X hostControlTable OBJECT-TYPE X SYNTAX SEQUENCE OF HostControlEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of host table control entries." X ::= { hosts 1 } X X X hostControlEntry OBJECT-TYPE X SYNTAX HostControlEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of parameters that set up the discovery of X hosts on a particular interface and the collection X of statistics about these hosts." X INDEX { hostControlIndex } X ::= { hostControlTable 1 } X X HostControlEntry ::= SEQUENCE { X hostControlIndex INTEGER (1..65535), X hostControlDataSource OBJECT IDENTIFIER, X hostControlTableSize INTEGER, X hostControlLastDeleteTime TimeTicks, X hostControlOwner OwnerString, X hostControlStatus INTEGER X } X X hostControlIndex 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 hostControl table. Each such entry defines X a function that discovers hosts on a particular X interface and places statistics about them in the X hostTable and the hostTimeTable on behalf of this X hostControlEntry." X ::= { hostControlEntry 1 } X X hostControlDataSource OBJECT-TYPE X SYNTAX OBJECT IDENTIFIER X ACCESS read-write X STATUS mandatory X DESCRIPTION X "This object identifies the source of the data for X this instance of the host function. This source X can be any interface on this device. In order X to identify a particular interface, this object shall X identify the instance of the ifIndex object, defined X in [4,6], for the desired interface. For example, X if an entry were to receive data from interface #1, X this object would be set to ifIndex.1. X X The statistics in this group reflect all packets X X X on the local network segment attached to the X identified interface. X X This object may not be modified if the associated X hostControlStatus object is equal to valid(1)." X ::= { hostControlEntry 2 } X X hostControlTableSize OBJECT-TYPE X SYNTAX INTEGER X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The number of hostEntries in the hostTable and the X hostTimeTable associated with this hostControlEntry." X ::= { hostControlEntry 3 } X X hostControlLastDeleteTime 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 hostTable X associated with this hostControlEntry. If no X deletions have occurred, this value shall be zero." X ::= { hostControlEntry 4 } X X hostControlOwner 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 ::= { hostControlEntry 5 } X X hostControlStatus OBJECT-TYPE X SYNTAX EntryStatus X ACCESS read-write X STATUS mandatory X DESCRIPTION X "The status of this hostControl entry. X X If this object is not equal to valid(1), all X associated entries in the hostTable, X hostTimeTable, and the hostTopNTable shall be X deleted by the agent." X ::= { hostControlEntry 6 } X X X hostTable OBJECT-TYPE X SYNTAX SEQUENCE OF HostEntry X ACCESS not-accessible X STATUS mandatory X DESCRIPTION X "A list of host entries." X ::= { hosts 2 } X X hostEntry OBJECT-TYPE X SYNTAX HostEntry 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." X INDEX { hostIndex, hostAddress } X ::= { hostTable 1 } X X HostEntry ::= SEQUENCE { X hostAddress OCTET STRING, X hostCreationOrder INTEGER (1..65535), X hostIndex INTEGER (1..65535), X hostInPkts Counter, X hostOutPkts Counter, X hostInOctets Counter, X hostOutOctets Counter, X hostOutErrors Counter, X hostOutBroadcastPkts Counter, X hostOutMulticastPkts Counter X } X X hostAddress OBJECT-TYPE X SYNTAX OCTET STRING X ACCESS read-only X STATUS mandatory X DESCRIPTION X "The physical address of this host." X ::= { hostEntry 1 } X X hostCreationOrder OBJECT-TYPE X SYNTAX INTEGER (1..65535) X ACCESS read-only X STATUS mandatory X DESCRIPTION X "An index that defines the relative ordering of X the creation time of hosts captured for a X particular hostControlEntry. This index shall X X 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. X X It is important to note that the order 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 hostTable. By observing X this variable, the management station may detect X the circumstances where a previous association X between a value of hostCreationOrder X and a hostEntry may no longer hold." X ::= { hostEntry 2 } X X hostIndex 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 ::= { hostEntry 3 } X X hostInPkts 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 hostTable." X ::= { hostEntry 4 } X X hostOutPkts 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 hostTable." X X X ::= { hostEntry 5 } X X hostInOctets OBJECT-TYPE SHAR_EOF : || echo 'restore of snmp2/mib.txt failed' fi echo 'End of snmp2 part 17' echo 'File snmp2/mib.txt is continued in part 18' echo 18 > _sharseq.tmp exit 0