This option is obsolete in the recent ALSA version.
.TP
.B \-r, \-\-strict
-Set strict device mode (equiv. with -g 17 -d 0660).
+Set strict device mode (equiv. with \-g 17 \-d 0660).
This option is obsolete in the recent ALSA version.
.TP
.B \-L, \-\-log file
audio group) and the default device mode is 0660.
For the ALSA base package, see also
-.I /usr/share/doc/alsa-base/
+.I /usr/share/doc/alsa\-base/
.SH SEE ALSO
\fB
\fP
.SH HOMEPAGE
-http://www.alsa-project.org/
+http://www.alsa\-project.org/
.SH AUTHOR
The alsaconf script was written by
.SS Options
.TP
-\fI-h, --help\fP
+\fI\-h, \-\-help\fP
Help: show available flags and commands.
.TP
-\fI-f, --file\fP
+\fI\-f, \-\-file\fP
Select the configuration file to use. The default is /etc/asound.state
.TP
-\fI-F, --force\fP
+\fI\-F, \-\-force\fP
Used with restore command. Try to restore the matching control elements
as much as possible.
.TP
-\fI-d, --debug\fP
+\fI\-d, \-\-debug\fP
Use debug mode: a bit more verbose.
.TP
-\fI-v, --version\fP
+\fI\-v, \-\-version\fP
Print alsactl version number.
.SH FILES
\fI/etc/asound.state\fP (or whatever file you specify with the
-\fB-f\fP flag) is used to store current settings for your
+\fB\-f\fP flag) is used to store current settings for your
soundcards. The settings include all the usual soundcard mixer
settings. More importantly, alsactl is
capable of controlling other card-specific features that mixer apps
.SH AUTHOR
\fBalsactl\fP is by Jaroslav Kysela <perex@suse.cz> and Abramo Bagnara
-<abramo@alsa-project.org>. This document is by Paul Winkler <zarmzarm@erols.com>.
+<abramo@alsa\-project.org>. This document is by Paul Winkler <zarmzarm@erols.com>.
.SS Options
.TP
-\fI-h, -help\fP
+\fI\-h, \-help\fP
Help: show available flags.
.TP
-\fI-c\fP <card number or idenfication>
+\fI\-c\fP <card number or idenfication>
Select the soundcard to use, if you have more than one. Cards are
numbered from 0 (the default).
.TP
-\fI-D\fP <device identification>
+\fI\-D\fP <device identification>
Select the mixer device to control.
.TP
-\fI-g\fP <toggle color settings>
+\fI\-g\fP <toggle color settings>
Toggle the using of colors.
.TP
-\fI-s\fP <minimize mixer window>
+\fI\-s\fP <minimize mixer window>
Minimize the mixer window.
.SH KEYBOARD COMMANDS
also use \fIn\fP ("next") and \fIp\fP ("previous").
The \fIUp\fP and \fIDown Arrows\fP control the volume for the
-currently selected device. You can also use \fI+\fP or \fI-\fP for the
+currently selected device. You can also use \fI+\fP or \fI\-\fP for the
same purpose. Both the left and right signals are affected. For
independent left and right control, see below.
.I options
Use the
-.I -h,
-.I -V,
-.I -l,
+.I \-h,
+.I \-V,
+.I \-l,
or
-.I -L
+.I \-L
options to display information;
or use at least one of the
-.I -s,
-.I -r,
-.I -S,
+.I \-s,
+.I \-r,
+.I \-S,
or
-.I -d
+.I \-d
options to specify what data to send or receive.
.SS Options
.TP
-.I -h, --help
+.I \-h, \-\-help
Help: prints a list of options.
.TP
-.I -V, --version
+.I \-V, \-\-version
Prints the current version.
.TP
-.I -l, --list-devices
+.I \-l, \-\-list\-devices
Prints a list of all hardware MIDI ports.
.TP
-.I -L, --list-rawmidis
+.I \-L, \-\-list\-rawmidis
Prints all RawMIDI definitions.
(used when debugging configuration files)
.TP
-.I -p, --port=name
+.I \-p, \-\-port=name
Sets the name of the ALSA RawMIDI port to use.
If this is not specified,
.B amidi
(the default for this is port 0 on card 0, which may not exist).
.TP
-.I -s, --send=filename
+.I \-s, \-\-send=filename
Sends the contents of the specified file to the MIDI port.
The file must contain raw MIDI commands (e.g. a .syx file);
for Standard MIDI (.mid) files, use
.B aplaymidi(1).
.TP
-.I -r, --receive=filename
+.I \-r, \-\-receive=filename
Writes data received from the MIDI port into the specified file.
The file will contain raw MIDI commands (such as in a .syx file);
to record a Standard MIDI (.mid) file, use
.B amidi
will filter out any Active Sensing bytes (FEh), unless the
-.I -a
+.I \-a
option has been given.
.TP
-.I -S, --send-hex="..."
+.I \-S, \-\-send\-hex="..."
Sends the bytes specified as hexadecimal numbers to the MIDI port.
.TP
-.I -d, --dump
+.I \-d, \-\-dump
Prints data received from the MIDI port as hexadecimal bytes.
Active Sensing bytes (FEh) will not be shown, unless the
-.I -a
+.I \-a
option has been given.
This option is useful for debugging.
.TP
-.I -t, --timeout=seconds
+.I \-t, \-\-timeout=seconds
Stops receiving data when no data has been received for the specified
amount of time.
to stop receiving data.
.TP
-.I -a, --active-sensing
+.I \-a, \-\-active\-sensing
Does not ignore Active Sensing bytes (FEh) when saving or printing
received MIDI commands.
.SH EXAMPLES
.TP
-.B amidi -p hw:0 -s my_settings.syx
+.B amidi \-p hw:0 \-s my_settings.syx
will send the MIDI commands in
.I my_settings.syx
to port
.I hw:0.
.TP
-.B amidi -S 'F0 43 10 4C 00 00 7E 00 F7'
+.B amidi \-S 'F0 43 10 4C 00 00 7E 00 F7'
sends an XG Reset to the default port.
.TP
-.B amidi -p hw:1,2 -S F0411042110C000000000074F7 -r dump.syx -t 1
+.B amidi \-p hw:1,2 \-S F0411042110C000000000074F7 \-r dump.syx \-t 1
sends a \(lqParameter Dump Request\(rq to a GS device, saves the received
parameter data to the file
.I dump.syx,
(when no data has been received for one second).
.TP
-.B amidi -p virtual -d
+.B amidi \-p virtual \-d
creates a virtual RawMIDI port and prints all data sent to this port.
.SH FILES
.SH BUGS
The
-.I --list-devices
+.I \-\-list\-devices
option pretends that output and input ports are the same.
.SH SEE ALSO
.SH NAME
amixer \- command-line mixer for ALSA soundcard driver
.SH SYNOPSIS
-\fBamixer\fP [\fI-c\fP card] [\fIcmd\fP]
+\fBamixer\fP [\fI\-c\fP card] [\fIcmd\fP]
.SH DESCRIPTION
\fBamixer\fP allows command-line control of the mixer for the ALSA
soundcard driver.
The parameters \fIcap, nocap, mute, unmute, toggle\fP are used to
change capture (recording) and muting for the group specified.
The parameters \fIfront, rear, center, woofer\fP are used to specify
-channels to be changed. When plus(+) or minus(-) letter is appended after
+channels to be changed. When plus(+) or minus(\-) letter is appended after
volume value, the volume is incremented or decremented from the current
value, respectively.
.SS Options
.TP
-[\fI-c\fP card]
+[\fI\-c\fP card]
Select the card number to control. The device name created from this
parameter has syntax 'hw:N' where N is specified card number.
.TP
-[\fI-D\fP device]
+[\fI\-D\fP device]
Select the device name to control. The default control name is 'default'.
.TP
-\fI-h\fP
+\fI\-h\fP
Help: show syntax.
.TP
-\fI-q\fP
+\fI\-q\fP
Quiet mode. Do not show results of changes.
.SS
Example #1:
.TP
-\fBamixer -c 1 sset Line,0 80%,40% unmute cap\fR
+\fBamixer \-c 1 sset Line,0 80%,40% unmute cap\fR
will set the second soundcard's left line input volume to 80% and
right line input to 40%, unmute it, and select it as a source for
capture (recording).\fR
Example #2:
.TP
-\fBamixer -c 2 cset iface=MIXER,name='Line Playback Volume",index=1 40%\fR
+\fBamixer \-c 2 cset iface=MIXER,name='Line Playback Volume",index=1 40%\fR
will set the third soundcard's second line playback volume(s) to 40%
.SS
Example #3:
.TP
-\fBamixer -c 2 cset numid=34 40%\fR
+\fBamixer \-c 2 cset numid=34 40%\fR
will set the 34th soundcard element to 40%
.SH BUGS
.SS Options
.TP
-\fI-h, --help\fP
+\fI\-h, \-\-help\fP
Help: show syntax.
.TP
-\fI--version\fP
+\fI\-\-version\fP
Print current version.
.TP
-\fI-l, --list-devices\fP
+\fI\-l, \-\-list\-devices\fP
List all soundcards and digital audio devices
.TP
-\fI-L, --list-pcms\fP
+\fI\-L, \-\-list\-pcms\fP
List all PCMs defined
.TP
-\fI-D, --device=NAME\fP
+\fI\-D, \-\-device=NAME\fP
Select PCM by name
.TP
-\fI-q --quiet\fP
+\fI\-q \-\-quiet\fP
Quiet mode. Suppress messages (not sound :))
.TP
-\fI-t, --file-type TYPE\fP
+\fI\-t, \-\-file\-type TYPE\fP
File type (voc, wav, raw or au)
.TP
-\fI-c, --channels=#\fP
+\fI\-c, \-\-channels=#\fP
The number of channels
.TP
-\fI-f --format=FORMAT\fP
+\fI\-f \-\-format=FORMAT\fP
Sample format
.br
Recognized sample formats are: S8 U8 S16_LE S16_BE U16_LE U16_BE S24_LE
.br
There are also two format shortcuts available:
.nf
--f cd (16 bit little endian, 44100, stereo [-f S16_LE -c2 -r44100]
--f dat (16 bit little endian, 48000, stereo) [-f S16_LE -c2 -r48000]
+\-f cd (16 bit little endian, 44100, stereo [\-f S16_LE \-c2 \-r44100]
+\-f dat (16 bit little endian, 48000, stereo) [\-f S16_LE \-c2 \-r48000]
.fi
.TP
-\fI-r, --rate=#<Hz>\fP
+\fI\-r, \-\-rate=#<Hz>\fP
Sampling rate in Hertz.
.TP
-\fI-d, --duration=#\fP
+\fI\-d, \-\-duration=#\fP
Interrupt after # seconds.
A value of zero means infinity.
The default is zero, so if this option is omitted then the arecord process will run until it is killed.
.TP
-\fI-s, --sleep-min=#\fP
+\fI\-s, \-\-sleep\-min=#\fP
Min ticks to sleep
.TP
-\fI-M, --mmap\fP
+\fI\-M, \-\-mmap\fP
Mmap stream
.TP
-\fI-N, --nonblock\fP
+\fI\-N, \-\-nonblock\fP
Nonblocking mode
.TP
-\fI-F, --period-time=#\fP
+\fI\-F, \-\-period\-time=#\fP
Distance between interrupts is # microseconds
.TP
-\fI-B, --buffer-time=#\fP
+\fI\-B, \-\-buffer\-time=#\fP
Buffer duration is # microseconds
.TP
-\fI--period-size=#\fP
+\fI\-\-period\-size=#\fP
Distance between interrupts is # frames
.TP
-\fI--buffer-size=#\fP
+\fI\-\-buffer\-size=#\fP
Buffer duration is # frames
.TP
-\fI-A, --avail-min=#\fP
+\fI\-A, \-\-avail\-min=#\fP
Min available space for wakeup is # microseconds
.TP
-\fI-R, --start-delay=#\fP
+\fI\-R, \-\-start\-delay=#\fP
Delay for automatic PCM start is # microseconds
(relative to buffer size if <= 0)
.TP
-\fI-T, --stop-delay=#\fP
+\fI\-T, \-\-stop\-delay=#\fP
Delay for automatic PCM stop is # microseconds from xrun
.TP
-\fI-v, --verbose\fP
+\fI\-v, \-\-verbose\fP
Show PCM structure and setup.
This option is accumulative. The VU meter is displayed when this
is given twice.
.TP
-\fI-I, --separate-channels\fP
+\fI\-I, \-\-separate\-channels\fP
One file for each channel
.SS
Example:
.TP
-\fBaplay -c 1 -t raw -r 22050 -f mu_law foobar\fR
+\fBaplay \-c 1 \-t raw \-r 22050 \-f mu_law foobar\fR
will play the raw file "foobar" as a
22050-Hz, mono, 8-bit, Mu-Law .au file.
.TP
-\fBarecord -d 10 -f cd -t wav -D copy foobar.wav\fP
+\fBarecord \-d 10 \-f cd \-t wav \-D copy foobar.wav\fP
will record foobar.wav as a 10-second, CD-quality wave file, using the
PCM "copy" (which might be defined in the user's .asoundrc file as:
.nf
shown as well.
The commands consist of the command directive and the argument.
-As the boolean argument, \fIyes\fP, \fIno\fP, \fItrue\fP, \fIfalse\fI,
+As the boolean argument, \fIyes\fP, \fIno\fP, \fItrue\fP, \fIfalse\fP,
or a digit number is allowed.
.SH EXAMPLES
.TP
.BI iecset\ \-Dhw:1
Displays the current IEC958 status bits on the second card.
-This is equivalent with \fI-c 1\fP.
+This is equivalent with \fI\-c 1\fP.
.TP
.BI iecset\ \-x
Displays the current IEC958 status bits in a style of the arguments
.SH OPTIONS
.TP
-\fI-D\fP device
+\fI\-D\fP device
Specifies the device name of the control to open
.TP
-\fI-c\fP card
-Specifies the card index to open. Equivalent with \fI-Dhw:x\fP.
+\fI\-c\fP card
+Specifies the card index to open. Equivalent with \fI\-Dhw:x\fP.
.TP
-\fI-x\fP
+\fI\-x\fP
Dumps the status in the form of AESx bytes.
.TP
-\fI-i\fP
+\fI\-i\fP
Reads the command sequences from stdin.
Each line has single command.
.SH SYNOPSIS
.B aconnect
-[\-d] [-options] sender receiver
+[\-d] [\-options] sender receiver
.br
.B aconnect
-\-i|-o [-options]
+\-i|\-o [\-options]
.br
.B aconnect
\-x
.B \-d
option.
.IP "" 4
-% aconnect -d 64:0 65:0
+% aconnect \-d 64:0 65:0
.PP
The address can be given using the client's name.
.IP "" 4
.B \-i
option.
.IP "" 4
-% aconnect -i
+% aconnect \-i
.br
client 0: 'System' [type=kernel]
.in +4
.br
1 'Announce '
.in -4
-client 64: 'External MIDI-0' [type=kernel]
+client 64: 'External MIDI\-0' [type=kernel]
.in +4
-0 'MIDI 0-0 '
+0 'MIDI 0\-0 '
.in -4
.PP
Similary, to see the output ports, use
.SH OPTIONS
.SS CONNNECTION MANAGEMENT
.TP
-.B \-d, --disconnect
+.B \-d, \-\-disconnect
Disconnect the given subscription.
.TP
-.B \-e, --exclusive
+.B \-e, \-\-exclusive
Connect ports with exclusive mode.
Both sender and receiver ports can be no longer connected by any other ports.
.TP
-.B \-r, --real queue
+.B \-r, \-\-real queue
Convert time-stamps of event packets to the current value of the given
.I real-time
queue.
This is option is, however, not so useful, since
the receiver port must use (not necessarily own) the specified queue.
.TP
-.B \-t, --tick queue
+.B \-t, \-\-tick queue
Like
-.B -r
+.B \-r
option, but
time-stamps are converted to the current value of the given
.I tick
.SS LIST PORTS
.TP
-.B \-i, --input
+.B \-i, \-\-input
List existing input (readable) ports.
This option is exclusive to
.B \-o.
.TP
-.B \-o, --output
+.B \-o, \-\-output
List existing output (writable) ports.
This option is exclusive to
.B \-i.
.TP
-.B \-l, --list
+.B \-l, \-\-list
List the current connection status. The connected and connecting ports
from/to each port are listed together.
The suffix flag
.SS REMOVE ALL CONNECTIONS
.TP
-.B \-x, --removeall
+.B \-x, \-\-removeall
Remove all exported connections.
.SH "SEE ALSO"
.SH SYNOPSIS
.B aplaymidi
--p client:port[,...] [-d delay] midifile ...
+\-p client:port[,...] [\-d delay] midifile ...
.SH DESCRIPTION
.B aplaymidi
.SH OPTIONS
.TP
-.I -h, --help
+.I \-h, \-\-help
Prints a list of options.
.TP
-.I -V, --version
+.I \-V, \-\-version
Prints the current version.
.TP
-.I -l, --list
+.I \-l, \-\-list
Prints a list of possible output ports.
.TP
-.I -p, --port=client:port,...
+.I \-p, \-\-port=client:port,...
Sets the sequencer port(s) to which the events in the MIDI file(s) are
sent.
environment variable if none is given on the command line.
.TP
-.I -d, --delay=seconds
+.I \-d, \-\-delay=seconds
Specifies how long to wait after the end of each MIDI file,
to allow the last notes to die away.
.TH ARECORDMIDI 1 "6 Apr 2004"
.SH NAME
-arecordmidi - record Standard MIDI Files
+arecordmidi \- record Standard MIDI Files
.SH SYNOPSIS
.B arecordmidi
--p client:port[,...] [options] midifile
+\-p client:port[,...] [options] midifile
.SH DESCRIPTION
.B arecordmidi
.SH OPTIONS
.TP
-.I -h,--help
+.I \-h,\-\-help
Prints a list of options.
.TP
-.I -V,--version
+.I \-V,\-\-version
Prints the current version.
.TP
-.I -l,--list
+.I \-l,\-\-list
Prints a list of possible input ports.
.TP
-.I -p,--port=client:port,...
+.I \-p,\-\-port=client:port,...
Sets the sequencer port(s) from which events are recorded.
A client can be specified by its number, its name, or a prefix of its
":0" part of the port specification can be omitted.
.TP
-.I -b,--bpm=beats
+.I \-b,\-\-bpm=beats
Sets the musical tempo of the MIDI file, in beats per minute.
The default value is 120 BPM.
.TP
-.I -f,--fps=frames
+.I \-f,\-\-fps=frames
Sets the SMPTE resolution, in frames per second.
Possible values are 24, 25, 29.97 (for 30 drop-frame), and 30.
.TP
-.I -t,--ticks=ticks
+.I \-t,\-\-ticks=ticks
Sets the resolution of timestamps (ticks) in the MIDI file,
in ticks per beat (when using musical tempo) or ticks per frame
(when using SMPTE timing).
The default value is 384 ticks/beat or 40 ticks/frame, respectively.
.TP
-.I -s,--split-channels
+.I \-s,\-\-split\-channels
Specifies that the data for each MIDI channel should be written to a
separate track in the MIDI file.
.TP
-.I -d,--dump
+.I \-d,\-\-dump
Shows the events received as text on standard output.
.TP
-.I -m,--metronome=client:port
+.I \-m,\-\-metronome=client:port
Plays a metronome signal on the specified sequencer port.
Metronome sounds are played on channel 10, MIDI notes 33 & 34 (GM2/GS/XG
metronome standard notes), with velocity 100 and duration 1.
.TP
-.I -i,--timesig=numerator:denominator
+.I \-i,\-\-timesig=numerator:denominator
Sets the time signature for the MIDI file and metronome.
The time signature is specified as usual with two numbers, representing
The following command plays MIDI on
.I hostB.
.IP "" 4
-hostA% pmidi -p 128:0 foo.mid
+hostA% pmidi \-p 128:0 foo.mid
.PP
The multiple clients may exist simultaneously. If
.I hostC
git://git.alsa-project.org / alsa-utils.git / commitdiff