play(1) [redhat man page]
play(1) General Commands Manual play(1) NAME
play - play any sound file to audio device rec - record audio to any sound file format SYNOPSIS
play [fopts] infile [effect] rec [fopts] outfile [effect] DESCRIPTION
This manual page briefly documents the play and rec commands. play and rec are programs that allow you to play and record different types of sound files from the command line. They are front ends to the more general sox(1) package. Normally, the play command will automatically detect the type and other parameters of the soundfile. If it can't do so, the parameters can be changed through options. OPTIONS
A summary of common options are included below. For a complete description of options and their values, see the sox(1) man page. -c [channels], --channels=[channels] Define the number of channels in the file. -d [device], --device=[device] Specify a different device to play the sound file to. -f [format], --format=[format] Specify bit format of the sample. One of s, u, U, A, a, or g. -r [rate], --rate=[rate] Specify the sample rate of the audio data (samples per second). -s [size], --size=[size] Specify the width of each sample. One of b, w, l, f, d, or D. -t [type], --type=[type] Specify audio file format to use. Useful if it can not be automatically determined. -v [volume], --volume=[volume] Change the audio volume -x , --xinu Reverse the byte order of the sample (only works with 16 and 32-bit data). -h, --help Show summary of options. --version Show version of play/rec. Description of effects are described in the sox(1) man page. SEE ALSO
sox(1) soxexam(1) AUTHOR
This manual page was written by Guenter Geiger <geiger@iem.mhsg.ac.at>, for the Debian GNU/Linux system. Updates by Anonymous. December 11, 2001 play(1)
Check Out this Related Man Page
audiots(7D) Devices audiots(7D) NAME
audiots - Acer Laboratories Inc. M5451 audio processor interface DESCRIPTION
The audiots device uses the ALI M5451 audio processor and an AC-97 Codec to implement the audio device interface. APPLICATION PROGRAM INTERFACE
This interface is described in the mixer(7I) and audio(7I) man pages. Driver Versions Applications that open /dev/audio may use the AUDIO_GETDEV ioctl(2) to determine which audio device is being used. The audiots driver will return the string SUNW,audiots in the name field of the audio_device structure. The version field will contain a letter (defined in the ta- ble below) and the config field will contain the string onboard1. Platform Ver. Out H. Phone Spkr. In Mic. CD Sun Blade 100 a Y Y Y Y Y N Key to the above table: Ver. = Version. Out = Line Out. H. Phone = Head Phone. Spkr = Internal Speaker. In = Line In. Mic. = Microphone. CD = CD=ROM The audiots device provides support for the internal speaker, headphone, line out, line in, and microphone. The play.mod_ports and record.mod_ports fields of the audio_info structure (see audio(7I)) indicate which ports may be manipulated. Audio Mixer Mode The configuration file /kernel/drv/audiots.conf is used to configure the audiots driver so that the audio mixer is enabled or disabled. See the mixer(7I) manual page for details. The audio mixer mode may be changed at any time using the sdtaudiocontrol(1) or mixerctl(1) com- mands. Audio Data Formats The audiots device supports 8-bit u-law and A-law, 8-bit linear and 16-bit linear encodings in mono and stereo. With the mixer enabled, a continuous range of sample rates from 5510 to 48000 Hz is supported. With the mixer disabled, the following sample rates are supported: 5510, 6620, 8000, 9600, 11025, 16000, 18900, 22050, 27420, 32000, 33075, 37800, 4410, and 48000 Hz. When the audio mixer is disabled and the device is opened for simultaneous play and record, the input and out data formats may be different. Sample Granularity Because the audiots device manipulates buffers of audio data, the reported input and output sample counts will vary at any given time from the actual sample count by no more than the size of the buffers the audiots driver is transferring. In general, programs should not rely on the absolute accuracy of the play.samples and record.samples fields of the audio_info structure. Interrupt Rate The driver determines how often play and record interrupts should take place. For playing audio, this determines how often and how much audio is requested from the audio mixer. The impact of interrupts on recording is minimal. However, if a very small read buffer size is set, the record interrupt rate should be increased to prevent the buffer from overflowing. The play and record interrupt rates are tunable in the /kernel/drv/audiots.conf file. Audio Status Change Notification As described in the audio(7I) and mixer(7I) man pages, it is possible to request asynchronous notification of changes in the state of an audio device. ERRORS
audiots errors are described in the audio(7I) man page. FILES
/dev/audio Symbolic link to the system's primary audio device. (Not necessarily an audiots audio device). /dev/audioctl Control device for the primary audio device. /dev/sound/0 Represents the first audio device on the system. (Not necessarily an audiots audio device). /dev/sound/0ctl Audio control for /dev/sound/0. /usr/share/audio/samples Audio sample files. /kernel/drv/sparcv9/audiots 64-bit audiots driver /kernel/drv/audiots.conf audiots driver configuration file. ATTRIBUTES
See attributes(5) for a descriptions of the following attributes: +--------------------+--------------------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +--------------------+--------------------------------------+ |Architecture |SPARC | +--------------------+--------------------------------------+ |Availability |SUNWaudd, SUNWauddx, SUNWauda | +--------------------+--------------------------------------+ |Stability level |Evolving | +--------------------+--------------------------------------+ SEE ALSO
mixerctl(1), sdtaudiocontrol(1), ioctl(2), attributes(5), audio(7I), mixer(7I), streamio(7I) Acer Laboratories Inc. M5451 PCI Audio Processor Technical Specification http://www.sun.com/io DIAGNOSTICS
In addition to being logged, the following messages may appear on the system console: init_state() play interrupt rate set too low The play interrupt rate in audiots.conf is set too low. It has been reset to the rate specified in the message. Update audiots.conf to a higher play interrupt rate. init_state() play interrupt rate set too high The play interrupt rate set in audiots.conf is set too high. It has been reset to the rate specified in the message. Update audiots.conf to a lower play interrupt rate. init_state() record interrupt rate set too low The record interrupt rate in audiots.conf is set too low. It has been reset to the rate specified in the message. Update audiots.conf to a higher record interrupt rate. init_state() record interrupt rate set too high The record interrupt rate in audiots.conf is set too high. It has been reset to the rate specified in the message. Update audiots.conf to a lower record interrupt rate. SunOS 5.11 23 Aug 2002 audiots(7D)