1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
'\" t
.\"
.\" This file and its contents are supplied under the terms of the
.\" Common Development and Distribution License ("CDDL"), version 1.0.
.\" You may only use this file in accordance with the terms of version
.\" 1.0 of the CDDL.
.\"
.\" A full copy of the text of the CDDL should have accompanied this
.\" source. A copy of the CDDL is also available via the Internet at
.\" http://www.illumos.org/license/CDDL.
.\"
.\"
.\" Copyright 2011 Nexenta Systems, Inc. All rights reserved.
.\" Copyright 2020 Peter Tribble.
.\"
.TH AUDIOCTL 1 "Feb 8, 2020"
.SH NAME
audioctl - audio device control command line interface
.SH SYNOPSIS
.nf
\fBaudioctl\fR \fBlist-devices\fR
.fi
.LP
.nf
\fBaudioctl\fR \fBshow-device\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fR]
.fi
.LP
.nf
\fBaudioctl\fR \fBshow-control\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fR] [\fIcontrol\fR ...]
.fi
.LP
.nf
\fBaudioctl\fR \fBset-control\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fR] \fIcontrol\fR \fIvalue\fR
.fi
.LP
.nf
\fBaudioctl\fR \fBsave-controls\fR [\fB-d\fR \fIdevice\fR] [\fB-f\fR] \fIfile\fR
.fi
.LP
.nf
\fBaudioctl\fR \fBload-controls\fR [\fB-d\fR \fIdevice\fR] \fIfile\fR
.fi
.LP
.nf
\fBaudioctl\fR \fBhelp\fR
.fi
.SH DESCRIPTION
The \fBaudioctl\fP command is used to control various settings and features
of audio devices, including mixer settings such as playback volume and
record gain.
.SH SUBCOMMANDS
The \fBaudioctl\fR command supports the following subcommands.
.sp
.ne 2
.na
\fBlist-devices\fR
.ad
.sp .6
.RS 4n
List all the audio devices on the system.
.RE
.sp
.ne 2
.na
\fBshow-device\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fR]
.ad
.sp .6
.RS 4n
Display an informational overview of \fIdevice\fR (or the default device if
not specified). If the \fB-v\fR option is specified, then more detail
will be displayed.
.RE
.sp
.ne 2
.na
\fBshow-control\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fR] [\fBcontrol\fR ... ]
.ad
.sp .6
.RS 4n
Display the control settings for one or more \fIcontrols\fR of a
\fIdevice\fR (or the default device if not specified). If no \fIcontrol\fR is
specified, then the settings for all controls will be displayed. If
the \fB-v\fR option is specified, then more detail will be displayed.
.RE
.sp
.ne 2
.na
\fBset-control\fR [\fB-v\fR] [\fB-d\fR \fIdevice\fR] \fIcontrol\fR \fIvalue\fR
.ad
.sp .6
.RS 4n
Set the control settings for a \fIcontrol\fR of a \fIdevice\fR (or the
default device if not specified) to \fIvalue\fR. If the \fB-v\fR
option is specified, then more verbose output be displayed.
.RE
.sp
.ne 2
.na
\fBsave-controls\fR [\fB-f\fR] [\fB-d\fR \fIdevice\fR] \fIfile\fR
.ad
.sp .6
.RS 4n
Save all control settings of the \fIdevice\fR (or the default device if not
specified) to the named \fIfile\fR. This subcommand will not replace
or modify an existing file unless \fB-f\fR (force) is specified.
.RE
.sp
.ne 2
.na
\fBload-controls\fR [\fB-d\fR \fIdevice\fR] \fIfile\fR
.ad
.sp .6
.RS 4n
Load previously saved control settings from a \fIfile\fR
into a \fIdevice\fR (or all audio devices if not
specified).
.RE
.sp
.ne 2
.na
\fBhelp\fR
.ad
.sp .6
.RS 4n
Display the usage message.
.RE
.SH ENVIRONMENT VARIABLES
.ne 2
.na
\fB\fBAUDIODEV\fR\fR
.ad
.RS 12n
The full path name of the default audio device to use if one
is not specified on the command line. If this variable is not set,
\fB/dev/audio\fR is used.
.RE
.SH ATTRIBUTES
The \fBaudioctl\fR command and its subcommands are Committed. The
names of controls, their values, and device names are Uncommitted.
The display output is intended for human consumption, and is Not An
Interface. The format of the state files used by the
\fBsave-controls\fR and \fBload-controls\fR subcommands is Committed
Private.
.SH SEE ALSO
\fBaudioplay\fR(1), \fBaudiorecord\fR(1), \fBdsp\fR(7I),
\fBmixer\fR(7I)
|
