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_fd - PRIME export function for GEM drivers
420  * This is the PRIME export function which must be used mandatorily by GEM
421  * drivers to ensure correct lifetime management of the underlying GEM object.
422  * The actual exporting from GEM object to a dma-buf is done through the
475 	 * protection of dev->object_name_lock to ensure that a racing gem close  in drm_gem_prime_handle_to_fd()
489 	 * and that is invariant as long as a userspace gem handle exists.  in drm_gem_prime_handle_to_fd()
570  * drm_gem_map_attach - dma_buf attach implementation for GEM
598  * drm_gem_map_detach - dma_buf detach implementation for GEM
616  * drm_gem_map_dma_buf - map_dma_buf implementation for GEM
657  * drm_gem_unmap_dma_buf - unmap_dma_buf implementation for GEM
678  * drm_gem_dmabuf_vmap - dma_buf vmap implementation for GEM
697  * drm_gem_dmabuf_vunmap - dma_buf vunmap implementation for GEM
713  * drm_gem_prime_mmap - PRIME mmap function for GEM drivers
714  * @obj: GEM object
718  * the same codepath that is used for regular GEM buffer mapping on the DRM fd.
719  * The fake GEM offset is added to vma->vm_pgoff and &drm_driver->fops->mmap is
751 	/* Used by drm_gem_mmap() to lookup the GEM object */  in drm_gem_prime_mmap()
771  * drm_gem_dmabuf_mmap - dma_buf mmap implementation for GEM
871  * @obj: GEM object to export
874  * This is the implementation of the &drm_gem_object_funcs.export functions for GEM drivers
923 			 * Importing dmabuf exported from our own gem increases  in drm_gem_prime_import_dev()
924 			 * refcount on gem itself instead of f_count of dmabuf.  in drm_gem_prime_import_dev()
972  * This is the implementation of the gem_prime_import functions for GEM drivers
1042  * drm_prime_gem_destroy - helper to clean up a PRIME-imported GEM object
1043  * @obj: GEM object which was created from a dma-buf
1046  * This is the cleanup functions which GEM drivers need to call when they use