Commit 3f12e6b0 authored by Hans Verkuil's avatar Hans Verkuil Committed by Mauro Carvalho Chehab

[media] vb2: consistent usage of periods in videobuf2-core.h

Sometimes sentences in comments ended with a period, and sometimes they
didn't. Add periods. No other changes.
Signed-off-by: default avatarHans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: default avatarMauro Carvalho Chehab <m.chehab@samsung.com>
parent 9c0863b1
...@@ -34,49 +34,49 @@ struct vb2_fileio_data; ...@@ -34,49 +34,49 @@ struct vb2_fileio_data;
* usually will result in the allocator freeing the buffer (if * usually will result in the allocator freeing the buffer (if
* no other users of this buffer are present); the buf_priv * no other users of this buffer are present); the buf_priv
* argument is the allocator private per-buffer structure * argument is the allocator private per-buffer structure
* previously returned from the alloc callback * previously returned from the alloc callback.
* @get_userptr: acquire userspace memory for a hardware operation; used for * @get_userptr: acquire userspace memory for a hardware operation; used for
* USERPTR memory types; vaddr is the address passed to the * USERPTR memory types; vaddr is the address passed to the
* videobuf layer when queuing a video buffer of USERPTR type; * videobuf layer when queuing a video buffer of USERPTR type;
* should return an allocator private per-buffer structure * should return an allocator private per-buffer structure
* associated with the buffer on success, NULL on failure; * associated with the buffer on success, NULL on failure;
* the returned private structure will then be passed as buf_priv * the returned private structure will then be passed as buf_priv
* argument to other ops in this structure * argument to other ops in this structure.
* @put_userptr: inform the allocator that a USERPTR buffer will no longer * @put_userptr: inform the allocator that a USERPTR buffer will no longer
* be used * be used.
* @attach_dmabuf: attach a shared struct dma_buf for a hardware operation; * @attach_dmabuf: attach a shared struct dma_buf for a hardware operation;
* used for DMABUF memory types; alloc_ctx is the alloc context * used for DMABUF memory types; alloc_ctx is the alloc context
* dbuf is the shared dma_buf; returns NULL on failure; * dbuf is the shared dma_buf; returns NULL on failure;
* allocator private per-buffer structure on success; * allocator private per-buffer structure on success;
* this needs to be used for further accesses to the buffer * this needs to be used for further accesses to the buffer.
* @detach_dmabuf: inform the exporter of the buffer that the current DMABUF * @detach_dmabuf: inform the exporter of the buffer that the current DMABUF
* buffer is no longer used; the buf_priv argument is the * buffer is no longer used; the buf_priv argument is the
* allocator private per-buffer structure previously returned * allocator private per-buffer structure previously returned
* from the attach_dmabuf callback * from the attach_dmabuf callback.
* @map_dmabuf: request for access to the dmabuf from allocator; the allocator * @map_dmabuf: request for access to the dmabuf from allocator; the allocator
* of dmabuf is informed that this driver is going to use the * of dmabuf is informed that this driver is going to use the
* dmabuf * dmabuf.
* @unmap_dmabuf: releases access control to the dmabuf - allocator is notified * @unmap_dmabuf: releases access control to the dmabuf - allocator is notified
* that this driver is done using the dmabuf for now * that this driver is done using the dmabuf for now.
* @prepare: called every time the buffer is passed from userspace to the * @prepare: called every time the buffer is passed from userspace to the
* driver, useful for cache synchronisation, optional * driver, useful for cache synchronisation, optional.
* @finish: called every time the buffer is passed back from the driver * @finish: called every time the buffer is passed back from the driver
* to the userspace, also optional * to the userspace, also optional.
* @vaddr: return a kernel virtual address to a given memory buffer * @vaddr: return a kernel virtual address to a given memory buffer
* associated with the passed private structure or NULL if no * associated with the passed private structure or NULL if no
* such mapping exists * such mapping exists.
* @cookie: return allocator specific cookie for a given memory buffer * @cookie: return allocator specific cookie for a given memory buffer
* associated with the passed private structure or NULL if not * associated with the passed private structure or NULL if not
* available * available.
* @num_users: return the current number of users of a memory buffer; * @num_users: return the current number of users of a memory buffer;
* return 1 if the videobuf layer (or actually the driver using * return 1 if the videobuf layer (or actually the driver using
* it) is the only user * it) is the only user.
* @mmap: setup a userspace mapping for a given memory buffer under * @mmap: setup a userspace mapping for a given memory buffer under
* the provided virtual memory region * the provided virtual memory region.
* *
* Required ops for USERPTR types: get_userptr, put_userptr. * Required ops for USERPTR types: get_userptr, put_userptr.
* Required ops for MMAP types: alloc, put, num_users, mmap. * Required ops for MMAP types: alloc, put, num_users, mmap.
* Required ops for read/write access types: alloc, put, num_users, vaddr * Required ops for read/write access types: alloc, put, num_users, vaddr.
* Required ops for DMABUF types: attach_dmabuf, detach_dmabuf, map_dmabuf, * Required ops for DMABUF types: attach_dmabuf, detach_dmabuf, map_dmabuf,
* unmap_dmabuf. * unmap_dmabuf.
*/ */
...@@ -258,22 +258,22 @@ struct vb2_buffer { ...@@ -258,22 +258,22 @@ struct vb2_buffer {
* @wait_prepare: release any locks taken while calling vb2 functions; * @wait_prepare: release any locks taken while calling vb2 functions;
* it is called before an ioctl needs to wait for a new * it is called before an ioctl needs to wait for a new
* buffer to arrive; required to avoid a deadlock in * buffer to arrive; required to avoid a deadlock in
* blocking access type * blocking access type.
* @wait_finish: reacquire all locks released in the previous callback; * @wait_finish: reacquire all locks released in the previous callback;
* required to continue operation after sleeping while * required to continue operation after sleeping while
* waiting for a new buffer to arrive * waiting for a new buffer to arrive.
* @buf_init: called once after allocating a buffer (in MMAP case) * @buf_init: called once after allocating a buffer (in MMAP case)
* or after acquiring a new USERPTR buffer; drivers may * or after acquiring a new USERPTR buffer; drivers may
* perform additional buffer-related initialization; * perform additional buffer-related initialization;
* initialization failure (return != 0) will prevent * initialization failure (return != 0) will prevent
* queue setup from completing successfully; optional * queue setup from completing successfully; optional.
* @buf_prepare: called every time the buffer is queued from userspace * @buf_prepare: called every time the buffer is queued from userspace
* and from the VIDIOC_PREPARE_BUF ioctl; drivers may * and from the VIDIOC_PREPARE_BUF ioctl; drivers may
* perform any initialization required before each hardware * perform any initialization required before each hardware
* operation in this callback; drivers that support * operation in this callback; drivers that support
* VIDIOC_CREATE_BUFS must also validate the buffer size; * VIDIOC_CREATE_BUFS must also validate the buffer size;
* if an error is returned, the buffer will not be queued * if an error is returned, the buffer will not be queued
* in driver; optional * in driver; optional.
* @buf_finish: called before every dequeue of the buffer back to * @buf_finish: called before every dequeue of the buffer back to
* userspace; drivers may perform any operations required * userspace; drivers may perform any operations required
* before userspace accesses the buffer; optional. The * before userspace accesses the buffer; optional. The
...@@ -286,7 +286,7 @@ struct vb2_buffer { ...@@ -286,7 +286,7 @@ struct vb2_buffer {
* all other cases the buffer contents will be ignored * all other cases the buffer contents will be ignored
* anyway. * anyway.
* @buf_cleanup: called once before the buffer is freed; drivers may * @buf_cleanup: called once before the buffer is freed; drivers may
* perform any additional cleanup; optional * perform any additional cleanup; optional.
* @start_streaming: called once to enter 'streaming' state; the driver may * @start_streaming: called once to enter 'streaming' state; the driver may
* receive buffers with @buf_queue callback before * receive buffers with @buf_queue callback before
* @start_streaming is called; the driver gets the number * @start_streaming is called; the driver gets the number
...@@ -307,7 +307,7 @@ struct vb2_buffer { ...@@ -307,7 +307,7 @@ struct vb2_buffer {
* the buffer back by calling vb2_buffer_done() function; * the buffer back by calling vb2_buffer_done() function;
* it is allways called after calling STREAMON ioctl; * it is allways called after calling STREAMON ioctl;
* might be called before start_streaming callback if user * might be called before start_streaming callback if user
* pre-queued buffers before calling STREAMON * pre-queued buffers before calling STREAMON.
*/ */
struct vb2_ops { struct vb2_ops {
int (*queue_setup)(struct vb2_queue *q, const struct v4l2_format *fmt, int (*queue_setup)(struct vb2_queue *q, const struct v4l2_format *fmt,
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment