[RFC v4 17/18] docs-rst: Document precise V4L2_BUF_FLAG_NO_CACHE_SYNC flag behaviour
Sakari Ailus
sakari.ailus at linux.intel.com
Mon May 8 15:03:29 UTC 2017
Document when should the user specify V4L2_BUF_FLAG_NO_CACHE_SYNC flag.
Signed-off-by: Sakari Ailus <sakari.ailus at linux.intel.com>
---
Documentation/media/uapi/v4l/buffer.rst | 21 +++++++++++++++++++++
1 file changed, 21 insertions(+)
diff --git a/Documentation/media/uapi/v4l/buffer.rst b/Documentation/media/uapi/v4l/buffer.rst
index 9eb42bd..e1f93dd 100644
--- a/Documentation/media/uapi/v4l/buffer.rst
+++ b/Documentation/media/uapi/v4l/buffer.rst
@@ -570,6 +570,27 @@ Buffer Flags
then read by another one, in which case the flag should be set in both
:ref:`VIDIOC_QBUF` and :ref:`VIDIOC_DQBUF` ioctls. This flag has no
effect on some devices / architectures.
+
+ More specifically, this flag causes cache synchronisation to
+ be skipped for OUTPUT buffers when the buffer is queued. The
+ flag can be used if the buffer has been previously written to
+ by hardware but has not been written to by the CPU.
+
+ Additionally, if this flag is specified for a CAPTURE buffer
+ when it is queued, cache synchronisation is skipped. This
+ signals that the application can guarantee that it has not
+ written to the buffer memory since it was last dequeued from
+ the device.
+
+ Specifying this flag for a CAPTURE buffer when
+ dequeueing a buffer will skip cache maintenance for the buffer
+ memory. An application may not access the buffer memory in
+ that case but it may well be passed onwards to another device
+ in the system.
+
+ Specifying this flag has no effect when dequeuing an OUTPUT
+ buffer.
+
* .. _`V4L2-BUF-FLAG-LAST`:
- ``V4L2_BUF_FLAG_LAST``
--
2.7.4
More information about the dri-devel
mailing list