I suggest to use the speaker-test command (which belongs to media-sound/alsa-utils) instead of relying on an external audio player like those mentioned in the ALSA guide (madplay and ogg123). This are several reasons:
1) No need for the user to emerge anything else besides alsa-utils; the user was already told to emerge it anyway.
2) speaker-test plays audio on each channel at different times; music, instead, uses all available channels and the user cannot easily detect if there's a problem with one of them, especially if you have a 5.1 system, for example
3) No need for the user to have a song or some other audio file at hand; speaker-test can be told to use its own wav files
I suggest to use a command such as "speaker-test -t wav -c 2" (of course the user should change the number of channels according to the number of speakers he has).
(In reply to comment #0)
> (of course the
> user should change the number of channels according to the number of
> speakers he has).
That's not quite right. One has to bear in mind what the output PCM is. If the output PCM is not specified, it will go to "default", which will be stereo unless it's been redefined. Try outputting 3 or more channels to stereo - only 2 channels will be outputted.
So to test 5.1 audio, use e.g.:
speaker-test -c 6 -D surround51 -t wav
Created attachment 327710 [details, diff]
Proposed change to the ALSA guide.
This document has been marked as obsolete due to insufficient resources. However, a more active document can be found on the Gentoo Wiki at https://wiki.gentoo.org/wiki/ALSA. We welcome any contributions on this guide and recommend you create an account (if you do not have one already) and make the adjustments to the article as needed. In case of doubt, use the Talk page to discuss potential changes before applying them.
If needed, the wiki-style version of the old document is available at https://wiki.gentoo.org/wiki/User:SwifT/Wikified_but_not_merged_documents/ALSA_guide so any previously existing content can, if needed, be reused on the wiki.