You are here: Home > CLI Commands > Just_CLI_Topics > pcap

pcap (deprecated)

pcap {raw-start <ipaddr> <target-ipaddr> <target-port> <format> [bssid <bssid>] [channel <number>] [maxlen <maxlen>]}|{interactive <am-ip> <filter> <target-ipaddr> <target-port> [bssid <bssid>][channel <number>]}|{clear|pause|resume|stop <am-ip> <id> [bssid <bssid>]}

Description

These commands manage packet capture (PCAP) on Aruba air monitors.

Syntax

Parameter

Description

raw-start

Stream raw packets to an external viewer.

<ipaddr>

IP address of the air monitor collecting packets.

<target-ipaddr>

IP address of the client station running Wildpacket’s AiroPeek monitoring application.

<target-port>

UDPUser Datagram Protocol. UDP is a part of the TCP/IP family of protocols used for data transfer. UDP is typically used for streaming media. UDP is a stateless protocol, which means it does not acknowledge that the packets being sent have been received. port number on the client station where the captured packets are sent.

<format>

Specify a number to indicate one of the following formats for captured packets:

0 : pcap

1 : peek

2 : airmagnet

3 : pcap+radio header

4 : ppi

bssid

(Optional) BSSIDBasic Service Set Identifier. The BSSID identifies a particular BSS within an area. In infrastructure BSS networks, the BSSID is the MAC address of the AP. In independent BSS or ad hoc networks, the BSSID is generated randomly. of the Air Monitor interface for the PCAP session.

  <bssid>

BSSIDBasic Service Set Identifier. The BSSID identifies a particular BSS within an area. In infrastructure BSS networks, the BSSID is the MAC address of the AP. In independent BSS or ad hoc networks, the BSSID is generated randomly. of the Air Monitor Interface, which is usually its MACMedia Access Control. A MAC address is a unique identifier assigned to network interfaces for communications on a network. address.

channel

(Optional) Number of a radio channel to tune into to capture packets

maxlen

(Optional) Limit the length of 802.11802.11 is an evolving family of specifications for wireless LANs developed by a working group of the Institute of Electrical and Electronics Engineers (IEEE). 802.11 standards use the Ethernet protocol and Carrier Sense Multiple Access with collision avoidance (CSMA/CA) for path sharing. frames to include in the capture to a specified maximum.

  <maxlen>

(Optional) Maximum number of packets to be captured.

interactive

Start an interactive packet capture session.

<am-ip>

IP address of the air monitor collecting packets.

<filter-spec>

Packet Capture filter specification.

<target-ipaddr>

 

<target-port>

 

bssid

(Optional) Specify the BSSIDBasic Service Set Identifier. The BSSID identifies a particular BSS within an area. In infrastructure BSS networks, the BSSID is the MAC address of the AP. In independent BSS or ad hoc networks, the BSSID is generated randomly. of the Air Monitor interface for the PCAP session.

  <bssid>

BSSIDBasic Service Set Identifier. The BSSID identifies a particular BSS within an area. In infrastructure BSS networks, the BSSID is the MAC address of the AP. In independent BSS or ad hoc networks, the BSSID is generated randomly. of the Air Monitor Interface, which is usually its MACMedia Access Control. A MAC address is a unique identifier assigned to network interfaces for communications on a network. address.

channel

(Optional) Number of a radio channel to tune into to capture packets

clear

Clears the packet capture session.

pause

Pause a packet capture session.

resume

Resume a packet capture session.

start

Start a new packet capture session.

stop

Stop a packet capture session.

<am-ip>

IP address of the air monitor collecting packets.

<id>

ID of the PCAP session.

bssid

(Optional) Specify the BSSIDBasic Service Set Identifier. The BSSID identifies a particular BSS within an area. In infrastructure BSS networks, the BSSID is the MAC address of the AP. In independent BSS or ad hoc networks, the BSSID is generated randomly. of the Air Monitor interface for the PCAP session.

  <bssid>

BSSIDBasic Service Set Identifier. The BSSID identifies a particular BSS within an area. In infrastructure BSS networks, the BSSID is the MAC address of the AP. In independent BSS or ad hoc networks, the BSSID is generated randomly. of the Air Monitor Interface, which is usually its MACMedia Access Control. A MAC address is a unique identifier assigned to network interfaces for communications on a network. address.

Usage Guidelines

These commands direct an Aruba air monitor to send packet captures to the Wildpacket’s AiroPeek monitoring application on a remote client. The AiroPeek application listens for packets sent by the air monitor.

The following pcap commands are available:

Command

Description

clear

Clears the packet capture session.

pause

Pause a packet capture session.

resume

Resume a packet capture session.

start

Start a new packet capture session.

stop

Stop a packet capture session.

Before using these commands, you need to start the AiroPeek application on the client and open a capture window for the air monitor. The AiroPeek application cannot be used to control the flow or type of packets sent from Aruba air monitors.

The AiroPeek application processes all packets, however, you can apply display filters on the capture window to control the number and type of packets being displayed. In the capture window, the time stamp displayed corresponds to the time that the packet is received by the client and is not synchronized with the time on the Aruba air monitor.

Example

The following command starts a raw packet capture session for the air monitor at 10.100.100.1 and sends the packets to the client at 192.168.22.44 on port 604 with pcap format:

(host) (config) #pcap raw-start 10.100.100.1 192.168.22.44 604 0

Command History

Release

Modification

ArubaOS 8.0.0.0

Command introduced.

Command Information

Platforms

Licensing

Command Mode

All platforms

Base operating system.

Enable mode on Mobility Master.

/*]]>*/