gpu/drm/drm_prime.c

48  * Similar to GEM global names, PRIME file descriptors are also used to share
51  * between applications, they can't be guessed like the globally unique GEM
59  * Reference Counting for GEM Drivers
65  * and stores the exporting GEM object in the &dma_buf.priv field. This
68  * GEM-based drivers, the &dma_buf should be exported using
72  * importing GEM object -> dma-buf -> exported GEM bo. A further complication
75  * is required to allow userspace to detect duplicated imports, since some GEM
82  * it will get a fd->handle request for a GEM object that it created.  Drivers
84  * dma-buf private. For GEM based drivers this is handled in
231  * drm_gem_dmabuf_export - &dma_buf export implementation for GEM
235  * This wraps dma_buf_export() for use by generic GEM drivers that are using
261  * drm_gem_dmabuf_release - &dma_buf release implementation for GEM
264  * Generic release function for dma_bufs exported as PRIME buffers. GEM drivers
282  * drm_gem_prime_fd_to_handle - PRIME import function for GEM drivers
288  * This is the PRIME import function which must be used mandatorily by GEM
289  * drivers to ensure correct lifetime management of the underlying GEM object.
290  * The actual importing of GEM object from the dma-buf is done through the
413  * drm_gem_prime_handle_to_dmabuf - PRIME export function for GEM drivers
419  * This is the PRIME export function which must be used mandatorily by GEM
420  * drivers to ensure correct lifetime management of the underlying GEM object.
421  * The actual exporting from GEM object to a dma-buf is done through the
476 	 * protection of dev->object_name_lock to ensure that a racing gem close  in drm_gem_prime_handle_to_dmabuf()
495  * drm_gem_prime_handle_to_fd - PRIME export function for GEM drivers
502  * This is the PRIME export function which must be used mandatorily by GEM
503  * drivers to ensure correct lifetime management of the underlying GEM object.
504  * The actual exporting from GEM object to a dma-buf is done through the
588  * drm_gem_map_attach - dma_buf attach implementation for GEM
616  * drm_gem_map_detach - dma_buf detach implementation for GEM
634  * drm_gem_map_dma_buf - map_dma_buf implementation for GEM
675  * drm_gem_unmap_dma_buf - unmap_dma_buf implementation for GEM
696  * drm_gem_dmabuf_vmap - dma_buf vmap implementation for GEM
715  * drm_gem_dmabuf_vunmap - dma_buf vunmap implementation for GEM
731  * drm_gem_prime_mmap - PRIME mmap function for GEM drivers
732  * @obj: GEM object
736  * the same codepath that is used for regular GEM buffer mapping on the DRM fd.
737  * The fake GEM offset is added to vma->vm_pgoff and &drm_driver->fops->mmap is
769 	/* Used by drm_gem_mmap() to lookup the GEM object */  in drm_gem_prime_mmap()
789  * drm_gem_dmabuf_mmap - dma_buf mmap implementation for GEM
889  * @obj: GEM object to export
892  * This is the implementation of the &drm_gem_object_funcs.export functions for GEM drivers
941 			 * Importing dmabuf exported from our own gem increases  in drm_gem_prime_import_dev()
942 			 * refcount on gem itself instead of f_count of dmabuf.  in drm_gem_prime_import_dev()
990  * This is the implementation of the gem_prime_import functions for GEM drivers
1060  * drm_prime_gem_destroy - helper to clean up a PRIME-imported GEM object
1061  * @obj: GEM object which was created from a dma-buf
1064  * This is the cleanup functions which GEM drivers need to call when they use