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