133  * an opaque handle to it.
139  * ion_free - free a handle
141  * @handle: the handle to free
143  * Free the provided handle.
145 void ion_free(struct ion_client *client, struct ion_handle *handle);
148  * ion_phys - returns the physical address and len of a handle
150  * @handle: the handle
154  * This function queries the heap for a particular handle to get the
155  * handle's physical address.  It't output is only correct if
158  * instead.  Returns -EINVAL if the handle is invalid.  This has
159  * no implications on the reference counting of the handle --
163 int ion_phys(struct ion_client *client, struct ion_handle *handle,
167  * ion_map_kernel - create mapping for the given handle
169  * @handle: handle to map
171  * Map the given handle into the kernel and return a kernel address that
174 void *ion_map_kernel(struct ion_client *client, struct ion_handle *handle);
177  * ion_unmap_kernel() - destroy a kernel mapping for a handle
179  * @handle: handle to unmap
181 void ion_unmap_kernel(struct ion_client *client, struct ion_handle *handle);
184  * ion_map_dma - create a dma mapping for a given handle
186  * @handle: handle to map
188  * Return an sglist describing the given handle
191                                 struct ion_handle *handle);
194  * ion_unmap_dma() - destroy a dma mapping for a handle
196  * @handle: handle to unmap
198 void ion_unmap_dma(struct ion_client *client, struct ion_handle *handle);
201  * ion_share() - given a handle, obtain a buffer to pass to other clients
203  * @handle: the handle to share
205  * Given a handle, return a buffer, which exists in a global name
207  * to obtain a new handle for this buffer.
211  * another client.  That is, ion_free should not be called on this handle until
215                              struct ion_handle *handle);
222  * Given a buffer, add it to the client and return the handle to use to refer
223  * to it further.  This is called to share a handle from one kernel client to
238  * the handle to use to refer to it further.
256  * @handle: pointer that will be populated with a cookie to use to refer
266     ion_user_handle_t handle;  member
270  * struct ion_fd_data - metadata passed to/from userspace for a handle/fd pair
271  * @handle: a handle
272  * @fd:     a file descriptor representing that handle
274  * For ION_IOC_SHARE or ION_IOC_MAP userspace populates the handle field with
275  * the handle returned from ion alloc, and the kernel returns the file
277  * provides the file descriptor and the kernel returns the handle.
280     ion_user_handle_t handle;  member
285  * struct ion_handle_data - a handle passed to/from the kernel
286  * @handle: a handle
289     ion_user_handle_t handle;  member
307  * @handle: handle with data to flush
310  * @offset: offset into the handle to flush
311  * @length: length of handle to flush
313  * Performs cache operations on the handle. If p is the start address
314  * of the handle, p + offset through p + offset + length will have
318     //struct ion_handle *handle;
319     ion_user_handle_t handle;  member
328     //struct ion_handle *handle;
329     ion_user_handle_t handle;  member
339     struct ion_handle *handle;  member
370  * Takes an ion_allocation_data struct and returns it with the handle field
371  * populated with the opaque handle for the allocation.
379  * Takes an ion_handle_data struct and frees the handle.
386  * Takes an ion_fd_data struct with the handle field populated with a valid
387  * opaque handle.  Returns the struct with the fd field set to a file
396  * Takes an ion_fd_data struct with the handle field populated with a valid
397  * opaque handle.  Returns the struct with the fd field set to a file
399  * can then be passed to another process.  The corresponding opaque handle can
408  * descriptor obtained from ION_IOC_SHARE and returns the struct with the handle
409  * filed set to the corresponding opaque handle.
436  * Clean the caches of the handle specified.
441  * Invalidate the caches of the handle specified.
446  * Clean and invalidate the caches of the handle specified.
452  * Get phys addr of the handle specified.