6977966888
- Backport upstream fix patches, including the deadlock fix for aplay/arecord (boo#1031525): 0001-ucm-Add-ATTRIBUTE_UNUSED-for-unused-parameters-of-ex.patch 0002-ucm-parser-needs-limits.h.patch 0003-pcm-direct-allow-users-to-configure-different-period.patch 0004-pcm-dshare-enable-silence.patch 0005-pcm-rate-fix-the-hw_ptr-update-until-the-boundary-av.patch 0006-plugin-dynamically-update-avail_min-on-slave.patch 0007-rate-dynamic-update-avail_min-on-slave.patch 0008-topology-fix-unused-const-variable-warning.patch 0009-seq-improve-documentation-about-new-get-pid-card-fun.patch 0010-pcm-direct-returning-semop-error-code-for-semaphore-.patch 0011-pcm-direct-Fix-for-sync-issue-on-xrun-recover.patch 0012-pcm-direct-check-state-before-enter-poll-on-timer.patch 0013-pcm-direct-don-t-return-bogus-buffer-levels-in-xrun-.patch 0014-conf-ucm-broxton-add-broxton-rt298-conf-files.patch 0015-pcm-direct-Fix-deadlock-in-poll_descriptors.patch 0016-ucm-Assure-the-user-input-card-name-not-to-exceed-ma.patch 0017-ucm-Load-device-specific-configuration-file-based-on.patch 0018-ucm-Add-command-get-_file-to-get-the-config-file-nam.patch 0019-topology-Fix-incorrect-license-in-source-comments.patch 0020-conf-cards-add-support-for-pistachio-card.patch 0021-pcm-multi-Drop-the-fixed-slave_map-in-snd_pcm_multi_.patch 0022-conf-Add-card-config-for-Intel-HDMI-DP-LPE-audio.patch 0023-pcm-Avoid-lock-for-snd_pcm_nonblock.patch 0024-pcm-Disable-locking-in-async-mode.patch 0025-pcm-dmix-Allow-disabling-x86-optimizations.patch 0026-pcm-dmix_rewind-corrupts-application-pointer-fix.patch 0027-pcm-direct-fix-race-on-clearing-timer-events.patch 0028-pcm-file-Enable-file-writing-for-capture-path.patch OBS-URL: https://build.opensuse.org/request/show/483406 OBS-URL: https://build.opensuse.org/package/show/multimedia:libs/alsa?expand=0&rev=210
78 lines
2.9 KiB
Diff
78 lines
2.9 KiB
Diff
From 1eddf1f918845d1e6cbcac5516319b20cad80f2f Mon Sep 17 00:00:00 2001
|
|
From: Adam Goode <agoode@google.com>
|
|
Date: Tue, 3 Jan 2017 08:33:42 -0500
|
|
Subject: [PATCH 09/43] seq: improve documentation about new get pid/card
|
|
functions
|
|
|
|
Document the technique for determining if the running kernel supports
|
|
the new snd_seq_client_info_get_pid and snd_seq_client_info_get_card
|
|
functions. Also add a little information about how to use these
|
|
functions and add some cross references.
|
|
|
|
Signed-off-by: Adam Goode <agoode@google.com>
|
|
Signed-off-by: Takashi Iwai <tiwai@suse.de>
|
|
---
|
|
src/seq/seq.c | 44 ++++++++++++++++++++++++++++++++++++++++++--
|
|
1 file changed, 42 insertions(+), 2 deletions(-)
|
|
|
|
--- a/src/seq/seq.c
|
|
+++ b/src/seq/seq.c
|
|
@@ -1530,7 +1530,25 @@ int snd_seq_client_info_get_error_bounce
|
|
* \param info client_info container
|
|
* \return card number or -1 if value is not available.
|
|
*
|
|
- * Only available for SND_SEQ_KERNEL_CLIENT clients.
|
|
+ * Only available for #SND_SEQ_KERNEL_CLIENT clients.
|
|
+ *
|
|
+ * The card number can be used to query state about the hardware
|
|
+ * device providing this client, by concatenating <code>"hw:CARD="</code>
|
|
+ * with the card number and using it as the <code>name</code> parameter
|
|
+ * to #snd_ctl_open().
|
|
+ *
|
|
+ * \note
|
|
+ * The return value of -1 is returned for two different conditions: when the
|
|
+ * running kernel does not support this operation, and when the client
|
|
+ * does not have a hardware card attached. See
|
|
+ * #snd_seq_client_info_get_pid() for a way to determine if the
|
|
+ * currently running kernel has support for this operation.
|
|
+ *
|
|
+ * \sa snd_seq_client_info_get_pid(),
|
|
+ * snd_card_get_name(),
|
|
+ * snd_card_get_longname(),
|
|
+ * snd_ctl_open(),
|
|
+ * snd_ctl_card_info()
|
|
*/
|
|
int snd_seq_client_info_get_card(const snd_seq_client_info_t *info)
|
|
{
|
|
@@ -1543,7 +1561,29 @@ int snd_seq_client_info_get_card(const s
|
|
* \param info client_info container
|
|
* \return pid or -1 if value is not available.
|
|
*
|
|
- * Only available for SND_SEQ_USER_CLIENT clients.
|
|
+ * Only available for #SND_SEQ_USER_CLIENT clients.
|
|
+ *
|
|
+ * \note
|
|
+ * The functionality for getting a client's PID and getting a
|
|
+ * client's card was added to the kernel at the same time, so you can
|
|
+ * use this function to determine if the running kernel
|
|
+ * supports reporting these values. If your own client has a valid
|
|
+ * PID as reported by this function, then the running kernel supports
|
|
+ * both #snd_seq_client_info_get_card() and #snd_seq_client_info_get_pid().
|
|
+ *
|
|
+ * \note
|
|
+ * Example code for determining kernel support:
|
|
+ * \code
|
|
+ * int is_get_card_or_pid_supported(snd_seq_t *seq)
|
|
+ * {
|
|
+ * snd_seq_client_info_t *my_client_info;
|
|
+ * snd_seq_client_info_alloca(&my_client_info);
|
|
+ * snd_seq_get_client_info(seq, my_client_info);
|
|
+ * return snd_seq_client_info_get_pid(my_client_info) != -1;
|
|
+ * }
|
|
+ * \endcode
|
|
+ *
|
|
+ * \sa snd_seq_client_info_get_card()
|
|
*/
|
|
int snd_seq_client_info_get_pid(const snd_seq_client_info_t *info)
|
|
{
|