Copyright (C) 1997,1998,1999
Oliver Fromme. All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
3. Neither the name of the author nor the names of any co-contributors
may be used to endorse or promote products derived from this software
without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY OLIVER FROMME AND CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL OLIVER FROMME OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.

@(#)$Id: pcmplay.1,v 1.3 1999/01/01 23:31:54 olli Exp $

pcmplay 1 "21 May 1997"
NAME
pcmplay - play PCM files on audio device
SYNOPSIS
pcmplay [ -un ] [ -d " dev" ] [ -b " size" ] [ -s " bits" ] [ -f " freq" ] [ -c " num" ] [ -g " gain" ] file " ... | " -
DESCRIPTION
pcmplay reads one or more file\^ s (or standard input if ``-'' is specified) and plays them on the audio device. file is assumed to be a headerless (``raw'') PCM audio file.
OPTIONS
pcmplay options may be either the traditional POSIX one letter options, or the GNU style long options. POSIX style options start with a single ``-'', while GNU long options start with ``-\^-''.

-u ", " -\^-unsigned The audio data is assumed to be unsigned. The default is signed data.

-n ", " -\^-network The audio data is assumed to be in network byte order (also called ``big-endian''). The default is intel byte order (``little-endian''). This option only applies to 16 bit samples.

-d device, -\^-device dev Specify the audio device to use. The default is /dev/dsp.

-b size, -\^-buffer size Use an audio output buffer of size Kbytes, the default is 32 Kbytes. If you experience short hangs in the audio output, you might try to reduce or enlarge the buffer with this option.

-s bits, -\^-bits bits Specify the number of bits per sample. This must be either 8 or 16 (the default is 16).

-f freq, -\^-frequency freq Specify the sampling frequency in Hertz (Hz). The default is 44100 Hz.

-c num, -\^-channels num Specify the number of channels. This must be either 1 (mono) or 2 (stereo). The default is 2.

-g gain, -\^-gain gain Set audio hardware output gain (default: don't change).

OPERANDS
The following operands are supported:

8 file (s) The path name(s) of one or more input files. If a dash ``-'' is specified, PCM data will be read from the standard input. Input data is assumed to be appropriate PCM audio files. However, since they are headerless (raw), it is not possible to recognize invalid files, so it is possible to specify any type of file.

BE CAREFUL: Playing inappropriate data at a too high volume can damage your audio hardware and speakers! Turn the volume down before playing anything with this program, unless you are absolutely sure that your equipment can handle it. Use this program at your own risk!

"SEE ALSO"
mpg123 (1), tosha (1), pcmfade (1), sox (1), intro (1)
NOTES
If you don't use any options, input data is assumed to be linear PCM, 44.1 kHz, signed 16 bit stereo in intel byte order (little-endian). This is the format of CD audio tracks.

pcmplay does not perform any data conversion. Use sox (1) if you need to convert sample rates, number of channels or other parameters.

Your soundcard must support the specified type of audio data. For example, you cannot play 16 bit samples on an 8 bit soundcard.

BUGS
Yes. This is an alpha version.
AUTHOR
Copyright (C) 1997-1999

Oliver Fromme <oliver.fromme@heim3.tu-clausthal.de>

All rights reserved. For more information, please refer to the file LICENCE which is included with the source distribution.

Internet references:

http://www.heim3.tu-clausthal.de/~olli/tosha/

That's the homepage of the CD-DA reader tosha (1) which also contains the latest version of pcmplay .