include/drm/drm_mode_config.h

42  * struct drm_mode_config_funcs - basic driver provided mode setting functions
44  * Some global (i.e. not per-CRTC, connector, etc) mode setting functions that
59 	 * ie. when (@mode_cmd->flags & DRM_MODE_FB_MODIFIERS) == 0.
70 	 * driver-specific information (like the internal native buffer object
135 	 *  - Checking that the modes, framebuffers, scaling and placement
138 	 *  - Checking that any hidden shared resources are not oversubscribed.
143 	 *  - Checking that virtualized resources exported to userspace are not
146 	 *    example is dual-pipe operations (which generally should be hidden
153 	 *  - Check that any transitional state is possible and that if
157 	 *  - Check any other constraints the driver or hardware might have.
159 	 *  - This callback also needs to correctly fill out the &drm_crtc_state
168 	 *  - The driver also does not need to repeat basic input validation
180 	 * drm_atomic_helper_check(), or one of the exported sub-functions of
187 	 *  - -EINVAL, if any of the above constraints are violated.
189 	 *  - -EDEADLK, when returned from an attempt to acquire an additional
192 	 *  - -ENOMEM, if allocating additional state sub-structures failed due
195 	 *  - -EINTR, -EAGAIN or -ERESTARTSYS, if the IOCTL should be restarted.
216 	 * drm_atomic_helper_commit(), or one of the exported sub-functions of
222 	 * errors resulting in -EIO. But even in that case the driver must
232 	 * buffer is a shared dma-buf. Nonblocking commits must not wait for
236 	 * completed. These events are per-CRTC and can be distinguished by the
255 	 *  - -EBUSY, if a nonblocking updated is requested and there is
262 	 *  - -ENOMEM, if the driver failed to allocate memory. Specifically
266 	 *  - -ENOSPC, as a refinement of the more generic -ENOMEM to indicate
270 	 *  - -EIO, if the hardware completely died.
272 	 *  - -EINTR, -EAGAIN or -ERESTARTSYS, if the IOCTL should be restarted.
279 	 * return -EINVAL (any invalid requests should be caught in
280 	 * @atomic_check) or -EDEADLK (this function must not acquire
291 	 * &drm_atomic_state to be able to track their own driver-private global
308 	 * passed-in &drm_atomic_state. This hook is called when the caller
342  * struct drm_mode_config - Mode configuration control structure
353  * @prefer_shadow: hint to userspace to prefer shadow-fb rendering
356  * @helper_private: mid-layer private data
381 	 * anything from under its protection and move it into more well-scoped
403 	 * impossible to use driver-private &struct drm_modeset_lock. Users of
420 	 * connector, modes - just makes life easier to have only one.
428 	 * high-res DP MST screens.
677 	 * @prop_mode_id: Default atomic CRTC property to set the mode for a
678 	 * CRTC. A 0 mode implies that the CRTC is entirely disabled - all
679 	 * connectors must be of and active must be set to disabled, too.
689 	 * @dvi_i_subconnector_property: Optional DVI-I property to
694 	 * @dvi_i_select_subconnector_property: Optional DVI-I property to
706 	 * @tv_subconnector_property: Optional TV property to differentiate
707 	 * between different TV connector types.
711 	 * @tv_select_subconnector_property: Optional TV property to select
712 	 * between different TV connector types.
717 	 * @legacy_tv_mode_property: Optional TV property to select
718 	 * the output TV mode.
725 	 * @tv_mode_property: Optional TV property to select the TV
731 	 * @tv_left_margin_property: Optional TV property to set the left
736 	 * @tv_right_margin_property: Optional TV property to set the right
741 	 * @tv_top_margin_property: Optional TV property to set the right
746 	 * @tv_bottom_margin_property: Optional TV property to set the right
751 	 * @tv_brightness_property: Optional TV property to set the
756 	 * @tv_contrast_property: Optional TV property to set the
761 	 * @tv_flicker_reduction_property: Optional TV property to control the
766 	 * @tv_overscan_property: Optional TV property to control the overscan
771 	 * @tv_saturation_property: Optional TV property to set the
776 	 * @tv_hue_property: Optional TV property to set the hue.
782 	 * upscaling, mostly used for built-in panels.
796 	 * @degamma_lut_property: Optional CRTC property to set the LUT used to
802 	 * the degamma LUT as supported by the driver (read-only).
806 	 * @ctm_property: Optional CRTC property to set the
812 	 * @gamma_lut_property: Optional CRTC property to set the LUT used to
819 	 * gamma LUT as supported by the driver (read-only).
843 	 * how the lcd-panel is mounted inside the casing (e.g. normal or
844 	 * upside-down).
858 	 * engine (read-only).
897 	 * only ever be set by the nouveau kernel driver.
904 	 * When set to true drm_mode_addfb() will pick host byte order
911 	 * opt-in.
924 	 * When this flag is set, the DRM device will not expose modifier
927 	 * drivers shall not set fhis flag.
952 	 * Set by drm_mode_config_helper_suspend() and cleared by
963  * drm_mode_config_init - DRM mode_configuration structure initialization