From: Jaroslav Kysela Date: Tue, 7 Aug 2001 10:28:24 +0000 (+0000) Subject: Update for 0.9 X-Git-Tag: v1.0.3~204 X-Git-Url: https://git.alsa-project.org/?a=commitdiff_plain;h=95dac87c1a0ee9e46774f76b2534a82ea725ee73;p=alsa-utils.git Update for 0.9 --- diff --git a/aplay/aplay.1 b/aplay/aplay.1 index 13d90ff..fabacaa 100644 --- a/aplay/aplay.1 +++ b/aplay/aplay.1 @@ -1,6 +1,7 @@ -.TH APLAY 1 "25 Nov 1998" +.TH APLAY 1 "2 August 2001" .SH NAME -arecord, aplay \- command-line sound recorder and player for ALSA soundcard driver +arecord, aplay \- command-line sound recorder and player for ALSA +soundcard driver .SH SYNOPSIS [\fBarecord\fP | \fBaplay\fP ] [\fIflags\fP] filename @@ -20,78 +21,107 @@ forth can be automatically determined from the soundfile header. .SS Options .TP -\fI-h, --help\fP +\fI--help\fP Help: show syntax. .TP -\fI-V, --version\fP +\fI--version\fP Print current version. .TP -\fI-l\fP -List all available soundcards and devices. +\fI-l, --list-devices\fP +List all soundcards and digital audio devices .TP -\fI-c\fP -Select the soundcard to use, if you have more than one. Cards are -numbered from 0 (the default). +\fI-L, --list-pcms\fP +List all PCMs defined .TP -\fI-d\fP -Select the soundcard device to use, if your card has more than -one. Devices are numbered from 0 (the default). Not to be confused -with the soundcard mixer channels, which are sometimes also referred -to as "devices", just to be annoying. Many soundcards will only have -device 0. Some more complex cards may have mor. Try using \fI-l\fP -and see what you get. - +\fI-D, --device=NAME\fP +Select PCM by name .TP -\fI-q\fP +\fI-q --quiet\fP Quiet mode. Suppress messages (not sound :)) - .TP -\fI-w\fP -Use Wave soundfile format (.wav) +\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=#\fP +Sampling rate in Hertz. +.TP +\fI-d, --duration=#\fP +Interrupt after # seconds .TP -\fI-r\fP -Use raw soundfile format. Requires -s, -b, and -p flags? +\fI-s, --sleep-min=#\fP +Min ticks to sleep .TP -\fI-u\fP -Use Sparc Audio soundfile format (.au) +\fI-M, --mmap\fP +Mmap stream .TP -\fI-v\fP -Use Voc soundfile format +\fI-N, --nonblock\fP +Nonblocking mode .TP -\fI-S\fP -Soundfile is stereo. Mono is the default for headerless files. +\fI-F, --period-time=#\fP +Distance between interrupts is # microseconds .TP -\fI-t \fP -Time limit for recording, in seconds. +\fI-B, --buffer-time=#\fP +Buffer duration is # microseconds .TP -\fI-s \fP -Sampling rate in Hertz. +\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-b \fP -Bit depth (8 or 16 bits). +\fI-T, --stop-delay=#\fP +Delay for automatic PCM stop is # microseconds from xrun .TP -\fI-m\fP -Set to CD standard quality (44100 Hz, stereo, 16-bit linear). +\fI-v, --verbose\fP +Show PCM structure and setup .TP -\fI-M \fP -Set to DAT quality (48000 Hz, stereo, 16-bit linear). +\fI-I, --separate-channels\fP +One file for each channel .TP -\fI-p \fP -Compression type (alaw, ulaw, adpcm). .SS Example: .RS -\fBaplay -c 1 -r -u -s 22050 -b 8 -p ulaw foobar\fR +\fBaplay -c 1 -t raw -r 22050 -f mu_law foobar\fR .ID will play the raw file "foobar" as a -22050-Hz, mono, 8-bit, Mu-Law .au file, using the second soundcard. - -\fBarecord -t 10 -m -w foobar.wav\fP - -will record foobar.wav as a 10-second, CD-quality wave file. +22050-Hz, mono, 8-bit, Mu-Law .au file. + +\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 @@ -105,8 +135,5 @@ Note that .aiff files are not currently supported. .SH AUTHOR \fBarecord\fP and \fBaplay\fP are by Jaroslav Kysela This document is by Paul Winkler . - - - - +Updated for Alsa 0.9 by James Tappin