OS Manuals

/usr/bin/btmon

From bluez-btmon 5.88-r0 (os), captured 2026-11-07 by running btmon --help (exit 0). permalink

btmon - Bluetooth monitor
Usage:
	btmon [options]
options:
	-r, --read <file>      Read traces in btsnoop format
	-w, --write <file>     Save traces in btsnoop format
	-a, --analyze <file>   Analyze traces in btsnoop format
	                       If gnuplot is installed on the
	                       system it will also attempt to plot
	                       packet latency graph.
	-s, --server <socket>  Start monitor server socket
	-p, --priority <level> Show only priority or lower
	-i, --index <num>      Show only specified controller
	-d, --tty <tty>        Read data from TTY
	-B, --tty-speed <rate> Set TTY speed (default 115200)
	-V, --vendor <compid>  Set default company identifier
	-M, --mgmt             Open channel for mgmt events
	-K, --kernel           Open kmsg for kernel messages
	-t, --time             Show time instead of time offset
	-T, --date             Show time and date information
	-S, --sco              Dump SCO traffic
	-A, --a2dp             Dump A2DP stream traffic
	-I, --iso              Dump ISO traffic
	-E, --ellisys [ip]     Send Ellisys HCI Injection
	-P, --no-pager         Disable pager usage
	-0, --print0           Separate frames with a NUL, for a
	                       pager reading records
	-J  --jlink <device>,[<serialno>],[<interface>],[<speed>]
	                       Read data from RTT
	-R  --rtt [<address>],[<area>],[<name>]
	                       RTT control block parameters
	-C, --columns [width]  Output width if not a terminal
	-c, --color [mode]     Output color: auto/always/never
	-h, --help             Show help options
Options (24)
OptionDescriptionSource
-r, --read fileRead traces in btsnoop formathelp
-w, --write fileSave traces in btsnoop formathelp
-a, --analyze fileAnalyze traces in btsnoop format If gnuplot is installed on the system it will also attempt to plot packet latency graph.help
-s, --server socketStart monitor server sockethelp
-i, --index numShow only specified controllerhelp
-d, --tty ttyRead data from TTYhelp
-V, --vendor compidSet default company identifierhelp
-M, --mgmtOpen channel for mgmt events.help + man
-K, --kernelOpen kmsg for kernel messages.help + man
-t, --timeShow a time instead of time offset.help + man
-T, --dateShow a time and date information instead of time offset.help + man
-S, --scoDump SCO traffic in raw hex format.help + man
-A, --a2dpDump A2DP stream traffic in a raw hex format.help + man
-I, --isoDump ISO stream traffic in raw hex format.help + man
-E, --ellisys ipSend Ellisys HCI Injectionhelp
-P, --no-pagerDisable pager usage while reading the log file.help + man
-0, --print0Separate the frames with a NUL, so that a pager or a tool reading records rather than lines sees a whole frame as one entry.help + man
-J--jlink <device>,[<serialno>],[<interface>],[<speed>] Read data from RTThelp
-R--rtt [<address>],[<area>],[<name>] RTT control block parametershelp
-C, --columns widthOutput width if not a terminalhelp
-c, --color modeOutput color: auto/always/neverhelp
-h, --helpShow help optionshelp + man
-N, --no-timeSuppress the time offset display entirely. (in the manual page but not in --help)man
-v, --versionShow version (in the manual page but not in --help)man
Examples (4) from the manual page, untested

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.