Updated: 2021/Apr/14


AUDIOCFG(1)                 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
     symlinks.

     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
     represented 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
     format you want to set.  These parameters must be selected from the
     candidates 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
     manual page was written by Thomas Klausner.

NetBSD 9.99                      April 7, 2021                     NetBSD 9.99