HDAUDIOCTL(8)

HDAUDIOCTL(8) | System Manager's Manual | HDAUDIOCTL(8)

# NAME

`hdaudioctl` — program to manipulate hdaudio(4) devices

# SYNOPSIS

`hdaudioctl` | [-f device] command [arguments]

# DESCRIPTION

The `hdaudioctl` command can be used to inspect and reconfigure High Definition Audio devices and their child codecs.

The mandatory command argument specifies the action to take. Valid commands are:

list
  For each child codec of the chosen hdaudio(4) device, display the nid, vendor, product, subsystem and device IDs.
show codecid nid
  Retrieve and display the current codec configuration in human-readable form.
get codecid nid
  Retrieve and display the current codec configuration as a proplib(3) XML plist.
set codecid nid [plist]
  Detach the specified hdafg(4) codec and then re-attach with its widgets explicitly configured according to the specified plist. If no plist is given, the in-built widget parsing rules based on the High Definition Audio specification will be used.
graph codecid nid
  Output a DOT file suitable processing by graphviz. The resulting image will graphically show the structure and interconnections of the widgets that form the chosen hdafg(4) codec.

# FILES

/dev/hdaudioX
  control devices

# SEE ALSO

audio(4), hdaudio(4), pkgsrc/graphics/graphviz

# HISTORY

The `hdaudioctl` command first appeared in NetBSD 5.1.

# AUTHORS

`hdaudioctl` is based on two separate programs written by Jared McNeill <jmcneill@NetBSD.org> under contract by Precedence Technologies Ltd. Integration into one program and writing this manual page was done by
Stephen Borrill <sborrill@NetBSD.org>.

# CAVEATS

When a plist is loaded and the hdafg(4) codec reattaches, all mixer controls will be returned to their default values.

April 12, 2021 | NetBSD 11.0