capture-packet access condition
Function
The capture-packet access condition mac-address command enables a device to obtain protocol packet headers based on a specified MAC address.
The capture-packet access condition interface command enables a device to obtain protocol packet headers based on a specified interface.
The capture-packet access condition l2tp slot source-ip dest-ip command enables a device to obtain L2TP packet headers and collect packet statistics based on a specified interface board and IP addresses.
The capture-packet access condition l2tp slot local-tunnel-id remote-tunnel-id command enables a device to obtain L2TP packet headers and collect packet statistics based on a specified interface board and tunnel IDs.
The undo capture-packet access condition command restores the default configuration.
By default, a device is disabled from obtaining protocol packet headers.
This command is supported only on the NetEngine 8000 F1A.
Format
capture-packet access condition { pppoe | dhcp | dhcpv6 | nd | ip | arp } mac-address mac-address vlan-tags vlan-tags [ inbound | outbound ] [ time-out time-out-value ]
capture-packet access condition { pppoe | dhcp | dhcpv6 | nd | ip | arp } { interface { interface-type interface-num | interface-name } [ pevlan pevlan-id [ cevlan cevlan-id ] ] } [ inbound | outbound ] [ time-out time-out-value ]
capture-packet access condition l2tp slot slot-id source-ip source-ip-address dest-ip dest-ip-address [ inbound | outbound ] [ time-out time-out-value ]
capture-packet access condition l2tp slot slot-id { local-tunnel-id local-tunnel-id | remote-tunnel-id remote-tunnel-id } * [ time-out time-out-value ]
undo capture-packet access condition
Parameters
| Parameter | Description | Value |
|---|---|---|
| pppoe |
Obtains PPPoE protocol packet headers. |
- |
| dhcp |
Obtains DHCP protocol packet headers. |
- |
| dhcpv6 |
Obtains DHCPv6 protocol packet headers. |
- |
| nd |
Obtains ND protocol packet headers. |
- |
| ip |
Obtains IP protocol packet headers. |
- |
| arp |
Obtains ARP protocol packet headers. |
- |
| mac-address mac-address |
Obtains protocol packet headers based on a MAC address. |
The value is a 12-digit hexadecimal number, in the format of H-H-H. Each H is 4 digits. If an H contains fewer than 4 digits, the left-most digits are padded with zeros. For example, e0 is displayed as 00e0. The MAC address cannot be set to FFFF-FFFF-FFFF. |
| vlan-tags vlan-tags |
Specifies the number of VLAN tags. |
The value is an integer ranging from 0 to 2. |
| inbound |
Obtains inbound packet headers. |
- |
| outbound |
Obtains outbound packet headers. |
- |
| time-out time-out-value |
Specifies a timeout period for obtaining packet headers. |
The value is an integer ranging from 1 to 3600, in seconds. |
| interface-type |
Specifies the type of an interface. |
- |
| interface-num |
Specifies the number of an interface. |
- |
| interface-name |
Specifies the name of an interface. |
- |
| pevlan pevlan-id |
Specifies an outer VLAN ID. |
The value is an integer ranging from 1 to 4094. |
| cevlan cevlan-id |
Specifies an inner VLAN ID. |
The value is an integer ranging from 1 to 4094. |
| slot slot-id |
Obtains L2TP protocol packet headers based on a slot ID. |
- |
| source-ip source-ip-address |
Obtains L2TP protocol packet headers based on a source IP address. |
The value is in dotted decimal notation. |
| dest-ip dest-ip-address |
Obtains L2TP protocol packet headers based on a destination IP address. |
The value is in dotted decimal notation. |
| local-tunnel-id local-tunnel-id |
Specifies a local tunnel ID based on which L2TP protocol packet headers are to be obtained. |
The value is an integer ranging from 1 to 65535. |
| remote-tunnel-id remote-tunnel-id |
Specifies a remote tunnel ID based on which L2TP protocol packet headers are to be obtained. |
The value is an integer ranging from 1 to 65535. |
Usage Guidelines
Usage Scenario
In case of a user access fault, to enable a device to obtain packet headers based on specified rules, run the capture-packet access condition command. This facilitates fault diagnosis. To check information about obtained packet headers, run the display capture-packet access information command.
The device distinguishes PPPoE protocol packets in the Discovery Stage and Session stage. If inbound is configured, the device obtains PPPoE packet headers in the Discovery stage. If outbound is configured, the device obtains PPPoE packet headers in the Session stage. If neither inbound or outbound is configured, the device obtains PPPoE packet headers in the Discovery stage only.Precautions
Due to hardware resource constraints, a maximum of four packet header obtaining rules can be configured. If more than four rules are configured, the capture-packet access condition command fails to take effect, and no prompt message is displayed. Run the display capture-packet access config-state command to check the packet header obtaining configuration.
The channelized subcard outbound direction does not support automatic matching of VLAN IDs to obtain the packet header.