---
name: "hcitop"
section: "1"
platform: "linux"
package: "bluez-alsa-utils"
version: "4.3.1-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/hcitop"
---

# hcitop(1)

a simple dynamic view of HCI activity

## NAME

hcitop - a simple dynamic view of HCI activity

## SYNOPSIS

**hcitop** \[*OPTION*\]...

## DESCRIPTION

**hcitop** provides a dynamic real-time view of activity statistics for each HCI interface. The view is refreshed at regular intervals, and also on demand by pressing a key. To quit the program press the 'q' key, or use Ctrl-C.

## OPTIONS

- **-h, --help**

  Output a usage message and exit.

- **-V, --version**

  Output the version number and exit.

- **-d** *SEC,* **--delay=***SEC*

  Set the interval at which the statistics are refreshed. SEC is a number of seconds and may include a decimal point or exponent.

## COLUMNS

- **HCI**

  The HCI name ("hci0", etc.).

- **BUS**

  The bus name ("UART", "USB", etc.).

- **ADDR**

  The Bluetooth device address.

- **FLAGS**

  Status flags of the HCI. See **FLAGS** below.

- **RX**

  Total amount of data received since the HCI was last brought up.

- **TX**

  Total amount of data transmitted since the HCI was last brought up.

- **RX/s**

  Average rate of reception during the last refresh interval.

- **TX/s**

  Average rate of transmission during the last refresh interval.

## FLAGS

An array of flag characters indicating the current status of the HCI. The flags are shown in the following order. The indicated letter appears when that flag is "TRUE", a blank is shown when the flag is "FALSE".

- **U**

  The interface is "Up".

- **N**

  The interface is initializing.

- **R**

  The interface is running.

- **P**

  Page scan is enabled.

- **I**

  Inquiry scan is enabled.

- **A**

  Authentication is enabled.

- **E**

  Encryption is enabled.

- **Q**

  The interface is currently inquiring (scanning) remote devices.

- **X**

  Raw mode is enabled.

## COPYRIGHT

Copyright (c) 2016-2023 Arkadiusz Bokowy.

The bluez-alsa project is licensed under the terms of the MIT license.

## SEE ALSO

**[btmon(1)](/btmon/1.md)**, **[hciconfig(1)](/hciconfig/1.md)**, **[hcitool(1)](/hcitool/1.md)**

- **Project web site**

   \<https://github.com/arkq/bluez-alsa\>