> For the complete documentation index, see [llms.txt](https://documentation.hak5.org/wifi-pineapple-pager/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.hak5.org/wifi-pineapple-pager/wifi-pineapple-commands/examine.md).

# EXAMINE

`PINEAPPLE_EXAMINE_BSSID` - stop channel hopping and examine the channel of a known access point

`PINEAPPLE_EXAMINE_CHANNEL` - stop channel hopping and examine a channel

`PINEAPPLE_EXAMINE_RESET` - resume channel hopping

### When to use them  <a href="#when-to-use-them" id="when-to-use-them"></a>

Normally, the recon engine hops between Wi-Fi channels to build a view of the Wi-Fi environment.

To build a more detailed view of a single channel - for instance to identify more clients on an access point of interest, or to attempt to capture handshakes from a specific AP - use the `EXAMINE` commands.

An `EXAMINE` command can examine for a fixed amount of time, or indefinitely. Use `PINEAPPLE_EXAMINE_RESET` to return to channel hopping mode.

### Syntax  <a href="#syntax" id="syntax"></a>

```none
PINEAPPLE_EXAMINE_BSSID [bssid] {time}
```

**bssid**

BSSID (MAC address) of the access point, in the format `xx:xx:xx:xx:xx:xx`.

**time (optional)**

Time (in seconds) to stay locked to a channel.

```none
PINEAPPLE_EXAMINE_CHANNEL [channel] {time}
```

**channel**

Wi-Fi channel

**time (optional)**

Time (in seconds) to stay locked to a channel.

### Results  <a href="#results" id="results"></a>

`EXAMINE` commands return immediately. In the background, the PineAP system will set the new channel and wait the amount of time requested (or until a `PINEAPPLE_EXAMINE_RESET` command is sent).

### Examples  <a href="#examples" id="examples"></a>

```bash
PINEAPPLE_EXAMINE_BSSID 00:AA:BB:CC:DD:EE 10
```

```bash
PINEAPPLE_EXAMINE_CHANNEL 36
# do some stuff
PINEAPPLE_EXAMINE_RESET
```