BTSOCKSTAT(1)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

💅 BTSOCKSTAT(1) — bestie's guide to peeking at Bluetooth sockets ✨

okay so real talk, this is btsockstat(1) from the General Commands Manual and it's lowkey iconic for anyone who's ever wondered what's actually going on inside their Bluetooth stack 🦋

🌸 NAME 🌸

btsockstat — show Bluetooth sockets information, and yes she will spill the tea about your active sockets 💖

✨ SYNOPSIS ✨

btsockstat [-nrh] [-M core] [-p protocol]

🎀 DESCRIPTION 🎀

The btsockstat utility symbolically displays the contents of various Bluetooth sockets related data structures. Like, it literally reads the vibes of your data structures and translates them into something you can actually look at 🫶

There are few output formats, depending on the options for the information presented — so the vibe check changes based on what flags you pass, no cap.

The btsockstat utility will print results to the standard output and error messages to the standard error. Clean split, standard behavior, we love to see it 💅

The options are as follows:

👑 OPTIONS 👑

  • -h — Display usage message and exit. The "wait what were the flags again" button, iykyk 🙈
  • -M core — Extract values associated with the name list from the specified core instead of the default /dev/kmem. So if you wanna point her at a different core file instead of the default, this is the move ✨
  • -n — Show Bluetooth addresses as numbers. Normally, btsockstat attempts to resolve Bluetooth addresses, and display them symbolically — so this flag is you going "bestie, just gimme the raw numbers" 🍓
  • -p protocol — Display a list of active sockets (protocol control blocks) for each specified protocol. Supported protocols are: hci_raw, l2cap_raw, l2cap, rfcomm and rfcomm_s. Pick your fighter, or honestly pick them all, main character energy 🔥
  • -r — Display a list of active routing entries (if any) for specified protocol. Note the "(if any)" — sometimes there's just nothing there and that's okay 🌈

💀 EXIT STATUS 💀

The btsockstat utility exits 0 on success, and >0 if an error occurs. Zero means slay, anything above zero means something went off the rails 😭

🔥 SEE ALSO 🔥

ng_btsocket(4) — go read that one next, fr fr ⭐

🧚 AUTHORS 🧚

Maksim Yevmenkin <m_evmenkin@yahoo.com> — the icon, the legend, the one who made this possible 👑

🌸 BUGS 🌸

Most likely. Please report if found. (Not me being this honest in a manpage 💀)

and that's the whole page bestie 🫶💖 — brought to you by the Debian crew, dated October 12, 2003, because some icons are timeless 💜✨

📦 where this page comes from