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 dialing sequence for each channel of the device with the index index. The number dialed is taken from the AUDIOCFG_DIAL environment variable and is 555-2368 by default. 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.

April 7, 2021 | NetBSD 11.99