diff options
Diffstat (limited to 'alsa-lib/NOTES')
| -rw-r--r-- | alsa-lib/NOTES | 56 |
1 files changed, 0 insertions, 56 deletions
diff --git a/alsa-lib/NOTES b/alsa-lib/NOTES deleted file mode 100644 index b318d1f..0000000 --- a/alsa-lib/NOTES +++ /dev/null @@ -1,56 +0,0 @@ -Old versus new PCM API (values returned using indirect pointers) -================================================================ - -From the binary compatibility view, there is no change. For compilation, -1.0 ALSA applications do not need any change. The older applications must -use this include sequence: - -#define ALSA_PCM_OLD_HW_PARAMS_API -#define ALSA_PCM_OLD_SW_PARAMS_API -#include <alsa/asoundlib.h> - -If you use already the new API, you may remove old defines selecting -this API, because they are no longer used: - -#define ALSA_PCM_NEW_HW_PARAMS_API -#define ALSA_PCM_NEW_SW_PARAMS_API - - -Verbose Error Messages -====================== - -Since version 1.0.8, assert() for some non-fatal errors are removed -and error messages are no longer shown to stderr as default. Instead, -the error messages appear only when the environment variable -LIBASOUND_DEBUG is set (to a non-empty value). - -When LIBASOUND_DEBUG=1 is set, the errors in hw_params configuration -will be dumped to stderr. Note that this will show even the non-fatal -errors of plug layer (trial-and-error of parameters). - -This feature is disabled when --with-debug=no is passed to configure, -i.e. no strict checking is done in alsa-lib. - -In addition, when --enable-debug-assert configure option is given and -when LIBASOUND_DEBUG_ASSERT=1 is set, the default error message -handler can call assert() to catch with a debugger. This feature was -formerly activated via LIBASOUND_DEBUG=2. - - -Blocking Open Mode -================== - -The default behavior of blocking at snd_pcm_open is changed to -non-blocking since version 1.0.11. That is, snd_pcm_open() returns --EAGAIN immediately when the device is in use and cannot be opened, -while the function was blocked in the former version. This influences -only on the opening behavior. The behavior of the further access, -read/write, poll or commit, are not changed. They follow the extra -flag argument of snd_pcm_open() as well as the former version. - -For taking back the compatible behavior of open blocking mode, set - - defaults.pcm.nonblock 0 - -in /etc/asound.conf or ~/.asoundrc file. - |