All MIBs › IF-MIB › ifPromiscuousMode
ifPromiscuousMode
Module: IF-MIB
OID (symbolic): IF-MIB::ifPromiscuousMode
OID (numeric): 1.3.6.1.2.1.31.1.1.1.16
Node type: OBJECT-TYPE
Type: TruthValue
Access: read-write
Description: This object has a value of false(2) if this interface only accepts packets/frames that are addressed to this station. This object has a value of true(1) when the station accepts all packets/frames transmitted on the media. The value true(1) is only legal on certain types of media. If legal, setting this object to a value of true(1) may require the interface to be reset before becoming effective.
The value of ifPromiscuousMode does not affect the reception of broadcast and multicast packets/frames by the interface.
What is ifPromiscuousMode?
This read-write TruthValue indicates whether the interface accepts only frames addressed to this station, false(2), or accepts every frame transmitted on the media, true(1). It matters for diagnostic and monitoring tools that need to see all traffic on a segment, though enabling it may require resetting the interface and does not affect reception of broadcast or multicast frames either way. For example, an admin sets ifPromiscuousMode to true(1) on a SPAN or capture port so a packet-sniffing appliance can see every frame on the wire, not just its own.
Examples
Walk all instances (SNMPv2c):
snmpwalk -v2c -c public <target> 1.3.6.1.2.1.31.1.1.1.16 snmpwalk -v2c -c public <target> IF-MIB::ifPromiscuousMode
Get a specific instance (index 1):
snmpget -v2c -c public <target> 1.3.6.1.2.1.31.1.1.1.16.1 snmpget -v2c -c public <target> IF-MIB::ifPromiscuousMode.1
Set instance 1 (SNMPv2c):
snmpset -v2c -c private <target> 1.3.6.1.2.1.31.1.1.1.16.1 s <value>
Start monitoring SNMP-managed network devices with a free 30-day trial of IPNetwork Monitor. Create custom SNMP monitor using the IF-MIB::ifPromiscuousMode OID value, configure state conditions and alerts, and monitor any SNMP-managed network devices from a single console.
OID Breakdown
Upper-level ancestors (6 from the standard OID tree / other modules)
| Numeric OID | Name | Module |
|---|---|---|
| 1 | iso | LANART-AGENT |
| 1.3 | org | AirPair-MIB |
| 1.3.6 | dod | AirPair-MIB |
| 1.3.6.1 | internet | AirPair-MIB |
| 1.3.6.1.2 | mgmt | AXON-MIB |
| 1.3.6.1.2.1 | mib_2 | AXON-MIB |
| Numeric OID | Name | Module |
|---|---|---|
| 1.3.6.1.2.1.31 | ifMIB | IF-MIB |
| 1.3.6.1.2.1.31.1 | ifMIBObjects | IF-MIB |
| 1.3.6.1.2.1.31.1.1 | ifXTable | IF-MIB |
| 1.3.6.1.2.1.31.1.1.1 | ifXEntry | IF-MIB |
| 1.3.6.1.2.1.31.1.1.1.16 | ifPromiscuousMode | IF-MIB |