Print this page
12287 errors in audio utility man pages
   1 AUDIORECORD(1)                   User Commands                  AUDIORECORD(1)
   2 
   3 
   4 
   5 NAME
   6        audiorecord - record an audio file
   7 
   8 SYNOPSIS
   9        audiorecord [-af] [-v vol] [-c channels] [-s rate]
  10             [-e encoding] [-t time] [-i info] [-d dev]
  11             [-T au | aif[f] | wav] [file[.au|.aif[f]]|.wav]
  12 
  13 
  14 DESCRIPTION
  15        The audiorecord utility copies audio data from the audio device to a
  16        named audio file, or to the standard output if no filename is present.
  17        If no output file is specified and standard output is a tty, the
  18        program exits with an error message.
  19 
  20 
  21        By default, monaural audio data is recorded at 8 kHz and encoded in
  22        -law format. If the audio device supports additional configurations,
  23        the -c, -s, and -e options may be used to specify the data format. The
  24        output file is prefixed by an audio file header that identifies the
  25        format of the data encoded in the file.
  26 
  27 
  28        Recording begins immediately and continues until a SIGINT signal (for
  29        example, Control-c) is received. If the -t option is specified,
  30        audiorecord stops when the specified quantity of data has been
  31        recorded.
  32 
  33 
  34        If the audio device is unavailable, that is, if another process
  35        currently has read access, audiorecord prints an error message and
  36        exits immediately.
  37 
  38 OPTIONS
  39        The following options are supported:
  40 
  41        -\?
  42                                Help: Prints a command line usage message.
  43 
  44 
  45        -a
  46                                Append: Appends the data on the end of the
  47                                named audio file. The audio device must support
  48                                the audio data format of the existing file.
  49 
  50 
  51        -c channels
  52                                Channels: Specifies the number of audio
  53                                channels (1 or 2). The value may be specified
  54                                as an integer or as the string mono or stereo.
  55                                The default value is mono.
  56 
  57 
  58        -d dev
  59                                Device: The dev argument specifies an alternate
  60                                audio device from which input should be taken.
  61                                If the -d option is not specified, the AUDIODEV


 107        -T au | aif[f] | wav
 108                                Specifies the audio file type to create. If the
 109                                -a option is used, the file type must match the
 110                                file to which it is being appended. Regardless
 111                                of the file suffix, the type is set as
 112                                specified in this option. If this option is not
 113                                specified, the file suffix determines the type.
 114 
 115 
 116        -v vol
 117                                Volume: The recording gain is set to the
 118                                specified value before recording begins, and is
 119                                reset to its previous level when audiorecord
 120                                exits. The vol argument is an integer value
 121                                between 0 and 100, inclusive. If this argument
 122                                is not specified, the input volume remains at
 123                                the level most recently set by any process.
 124 
 125 
 126 OPERANDS
 127        file[.au|.aif[f]]|.wav
 128 
 129            File Specification: The named audio file is rewritten, or appended.
 130            If no filename is present, and standard output is not a tty, or if
 131            the special filename "-" is specified, output is directed to the
 132            standard output.
 133 
 134            If the -T option is not specified, the file suffix determines the
 135            type of file. If the suffix is not recognized, the default is .au.
 136            If the -T option is specified, that file type is used regardless of
 137            the file suffix.
 138 
 139 
 140 USAGE
 141        See largefile(5) for the description of the behavior of audiorecord
 142        when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
 143 
 144 ENVIRONMENT VARIABLES
 145        AUDIODEV
 146                    The full path name of the audio device to record from, if
 147                    no -d argument is supplied. If the AUDIODEV variable is not
 148                    set, /dev/audio is used.
 149 
 150 
 151 ATTRIBUTES
 152        See attributes(5) for descriptions of the following attributes:
 153 
 154 
 155 
 156 
 157        +--------------------+-----------------+
 158        |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
 159        +--------------------+-----------------+
 160        |Architecture        | SPARC, x86      |
 161        +--------------------+-----------------+
 162        |Interface Stability | Committed       |
 163        +--------------------+-----------------+
 164 
 165 SEE ALSO
 166        audioconvert(1), audioplay(1), attributes(5), largefile(5), audio(7I)
 167 
 168 
 169 
 170                                  May 13, 2017                   AUDIORECORD(1)
   1 AUDIORECORD(1)                   User Commands                  AUDIORECORD(1)
   2 
   3 
   4 
   5 NAME
   6        audiorecord - record an audio file
   7 
   8 SYNOPSIS
   9        audiorecord [-af] [-v vol] [-c channels] [-s rate]
  10             [-e encoding] [-t time] [-i info] [-d dev]
  11             [-T au|aif[f]|wav] [file[.au|.aif[f]|.wav]]
  12 
  13 
  14 DESCRIPTION
  15        The audiorecord utility copies audio data from the audio device to a
  16        named audio file, or to the standard output if no filename is present.
  17        If no output file is specified and standard output is a tty, the
  18        program exits with an error message.
  19 
  20 
  21        By default, monaural audio data is recorded at 8 kHz and encoded in u-
  22        law format. If the audio device supports additional configurations, the
  23        -c, -s, and -e options may be used to specify the data format. The
  24        output file is prefixed by an audio file header that identifies the
  25        format of the data encoded in the file.
  26 
  27 
  28        Recording begins immediately and continues until a SIGINT signal (for
  29        example, Control-c) is received. If the -t option is specified,
  30        audiorecord stops when the specified quantity of data has been
  31        recorded.
  32 
  33 
  34        If the audio device is unavailable, that is, if another process
  35        currently has read access, audiorecord prints an error message and
  36        exits immediately.
  37 
  38 OPTIONS
  39        The following options are supported:
  40 
  41        -?
  42                                Help: Prints a command line usage message.
  43 
  44 
  45        -a
  46                                Append: Appends the data on the end of the
  47                                named audio file. The audio device must support
  48                                the audio data format of the existing file.
  49 
  50 
  51        -c channels
  52                                Channels: Specifies the number of audio
  53                                channels (1 or 2). The value may be specified
  54                                as an integer or as the string mono or stereo.
  55                                The default value is mono.
  56 
  57 
  58        -d dev
  59                                Device: The dev argument specifies an alternate
  60                                audio device from which input should be taken.
  61                                If the -d option is not specified, the AUDIODEV


 107        -T au | aif[f] | wav
 108                                Specifies the audio file type to create. If the
 109                                -a option is used, the file type must match the
 110                                file to which it is being appended. Regardless
 111                                of the file suffix, the type is set as
 112                                specified in this option. If this option is not
 113                                specified, the file suffix determines the type.
 114 
 115 
 116        -v vol
 117                                Volume: The recording gain is set to the
 118                                specified value before recording begins, and is
 119                                reset to its previous level when audiorecord
 120                                exits. The vol argument is an integer value
 121                                between 0 and 100, inclusive. If this argument
 122                                is not specified, the input volume remains at
 123                                the level most recently set by any process.
 124 
 125 
 126 OPERANDS
 127        file[.au|.aif[f]|.wav]
 128 
 129            File Specification: The named audio file is rewritten, or appended.
 130            If no filename is present, and standard output is not a tty, or if
 131            the special filename "-" is specified, output is directed to the
 132            standard output.
 133 
 134            If the -T option is not specified, the file suffix determines the
 135            type of file. If the suffix is not recognized, the default is .au.
 136            If the -T option is specified, that file type is used regardless of
 137            the file suffix.
 138 
 139 
 140 USAGE
 141        See largefile(5) for the description of the behavior of audiorecord
 142        when encountering files greater than or equal to 2 Gbyte (2^31 bytes).
 143 
 144 ENVIRONMENT VARIABLES
 145        AUDIODEV
 146                    The full path name of the audio device to record from, if
 147                    no -d argument is supplied. If the AUDIODEV variable is not
 148                    set, /dev/audio is used.
 149 
 150 














 151 SEE ALSO
 152        audioconvert(1), audioplay(1), largefile(5), audio(7I)
 153 
 154 
 155 
 156                                February 8, 2020                 AUDIORECORD(1)