1 AUDIOCTL(1)                      User Commands                     AUDIOCTL(1)
   2 
   3 
   4 
   5 NAME
   6        audioctl - audio device control command line interface
   7 
   8 SYNOPSIS
   9        audioctl list-devices
  10 
  11 
  12        audioctl show-device [-v] [-d device]
  13 
  14 
  15        audioctl show-control [-v] [-d device] [control ...]
  16 
  17 
  18        audioctl set-control [-v] [-d device] control value
  19 
  20 
  21        audioctl save-controls [-d device] [-f] file
  22 
  23 
  24        audioctl load-controls [-d device] file
  25 
  26 
  27 DESCRIPTION
  28        The audioctl command is used to control various settings and features
  29        of audio devices, including mixer settings such as playback volume and
  30        record gain.
  31 
  32 SUBCOMMANDS
  33        The audioctl command supports the following subcommands.
  34 
  35        list-devices
  36 
  37            List all the audio devices on the system.
  38 
  39 
  40        show-device [-v] [-d device] [control ... ]
  41 
  42            Display an informational overview of device (or the default device
  43            if not specified).  If the -v option is specified, then more detail
  44            will be displayed.
  45 
  46 
  47        show-control [-v] [-d device]
  48 
  49            Display the control settings for one or more controls of a device
  50            (or the default device if not specified).  If no control is
  51            specified, then the settings for all controls will be displayed. If
  52            the -v option is specified, then more detail will be displayed.
  53 
  54 
  55        set-control [-v] [-d device] control value
  56 
  57            Set the control settings for a control of a device (or the default
  58            device if not specified) to value.  If the -v option is specified,
  59            then more verbose output be displayed.
  60 
  61 
  62        save-controls [-f] [-d device] file
  63 
  64            Save all control settings of the device (or the default device if
  65            not specified) to the named file.  This subcommand will not replace
  66            or modify an existing file unless -f (force) is specified.
  67 
  68 
  69        load-controls [-d device] file
  70 
  71            Load previously saved control settings from a file into a device
  72            (or all audio devices if not specified).
  73 
  74 
  75 ENVIRONMENT VARIABLES
  76        AUDIODEV
  77                    The full path name of the default audio device to use if
  78                    one is not specified on the command line.  If this variable
  79                    is not set, /dev/audio is used.
  80 
  81 
  82 
  83 ATTRIBUTES
  84        See attributes(5) for descriptions of the following attributes:
  85 
  86 
  87 
  88 
  89        +--------------------+-----------------+
  90        |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
  91        +--------------------+-----------------+
  92        |Interface Stability | See below.      |
  93        +--------------------+-----------------+
  94        The audioctl command and its subcommands are Committed.  The names of
  95        controls, their values, and device names are Uncommitted.  The display
  96        output is intended for human consumption, and is Not An Interface.  The
  97        format of the state files used by the save-controls and load-controls
  98        subcommands is Committed Private.
  99 
 100 SEE ALSO
 101        audioplay(1), audiorecord(1), dsp(7I), mixer(7I), attributes(5)
 102 
 103 
 104 
 105                                 March 18, 2011                     AUDIOCTL(1)