git: a380d07f4739 - stable/15 - virtual_oss.8: Document `/dev/bluetooth/` prefix magic

From: Aymeric Wibo <obiwac_at_FreeBSD.org>
Date: Sat, 27 Jun 2026 01:11:43 UTC
The branch stable/15 has been updated by obiwac:

URL: https://cgit.FreeBSD.org/src/commit/?id=a380d07f4739168a6eae4383ca23c2ed9890d0fe

commit a380d07f4739168a6eae4383ca23c2ed9890d0fe
Author:     Aymeric Wibo <obiwac@FreeBSD.org>
AuthorDate: 2026-06-24 13:54:02 +0000
Commit:     Aymeric Wibo <obiwac@FreeBSD.org>
CommitDate: 2026-06-27 01:11:23 +0000

    virtual_oss.8: Document `/dev/bluetooth/` prefix magic
    
    Without this one could be led to believe they should have an actual
    `/dev/bluetooth/xxx` device in devfs from just reading the examples.
    
    Event:          Halifax Hackathon 202606
    Reviewed by:    christos
    Sponsored by:   The FreeBSD Foundation
    MFC after:      3 days
    Differential Revision:  https://reviews.freebsd.org/D57818
    
    (cherry picked from commit 7ecd9afd3b28b9e1a112b5925a8f5902e121b128)
---
 usr.sbin/virtual_oss/virtual_oss/virtual_oss.8 | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/usr.sbin/virtual_oss/virtual_oss/virtual_oss.8 b/usr.sbin/virtual_oss/virtual_oss/virtual_oss.8
index 14a531c708b4..3cb407e6c67b 100644
--- a/usr.sbin/virtual_oss/virtual_oss/virtual_oss.8
+++ b/usr.sbin/virtual_oss/virtual_oss/virtual_oss.8
@@ -150,6 +150,13 @@ Specifying a
 device descriptor prefixed by
 .Pa /dev/sndio/
 is also magic, and will use a sndio backend rather than an OSS device.
+Specifying path prefixed by
+.Pa /dev/bluetooth/
+is also magic, and will use Bluetooth audio backend rather than an OSS device.
+Suffix after
+.Pa /dev/bluetooth/
+is Bluetooth device address or alias as configured in
+.Xr bluetooth.hosts 5 .
 .It Fl O Ar devname
 Set playback DSP device only which acts as a master device.
 This option is used in conjunction with
@@ -160,8 +167,22 @@ Set recording DSP device only.
 Specifying
 .Pa /dev/null
 is magic and means no recording device.
+Specifying path prefixed by
+.Pa /dev/bluetooth/
+is also magic, and will use Bluetooth audio backend rather than an OSS device.
+Suffix after
+.Pa /dev/bluetooth/
+is Bluetooth device address or alias as configured in
+.Xr bluetooth.hosts 5 .
 .It Fl f Ar devname
-Set both playback and recording DSP device
+Set both playback and recording DSP device.
+Specifying path prefixed by
+.Pa /dev/bluetooth/
+is magic, and will use Bluetooth audio backend rather than an OSS device.
+Suffix after
+.Pa /dev/bluetooth/
+is Bluetooth device address or alias as configured in
+.Xr bluetooth.hosts 5 .
 .It Fl w Ar name
 Create a WAV file format compatible companion device by given name.
 This option should be specified before the -d and -l options.