asgardius/alsa-utils
1
0
Fork 0
mirror of https://github.com/alsa-project/alsa-utils synced 2024-12-22 13:16:31 +01:00
Code Issues Projects Releases Packages Wiki Activity

speaker-test.1: Clarify man page by giving examples

Browse source 
BugLink: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=620513

From the Debian bug report:
"The speaker-test manpage could be improved somewhat by helping a
little bit the user determine how to find out the devices he can test.

Based on http://alsa.opensrc.org/Speaker-test I have make some changes
to the manpage (diff attached) to describe a little bit more how
speaker-test can be used alongside 'aplay'.

Please consider the following patch for
alsa-utils-1.0.23/speaker-test/speaker-test.1"

Signed-off-by: Javier Fernández-Sanguino Peña <jfs@debian.org>
Signed-off-by: Takashi Iwai <tiwai@suse.de>
This commit is contained in:
Daniel T Chen 2011-06-04 17:44:43 -04:00 committed by Takashi Iwai
parent 36d642f448
commit 471191abe5
1 changed files with 45 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

46
speaker-test/speaker-test.1
View file

@ -11,7 +11,7 @@
. fi
. PP
..
.TH SPEAKER\-TEST 1 "20 September 2004" speaker-test
.TH SPEAKER\-TEST 1 "April 2nd, 2011" speaker-test
.SH NAME
speaker\-test \- command-line speaker test tone generator for ALSA
.SH SYNOPSIS
@ -20,6 +20,41 @@ speaker\-test \- command-line speaker test tone generator for ALSA
.SH DESCRIPTION
\fBspeaker\-test\fP generates a tone that can be used to test the speakers of a computer.
\fBspeaker-test\fP by default will test the \fIdefault\fP device. If you
want to test another sound device you will have first to get a list of
all of the sound cards in your system and the devices associated with
those cards. Notice that there might be for example, one device for
analog sound, one for digital sound and one for HDMI sound.
To get the list of available cards and devices you can run \fBaplay -L\fR.
.P \fBaplay\fR's output will be similar to this one:
.nf
$ aplay -L
null
Discard all samples (playback) or generate zero samples (capture)
default:CARD=ICH5
Intel ICH5, Intel ICH5
Default Audio Device
front:CARD=ICH5,DEV=0
Intel ICH5, Intel ICH5
Front speakers
surround40:CARD=ICH5,DEV=0
Intel ICH5, Intel ICH5
4.0 Surround output to Front and Rear speakers
(...)
.fi
.P Each of the devices is listed in the beginning of the definition so,
in the above example, there are four devices listed: null, default, front
and surround40. So, if you want to test the last device you can
run \fBspeaker-test -Dsurround40:ICH5 -c 6\fR. The \fB-c\fR option will
indicate that the six audio channels in the device have to be tested.
.SH OPTIONS
.TP
@ -119,6 +154,15 @@ To send a nice low 75Hz tone to the Woofer and then exit without touching any ot
speaker-test -Dplug:surround51 -c6 -s1 -f75
.EE
To do a 2-speaker test using the spdif (coax or optical) output:
.EX
speaker-test -Dplug:spdif -c2
.EE
.SH SEE ALSO
.BR aplay(1)
.SH AUTHOR
The speaker-test program was written by James Courtier-Dutton.
Pink noise support was added by Nathan Hurst.