@@ -1,6 +1,6 @@
.TH APLAY 1 "1 January 2010"
.SH NAME
-arecord, aplay \- command\-line sound recorder and player for ALSA
+arecord, aplay \- command\-line sound recorder and player for ALSA
soundcard driver
.SH SYNOPSIS
\fBarecord\fP [\fIflags\fP] [filename]
@@ -9,15 +9,20 @@ soundcard driver
.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. If recording with interleaved mode samples the file is
-automatically split before the 2GB filesize.
-
-\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.
-
-If filename is not specified, the standard output or input is used. The \fBaplay\fP utility accepts multiple filenames.
+driver.
+It supports several file formats
+and multiple soundcards with multiple devices.
+If recording with interleaved mode samples
+the file is automatically split before the 2\~GB filesize.
+
+\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.
+
+If filename is not specified,
+the standard output or input is used.
+The \fBaplay\fP utility accepts multiple filenames.
.SH OPTIONS
.TP
@@ -61,100 +66,122 @@ Some of these may not be available on se
.br
The available format shortcuts are:
.nf
-\-f cd (16 bit little endian, 44100, stereo) [\-f S16_LE \-c2 \-r44100]
-\-f cdr (16 bit big endian, 44100, stereo) [\-f S16_BE \-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 cdr (16-bit big endian, 44100, stereo) [\-f S16_BE \-c2 \-r44100]
+\-f dat (16-1251bit little endian, 48000, stereo) [\-f S16_LE \-c2 \-r48000]
.fi
If no format is given U8 is used.
.TP
\fI\-r, \-\-rate=#<Hz>\fP
-Sampling rate in Hertz. The default rate is 8000 Hertz.
-If the value specified is less than 300, it is taken as the rate in kilohertz.
-Valid values are 2000 through 192000 Hertz.
+Sampling rate in hertz.
+The default rate is 8000 hertz.
+If the value specified is less than 300,
+it is taken as the rate in kilohertz.
+Valid values are 2000 through 192000 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 record/playback process will run until it is killed.
-Either '-d' or '-s' option is available exclusively.
+The default is zero,
+so if this option is omitted
+then the record/playback process will run until it is killed.
+Either '\-d' or '\-s' option is available exclusively.
.TP
\fI\-s, \-\-samples=#\fP
Interrupt after transmission of # PCM frames.
A value of zero means infinity.
-The default is zero, so if this options is omitted then the record/playback process will run until it is killed.
-Either '-d' or '-s' option is available exclusively.
+The default is zero,
+so if this options is omitted
+then the record/playback process will run until it is killed.
+Either '\-d' or '\-s' option is available exclusively.
.TP
-\fI\-M, \-\-mmap\fP
+\fI\-M, \-\-mmap\fP
Use memory\-mapped (mmap) I/O mode for the audio stream.
-If this option is not set, the read/write I/O mode will be used.
+If this option is not set,
+the read/write I/O mode will be used.
.TP
-\fI\-N, \-\-nonblock\fP
-Open the audio device in non\-blocking mode. If the device is busy the program will exit immediately.
-If this option is not set the program will block until the audio device is available again.
+\fI\-N, \-\-nonblock\fP
+Open the audio device in non\-blocking mode.
+If the device is busy the program will exit immediately.
+If this option is not set
+the program will block until the audio device is available again.
.TP
-\fI\-F, \-\-period\-time=#\fP
+\fI\-F, \-\-period\-time=#\fP
Distance between interrupts is # microseconds.
-If no period time and no period size is given then a quarter of the buffer time is set.
-.TP
-\fI\-B, \-\-buffer\-time=#\fP
-Buffer duration is # microseconds
-If no buffer time and no buffer size is given then the maximal allowed buffer time but not more than 500ms is set.
+If no period time and no period size is given
+then a quarter of the buffer time is set.
.TP
-\fI\-\-period\-size=#\fP
-Distance between interrupts is # frames
-If no period size and no period time is given then a quarter of the buffer size is set.
+\fI\-B, \-\-buffer\-time=#\fP
+Buffer duration is # microseconds.
+If no buffer time and no buffer size is given
+then the maximal allowed buffer time,
+but not more than 500\~ms,
+is set.
+.TP
+\fI\-\-period\-size=#\fP
+Distance between interrupts is # frames.
+If no period size and no period time is given
+then a quarter of the buffer size is set.
.TP
-\fI\-\-buffer\-size=#\fP
+\fI\-\-buffer\-size=#\fP
Buffer duration is # frames
-If no buffer time and no buffer size is given then the maximal allowed buffer time but not more than 500ms is set.
+If no buffer time and no buffer size is given
+then the maximal allowed buffer time,
+but not more than 500\~ms,
+is set.
.TP
-\fI\-A, \-\-avail\-min=#\fP
+\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
+\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 or three times.
+This option is accumulative.
+The VU meter is displayed
+when this is given twice or three times.
.TP
\fI\-V, \-\-vumeter=TYPE\fP
-Specifies the VU\-meter type, either \fIstereo\fP or \fImono\fP.
+Specifies the VU\-meter type,
+either \fIstereo\fP or \fImono\fP.
The stereo VU\-meter is available only for 2\-channel stereo samples
with interleaved format.
.TP
-\fI\-I, \-\-separate\-channels\fP
-One file for each channel. This option disables max\-file\-time
-and use\-strftime, and ignores SIGUSR1. The stereo VU meter is
-not available with separate channels.
+\fI\-I, \-\-separate\-channels\fP
+One file for each channel.
+This option disables max\-file\-time
+and use\-strftime, and ignores SIGUSR1.
+The stereo VU meter is not available with separate channels.
.TP
\fI\-P\fP
-Playback. This is the default if the program is invoked
-by typing aplay.
+Playback.
+This is the default
+if the program is invoked by typing aplay.
.TP
\fI\-C\fP
-Record. This is the default if the program is invoked
-by typing arecord.
+Record.
+This is the default
+if the program is invoked by typing arecord.
.TP
\fI\-i, \-\-interactive\fP
Allow interactive operation via stdin.
Currently only pause/resume via space or enter key is implemented.
.TP
-\fI-m, \-\-chmap=ch1,ch2,...\fP
-Give the channel map to override or follow. Pass channel position
-strings like \fIFL\fP, \fIFR\fP, etc.
-
-If a device supports the override of the channel map, \fBaplay\fP
-tries to pass the given channel map.
-If it doesn't support the channel map override but still it provides
-the channel map information, \fBaplay\fP tries to rearrange the
-channel order in the buffer to match with the returned channel map
-from the device.
+\fI\-m, \-\-chmap=ch1,ch2,...\fP
+Give the channel map to override or follow.
+Pass channel position strings like \fIFL\fP, \fIFR\fP, etc.
+
+If a device supports the override of the channel map,
+\fBaplay\fP tries to pass the given channel map.
+If it doesn't support the channel map override
+but still it provides the channel map information,
+\fBaplay\fP tries to rearrange the channel order in the buffer
+to match with the returned channel map from the device.
.TP
\fI\-\-disable\-resample\fP
Disable automatic rate resample.
@@ -177,26 +204,31 @@ Expression for validation is: coef * (bu
Minimum value is 1.
.TP
\fI\-\-test\-nowait\fP
-Do not wait for the ring buffer \(hy eats the whole CPU.
+Do not wait for the ring buffer \(en eats the whole CPU.
.TP
\fI\-\-max\-file\-time\fP
-While recording, when the output file has been accumulating
-sound for this long,
-close it and open a new output file. Default is the maximum
-size supported by the file format: 2 GiB for WAV files.
-This option has no effect if \-\-separate\-channels is
-specified.
+While recording,
+when the output file has been accumulating sound for this long,
+close it and open a new output file.
+Default is the maximum size supported by the file format:
+2\~GiB for WAV files.
+This option has no effect
+if \-\-separate\-channels is specified.
.TP
\fI\-\-process\-id\-file <file name>\fP
-aplay writes its process ID here, so other programs can
-send signals to it.
+aplay writes its process ID here,
+so other programs can send signals to it.
.TP
\fI\-\-use\-strftime\fP
-When recording, interpret %\-codes in the file name parameter using
-the strftime facility whenever the output file is opened. The
-important strftime codes are: %Y is the year, %m month, %d day of
-the month, %H hour, %M minute and %S second. In addition, %v is
-the file number, starting at 1. When this option is specified,
+When recording,
+interpret %\-codes in the file name parameter using the strftime facility
+whenever the output file is opened.
+The important strftime codes are:
+%Y is the year, %m month, %d day of the month,
+%H hour, %M minute and %S second.
+In addition,
+%v is the file number, starting at 1.
+When this option is specified,
intermediate directories for the output file are created automatically.
This option has no effect if \-\-separate\-channels is specified.
.TP
@@ -208,21 +240,22 @@ For raw device hw:X this option basicall
the soundcard.
.TP
\fI\-\-fatal\-errors\fP
-Disables recovery attempts when errors (e.g. xrun) are encountered; the
+Disables recovery attempts when errors (e.g., xrun) are encountered; the
aplay process instead aborts immediately.
.SH SIGNALS
-When recording, SIGINT, SIGTERM and SIGABRT will close the output
-file and exit. SIGUSR1 will close the output file, open a new one,
-and continue recording. However, SIGUSR1 does not work with
-\-\-separate\-channels.
+When recording,
+SIGINT, SIGTERM and SIGABRT will close the output file and exit.
+SIGUSR1 will close the output file, open a new one,
+and continue recording.
+However, SIGUSR1 does not work with \-\-separate\-channels.
.SH EXAMPLES
.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.
+22050\-Hz, mono, 8\-bit, Mu\-Law .au file.
.TP
\fBarecord \-d 10 \-f cd \-t wav \-D copy foobar.wav\fP
@@ -240,24 +273,26 @@ pcm.copy {
.TP
\fBarecord \-t wav \-\-max\-file\-time 30 mon.wav\fP
-Record from the default audio source in monaural, 8,000 samples
-per second, 8 bits per sample. Start a new file every
-30 seconds. File names are mon\-nn.wav, where nn increases
-from 01. The file after mon\-99.wav is mon\-100.wav.
+Record from the default audio source in monaural,
+8,000 samples per second, 8 bits per sample.
+Start a new file every 30 seconds.
+File names are mon\-nn.wav, where nn increases from 01.
+The file after mon\-99.wav is mon\-100.wav.
.TP
-\fBarecord \-f cd \-t wav \-\-max\-file\-time 3600 \-\-use-strftime %Y/%m/%d/listen-%H-%M-%v.wav\fP
-Record in stereo from the default audio source. Create a new file
-every hour. The files are placed in directories based on their start dates
+\fBarecord \-f cd \-t wav \-\-max\-file\-time 3600 \-\-use-strftime \
+%Y/%m/%d/listen-%H-%M-%v.wav\fP
+Record in stereo from the default audio source.
+Create a new file every hour.
+The files are placed in directories based on their start dates
and have names which include their start times and file numbers.
.SH SEE ALSO
-\fB
-alsamixer(1),
-amixer(1)
-\fP
+.BR \
+alsamixer "(1), " \
+amixer (1)
-.SH BUGS
+.SH BUGS
Note that .aiff files are not currently supported.
.SH AUTHOR