HCITOP(1)

๐Ÿ“ฆ
version 4.3.1 ยท 2 versions
, in alpine 3.24, debian trixie, ubuntu questing

๐Ÿ’– HCITOP(1) ๐Ÿ’–

okay so bestie, welcome to the hcitop page from the General Commands Manual โ€” she's a lil' command, she's a whole vibe, and by the end of this you're gonna know her like the back of your hand. no cap. โœจ


๐ŸŒธ NAME ๐ŸŒธ

hcitop</puruple> โ€” a simple dynamic view of HCI activity. that's it, that's the girl. ๐ŸŽ€


๐Ÿฆ‹ SYNOPSIS ๐Ÿฆ‹

hcitop [OPTION]...

โœจ DESCRIPTION โœจ

okay so here's the tea โ˜•: hcitop gives you a dynamic, real-time view of activity statistics for each HCI interface. every single one. she's watching. ๐Ÿ‘€

The view refreshes at regular intervals โ€” and on demand whenever you press a key, because she's responsive like that. ๐Ÿ’…

To quit the program, press the q key, or use Ctrl-C. either one, she's not picky, she just wants you to leave politely. ๐Ÿซถ


๐Ÿ’… OPTIONS ๐Ÿ’…

  • -h, --help โ€” outputs a usage message and then dips. that's it, that's all. ๐ŸŒˆ
  • -V, --version โ€” outputs the version number and exits. iconic. show-off behavior honestly. ๐Ÿ‘‘
  • -d SEC, --delay=SEC โ€” sets the interval at which the statistics get refreshed. SEC is a number of seconds and may include a decimal point or exponent, so like, go feral with the math, she can handle it. ๐Ÿ”ฅ

๐ŸŽ€ COLUMNS ๐ŸŽ€

here's what each column is giving, one by one:

  • HCI โ€” the HCI name (like "hci0", etc.). name tag energy. ๐Ÿท๏ธ
  • BUS โ€” the bus name (like "UART", "USB", etc.). where she rides. ๐ŸšŒ
  • ADDR โ€” the Bluetooth device address. her address, but make it wireless. ๐Ÿ“ฎ
  • FLAGS โ€” status flags of the HCI. see FLAGS below for the whole breakdown. โฌ‡๏ธ
  • RX โ€” total amount of data received since the HCI was last brought up. all the incoming, bestie. ๐Ÿ“ฅ
  • TX โ€” total amount of data transmitted since the HCI was last brought up. all the outgoing. ๐Ÿ“ค
  • RX/s โ€” average rate of reception during the last refresh interval. per second, obviously. โฑ๏ธ
  • TX/s โ€” average rate of transmission during the last refresh interval. same energy, other direction. โฑ๏ธ

๐Ÿ”ฅ FLAGS ๐Ÿ”ฅ

So FLAGS is an array of flag characters showing the current status of the HCI. They show up in the following order, and here's the rule: the indicated letter appears when that flag is "TRUE", and a blank shows up when the flag is "FALSE". no in-between, she's binary like that. ๐Ÿ’€

  • U โ€” the interface is "Up". she's awake!! ๐Ÿซถ
  • N โ€” the interface is initializing. give her a sec, she's loading. ๐Ÿงš
  • R โ€” the interface is running. she's moving, she's grooving. ๐Ÿ”ฅ
  • 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. nosy in the best way. ๐Ÿ‘€
  • X โ€” Raw mode is enabled. raw. unfiltered. main character energy. ๐Ÿ’…

Copyright (c) 2016-2023 Arkadiusz Bokowy.

The bluez-alsa project is licensed under the terms of the MIT license. respect the license bestie, it's the rules. ๐ŸŽ€


๐ŸŒˆ SEE ALSO ๐ŸŒˆ

Project web site


and that's the whole page, bestie!! โœจ this was BlueALSA v4.3.1, dated July 2023, and honestly? she ate. ๐Ÿ’– go forth and watch those HCI interfaces pop off. ๐Ÿฆ‹๐ŸŽ€๐Ÿ’…

๐Ÿ“ฆ where this page comes from