diff mbox series

[v2] ALSA: document that struct __snd_pcm_mmap_control64 is messed up

Message ID 20230406111545.2240797-1-oswald.buddenhagen@gmx.de (mailing list archive)
State Superseded
Headers show
Series [v2] ALSA: document that struct __snd_pcm_mmap_control64 is messed up | expand

Commit Message

Oswald Buddenhagen April 6, 2023, 11:15 a.m. UTC
On Thu, Apr 06, 2023 at 09:48:40AM +0200, Takashi Iwai wrote:
>The "BUG:" suffix should be dropped.  This would catch eyes of (badly)
>trained kernel programmers as if it were a kernel panic message :)
>
done

>Also the term "binary compatibility" is ambiguous in this context --
>especially because we're dealing with the code that treats the
>32/64bit binary compatibility.
>
i wasn't sure what to make of that. how about this:

-- >8 --

I'm not the first one to run into this, see e.g.
https://lore.kernel.org/all/29QBMJU8DE71E.2YZSH8IHT5HMH@mforney.org/

Signed-off-by: Oswald Buddenhagen <oswald.buddenhagen@gmx.de>
---
 include/uapi/sound/asound.h | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

Comments

Takashi Iwai April 6, 2023, 12:29 p.m. UTC | #1
On Thu, 06 Apr 2023 13:15:45 +0200,
Oswald Buddenhagen wrote:
> 
> On Thu, Apr 06, 2023 at 09:48:40AM +0200, Takashi Iwai wrote:
> >The "BUG:" suffix should be dropped.  This would catch eyes of (badly)
> >trained kernel programmers as if it were a kernel panic message :)
> >
> done
> 
> >Also the term "binary compatibility" is ambiguous in this context --
> >especially because we're dealing with the code that treats the
> >32/64bit binary compatibility.
> >
> i wasn't sure what to make of that. how about this:
> 
> -- >8 --
> 
> I'm not the first one to run into this, see e.g.
> https://lore.kernel.org/all/29QBMJU8DE71E.2YZSH8IHT5HMH@mforney.org/
> 
> Signed-off-by: Oswald Buddenhagen <oswald.buddenhagen@gmx.de>
> ---
>  include/uapi/sound/asound.h | 3 ++-
>  1 file changed, 2 insertions(+), 1 deletion(-)
> 
> diff --git a/include/uapi/sound/asound.h b/include/uapi/sound/asound.h
> index de6810e94abe..7eecc99ddef7 100644
> --- a/include/uapi/sound/asound.h
> +++ b/include/uapi/sound/asound.h
> @@ -570,7 +570,8 @@ struct __snd_pcm_mmap_status64 {
>  struct __snd_pcm_mmap_control64 {
>  	__pad_before_uframe __pad1;
>  	snd_pcm_uframes_t appl_ptr;	 /* RW: appl ptr (0...boundary-1) */
> -	__pad_before_uframe __pad2;
> +	__pad_before_uframe __pad2;	 // This should be __pad_after_uframe, but binary
> +					 // backwards compatibility constraints prevent a fix.

Looks much better.
Care to resubmit v2 patch?


Thanks!

Takashi
Oswald Buddenhagen April 6, 2023, 12:34 p.m. UTC | #2
On Thu, Apr 06, 2023 at 02:29:44PM +0200, Takashi Iwai wrote:
>Care to resubmit v2 patch?
>
that *was* a v2 patch - you can git-am the mail with --scissors (at 
least if i got it right). not acceptable?
Takashi Iwai April 6, 2023, 1:23 p.m. UTC | #3
On Thu, 06 Apr 2023 14:34:36 +0200,
Oswald Buddenhagen wrote:
> 
> On Thu, Apr 06, 2023 at 02:29:44PM +0200, Takashi Iwai wrote:
> > Care to resubmit v2 patch?
> > 
> that *was* a v2 patch - you can git-am the mail with --scissors (at
> least if i got it right). not acceptable?

Please resubmit properly.  Nowadays commits have the link to the mail
of the patch submission, and such mixup makes it harder to follow.


Takashi
diff mbox series

Patch

diff --git a/include/uapi/sound/asound.h b/include/uapi/sound/asound.h
index de6810e94abe..7eecc99ddef7 100644
--- a/include/uapi/sound/asound.h
+++ b/include/uapi/sound/asound.h
@@ -570,7 +570,8 @@  struct __snd_pcm_mmap_status64 {
 struct __snd_pcm_mmap_control64 {
 	__pad_before_uframe __pad1;
 	snd_pcm_uframes_t appl_ptr;	 /* RW: appl ptr (0...boundary-1) */
-	__pad_before_uframe __pad2;
+	__pad_before_uframe __pad2;	 // This should be __pad_after_uframe, but binary
+					 // backwards compatibility constraints prevent a fix.
 
 	__pad_before_uframe __pad3;
 	snd_pcm_uframes_t  avail_min;	 /* RW: min available frames for wakeup */