diff options
| author | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-27 12:32:31 +0300 |
|---|---|---|
| committer | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-29 02:08:19 +0300 |
| commit | 43f71d93a0cb342f0c918fba3f6abb7661e40ad2 (patch) | |
| tree | a1dc7288bc480e7027ca1827ca4876472fa12e40 /Documentation/DocBook/media/v4l/vidioc-prepare-buf.xml | |
| parent | ff9a082fda424257976f08fce942609f358015e0 (diff) | |
| download | linux-43f71d93a0cb342f0c918fba3f6abb7661e40ad2.tar.xz | |
doc-rst: Remove the media docbook
Now that all media documentation was converted to Sphinx, we
should get rid of the old DocBook one, as we don't want people
to submit patches against the old stuff.
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Acked-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Diffstat (limited to 'Documentation/DocBook/media/v4l/vidioc-prepare-buf.xml')
| -rw-r--r-- | Documentation/DocBook/media/v4l/vidioc-prepare-buf.xml | 88 |
1 files changed, 0 insertions, 88 deletions
diff --git a/Documentation/DocBook/media/v4l/vidioc-prepare-buf.xml b/Documentation/DocBook/media/v4l/vidioc-prepare-buf.xml deleted file mode 100644 index 7bde698760e4..000000000000 --- a/Documentation/DocBook/media/v4l/vidioc-prepare-buf.xml +++ /dev/null @@ -1,88 +0,0 @@ -<refentry id="vidioc-prepare-buf"> - <refmeta> - <refentrytitle>ioctl VIDIOC_PREPARE_BUF</refentrytitle> - &manvol; - </refmeta> - - <refnamediv> - <refname>VIDIOC_PREPARE_BUF</refname> - <refpurpose>Prepare a buffer for I/O</refpurpose> - </refnamediv> - - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ioctl</function></funcdef> - <paramdef>int <parameter>fd</parameter></paramdef> - <paramdef>int <parameter>request</parameter></paramdef> - <paramdef>struct v4l2_buffer *<parameter>argp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - - <refsect1> - <title>Arguments</title> - - <variablelist> - <varlistentry> - <term><parameter>fd</parameter></term> - <listitem> - <para>&fd;</para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>request</parameter></term> - <listitem> - <para>VIDIOC_PREPARE_BUF</para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>argp</parameter></term> - <listitem> - <para></para> - </listitem> - </varlistentry> - </variablelist> - </refsect1> - - <refsect1> - <title>Description</title> - - <para>Applications can optionally call the -<constant>VIDIOC_PREPARE_BUF</constant> ioctl to pass ownership of the buffer -to the driver before actually enqueuing it, using the -<constant>VIDIOC_QBUF</constant> ioctl, and to prepare it for future I/O. -Such preparations may include cache invalidation or cleaning. Performing them -in advance saves time during the actual I/O. In case such cache operations are -not required, the application can use one of -<constant>V4L2_BUF_FLAG_NO_CACHE_INVALIDATE</constant> and -<constant>V4L2_BUF_FLAG_NO_CACHE_CLEAN</constant> flags to skip the respective -step.</para> - - <para>The <structname>v4l2_buffer</structname> structure is -specified in <xref linkend="buffer" />.</para> - </refsect1> - - <refsect1> - &return-value; - - <variablelist> - <varlistentry> - <term><errorcode>EBUSY</errorcode></term> - <listitem> - <para>File I/O is in progress.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><errorcode>EINVAL</errorcode></term> - <listitem> - <para>The buffer <structfield>type</structfield> is not -supported, or the <structfield>index</structfield> is out of bounds, -or no buffers have been allocated yet, or the -<structfield>userptr</structfield> or -<structfield>length</structfield> are invalid.</para> - </listitem> - </varlistentry> - </variablelist> - </refsect1> -</refentry> |