aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAymeric Wibo <obiwac@FreeBSD.org>2026-06-24 13:54:02 +0000
committerAymeric Wibo <obiwac@FreeBSD.org>2026-06-27 01:11:23 +0000
commita380d07f4739168a6eae4383ca23c2ed9890d0fe (patch)
tree33808236f8d111bde69a52d72f8282edb740b129
parenta6d7347f3042d72deb6a6a822101e7be36ccf07d (diff)
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)
-rw-r--r--usr.sbin/virtual_oss/virtual_oss/virtual_oss.823
1 files changed, 22 insertions, 1 deletions
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.