summaryrefslogtreecommitdiff
path: root/INSTALL
Commit message (Collapse)AuthorAgeFilesLines
* pcm: Add thread-safety to PCM APITakashi Iwai2016-07-111-0/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Traditionally, many of ALSA library functions are supposed to be thread-unsafe, and applications are required to take care of thread safety by themselves. However, people never be careful enough, and almost all applications fail in this regard. This patch is an attempt to harden the thread safety in exported PCM functions in a simplistic way: just wrap some of exported functions with the pthread mutex of each PCM object. Not all API functions are wrapped by the mutex since it doesn't make sense. Instead, the patchset covers only the functions that may be likely called concurrently. The supposedly thread-safe API functions are marked in the document. For achieving the feature, two new fields are added snd_pcm_t when the option is enabled: thread_safe and lock. The former indicates that the plugin is thread-safe that doesn't need this workaround and the latter is the pthread mutex. Currently only hw plugin have thread_safe=1. So, the most of real-time sensitive apps won't be influenced by this patchset. Although the patch covers most of PCM ops, a few snd_pcm_fast_ops are left without the extra mutex locking: namely, the ones that may have blocking behavior, i.e. resume, drain, readi, writei, readn and writen. These are supposed to handle own locking in the callbacks. Also, if anyone wants to disable this new thread-safe API feature, it can be still turned off via --disable-thread-safety configure option. Signed-off-by: Takashi Iwai <tiwai@suse.de>
* INSTALL: update text and drop reference to HgHenrik Austad2016-06-211-5/+10
| | | | | | | | | | | This is really just nitpick, but it annoyed me for a few seconds, so I thought I'd just fix it. In d7534b2ceec7 (hgcompile -> gitcompile) the filename was updated but INSTALL was not, leaving outdated docs. Signed-off-by: Henrik Austad <henrik@austad.us> Signed-off-by: Takashi Iwai <tiwai@suse.de>
* doc: fix cross-compiling exampleDmitry Voytik2014-08-251-6/+3
| | | | | | | | | Simplest way to configure cross-compilation with configure script is to pass '--host' option. Passing just '--target' doesn't work. Signed-off-by: Dmitry Voytik <voytikd@gmail.com> Signed-off-by: Takashi Iwai <tiwai@suse.de>
* Add hgcompile script and fix INSTALL documentTakashi Iwai2006-05-121-4/+4
| | | | | Added hgcompile script (just a copy of cvscompile), and fixed INSTALL document about HG.
* Add description for new configure optionsTakashi Iwai2005-11-301-4/+31
| | | | | Add description for new configure options. Also fixed some typos.
* Add a note on FC3Takashi Iwai2005-02-241-0/+14
| | | | Added a note on installation on FC3.
* Remove JACK pluginTakashi Iwai2005-02-241-7/+1
| | | | Removed JACK plugin. It's in alsa-plugins now.
* Added note about jack pluginJaroslav Kysela2003-03-101-0/+11
|
* duplicated the required alsa-kernel header files into the localTakashi Iwai2002-10-091-49/+4
| | | | | | | | | | include/sound directory, so that alsa-lib can be compiled without alsa-driver. with this addition, --with-kernel and --with-soundbase options are removed from configure. they are obviously unnecessary. the relevant parts in INSTALL are removed/modified.
* Added HAVE_SOFT_FLOAT (--with-softfloat)Jaroslav Kysela2002-04-241-0/+8
|
* Added support for --with-hostJaroslav Kysela2002-03-031-0/+37
|
* Added section for installation using Linux kernel sourcesJaroslav Kysela2002-02-171-4/+28
|
* A bit updatedJaroslav Kysela2001-11-261-1/+5
|
* Changes for static build.Jaroslav Kysela2001-10-241-1/+12
|
* First version...Jaroslav Kysela1998-12-301-0/+37