alsa-lib/src
Takashi Sakamoto 6d951ddf00 ctl: deprecate APIs of dimensional information
In ALSA control interface in asound.h, 'struct snd_ctl_elem_info' has
'dimen' member to deliver information for multi-dimensional array, however
there's no common way to handle the member. As a result, drivers can
force userspace applications to handle the information by inconsistent
ways.

This issue was reported by a commit 51db452df07b ('Revert "ALSA: echoaudio:
purge contradictions between dimension matrix members and total number of
members"') to Linux kernel. As a result of discussion at Linux
miniconference 2017, usage of 'dimen' member of 'struct snd_ctl_elem_info'
is going to be deprecated for future removal.

A removal of kernel interface can cause regression issues. However no ALSA
driver in kernel land except for 'echoaudio' series utilizes this feature.
Actually it's reasonable to assume that 'echomixer' program is an unique
consumer of the interface in user land and the removal rarely brings any
impact to user land.

This commit deprecates some APIs corresponding to the kernel interface. The
kernel interface is kept till Linux kernel v4.20 at least, but actual
timing of removal is not fixed yet. After that, these APIs may also be
removed at a reasonable timing.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>
Signed-off-by: Takashi Iwai <tiwai@suse.de>
2017-11-13 16:56:55 +01:00
..
alisp conf: Allow dynamic top-level config directory 2017-05-03 09:54:16 +02:00
conf conf/ucm: rt5651: Mute speakers on boot 2017-11-08 15:10:20 +01:00
control ctl: deprecate APIs of dimensional information 2017-11-13 16:56:55 +01:00
hwdep conf: Add thread-safe global tree reference 2016-05-17 15:51:20 +02:00
mixer conf: Allow dynamic top-level config directory 2017-05-03 09:54:16 +02:00
pcm pcm: softvol: add support for S24_LE 2017-09-18 15:36:08 +02:00
rawmidi rawmidi: symbols: use rawmidi_virt only when available 2017-08-12 23:40:19 +02:00
seq seq: fix snd_seq_set_queue_tempo() usage example in the documentation 2017-10-03 09:11:44 +02:00
timer conf: Add thread-safe global tree reference 2016-05-17 15:51:20 +02:00
topology alsa-lib: topology: fix DSP_B mode string 2017-11-01 17:42:12 +01:00
ucm conf: Allow dynamic top-level config directory 2017-05-03 09:54:16 +02:00
async.c async: Handle previously installed signal handler 2016-06-01 08:16:31 +02:00
conf.c conf: Check the availability of PTHREAD_MUTEX_RECURSIVE 2017-05-16 16:26:20 +02:00
confmisc.c conf: Allow dynamic top-level config directory 2017-05-03 09:54:16 +02:00
dlmisc.c dlmisc: Remove unused label 2014-11-16 09:43:39 +01:00
error.c all places: doxygen cleanups 2013-04-08 16:42:24 +02:00
input.c Make all the remaining ops structure constants. 2008-11-21 20:48:33 +01:00
Makefile.am topology: autotools: Add build support for topology core 2015-07-30 17:10:14 +02:00
names.c Remove docs for snd_names_list and snd_names_list_free 2012-01-19 12:35:20 +01:00
output.c fix doc errors 2009-08-04 09:17:20 +02:00
shmarea.c cleanup: fix poll.h includes 2017-07-12 12:05:37 +02:00
socket.c Remove unused hostname resolution in shm plugins and aserver 2015-01-28 16:23:06 +01:00
userfile.c snd_user_file: avoid use wordexp 2017-07-15 09:57:46 +02:00
Versions.in Fix wrong exported functions 2008-02-04 14:15:44 +01:00