← Back to branch summary

~ubuntu-branches/ubuntu/vivid/oss4/vivid

« back to all changes in this revision

Viewing changes to cmd/osstest/osstest.man

  • Committer: Bazaar Package Importer
  • Author(s): Romain Beauxis, Samuel Thibault, Romain Beauxis, Sebastien NOEL
  • Date: 2011-06-14 10:06:56 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20110614100656-cx4oc7u426zn812z
Tags: 4.2-build2004-1
http://bugs.debian.org/589127
http://bugs.debian.org/604679
http://bugs.debian.org/595298
http://bugs.debian.org/619272
http://bugs.debian.org/627149
http://bugs.debian.org/628879
[ Samuel Thibault ]
* debian/control: Add liboss4-salsa2, liboss4-salsa-dev and
  liboss4-salsa-asound2 packages, equivalent to (and will replace) those from
  the oss-libsalsa package (Closes: #589127).
* debian/patches/liboss4-salsa.patch: New patch to rename libsalsa into
  liboss4-salsa to avoid conflicts in the archive for no good reason.
* debian/rules: Make in libOSSlib and libsalsa.
* debian/liboss4-salsa-dev.install, debian/liboss4-salsa2.install,
  debian/liboss4-salsa-asound2.links, debian/liboss4-salsa-dev.links:
  Install liboss4-salsa libraries like was done in the oss-libsalsa package.
* include-alsa: Add a copy of ALSA 1.0.5 headers: Cf ALSA_1.0.* symbols in
  libsalsa, this is the roughly supported version.
* debian/copyright: Update for new include-alsa files.
* alsa.pc: New file for compatibility with libasound-dev.
* debian/control:
  - Add Vcs-Browser and Vcs-Svn fields.
  - Use linux-any instead of the list of Linux archs (Closes: #604679).
  - Make dkms dependency linux-any only.
* debian/patches/hurd_iot.patch: New patch to fix soundcard.h usage in
  libsalsa on hurd-i386.
* debian/patches/libsalsa_fixes.patch: New patch to fix some printf usages
  and ioctl declaration in libsalsa.
* debian/patches/no_EBADE.patch: New patch to cope with hurd-i386 not having
  EBADE.
* debian/patches/CFLAGS.patch: New patch to make oss4 take debian/rules
  CFLAGS into account.
* debian/patches/snd_asoundlib_version.patch: New patch to add
  snd_asoundlib_version().
* debian/patches/generic_srccconf.patch: New patch to fix source
  configuration on unknown archs.

[ Romain Beauxis ]
* Fixed README.Debian to only mention dkms' modules.
* Switch to dpkg-source 3.0 (quilt) format
* Added DM-Upload-Allowed: yes

[ Sebastien NOEL ]
* New upstream release (Closes: #595298, #619272).
* Fix typo in initscript (Closes: #627149).
* debian/control: adjust linux-headers dependencies (Closes: #628879).

Show diffs side-by-side

added added

removed removed

Lines of Context:
cmd/osstest/osstest.man
 
1
NAME
 
2
osstest - Open Sound System audio self test applet.
 
3
 
 
4
DESCRIPTION
 
5
The osstest applet is a simple test application that can be used to test 
 
6
functionality of the sound hardware installed in the system.
 
7
 
 
8
osstest performs a playback test for each installed audio device. If there
 
9
are any "machine detectable" problems they will be reported. You will first
 
10
hear an audio sample played on the left speaker, then the right speaker and
 
11
finally in stereo on both speakers.
 
12
 
 
13
It's user's responsibility to listen if the test sound is audible. If no
 
14
sound output can be heard the possible reason is one of the following:
 
15
 
 
16
1. An error was reported by osstest. In this case there will usually not be
 
17
any sound output. The error needs to be fixed before running osstest
 
18
again.
 
19
2. There is no headphones or speakers connected. Or the connection is not
 
20
made correctly.
 
21
3. The mixer volume level is set to a too low value. By default it should
 
22
be OK. The mixer level can be adjusted using the mixer, ossmix and ossxmix
 
23
utilities distributed with OSS.
 
24
4. Some notebooks have nonstandard volume control and/or speaker selection
 
25
hardware that is not supported by OSS. It's very likely that OSS doesn't
 
26
support such vendor specific additions.
 
27
 
 
28
If no errors were reported and the test sound was audible it means that
 
29
OSS and your sound hardware is functioning correctly. If you still encounter
 
30
problems with some sound applications the reason is almost certainly in
 
31
the application. Check it's configuration or try to use another equivivalent
 
32
application. 
 
33
 
 
34
If you are having problems with JDS, KDE and/or Gnome system sounds, you need
 
35
to make sure that OSS gets started before the GUI environment. Refer to your
 
36
operating system's startup procedures.
 
37
 
 
38
 SAMPLE RATE DRIFT
 
39
 
 
40
The osstest utility measures a sample rate drift value after playing
 
41
back the test sound. Ideally it should be 0% but in practice there
 
42
will be an error of few percents. 0% means that the 48000 Hz test file
 
43
was played exactly at 48000 Hz sampling rate.
 
44
 
 
45
The sample rate measurement is based on the system timer which has limited
 
46
precision. It's likely that less than 1% differenc between the nominal and 
 
47
the measured sampling rates are actually caused by an error in the measurement.
 
48
For this reason the drift reported by osstest should not be used as any kind of
 
49
quality measurement. However if the drift is very large it means that there is
 
50
something wrong in the system. The oscillator chip used with the sound chip is
 
51
broken or the system clock is running at a wrong speed.
 
52
 
 
53
 USING OSSTEST MANUALLY
 
54
 
 
55
The osstest utility is located in the /usr/bin directory. It can be run 
 
56
manually to test functionality of OSS and your sound hardware. When invoked 
 
57
without any command line parameters osstest performs the default test on all 
 
58
devices. However it will skip some of the devices base on the following rules.
 
59
 
 
60
o It is possible to test just one of the available audio devices by giving
 
61
its number on command line (for example osstest 1). Use the device index
 
62
numbers reported by "ossinfo -a".
 
63
o Use the -l command line option to loop the test infinitely.
 
64
o Virtual mixer devices will not be tested. Use the -V command line option to
 
65
force test of virtual devices.
 
66
o The actual (physical) audio devices will be tested directly (bypassing
 
67
virtual mixer). If you want to test playback through vmix then use the
 
68
-V option.
 
69
o Multiple device files related with the same physical device will not
 
70
be tested. Only the first one gets tested while the remaining ones will be
 
71
skipped. At this moment there is no way to force osstest to test this kind of
 
72
devices.
 
73
o Only stereo devices will be tested. Future versions of osstest will be
 
74
able to test mono and multi channel devices too. Also osstest requires that
 
75
the device supports the 16 bit signed format and 48kHz sampling rate.
 
76
o Send a SIGQUIT (Ctrl-\e on most terminals) to make osstest skip a device.
 
77
 
 
78
FILES
 
79
/usr/bin/osstest
 
80
 
 
81
SEE ALSO
 
82
savemixer(1)
 
83
 
 
84
AUTHOR
 
85
4Front Technologies