[BACK]Return to aucat.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / aucat

Diff for /src/usr.bin/aucat/aucat.1 between version 1.16 and 1.17

version 1.16, 2008/05/23 07:15:46 version 1.17, 2008/05/23 12:56:27
Line 43 
Line 43 
 utility can record one input stream  utility can record one input stream
 and store it on multiple destination files,  and store it on multiple destination files,
 doing the necessary conversions on the fly.  doing the necessary conversions on the fly.
 Simultaneously, it can play, convert, and mix multiple input files.  It can play, convert, and mix multiple input files simultaneously.
 .Nm  .Nm
 also has a legacy mode that works like previous versions of  also has a legacy mode that works like previous versions of
 .Nm ,  .Nm ,
 which does not convert on the fly and supports playback of .au files.  which does not convert on the fly and supports playback of .au files.
   .Pp
 The options are as follows:  The options are as follows:
 .Bl -tag -width "-m mmmmmmmm "  .Bl -tag -width "-m mmmmmmmm "
 .It Fl C Ar min : Ns Ar max  .It Fl C Ar min : Ns Ar max
 Range of channel numbers on the output stream specified by  The range of channel numbers on the output stream.
 .Fl o  The default is 0:1, i.e. stereo.
 options that follow (the default is 0:1, i.e. stereo).  
 .It Fl c Ar min : Ns Ar max  .It Fl c Ar min : Ns Ar max
 Range of channel numbers in the input stream specified by  The range of channel numbers on the input stream.
 .Fl i  The default is 0:1, i.e. stereo.
 options that follow (the default is 0:1, i.e. stereo).  
 .It Fl d Ar level  .It Fl d Ar level
 The debug level:  The debug level:
 may be a value between 0 and 4.  may be a value between 0 and 4.
 .It Fl E Ar enc  .It Fl E Ar enc
 Encoding of the output stream specified by the  Encoding of the output stream.
 .Fl o  The default is signed, 16-bit, native byte order.
 options that follow (the default is signed, 16-bit, native byte order).  
 .It Fl e Ar enc  .It Fl e Ar enc
 Encoding of the input stream specified by  Encoding of the input stream.
 .Fl i  The default is signed, 16-bit, native byte order.
 options that follow (the default is signed, 16-bit, native byte order).  
 .It Fl H Ar fmt  
 File format of the output stream specified by the  
 .Fl o  
 options that follow (the default is auto).  
 .It Fl h Ar fmt  
 File format of the input stream specified by  
 .Fl i  
 options that follow (the default is auto).  
 .It Fl f Ar device  .It Fl f Ar device
   The
 .Xr audio 4  .Xr audio 4
 device to use for playing and/or recording (the default is  device to use for playing and/or recording.
 .Pa /dev/audio ) .  The default is
   .Pa /dev/audio .
   .It Fl H Ar fmt
   File format of the output stream (see below).
   The default is auto.
   .It Fl h Ar fmt
   File format of the input stream (see below).
   The default is auto.
 .It Fl i Ar file  .It Fl i Ar file
 Add this file to the list of files to play.  Add this file to the list of files to play.
 The format of the file is specified by the last  The format of the file is specified by the last
 .Fl e ,  
 .Fl c ,  .Fl c ,
   .Fl e ,
   .Fl h ,
 and  and
 .Fl r  .Fl r
 options.  options.
Line 95 
Line 93 
 .It Fl o Ar file  .It Fl o Ar file
 Add this file to the list of files in which to store recorded samples.  Add this file to the list of files in which to store recorded samples.
 The format of the file is specified by the last  The format of the file is specified by the last
 .Fl E ,  
 .Fl C ,  .Fl C ,
   .Fl E ,
   .Fl H ,
 and  and
 .Fl R  .Fl R
 options.  options.
Line 104 
Line 103 
 .Sq -  .Sq -
 then standard output will be used.  then standard output will be used.
 .It Fl R Ar rate  .It Fl R Ar rate
 Sample rate in Hertz of the output stream specified by the  Sample rate in Hertz of the output stream.
 .Fl o  The default is 44100Hz.
 options that follow (the default is 44100Hz).  
 .It Fl r Ar rate  .It Fl r Ar rate
 Sample rate in Hertz of the input stream specified by  Sample rate in Hertz of the input stream.
 .Fl i  The default is 44100Hz.
 options that follow (the default is 44100Hz).  
 .It Fl u  .It Fl u
 Don't try to automatically determine the optimal parameters for the  Don't try to automatically determine the optimal parameters for the
 audio device;  audio device;
 instead use the parameters specified by the last  instead use the parameters specified by the last
 .Fl E ,  
 .Fl C ,  .Fl C ,
 .Fl R ,  
 .Fl e ,  
 .Fl c ,  .Fl c ,
   .Fl E ,
   .Fl e ,
   .Fl H ,
   .Fl h ,
   .Fl R ,
 and  and
 .Fl r  .Fl r
 options.  options.
 As for  For the
 .Fl i  .Fl i
 and  and
 .Fl o  .Fl o
 options, if the  options, if
 .Fl f  .Fl f
 option is used, then parameters must be specified before it.  is used then parameters must be specified before it.
 .El  .El
 .Pp  .Pp
 The following file formats are supported:  The following file formats are supported:
 .Pp  
 .Bl -tag -width s32lexxx -offset -indent  .Bl -tag -width s32lexxx -offset -indent
 .It raw  .It raw
 Headerless file.  Headerless file.
 It's recommended to use this format since it has no limitations.  This format is recommended since it has no limitations.
 .It wav  .It wav
 Microsoft WAVE file format.  Microsoft WAVE file format.
 There are limitations inherent to the file format itself:  There are limitations inherent to the file format itself:
 not all encodings are supported,  not all encodings are supported,
 file sizes are limited to 2GB,  file sizes are limited to 2GB,
 the file must support the  and the file must support the
 .Xr lseek 2  .Xr lseek 2
 operation (eg. pipes do not support it).  operation (e.g. pipes do not support it).
 .It auto  .It auto
 Try to guess, depending on the file name.  Try to guess, depending on the file name.
 .El  .El
Line 211 
Line 209 
 .Fl i  .Fl i
 nor  nor
 .Fl o  .Fl o
 options are specified,  are specified,
 .Nm  .Nm
 will run in legacy mode, in which case  will run in legacy mode, and won't convert sample formats or sampling rates.
 .Nm  
 does not convert sample formats or sampling rates.  
 In legacy mode, all options except  In legacy mode, all options except
 .Fl f Ar device  .Fl f
 are ignored and all other arguments are assumed to be names of files.  are ignored, and all other arguments are assumed to be names of files.
 In legacy mode  In legacy mode
 .Nm  .Nm
 reads files sequentially, and writes them to the specified device.  reads files sequentially, and writes them to the specified device.
Line 245 
Line 241 
 .Sh EXAMPLES  .Sh EXAMPLES
 The following command will record a stereo s16le stream at  The following command will record a stereo s16le stream at
 44100Hz from the default device.  44100Hz from the default device.
 If necesseary, the stream will be converted and/or resampled  If necessary, the stream will be converted and/or resampled
 to match parameters supported by the device:  to match parameters supported by the device:
 .Bd -literal -offset indent  .Bd -literal -offset indent
 $ aucat -o file.raw  $ aucat -o file.raw
Line 282 
Line 278 
 .Ed  .Ed
 .Sh SEE ALSO  .Sh SEE ALSO
 .Xr audioctl 1 ,  .Xr audioctl 1 ,
   .Xr cdio 1 ,
 .Xr mixerctl 1 ,  .Xr mixerctl 1 ,
 .Xr audio 4  .Xr audio 4
 .Sh BUGS  .Sh BUGS
Line 301 
Line 298 
 .Pp  .Pp
 Processing is done using 16-bit arithmetic,  Processing is done using 16-bit arithmetic,
 thus samples with more than 16 bits are rounded.  thus samples with more than 16 bits are rounded.
 16 bits (ie 97dB dynamic) are largely enough for most applications though.  16 bits (i.e. 97dB dynamic) are largely enough for most applications though.
Legend:
Removed from v.1.16  
changed lines
  Added in v.1.17