Re: [PATCH] drm/uapi: Add a warning that mode flags must match the xrandr definitions

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Thu, Nov 03, 2016 at 04:10:01PM +0200, ville.syrjala@xxxxxxxxxxxxxxx wrote:
> From: Ville Syrjälä <ville.syrjala@xxxxxxxxxxxxxxx>
> 
> Existing userspace expected the mode flags to match the xrandr
> definitions 1:1, and even adding new flags in he previously unused
> bits is likely to break existing userspace. Add a comment warning
> people about this potential trap.
> 
> Cc: Shashank Sharma <shashank.sharma@xxxxxxxxx>
> Cc: "Lin, Jia" <lin.a.jia@xxxxxxxxx>
> Cc: Akashdeep Sharma <akashdeep.sharma@xxxxxxxxx>
> Cc: Jim Bride <jim.bride@xxxxxxxxxxxxxxx>
> Cc: Jose Abreu <Jose.Abreu@xxxxxxxxxxxx>
> Cc: Daniel Vetter <daniel.vetter@xxxxxxxx>
> Cc: Emil Velikov <emil.l.velikov@xxxxxxxxx>
> Signed-off-by: Ville Syrjälä <ville.syrjala@xxxxxxxxxxxxxxx>

Applied to drm-misc, thanks.
-Daniel

> ---
>  include/uapi/drm/drm_mode.h | 10 +++++++++-
>  1 file changed, 9 insertions(+), 1 deletion(-)
> 
> diff --git a/include/uapi/drm/drm_mode.h b/include/uapi/drm/drm_mode.h
> index 084b50a02dc5..01000c9f7c2c 100644
> --- a/include/uapi/drm/drm_mode.h
> +++ b/include/uapi/drm/drm_mode.h
> @@ -47,7 +47,15 @@ extern "C" {
>  #define DRM_MODE_TYPE_DRIVER	(1<<6)
>  
>  /* Video mode flags */
> -/* bit compatible with the xorg definitions. */
> +/* bit compatible with the xrandr RR_ definitions (bits 0-13)
> + *
> + * ABI warning: Existing userspace really expects
> + * the mode flags to match the xrandr definitions. Any
> + * changes that don't match the xrandr definitions will
> + * likely need a new client cap or some other mechanism
> + * to avoid breaking existing userspace. This includes
> + * allocating new flags in the previously unused bits!
> + */
>  #define DRM_MODE_FLAG_PHSYNC			(1<<0)
>  #define DRM_MODE_FLAG_NHSYNC			(1<<1)
>  #define DRM_MODE_FLAG_PVSYNC			(1<<2)
> -- 
> 2.7.4
> 

-- 
Daniel Vetter
Software Engineer, Intel Corporation
http://blog.ffwll.ch
_______________________________________________
dri-devel mailing list
dri-devel@xxxxxxxxxxxxxxxxxxxxx
https://lists.freedesktop.org/mailman/listinfo/dri-devel




[Index of Archives]     [Linux DRI Users]     [Linux Intel Graphics]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]     [XFree86]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [XFree86]
  Powered by Linux