SYNOPSIS

void drm_atomic_helper_swap_state(struct drm_device * dev, struct drm_atomic_state * state);

ARGUMENTS

dev

DRM device

state

atomic state

DESCRIPTION

This function stores the atomic state into the current state pointers in all driver objects. It should be called after all failing steps have been done and succeeded, but before the actual hardware state is committed.

For cleanup and error recovery the current state for all changed objects will be swaped into state.

With that sequence it fits perfectly into the plane prepare/cleanup sequence:

1. Call drm_atomic_helper_prepare_planes with the staged atomic state.

2. Do any other steps that might fail.

3. Put the staged state into the current state pointers with this function.

4. Actually commit the hardware state.

5. Call drm_atomic_helper_cleanup_planes with state, which since step 3 contains the old state. Also do any other cleanup required with that state.

AUTHORS

Jesse Barnes <[email protected]>
Intel Corporation,         
        

Initial version

Laurent Pinchart <[email protected]>
Ideas on board SPRL,         
        

Driver internals

Daniel Vetter <[email protected]>
Intel Corporation,         
        

Contributions all over the place

Lukas Wunner <[email protected]>

vga_switcheroo documentation

COPYRIGHT