It seems like we can't have nice things, so let's just document the disappointing behaviour instead. The previous version assumed the kernel would perform the probing work when appropriate, however this is not the case today. Update the documentation to reflect reality. v2: - Improve commit message to explain why this change is made (Pekka) - Keep the bit about flickering (Daniel) - Explain when user-space should force-probe, and when it shouldn't (Daniel)
Showing the changes to include/uapi (1 of 1 file). Show all
Unified · Split
| @@ -414,15 +414,12 @@ enum drm_mode_subconnector { · 413 unmodified lines | |||
| 414 | * | 414 | * |
| 415 | * If the @count_modes field is set to zero, the kernel will perform a forced | 415 | * If the @count_modes field is set to zero, the kernel will perform a forced |
| 416 | * probe on the connector to refresh the connector status, modes and EDID. | 416 | * probe on the connector to refresh the connector status, modes and EDID. |
| 417 | * A forced-probe can be slow and the ioctl will block. A force-probe can cause | 417 | * A forced-probe can be slow, might cause flickering and the ioctl will block. |
| 418 | * flickering and temporary freezes, so it should not be performed | ||
| 419 | * automatically. | ||
| 420 | * | 418 | * |
| 421 | * User-space shouldn't need to force-probe connectors in general: the kernel | 419 | * User-space needs to force-probe connectors to ensure their metadata is |
| 422 | * will automatically take care of probing connectors that don't support | 420 | * up-to-date at startup and after receiving a hot-plug event. User-space |
| 423 | * hot-plug detection when appropriate. However, user-space may force-probe | 421 | * may perform a forced-probe when the user explicitly requests it. User-space |
| 424 | * connectors on user request (e.g. clicking a "Scan connectors" button, or | 422 | * shouldn't perform a forced-probe in other situations. |
| 425 | * opening a UI to manage screens). | ||
| 426 | */ | 423 | */ |
| 427 | struct drm_mode_get_connector { | 424 | struct drm_mode_get_connector { |
| 428 | /** @encoders_ptr: Pointer to ``__u32`` array of object IDs. */ | 425 | /** @encoders_ptr: Pointer to ``__u32`` array of object IDs. */ |