Imported Upstream version 4.2-build2006upstream/4.2-build2006upstream

4 files changed, 174 insertions, 0 deletions

diff --git a/misc/man7/dsp.man b/misc/man7/dsp.man
new file mode 100644
index 0000000..c7f9dad
--- /dev/null
+++ b/misc/man7/dsp.man
@@ -0,0 +1,66 @@
+NAME
+dsp - Open Sound System audio devices
+
+DESCRIPTION
+/dev/dsp is the default audio device in the system. It's connected to the
+main speakers and the primary recording source (such as microphone). The system
+administrator can set /dev/dsp to be a symbolic link to the desired default
+device. The ossinfo utility can be used to list the available audio devices
+in the system.
+
+/dev/dsp_mmap, /dev/dsp_ac3, /dev/dsp_multich and /dev/dsp_spdifout are
+default audio devices for specific applications such as games or media (DVD)
+players.
+
+DIRECT ACCESS AUDIO DEVICE FILES
+OSS 4.0 (and later) will create audio devices under /dev/oss/<device> directory.
+For example /dev/oss/sblive0/pcm0 is the first audio device that belongs to the
+first Sound Blaster Live! or Audigy card in the system. These direct devices
+are used when an application needs to access specific audio device (instead of
+the default one).
+
+You can use the ossinfo(1) utility with the -a option to get a list of the
+available audio devices in the system.
+
+LEGACY AUDIO DEVICE FILES
+Traditionally OSS has created device files like /dev/dsp0 to /dev/dspN for
+each audio device in the system. OSS 4.0 still supports this legacy naming.
+These files are symbolic links to the actual device files located under
+/dev/oss. The ossdevlinks(8) utility is used to manage these links and it
+will be automatically invoked when OSS is started.
+
+COMPATIBILITY
+o The /dev/dsp (default() audio device file will be supported by all OSS
+implementations and versions.
+o The special purpose audio default devices (such as /dev/dsp_mmap) are only
+supported by OSS 4.0 and later.
+o The legacy audio device files (such as /dev/dsp1) are supported by all OSS
+versions and implementations.
+o New style audio device files (under /dev/oss) are only supported by OSS 4.0
+and later. However some independent OSS implementations may only support
+the legacy naming even they are otherwise OSS 4.0 compatible.
+o /dev/dsp0 doesn't exist in all Linux systems which use /dev/dsp for the same
+purpose. In such systems /dev/dsp points to the first audio device and 
+/dev/dsp1 to the second.
+
+PROGRAMMING INFORMATION
+See the Audio Programming section of the OSS Programmer's Guide (DSP(2)) for
+more info.
+
+OPTIONS
+None
+
+FILES
+o /dev/dsp 		Default audio device
+o /dev/dsp_mmap 		Default audio device for applications using mmap(2)
+o /dev/dsp_ac3 		Default audio device for applications sending Dolby
+			Digital (AC3) audio to an external receiver.
+o /dev/dsp_multich 	Default multichannel (4.0-7.1) audio output device
+o /dev/dsp_spdifout	Default digital audio (S/PDIF) output device
+o /dev/oss/<driver>/pcmN 	Direct access device files for individual audio
+			devices.
+o /dev/dsp0 to /dev/dspN 	Legacy style direct access audio device files.
+
+AUTHOR
+4Front Technologies
+
diff --git a/misc/man7/midi.man b/misc/man7/midi.man
new file mode 100644
index 0000000..8ea1eeb
--- /dev/null
+++ b/misc/man7/midi.man
@@ -0,0 +1,20 @@
+NAME
+midi - Open Sound System MIDI devices
+
+DESCRIPTION
+MIDI support is not included in OSS 4.0. It will be introduced in the future OSS
+versions.
+
+PROGRAMMING INFORMATION
+See the OSS MIDI Programming section of the OSS Programmer's Guide (MIDI(2))
+for more info.
+
+OPTIONS
+None
+
+FILES
+/dev/midi is the default MIDI device file in the system.
+
+AUTHOR
+4Front Technologies
+
diff --git a/misc/man7/mixer.man b/misc/man7/mixer.man
new file mode 100644
index 0000000..c2f9849
--- /dev/null
+++ b/misc/man7/mixer.man
@@ -0,0 +1,20 @@
+NAME
+mixer - Open Sound System mixer (control panel) device
+
+DESCRIPTION
+Mixer devices are used by control panel and mixer programs (such as ossxmix(1))
+to change volumes and other settings of the sound cards in the system.
+
+PROGRAMMING INFORMATION
+See the OSS Mixer Programming section of the OSS Programmer's Guide (MIXER(2))
+for more info.
+
+OPTIONS
+None
+
+FILES
+/dev/mixer is the default mixer device file in the system.
+
+AUTHOR
+4Front Technologies
+
diff --git a/misc/man7/sndstat.man b/misc/man7/sndstat.man
new file mode 100644
index 0000000..ab2789b
--- /dev/null
+++ b/misc/man7/sndstat.man
@@ -0,0 +1,68 @@
+NAME
+sndstat - Open Sound System status device
+
+DESCRIPTION
+/dev/sndstat is a text formatted device special file that returns information
+about available (OSS) sound devices. This device file is obsolete and the
+ossinfo(1) utility should be used instead.
+
+Notice that the device numbering used in this file is different that the
+official numbering used by ossinfo(1) and some other utilities. /dev/sndstat
+uses device numbers that match the "legacy" /dev/dspN, /dev/midiN and
+/dev/mixerN device files.
+
+Application programs should not use /dev/sndstat to obtain information about the
+sound devices. The format of this file may change in the future and /dev/sndstat
+may even be removed from OSS in distant future. OSS 4.0 and later has an
+ioctl interface for getting detailed and reliable information about the
+devices.
+
+AUDIO USAGE HISTORY
+
+/dev/sndstat reports some history information about previously run audio
+applications. This section is a debugging aid for application developers and
+it will be moved to the ossinfo program in the future.
+
+For example:
+
+	History:
+	/dev/oss/hdaudio0/pcm0.10: pid 6326 cmd 'error_test' OUT Play events:01009:2 Rec events:01002:0
+	/dev/oss/hdaudio0/pcm0.10: pid 6329 cmd 'mpg123' OUT
+	/dev/oss/hdaudio0/pcm0.10: pid 6329 cmd 'mpg123' OUT
+	/dev/oss/hdaudio0/pcm0.10: pid 6329 cmd 'mpg123' OUT
+
+Each line will show the the device name, PID and name of the application
+(if known) and access mode (IN and/or OUT). There may also be additional
+info about buffer underruns/overruns and other recording and playback
+related events.
+
+Each Play and rec events consist of 5-6 digit event code and a parameter
+separated by a colon. A list of defined event codes and their explanations 
+can be found from http://manuals.opensound.com/developer/oss_error_codes.html.
+Purpose of these events is to inform application developers by potential
+problems in their code.
+
+COMPATIBILITY
+/dev/sndstat has been available in all OSS versions. However in OSS 4.0 and 
+later this device file should only be used by applications written for earlier
+OSS versions.
+
+OPTIONS
+None
+
+PROGRAMMING INFORMATION
+Some applications use /dev/sndstat to find the audio devices available
+in the system. This method is no longer recommended. Applications should use
+the SNDCTL_AUDIOINFO(2) ioctl call to find the devices.
+
+SEE ALSO
+o dsp(7) - Audio device files
+o mixer(7) - Mixer (control panel) device files
+o midi(7) - MIDI device files
+
+FILES
+/dev/sndstat
+
+AUTHOR
+4Front Technologies
+