audiocfg(1) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
AUDIOCFG(1)             NetBSD General Commands Manual             AUDIOCFG(1)


NAME

     audiocfg -- configure default audio device


SYNOPSIS

     audiocfg list [index]
     audiocfg default index
     audiocfg set index direction encoding precision channels sample_rate
     audiocfg test index


DESCRIPTION

     The audiocfg utility helps maintaining the audio and mixer device sym-
     links.

     Run with ``list'', it lists the available audio devices and shows the
     currently selected default audio device.

     Run with ``set'', it sets the hardware format.  The direction is repre-
     sented by either of 'p' (playback) or 'r' (record), or both of them.
     This indicates the direction you want to set.  The remaining parameters
     encoding, precision, channels, and sample_rate indicate the hardware for-
     mat you want to set.  These parameters must be selected from the candi-
     dates displayed by audiocfg list.

     Called with ``test'', it plays a tone of 2 seconds for each channel of
     the device with the index index.  Called with ``default'', it sets the
     default audio device to the one with the index index.

     audiocfg needs access to /dev/drvctl and write access to /dev (when used
     with ``default'') to work.


FILES

     /dev/audio  Symlink to default audio device.

     /dev/audio[0-9]*
                 Available audio devices.

     /dev/audioctl
                 Symlink to default audio control device.

     /dev/audioctl[0-9]*
                 Available audio control devices.

     /dev/drvctl
                 Used for finding the corresponding audio driver to an audio
                 device.

     /dev/mixer  Symlink to default mixer device.

     /dev/mixer[0-9]*
                 Available mixer devices.

     /dev/sound  Symlink to default audio device (for the difference to
                 /dev/audio, see audio(4)).

     /dev/sound[0-9]*
                 Available audio devices.


EXAMPLES

     Configure audio device 0 for playing BluRay 5.1 surround sound:
           $ audiocfg set 0 p slinear_le 16 6 48000

     Configure audio device 0 for playing CD quality audio:
           $ audiocfg set 0 p slinear_le 16 2 44100


SEE ALSO

     audioplay(1), audiorecord(1), audio(4), drvctl(8)


HISTORY

     The audiocfg utility first appeared in NetBSD 6.0.


AUTHORS

     The audiocfg utility was originally written by Jared McNeill.  This man-
     ual page was written by Thomas Klausner.

NetBSD 10.0                      April 7, 2021                     NetBSD 10.0