This is a summary of information regarding objects below the tcp MIB object, which is defined within the TCP-MIB MIB document as .1.3.6.1.2.1.6.
| Table Name | tcpConnectionTable |
| In MIB | TCP-MIB |
| Registered at OID | .1.3.6.1.2.1.6.19 |
| Table Description |
A table containing information about existing TCP connections. Note that unlike earlier TCP MIBs, there is a separate table for connections in the LISTEN state. |
| Row Description |
A conceptual row of the tcpConnectionTable containing information about a particular current TCP connection. Each row of this table is transient in that it ceases to exist when (or soon after) the connection makes the transition to the CLOSED state. |
| Name | Type | Access | Description |
|---|---|---|---|
|
1
tcpConnectionLocalAddressType |
INTEGER
InetAddressType (ENUM list below) | NoAccess |
Note: this object is based on the InetAddressType TEXTUAL-CONVENTION. The address type of tcpConnectionLocalAddress. |
|
2
tcpConnectionLocalAddress |
OCTETSTR
Legal Lengths: 0 .. 255 InetAddress | NoAccess |
Note: this object is based on the InetAddress TEXTUAL-CONVENTION. The local IP address for this TCP connection. The type of this address is determined by the value of tcpConnectionLocalAddressType. As this object is used in the index for the tcpConnectionTable, implementors should be careful not to create entries that would result in OIDs with more than 128 subidentifiers; otherwise the information cannot be accessed by using SNMPv1, SNMPv2c, or SNMPv3. |
|
3
tcpConnectionLocalPort |
UNSIGNED32
Legal values: 0 .. 65535 InetPortNumber | NoAccess |
Note: this object is based on the InetPortNumber TEXTUAL-CONVENTION. The local port number for this TCP connection. |
|
4
tcpConnectionRemAddressType |
INTEGER
InetAddressType (ENUM list below) | NoAccess |
Note: this object is based on the InetAddressType TEXTUAL-CONVENTION. The address type of tcpConnectionRemAddress. |
|
5
tcpConnectionRemAddress |
OCTETSTR
Legal Lengths: 0 .. 255 InetAddress | NoAccess |
Note: this object is based on the InetAddress TEXTUAL-CONVENTION. The remote IP address for this TCP connection. The type of this address is determined by the value of tcpConnectionRemAddressType. As this object is used in the index for the tcpConnectionTable, implementors should be careful not to create entries that would result in OIDs with more than 128 subidentifiers; otherwise the information cannot be accessed by using SNMPv1, SNMPv2c, or SNMPv3. |
|
6
tcpConnectionRemPort |
UNSIGNED32
Legal values: 0 .. 65535 InetPortNumber | NoAccess |
Note: this object is based on the InetPortNumber TEXTUAL-CONVENTION. The remote port number for this TCP connection. |
| Name | Type | Access | Description | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
7
tcpConnectionState |
INTEGER
| ReadWrite |
The state of this TCP connection.
The value listen(2) is included only for parallelism to the
old tcpConnTable and should not be used. A connection in
LISTEN state should be present in the tcpListenerTable.
The only value that may be set by a management station is
deleteTCB(12). Accordingly, it is appropriate for an agent
to return a `badValue' response if a management station
attempts to set this object to any other value.
If a management station sets this object to the value
deleteTCB(12), then the TCB (as defined in [RFC793]) of
the corresponding connection on the managed node is
deleted, resulting in immediate termination of the
connection.
As an implementation-specific option, a RST segment may be
sent from the managed node to the other TCP endpoint (note,
however, that RST segments are not sent reliably).
|
||||||||||||||||||||||||||
|
8
tcpConnectionProcess | UNSIGNED32 | ReadOnly |
The system's process ID for the process associated with this connection, or zero if there is no such process. This value is expected to be the same as HOST-RESOURCES-MIB:: hrSWRunIndex or SYSAPPL-MIB::sysApplElmtRunIndex for some row in the appropriate tables. |
| Table Name | tcpListenerTable |
| In MIB | TCP-MIB |
| Registered at OID | .1.3.6.1.2.1.6.20 |
| Table Description |
A table containing information about TCP listeners. A listening application can be represented in three possible ways: 1. An application that is willing to accept both IPv4 and IPv6 datagrams is represented by a tcpListenerLocalAddressType of unknown (0) and a tcpListenerLocalAddress of ''h (a zero-length octet-string). 2. An application that is willing to accept only IPv4 or IPv6 datagrams is represented by a tcpListenerLocalAddressType of the appropriate address type and a tcpListenerLocalAddress of '0.0.0.0' or '::' respectively. 3. An application that is listening for data destined only to a specific IP address, but from any remote system, is represented by a tcpListenerLocalAddressType of an appropriate address type, with tcpListenerLocalAddress as the specific local address. NOTE: The address type in this table represents the address type used for the communication, irrespective of the higher-layer abstraction. For example, an application using IPv6 'sockets' to communicate via IPv4 between ::ffff:10.0.0.1 and ::ffff:10.0.0.2 would use InetAddressType ipv4(1)). |
| Row Description |
A conceptual row of the tcpListenerTable containing information about a particular TCP listener. |
| Name | Type | Access | Description |
|---|---|---|---|
|
1
tcpListenerLocalAddressType |
INTEGER
InetAddressType (ENUM list below) | NoAccess |
Note: this object is based on the InetAddressType TEXTUAL-CONVENTION. The address type of tcpListenerLocalAddress. The value should be unknown (0) if connection initiations to all local IP addresses are accepted. |
|
2
tcpListenerLocalAddress |
OCTETSTR
Legal Lengths: 0 .. 255 InetAddress | NoAccess |
Note: this object is based on the InetAddress TEXTUAL-CONVENTION.
The local IP address for this TCP connection.
The value of this object can be represented in three
possible ways, depending on the characteristics of the
listening application:
1. For an application willing to accept both IPv4 and
IPv6 datagrams, the value of this object must be
''h (a zero-length octet-string), with the value
of the corresponding tcpListenerLocalAddressType
object being unknown (0).
2. For an application willing to accept only IPv4 or
IPv6 datagrams, the value of this object must be
'0.0.0.0' or '::' respectively, with
tcpListenerLocalAddressType representing the
appropriate address type.
3. For an application which is listening for data
destined only to a specific IP address, the value
of this object is the specific local address, with
tcpListenerLocalAddressType representing the
appropriate address type.
As this object is used in the index for the
tcpListenerTable, implementors should be
careful not to create entries that would result in OIDs
with more than 128 subidentifiers; otherwise the information
cannot be accessed, using SNMPv1, SNMPv2c, or SNMPv3.
|
|
3
tcpListenerLocalPort |
UNSIGNED32
Legal values: 0 .. 65535 InetPortNumber | NoAccess |
Note: this object is based on the InetPortNumber TEXTUAL-CONVENTION. The local port number for this TCP connection. |
| Name | Type | Access | Description |
|---|---|---|---|
|
4
tcpListenerProcess | UNSIGNED32 | ReadOnly |
The system's process ID for the process associated with this listener, or zero if there is no such process. This value is expected to be the same as HOST-RESOURCES-MIB:: hrSWRunIndex or SYSAPPL-MIB::sysApplElmtRunIndex for some row in the appropriate tables. |
SCALAR OBJECTS
TABLE OBJECTSTable tcpConnTable
tcpConnTable Indexes:
Other tcpConnTable Columns:
|
These TEXTUAL-CONVENTIONS are used in other parts of the document above. They are SNMP's way of defining a datatype that is used repeatedly by other MIB objects. Any implementation implementing objects that use one of these definitions must follow its DESCRIPTION clause as well as the DESCRIPTION clause of the object itself.
| Name | Type | Description | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| InetPortNumber | UNSIGNED32 | Represents a 16 bit port number of an Internet transport
layer protocol. Port numbers are assigned by IANA. A
current list of all assignments is available from
| ||||||||||||||
| InetAddress | OCTETSTR | Denotes a generic Internet address.
An InetAddress value is always interpreted within the context
of an InetAddressType value. Every usage of the InetAddress
textual convention is required to specify the InetAddressType
object that provides the context. It is suggested that the
InetAddressType object be logically registered before the
object(s) that use the InetAddress textual convention, if
they appear in the same logical row.
The value of an InetAddress object must always be
consistent with the value of the associated InetAddressType
object. Attempts to set an InetAddress object to a value
inconsistent with the associated InetAddressType
must fail with an inconsistentValue error.
When this textual convention is used as the syntax of an
index object, there may be issues with the limit of 128
sub-identifiers specified in SMIv2, STD 58. In this case,
the object definition MUST include a 'SIZE' clause to
limit the number of potential instance sub-identifiers;
otherwise the applicable constraints MUST be stated in
the appropriate conceptual row DESCRIPTION clauses, or
in the surrounding documentation if there is no single
DESCRIPTION clause that is appropriate. | ||||||||||||||
| InetAddressType | INTEGER
| A value that represents a type of Internet address.
unknown(0) An unknown address type. This value MUST
be used if the value of the corresponding
InetAddress object is a zero-length string.
It may also be used to indicate an IP address
that is not in one of the formats defined
below.
ipv4(1) An IPv4 address as defined by the
InetAddressIPv4 textual convention.
ipv6(2) An IPv6 address as defined by the
InetAddressIPv6 textual convention.
ipv4z(3) A non-global IPv4 address including a zone
index as defined by the InetAddressIPv4z
textual convention.
ipv6z(4) A non-global IPv6 address including a zone
index as defined by the InetAddressIPv6z
textual convention.
dns(16) A DNS domain name as defined by the
InetAddressDNS textual convention.
Each definition of a concrete InetAddressType value must be
accompanied by a definition of a textual convention for use
with that InetAddressType.
To support future extensions, the InetAddressType textual
convention SHOULD NOT be sub-typed in object type definitions.
It MAY be sub-typed in compliance statements in order to
require only a subset of these address types for a compliant
implementation.
Implementations must ensure that InetAddressType objects
and any dependent objects (e.g., InetAddress objects) are
consistent. An inconsistentValue error must be generated
if an attempt to change an InetAddressType object would,
for example, lead to an undefined InetAddress value. In
particular, InetAddressType/InetAddress pairs must be
changed together if the address type changes (e.g., from
ipv6(2) to ipv4(1)). |
Tree view generated by running: snmptranslate -Tp TCP-MIB::tcp
+--tcp(6) | +-- -R-- EnumVal tcpRtoAlgorithm(1) | Values: other(1), constant(2), rsre(3), vanj(4), rfc2988(5) +-- -R-- Integer32 tcpRtoMin(2) | Range: 0..2147483647 +-- -R-- Integer32 tcpRtoMax(3) | Range: 0..2147483647 +-- -R-- Integer32 tcpMaxConn(4) | Range: -1 | 0..2147483647 +-- -R-- Counter tcpActiveOpens(5) +-- -R-- Counter tcpPassiveOpens(6) +-- -R-- Counter tcpAttemptFails(7) +-- -R-- Counter tcpEstabResets(8) +-- -R-- Gauge tcpCurrEstab(9) +-- -R-- Counter tcpInSegs(10) +-- -R-- Counter tcpOutSegs(11) +-- -R-- Counter tcpRetransSegs(12) | +--tcpConnTable(13) | | | +--tcpConnEntry(1) | | Index: tcpConnLocalAddress, tcpConnLocalPort, tcpConnRemAddress, tcpConnRemPort | | | +-- -RW- EnumVal tcpConnState(1) | | Values: closed(1), listen(2), synSent(3), synReceived(4), established(5), finWait1(6), finWait2(7), closeWait(8), lastAck(9), closing(10), timeWait(11), deleteTCB(12) | +-- -R-- IpAddr tcpConnLocalAddress(2) | +-- -R-- Integer32 tcpConnLocalPort(3) | | Range: 0..65535 | +-- -R-- IpAddr tcpConnRemAddress(4) | +-- -R-- Integer32 tcpConnRemPort(5) | Range: 0..65535 | +-- -R-- Counter tcpInErrs(14) +-- -R-- Counter tcpOutRsts(15) +-- -R-- Counter64 tcpHCInSegs(17) +-- -R-- Counter64 tcpHCOutSegs(18) | +--tcpConnectionTable(19) | | | +--tcpConnectionEntry(1) | | Index: tcpConnectionLocalAddressType, tcpConnectionLocalAddress, tcpConnectionLocalPort, tcpConnectionRemAddressType, tcpConnectionRemAddress, tcpConnectionRemPort | | | +-- ---- EnumVal tcpConnectionLocalAddressType(1) | | Textual Convention: InetAddressType | | Values: unknown(0), ipv4(1), ipv6(2), ipv4z(3), ipv6z(4), dns(16) | +-- ---- String tcpConnectionLocalAddress(2) | | Textual Convention: InetAddress | | Size: 0..255 | +-- ---- Unsigned tcpConnectionLocalPort(3) | | Textual Convention: InetPortNumber | | Range: 0..65535 | +-- ---- EnumVal tcpConnectionRemAddressType(4) | | Textual Convention: InetAddressType | | Values: unknown(0), ipv4(1), ipv6(2), ipv4z(3), ipv6z(4), dns(16) | +-- ---- String tcpConnectionRemAddress(5) | | Textual Convention: InetAddress | | Size: 0..255 | +-- ---- Unsigned tcpConnectionRemPort(6) | | Textual Convention: InetPortNumber | | Range: 0..65535 | +-- -RW- EnumVal tcpConnectionState(7) | | Values: closed(1), listen(2), synSent(3), synReceived(4), established(5), finWait1(6), finWait2(7), closeWait(8), lastAck(9), closing(10), timeWait(11), deleteTCB(12) | +-- -R-- Unsigned tcpConnectionProcess(8) | +--tcpListenerTable(20) | +--tcpListenerEntry(1) | Index: tcpListenerLocalAddressType, tcpListenerLocalAddress, tcpListenerLocalPort | +-- ---- EnumVal tcpListenerLocalAddressType(1) | Textual Convention: InetAddressType | Values: unknown(0), ipv4(1), ipv6(2), ipv4z(3), ipv6z(4), dns(16) +-- ---- String tcpListenerLocalAddress(2) | Textual Convention: InetAddress | Size: 0..255 +-- ---- Unsigned tcpListenerLocalPort(3) | Textual Convention: InetPortNumber | Range: 0..65535 +-- -R-- Unsigned tcpListenerProcess(4)
Last modified: Wednesday, 01-Aug-2018 04:41:28 UTC
For questions regarding web content and site functionality, please write to the net-snmp-users mail list.