[resend,04/11] ASoC: soc-core: add NOTE to snd_soc_rtdcom_lookup()

Commit Message

Kuninori Morimoto Aug. 20, 2019, 5:05 a.m. UTC

From: Kuninori Morimoto <[e-mail]>

We can find specified name component via snd_soc_rtdcom_lookup().
But, it is not enough under multi CPU/Codec/Platform, because many
components which have same driver name might be connected to same rtd.

Not using this function as much as possible is best solution,
but some drivers are already deeply depended to it.

We can expand this function, for example having "num" which specifies
found order at parameter, etc (In such case, it need to have fixed
probing order).
Or, use different driver name in such component, etc.

We will have such issue if multi CPU/Codec/Platform were supported.
To indicate it, this patch adds NOTE to this function.

Signed-off-by: Kuninori Morimoto <[e-mail]>
Reviewed-by: Ranjani Sridharan <[e-mail]>
---
v2 -> v3

	- add Ranjani's Reviewed-by

 sound/soc/soc-core.c | 8 ++++++++
 1 file changed, 8 insertions(+)

Patch

diff --git a/sound/soc/soc-core.c b/sound/soc/soc-core.c
index 3860d85..0ed6576 100644
--- a/sound/soc/soc-core.c
+++ b/sound/soc/soc-core.c
@@ -315,6 +315,14 @@  struct snd_soc_component *snd_soc_rtdcom_lookup(struct snd_soc_pcm_runtime *rtd,
 	if (!driver_name)
 		return NULL;
 
+	/*
+	 * NOTE
+	 *
+	 * snd_soc_rtdcom_lookup() will find component from rtd by using
+	 * specified driver name.
+	 * But, if many components which have same driver name are connected
+	 * to 1 rtd, this function will return 1st found component.
+	 */
 	for_each_rtdcom(rtd, rtdcom) {
 		const char *component_name = rtdcom->component->driver->name;