drm/doc: Discourage usage of MODESET_CTL ioctl

Leftover from the old days of ums and should be used any longer. Since

commit 29935554b3
Author: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Date:   Wed May 30 00:58:09 2012 +0200

    drm: Disallow DRM_IOCTL_MODESET_CTL for KMS drivers

it is a complete no-Op for kms drivers.

v2: Fix up mangled sentence spotted by Michel.

Cc: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Cc: Michel Dänzer <michel@daenzer.net>
Reviewed-by: Ville Syrjälä <ville.syrjala@linux.intel.com>
Signed-off-by: Daniel Vetter <daniel.vetter@ffwll.ch>
This commit is contained in:
Daniel Vetter 2014-05-08 15:39:19 +02:00
parent add1d00823
commit 8edffbb933

View File

@ -2861,12 +2861,12 @@ int num_ioctls;</synopsis>
<term>DRM_IOCTL_MODESET_CTL</term> <term>DRM_IOCTL_MODESET_CTL</term>
<listitem> <listitem>
<para> <para>
This should be called by application level drivers before and This was only used for user-mode-settind drivers around
after mode setting, since on many devices the vertical blank modesetting changes to allow the kernel to update the vblank
counter is reset at that time. Internally, the DRM snapshots interrupt after mode setting, since on many devices the vertical
the last vblank count when the ioctl is called with the blank counter is reset to 0 at some point during modeset. Modern
_DRM_PRE_MODESET command, so that the counter won't go backwards drivers should not call this any more since with kernel mode
(which is dealt with when _DRM_POST_MODESET is used). setting it is a no-op.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>