git: a380d07f4739 - stable/15 - virtual_oss.8: Document `/dev/bluetooth/` prefix magic
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
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.