2 files changed, 112 insertions, 0 deletions
diff --git a/cmd/ossrecord/.changelog b/cmd/ossrecord/.changelog
new file mode 100644
index 0000000..956e623
--- /dev/null
+++ b/cmd/ossrecord/.changelog
@@ -0,0 +1,2 @@
+20080211 by Hannu: Added capability to record to stdout.
+20080212 by Hannu: Added -a (amplification) option.
diff --git a/cmd/ossrecord/ossrecord.man b/cmd/ossrecord/ossrecord.man
new file mode 100644
index 0000000..fbccc5d
--- /dev/null
+++ b/cmd/ossrecord/ossrecord.man
@@ -0,0 +1,110 @@
+NAME
+ossrecord - Open Sound System recording program.
+
+SYNOPSIS
+ossrecord [-ORhlv] [-F cntname | ? ] [ -c channels ] [ -d devname ]
+          [ -f fmtname | ? ] [ -g gain ] [ -i recsource | ? ] [ -m nfiles ]
+          [ -r command ] [ -s rate ] [ -t maxsecs ] filename | - ...
+
+
+DESCRIPTION
+The ossrecord program records audio in Microsoft RIFF (wav) format. It
+will record from any input that's currently set as the recording source
+by the ossxmix/ossmix mixer programs. With the -l option, you also get
+a level meter that will display VU levels in a character mode.
+
+The filename parameter is name of the (.wav) file to be produced. Output can be
+sent to stdout by giving - as the file name.
+
+OPTIONS
+-s<rate> 	Select the recording rate for raw PCM audio (eg -s48000).
+-c<channels> 	Select the number of channels 1=mono 2=stereo, 4, 6, 8, etc. 
+-d<devname>  	Select <devname> as the device (eg -d/dev/dsp2).
+-f<fmt>		Select the input sample format (eg -fS32_LE or -fMU_LAW)
+-f?		Prints the list of supported format names.
+-F<cnt>		Select the container format (eg WAV or AU). Default is WAV.
+-F?		Prints the list of supported container formats.
+-R		Open audio device in raw mode to disable virtual mixing and
+		sample rate/format conversions. Can be used when recording
+		from a digital source (S/PDIF input).
+-v		Verbose output.
+-l		Display level meters (character based).
+-i<recsrc|?> 	Select the recording source or display available recording 
+		sources if '?' is supplied.
+		e.g. ossrecord -i? may display:
+			        vol
+        			line (currently selected)
+        			mic
+        			cd
+        			aux1
+        			phone
+        			mono
+        			video
+-m<nfiles> 	Repeat the recording operation <nfiles> times. The filename
+		argument must have %d (or %02d) somewhere in the file to
+		guarantee unique filenames. If no %d is given then subsequent
+		recordings will overwrite the previous one(s). This option is
+		useful only with loopback audio devices or if the -t option
+		is used.
+-r<command> 	This option launches the <command> in background after 
+		recording the file has completed. The name of the recorded file
+		will be given as the (only) command line argument. When the -m 
+		option is used the script will run in parallel while recording
+		the next file. See the COMMAND SCRIPT section (below) for more
+		info.
+-g<gain>	Amplify recorded samples by percentage given as argument.
+		100 (default) means normal signal level, 200 means double level.
+		Only supported in 16 and 32 bit modes.
+-t<maxsecs>	Do not record more than <maxsecs> seconds in a single recording
+		operation.
+-L<level>	Set the recording level to <level>.
+-O             Do not allow ossrecord to overwrite the output file.
+-h		Display usage instructions.
+
+COMMAND SCRIPT
+		The -r command line argument makes it possible to execute a
+		script or program after recording of the wave file is finished.
+		Below is a simple scell script that does MP3 encoding using
+		lame.
+
+#!/bin/sh
+
+WAVENAME=$1
+
+MP3NAME=$1.mp3
+
+lame -m s -h --preset studio $WAVENAME $MP3NAME
+
+exit 0
+
+Another example script for ossrecord is a simple CGI script for live MP3
+streaming (from /dev/dsp).
+
+#!/bin/sh
+
+echo Content-Type: audio/mp3
+
+echo
+
+ossrecord -S -b16 -s48 - | lame -m j - -
+
+exit 0
+
+NOTES
+The ossrecord executable is the same as the ossplay executable.
+Behaviour is decided by the name used to invoke the program.
+
+Some file formats allocate only 32 bits to record the file length,
+which may prevent some programs from reading a too large file properly.
+If a recording may pass the 4GB limit (a bit more then 6 hours and 10 minutes
+of sound assuming [48Khz/16bit/stereo] quality), it's best to have ossrecord
+use the AU or RAW containers (via -F switch) which do not have this restriction.
+
+SEE ALSO
+ossplay(1), ossmix(1), ossxmix(1)
+
+FILES
+/usr/bin/ossrecord
+
+AUTHOR
+4Front Technologies