Re: [RFC PATCH] ALSA: Add debugging guide for audio issues

From: Jonathan Corbet
Date: Thu Nov 07 2024 - 16:40:26 EST


Randy Dunlap <rdunlap@xxxxxxxxxxxxx> writes:

> On 11/7/24 12:45 PM, Jonathan Corbet wrote:
>> anish kumar <yesanishhere@xxxxxxxxx> writes:
>>
>>> Add a comprehensive debugging guide for ALSA audio issues, covering
>>> topics from bootup to runtime debugging. This document aims to help
>>> developers diagnose and resolve common audio problems in Linux.
>>>
>>> The guide includes sections on:
>>> - Bootup/bringup issues
>>> - Runtime debugging
>>> - XRUN debugging
>>> - Audio pops and clicks
>>>
>>> This addresses the lack of a centralized debugging resource for ALSA
>>> and should help improve the troubleshooting process for audio drivers.
>>>
>>> Inspired by discussions on LKML:
>>> https://lkml.org/lkml/2024/9/24/392
>>>
>>> Signed-off-by: anish kumar <yesanishhere@xxxxxxxxx>
>>> ---
>>> Documentation/sound/soc/debug.rst | 334 ++++++++++++++++++++++++++++++
>>> Documentation/sound/soc/index.rst | 1 +
>>> 2 files changed, 335 insertions(+)
>>> create mode 100644 Documentation/sound/soc/debug.rst
>>
>> At a first glance, this seems useful.
>>
>> I was just looking at Sebastian's new debugging documentation:
>>
>> https://lore.kernel.org/all/20241028-media_docs_improve_v3-v1-0-2b1b486c223e@xxxxxxxxxxxxx/
>>
>> ... so my immediate thought is that this documentation should be
>> coherent and together, rather than scattered though the docs. Maybe
>> move this to process/debugging and integrate it with his work?
>
> and once again I disagree that these docs should be in Documentation/process/.

OK, I guess I missed that...where do you think we should put them?

jon