OS Manuals

/usr/bin/alsactl

ALSA (Advanced Linux Sound Architecture) command-line utilities: aplay, arecord, amixer, alsamixer, alsactl, speaker-test and more

From alsa-utils 1.2.16-r3 (enterprise-packages), captured 2026-11-08 by running alsactl --help (exit 0). permalink

Usage: alsactl <options> command

global options:
  -h,--help        this help
  -d,--debug       debug mode
  -v,--version     print version of this program

Available state options:
  -f,--file #      configuration file (default /var/lib/alsa/asound.state)
  -G,--group-file #  card group configuration file (default /var/lib/alsa/card-group.state)
  -a,--config-dir #  boot / hotplug configuration directory (default /var/lib/alsa)
  -l,--lock        use file locking to serialize concurrent access
  -L,--no-lock     do not use file locking to serialize concurrent access
  -K,--lock-dir #  lock path (default /var/lock)
  -O,--lock-state-file #  state lock file path (default asound.state.lock)
  -F,--force       try to restore the matching controls as much as possible
                     (default mode)
  -g,--ignore      ignore 'No soundcards found' error
  -P,--pedantic    do not restore mismatching controls (old default)
  -I,--no-init-fallback
                   don't initialize even if restore fails
  -r,--runstate #  save restore and init state to this file (only errors)
                     default settings is 'no file set'
  -R,--remove      remove runstate file at first, otherwise append errors
  -Y,--export      export card state as key=value pairs (restore command only)
  -p,--period #    store period in seconds for the daemon command
  -e,--pid-file #  pathname for the process id (daemon mode)

Available init options:
  -E,--env #=#     set environment variable for init phase (NAME=VALUE)
  -i,--initfile #  main configuation file for init phase
                     (default /usr/share/alsa/init/00main)
  -b,--background  run daemon in background
  -s,--syslog      use syslog for messages
  -n,--nice #      set the process priority (see 'man nice')
  -c,--sched-idle  set the process scheduling policy to idle (SCHED_IDLE)
  -D,--ucm-defaults  execute also the UCM 'defaults' section
  -U,--no-ucm      don't init with UCM
  -m,--force-ucm-restore  force UCM restore for boot card groups
  -X,--ucm-nodev   show UCM no device errors

Available commands:
  store       <card>  save current driver setup for one or each soundcards
                        to configuration file
  restore     <card>  load current driver setup for one or each soundcards
                        from configuration file
  nrestore    <card>  like restore, but notify the daemon to rescan soundcards
  wrestore    <card>  wait for card ready, then restore
  init        <card>  initialize driver to a default state
  daemon      <card>  store state periodically for one or each soundcards
  rdaemon     <card>  like daemon but do the state restore at first
  kill        <cmd>   notify daemon to quit, rescan or save_and_quit
  monitor     <card>  monitor control events
  info        <card>  general information
  clean       <card>  clean application controls
  dump-state          dump the state (for all cards)
  dump-cfg            dump the configuration (expanded, for all cards)
Options (29)
OptionDescriptionSource
-h, --helpHelp: show available flags and commands.help + man
-d, --debugUse debug mode: a bit more verbose.help + man
-v, --versionprint version of this programhelp + man
-f, --file #configuration file (default /var/lib/alsa/asound.state)help + man
-G, --group-file #card group configuration file (default /var/lib/alsa/card-group.state)help
-a, --config-dir #boot / hotplug configuration directory (default /var/lib/alsa)help + man
-l, --lockUse the file locking to serialize the concurrent access to the state file (this option is default for the global state file).help + man
-L, --no-lockDo not use the file locking to serialize the concurrent access to the state file (including the global state file).help + man
-K, --lock-dir #lock path (default /var/lock)help
-O, --lock-state-file #state lock file path (default asound.state.lock)help + man
-F, --forcetry to restore the matching controls as much as possible (default mode)help + man
-g, --ignoreUsed with store, restore and init commands.help + man
-P, --pedanticdo not restore mismatching controls (old default)help + man
-I, --no-init-fallbackDon't initialize cards if restore fails.help + man
-r, --runstate #save restore and init state to this file (only errors) default settings is 'no file set'help + man
-R, --removeremove runstate file at first, otherwise append errorshelp + man
-Y, --exportexport card state as key=value pairs (restore command only)help
-p, --period #The store period in seconds for the daemon command.help + man
-e, --pid-file #The pathname to store the process-id file in the HDB UUCP format (ASCII).help + man
-E, --env #=#Set environment variable (useful for init action or you may override ALSA_CONFIG_PATH to read different or optimized configuration - may be useful for "boot" scripts).help + man
-i, --initfile #main configuation file for init phase (default /usr/share/alsa/init/00main)help + man
-b, --backgroundRun the task in background.help + man
-s, --syslogUse syslog for messages.help + man
-n, --nice #set the process priority (see 'man nice')help + man
-c, --sched-idleSet the process scheduling policy to idle (SCHED_IDLE).help + man
-D, --ucm-defaultsExecute also the 'defaults' section from the UCM configuration.help + man
-U, --no-ucmSkip the UCM init even if available.help + man
-m, --force-ucm-restoreforce UCM restore for boot card groupshelp
-X, --ucm-nodevshow UCM no device errorshelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.