xref: /freebsd/usr.sbin/virtual_oss/virtual_oss_cmd/virtual_oss_cmd.8 (revision 9cab9fde5edad9b409dd2317a2aec7815e6d6bed)
1.\"
2.\" Copyright (c) 2021-2022 Hans Petter Selasky <hselasky@freebsd.org>
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\"
26.Dd February 12, 2025
27.Dt VIRTUAL_OSS_CMD 8
28.Os
29.Sh NAME
30.Nm virtual_oss_cmd
31.Nd modify a running
32.Xr virtual_oss 8
33instance's options
34.Sh SYNOPSIS
35.Nm
36.Sh DESCRIPTION
37.Nm
38pass additional command line arguments to a running
39.Xr virtual_oss 8
40instance via its control device.
41Supported command line arguments:
42.Bl -tag -width indent
43.It Fl E Ar xxx
44.It Fl F Ar xxx
45.It Fl G Ar xxx
46.It Fl L Ar xxx
47.It Fl M Ar xxx
48.It Fl O Ar xxx
49.It Fl P Ar xxx
50.It Fl R Ar xxx
51.It Fl a Ar xxx
52.It Fl b Ar xxx
53.It Fl c Ar xxx
54.It Fl d Ar xxx
55.It Fl e Ar xxx
56.It Fl f Ar xxx
57.It Fl l Ar xxx
58.It Fl m Ar xxx
59.It Fl p Ar xxx
60.It Fl s Ar xxx
61.It Fl w Ar xxx
62.El
63.Pp
64Refer to
65.Xr virtual_oss 8
66for a detailed description of the command line arguments.
67.Sh EXAMPLES
68To change the recording device:
69.Bd -literal -offset indent
70virtual_oss_cmd /dev/vdsp.ctl -R /dev/dsp4
71
72.Ed
73To change the playback device:
74.Bd -literal -offset indent
75virtual_oss_cmd /dev/vdsp.ctl -P /dev/dsp4
76
77.Ed
78To enable recording:
79.Bd -literal -offset indent
80virtual_oss_cmd /dev/vdsp.ctl -E 1
81
82.Ed
83To disable recording:
84.Bd -literal -offset indent
85virtual_oss_cmd /dev/vdsp.ctl -E 0
86
87.Ed
88To create a new DSP device on the fly:
89.Bd -literal -offset indent
90virtual_oss_cmd /dev/vdsp.ctl -b 16 -c 2 -d dsp.new
91
92.Ed
93To show system information:
94.Bd -literal -offset indent
95virtual_oss_cmd /dev/vdsp.ctl
96
97.Ed
98.Sh SEE ALSO
99.Xr virtual_oss 8
100.Sh AUTHORS
101.Nm
102was written by
103.An Hans Petter Selasky hselasky@freebsd.org .
104