CISCO-IP-TAP-MIB
File:
CISCO-IP-TAP-MIB.mib (18036 bytes)
Imported modules
Imported symbols
Defined Types
CitapStreamEntry |
|
SEQUENCE |
|
|
|
|
citapStreamInterface |
INTEGER |
|
|
citapStreamAddrType |
InetAddressType |
|
|
citapStreamDestinationAddress |
InetAddress |
|
|
citapStreamDestinationLength |
InetAddressPrefixLength |
|
|
citapStreamSourceAddress |
InetAddress |
|
|
citapStreamSourceLength |
InetAddressPrefixLength |
|
|
citapStreamTosByte |
INTEGER |
|
|
citapStreamTosByteMask |
INTEGER |
|
|
citapStreamFlowId |
INTEGER |
|
|
citapStreamProtocol |
INTEGER |
|
|
citapStreamDestL4PortMin |
InetPortNumber |
|
|
citapStreamDestL4PortMax |
InetPortNumber |
|
|
citapStreamSourceL4PortMin |
InetPortNumber |
|
|
citapStreamSourceL4PortMax |
InetPortNumber |
|
|
citapStreamVRF |
SnmpAdminString |
|
|
citapStreamStatus |
RowStatus |
|
Defined Values
citapStreamCapabilities |
1.3.6.1.4.1.9.9.394.1.1.1 |
This object displays what types of intercept streams can be
configured on this type of device. This may be dependent on
hardware capabilities, software capabilities. The following
fields may be supported:
tapEnable: set if table entries with
cTap2StreamInterceptEnable set to 'false'
are used to pre-screen packets for intercept;
otherwise these entries are ignored.
interface: SNMP ifIndex Value may be used to select
interception of all data crossing an
interface or set of interfaces.
ipV4: IPv4 Address or prefix may be used to select
traffic to be intercepted.
ipV6: IPv6 Address or prefix may be used to select
traffic to be intercepted.
l4Port: TCP/UDP Ports may be used to select traffic
to be intercepted.
dscp: DSCP (Differentiated Services Code Point) may
be used to select traffic to be intercepted.
voip: packets belonging to a voice session may
be intercepted using source IPv4 address and
source UDP port. |
Status: mandatory |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
OCTET STRING |
Size(1..2) |
|
citapStreamTable |
1.3.6.1.4.1.9.9.394.1.1.2 |
The Intercept Stream IP Table lists the IPv4 and IPv6 streams
to be intercepted. The same data stream may be required by
multiple taps, and one might assume that often the intercepted
stream is a small subset of the traffic that could be
intercepted.
This essentially provides options for packet selection, only
some of which might be used. For example, if all traffic to or
from a given interface is to be intercepted, one would
configure an entry which lists the interface, and wild-card
everything else. If all traffic to or from a given IP Address
is to be intercepted, one would configure two such entries
listing the IP Address as source and destination respectively,
and wild-card everything else. If a particular voice on a
teleconference is to be intercepted, on the other hand, one
would extract the multicast (destination) IP address, the
source IP Address, the protocol (UDP), and the source and
destination ports from the call control exchange and list all
necessary information.
The first index indicates which Mediation Device the
intercepted traffic will be diverted to. The second index
permits multiple classifiers to be used together, such as
having an IP address as source or destination. The value of the
second index is that of the stream's counter entry in the
cTap2StreamTable.
Entries are added to this table via citapStreamStatus in
accordance with the RowStatus convention. |
Status: mandatory |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
SEQUENCE OF |
|
|
|
|
CitapStreamEntry |
|
citapStreamEntry |
1.3.6.1.4.1.9.9.394.1.1.2.1 |
A stream entry indicates a single data stream to be
intercepted to a Mediation Device. Many selected data
streams may go to the same application interface, and many
application interfaces are supported. |
Status: mandatory |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
CitapStreamEntry |
|
|
citapStreamInterface |
1.3.6.1.4.1.9.9.394.1.1.2.1.1 |
The ifIndex value of the interface over which traffic to be
intercepted is received or transmitted. The interface may be
physical or virtual. If this is the only parameter specified,
and it is other than -2, -1 or 0, all traffic on the selected
interface will be chosen.
If the value is zero, matching traffic may be received or
transmitted on any interface. Additional selection parameters
must be selected to limit the scope of traffic intercepted.
This is most useful on non-routing platforms or on intercepts
placed elsewhere than a subscriber interface.
If the value is -1, one or both of
citapStreamDestinationAddress and citapStreamSourceAddress
must be specified with prefix length greater than zero.
Matching traffic on the interface pointed to by ipRouteIfIndex
or ipCidrRouteIfIndex values associated with those values is
intercepted, whichever is specified to be more focused than a
default route. If routing changes, either by operator action
or by routing protocol events, the interface will change with
it. This is primarily intended for use on subscriber interfaces
and other places where routing is guaranteed to be
symmetrical.
In both of these cases, it is possible to have the same packet
selected for intersection on both its ingress and egress
interface. Nonetheless, only one instance of the packet is
sent to the Mediation Device.
If the value is -2, packets belonging to a Voice over IP (VoIP)
session identified by citapStreamSourceAddress,
citapStreamSourceLen and citapStreamSourceL4PortMin may be
intercepted, as a specific voice session can be identified
with source IP address and udp port number. Other selection
parameters may be not considered, even if they are set by
the Mediation Device.
This value must be set when creating a stream entry, either to
select an interface, to select all interfaces, or to select the
interface that routing chooses. Some platforms may not
implement the entire range of options. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
INTEGER |
-2..2147483647 |
|
citapStreamDestinationAddress |
1.3.6.1.4.1.9.9.394.1.1.2.1.3 |
The Destination address or prefix used in packet selection.
This address will be of the type specified in
citapStreamAddrType. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
InetAddress |
|
|
citapStreamDestinationLength |
1.3.6.1.4.1.9.9.394.1.1.2.1.4 |
The length of the Destination Prefix. A value of zero causes
all addresses to match. This prefix length will be consistent
with the type specified in citapStreamAddrType. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
InetAddressPrefixLength |
|
|
citapStreamSourceAddress |
1.3.6.1.4.1.9.9.394.1.1.2.1.5 |
The Source Address used in packet selection. This address will
be of the type specified in citapStreamAddrType. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
InetAddress |
|
|
citapStreamSourceLength |
1.3.6.1.4.1.9.9.394.1.1.2.1.6 |
The length of the Source Prefix. A value of zero causes all
addresses to match. This prefix length will be consistent with
the type specified in citapStreamAddrType. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
InetAddressPrefixLength |
|
|
citapStreamTosByte |
1.3.6.1.4.1.9.9.394.1.1.2.1.7 |
The value of the TOS byte, when masked with
citapStreamTosByteMask, of traffic to be intercepted. If
citapStreamTosByte&(~citapStreamTosByteMask)!=0,
configuration is rejected. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
INTEGER |
0..255 |
|
citapStreamTosByteMask |
1.3.6.1.4.1.9.9.394.1.1.2.1.8 |
The value of the TOS byte in an IPv4 or IPv6 header is ANDed
with citapStreamTosByteMask and compared with
citapStreamTosByte. If the values are equal, the comparison
is equal. If the mask is zero and the TosByte value is zero,
the result is to always accept. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
INTEGER |
0..255 |
|
citapStreamFlowId |
1.3.6.1.4.1.9.9.394.1.1.2.1.9 |
The flow identifier in an IPv6 header. -1 indicates that the
Flow Id is unused. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
INTEGER |
-1 | 0..1048575 |
|
citapStreamProtocol |
1.3.6.1.4.1.9.9.394.1.1.2.1.10 |
The IP protocol to match against the IPv4 protocol number or
the IPv6 Next- Header number in the packet. -1 means 'any IP
protocol'. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
INTEGER |
-1 | 0..255 |
|
citapStreamDestL4PortMin |
1.3.6.1.4.1.9.9.394.1.1.2.1.11 |
The minimum value that the layer-4 destination port number in
the packet must have in order to match. This value must be
equal to or less than the value specified for this entry in
citapStreamDestL4PortMax.
If both citapStreamDestL4PortMin and citapStreamDestL4PortMax
are at their default values, the port number is effectively
unused. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
InetPortNumber |
|
|
citapStreamDestL4PortMax |
1.3.6.1.4.1.9.9.394.1.1.2.1.12 |
The maximum value that the layer-4 destination port number in
the packet must have in order to match this classifier entry.
This value must be equal to or greater than the value specified
for this entry in citapStreamDestL4PortMin.
If both citapStreamDestL4PortMin and citapStreamDestL4PortMax
are at their default values, the port number is effectively
unused. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
InetPortNumber |
|
|
citapStreamSourceL4PortMin |
1.3.6.1.4.1.9.9.394.1.1.2.1.13 |
The minimum value that the layer-4 destination port number in
the packet must have in order to match. This value must be
equal to or less than the value specified for this entry in
citapStreamSourceL4PortMax.
If both citapStreamSourceL4PortMin and
citapStreamSourceL4PortMax are at their default values, the
port number is effectively unused. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
InetPortNumber |
|
|
citapStreamSourceL4PortMax |
1.3.6.1.4.1.9.9.394.1.1.2.1.14 |
The maximum value that the layer-4 destination port number in
the packet must have in order to match this classifier entry.
This value must be equal to or greater than the value specified
for this entry in citapStreamSourceL4PortMin.
If both citapStreamSourceL4PortMin and
citapStreamSourceL4PortMax are at their default values, the
port number is effectively unused. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
InetPortNumber |
|
|
citapStreamVRF |
1.3.6.1.4.1.9.9.394.1.1.2.1.15 |
An ASCII string, which is the name of a Virtual Routing
and Forwarding (VRF) table comprising the routing context
of a Virtual Private Network. The interface or set of
interfaces on which the packet might be found should be
selected from the set of interfaces in the VRF table.
A string length of zero implies that global routing table
be used for selection of interfaces on which the packet
might be found. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
SnmpAdminString |
|
|
citapStreamStatus |
1.3.6.1.4.1.9.9.394.1.1.2.1.16 |
The status of this conceptual row. This object manages
creation, modification, and deletion of rows in this table.
When any rows must be changed, citapStreamStatus must be first
set to 'notInService'. |
Status: mandatory |
Access: read-write |
OBJECT-TYPE |
|
|
|
|
RowStatus |
|
|