mirror of
https://github.com/alsa-project/alsa-utils
synced 2024-12-23 00:26:30 +01:00
ca5f8cbcfe
This patch converts hyphens to minus signs in the man pages (for options, emails, or command line examples). This patch also closes one font modifier in iecset.1. (s/\fIfalse\fI,/\fIfalse\fP,/) Signed-off-by: Nicolas FRANCOIS <nicolas.francois@centraliens.net>
150 lines
3.7 KiB
Groff
150 lines
3.7 KiB
Groff
.TH APLAY 1 "2 August 2001"
|
|
.SH NAME
|
|
arecord, aplay \- command-line sound recorder and player for ALSA
|
|
soundcard driver
|
|
.SH SYNOPSIS
|
|
\fBarecord\fP [\fIflags\fP] [filename]
|
|
.SH SYNOPSIS
|
|
\fBaplay\fP [\fIflags\fP] [filename [filename]] ...
|
|
|
|
.SH DESCRIPTION
|
|
\fBarecord\fP is a command-line soundfile recorder for the ALSA soundcard
|
|
driver. It supports several file formats and multiple soundcards with
|
|
multiple devices.
|
|
|
|
\fBaplay\fP is much the same, only it plays instead of recording. For
|
|
supported soundfile formats, the sampling rate, bit depth, and so
|
|
forth can be automatically determined from the soundfile header.
|
|
|
|
.SH INVOKING
|
|
|
|
[\fBarecord\fP | \fBaplay\fP ] [\fIflags\fP] filename
|
|
.TP
|
|
If filename is not specified, the standard output or input is used. The \fBaplay\fP utility accepts multiple filenames.
|
|
|
|
|
|
.SS Options
|
|
.TP
|
|
\fI\-h, \-\-help\fP
|
|
Help: show syntax.
|
|
.TP
|
|
\fI\-\-version\fP
|
|
Print current version.
|
|
.TP
|
|
\fI\-l, \-\-list\-devices\fP
|
|
List all soundcards and digital audio devices
|
|
.TP
|
|
\fI\-L, \-\-list\-pcms\fP
|
|
List all PCMs defined
|
|
.TP
|
|
\fI\-D, \-\-device=NAME\fP
|
|
Select PCM by name
|
|
.TP
|
|
\fI\-q \-\-quiet\fP
|
|
Quiet mode. Suppress messages (not sound :))
|
|
.TP
|
|
\fI\-t, \-\-file\-type TYPE\fP
|
|
File type (voc, wav, raw or au)
|
|
.TP
|
|
\fI\-c, \-\-channels=#\fP
|
|
The number of channels
|
|
.TP
|
|
\fI\-f \-\-format=FORMAT\fP
|
|
Sample format
|
|
.br
|
|
Recognized sample formats are: S8 U8 S16_LE S16_BE U16_LE U16_BE S24_LE
|
|
S24_BE U24_LE U24_BE S32_LE S32_BE U32_LE U32_BE FLOAT_LE FLOAT_BE
|
|
FLOAT64_LE FLOAT64_BE IEC958_SUBFRAME_LE IEC958_SUBFRAME_BE MU_LAW
|
|
A_LAW IMA_ADPCM MPEG GSM
|
|
.br
|
|
Some of these may not be available on selected hardware
|
|
.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]
|
|
.fi
|
|
.TP
|
|
\fI\-r, \-\-rate=#<Hz>\fP
|
|
Sampling rate in Hertz.
|
|
.TP
|
|
\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
|
|
Min ticks to sleep
|
|
.TP
|
|
\fI\-M, \-\-mmap\fP
|
|
Mmap stream
|
|
.TP
|
|
\fI\-N, \-\-nonblock\fP
|
|
Nonblocking mode
|
|
.TP
|
|
\fI\-F, \-\-period\-time=#\fP
|
|
Distance between interrupts is # microseconds
|
|
.TP
|
|
\fI\-B, \-\-buffer\-time=#\fP
|
|
Buffer duration is # microseconds
|
|
.TP
|
|
\fI\-\-period\-size=#\fP
|
|
Distance between interrupts is # frames
|
|
.TP
|
|
\fI\-\-buffer\-size=#\fP
|
|
Buffer duration is # frames
|
|
.TP
|
|
\fI\-A, \-\-avail\-min=#\fP
|
|
Min available space for wakeup is # microseconds
|
|
.TP
|
|
\fI\-R, \-\-start\-delay=#\fP
|
|
Delay for automatic PCM start is # microseconds
|
|
(relative to buffer size if <= 0)
|
|
.TP
|
|
\fI\-T, \-\-stop\-delay=#\fP
|
|
Delay for automatic PCM stop is # microseconds from xrun
|
|
.TP
|
|
\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
|
|
One file for each channel
|
|
|
|
.SS
|
|
Example:
|
|
|
|
.TP
|
|
\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
|
|
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
|
|
pcm.copy {
|
|
type plug
|
|
slave {
|
|
pcm hw
|
|
}
|
|
route_policy copy
|
|
}
|
|
.fi
|
|
|
|
.SH SEE ALSO
|
|
\fB
|
|
alsamixer(1),
|
|
amixer(1)
|
|
\fP
|
|
|
|
.SH BUGS
|
|
Note that .aiff files are not currently supported.
|
|
|
|
.SH AUTHOR
|
|
\fBarecord\fP and \fBaplay\fP are by Jaroslav Kysela <perex@suse.cz>
|
|
This document is by Paul Winkler <zarmzarm@erols.com>.
|
|
Updated for Alsa 0.9 by James Tappin <james@xena.uklinux.net>
|
|
|