unix sysadmin archives
Donation will make us pay more time on the project:
          

Friday 1 January 2010

audiorecord man page

User Commands                                      audiorecord(1)



NAME
     audiorecord - record an audio file

SYNOPSIS
     audiorecord [-af] [-v vol] [-b bal]  [-m monvol]  [-p mic  |
     line  |  internal-cd]  [-c channels] [-s rate] [-e encoding]
     [-t time]  [-i info]  [-d dev]  [-T   au  |  aif[f]  |  wav]
     [file[.au|.aif[f]]|.wav]

DESCRIPTION
     The audiorecord utility copies audio  data  from  the  audio
     device  to  a named audio file, or to the standard output if
     no filename is present. If no output file is  specified  and
     standard  output  is  a  tty,  the  volume, balance, monitor
     volume, port, and audio format  settings  specified  on  the
     command line will be applied and the program will exit.

     By default, monaural audio data is recorded  at  8  kHz  and
     encoded  in  -law format. If the audio device supports addi-
     tional configurations, the -c, -s, and  -e  options  may  be
     used to specify the data format. The output file is prefixed
     by an audio file header that identifies the  format  of  the
     data encoded in the file.

     Recording begins immediately and continues  until  a  SIGINT
     signal  (for  example,   Control-c)  is  received. If the -t
     option is specified, audiorecord stops  when  the  specified
     quantity of data has been recorded.

     If the audio device is unavailable, that is, if another pro-
     cess  currently has read access, audiorecord prints an error
     message and exits immediately.

OPTIONS
     The following options are supported:

     -\?

         Help: Prints a command line usage message.



     -a

         Append: Appends the data on the end of the  named  audio
         file.  The audio device must support the audio data for-
         mat of the existing file.



     -b bal




SunOS 5.10          Last change: 16 Jul 2003                    1






User Commands                                      audiorecord(1)



         Balance: The recording balance is set to  the  specified
         value  before recording begins, and is reset to its pre-
         vious level when audiorecord exits. The bal argument  is
         an  integer  value  between  -100  and 100, inclusive. A
         value of -100 indicates left balance, 0 middle, and  100
         right. If this argument is not specified, the input bal-
         ance will remain at the level most recently set  by  any
         process.



     -c channels

         Channels: Specifies the number of audio channels  (1  or
         2).  The  value may be specified as an integer or as the
         string mono or stereo. The default value is mono.



     -d dev

         Device: The dev argument specifies  an  alternate  audio
         device  from  which  input  should  be  taken. If the -d
         option is not specified, the AUDIODEV environment  vari-
         able  is consulted (see below). Otherwise, /dev/audio is
         used as the default audio device.



     -e encoding

         Encoding: Specifies the audio data encoding. This  value
         may  be one of ulaw, alaw, or linear. The default encod-
         ing is ulaw.



     -f

         Force: When the -a flag is specified, the sample rate of
         the audio device must match the sample rate at which the
         original file was recorded.  If  the  -f  flag  is  also
         specified,  sample  rate differences are ignored, with a
         warning message printed on the standard error.



     -i info

         Information: The `information' field of the output  file
         header  is set to the string specified by the info argu-
         ment. This option cannot  be  specified  in  conjunction



SunOS 5.10          Last change: 16 Jul 2003                    2






User Commands                                      audiorecord(1)



         with the -a argument.



     -m monvol

         Monitor Volume: The input monitor volume is set  to  the
         specified value before recording begins, and is reset to
         its previous level when audiorecord  exits.  The  monval
         argument   is  an  integer  value  between  0  and  100,
         inclusive. A non-zero value allows a directly  connected
         input  source  to  be  heard on the output speaker while
         recording is in-progress. If this argument is not speci-
         fied,  the  monitor volume will remain at the level most
         recently set by any process.



     -p mic | line | internal-cd

         Input Port: Selects the mic, line, or internal-cd  input
         as  the source of the audio output signal. If this argu-
         ment is  not  specified,  the  input  port  will  remain
         unchanged.  Please notice: Some systems will not support
         all possible input ports. If the  named  port  does  not
         exist, this option is ignored.



     -s rate

         Sample Rate: Specifies the sample rate, in  samples  per
         second.  If  a number is followed by the letter k, it is
         multiplied by 1000 (for example,  44.1k  =  44100).  The
         default sample rate is 8 kHz.



     -t time

         Time: The time argument specifies the maximum length  of
         time  to  record.  Time  can be specified as a floating-
         point value, indicating the number of seconds, or in the
         form:  hh:mm:ss.dd, where the hour and minute specifica-
         tions are optional.



     -T au | aif[f] | wav

         Specifies the audio file  type  to  create.  If  the  -a
         option  is  used,  the  file type must match the file to



SunOS 5.10          Last change: 16 Jul 2003                    3






User Commands                                      audiorecord(1)



         which it is being appended. Regardless of the file  suf-
         fix,  the  type will be set as specified in this option.
         If this option is not specified, the  file  suffix  will
         determine the type.



     -v vol

         Volume: The recording gain is set to the specified value
         before  recording  begins,  and is reset to its previous
         level when audiorecord exits. The  vol  argument  is  an
         integer  value  between  0  and  100, inclusive. If this
         argument is not specified, the input volume will  remain
         at the level most recently set by any process.



OPERANDS
     file[.au|.aif[f]]|.wav

         File Specification: The named audio file  is  rewritten,
         or  appended.  If  no  filename is present, and standard
         output is not a tty, or if the special filename  "-"  is
         specified,  output  is directed to the the standard out-
         put.

         If the -T option is not specified, the file suffix  will
         determine  the type of file. If the suffix is not recog-
         nized, the default is .au. If the -T  option  is  speci-
         fied, that file type is used regardless of the file suf-
         fix.



USAGE
     See largefile(5) for the  description  of  the  behavior  of
     audiorecord when encountering files greater than or equal to
     2 Gbyte ( 2**31 bytes).

ENVIRONMENT VARIABLES
     AUDIODEV        The full path name of the  audio  device  to
                     record  from, if no -d argument is supplied.
                     If  the  AUDIODEV  variable  is   not   set,
                     /dev/audio is used.



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:




SunOS 5.10          Last change: 16 Jul 2003                    4






User Commands                                      audiorecord(1)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Architecture                | SPARC, x86                  |
    |_____________________________|_____________________________|
    | Availability                | SUNWauda                    |
    |_____________________________|_____________________________|
    | Interface Stability         | Evolving                    |
    |_____________________________|_____________________________|


SEE ALSO
     audioconvert(1), audioplay(1),  mixerctl(1),  attributes(5),
     largefile(5), usb_ac(7D), audio(7I), mixer(7I)









































SunOS 5.10          Last change: 16 Jul 2003                    5

No comments:

Post a Comment