[media] DocBook: Use the generic error code page also for MC API
authorMauro Carvalho Chehab <mchehab@redhat.com>
Tue, 5 Jul 2011 14:37:58 +0000 (11:37 -0300)
committerMauro Carvalho Chehab <mchehab@redhat.com>
Wed, 27 Jul 2011 20:53:35 +0000 (17:53 -0300)
Instead of having their own generic error codes at the MC API, move
its section to the generic one and be sure that all media ioctl's
will point to it.

Acked-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
Documentation/DocBook/media/v4l/gen-errors.xml
Documentation/DocBook/media/v4l/media-func-ioctl.xml
Documentation/DocBook/media/v4l/media-ioc-device-info.xml

index 6ef476a5401652a8be457e14ec8a0e0f38759d59..9bf9ca7f46dc430415ec97939e4259d17995bf48 100644 (file)
@@ -5,6 +5,11 @@
   <tgroup cols="2">
     &cs-str;
     <tbody valign="top">
+       <!-- Keep it ordered alphabetically -->
+      <row>
+       <entry>EBADF</entry>
+       <entry><parameter>fd</parameter> is not a valid open file descriptor.</entry>
+      </row>
       <row>
        <entry>EBUSY</entry>
        <entry>The ioctl can't be handled because the device is busy. This is
               must not be retried without performing another action to fix the
               problem first (typically: stop the stream before retrying).</entry>
       </row>
+      <row>
+       <entry>EFAULT</entry>
+       <entry><parameter>fd</parameter> is not a valid open file descriptor.</entry>
+      </row>
       <row>
        <entry>EINVAL</entry>
+       <entry>One or more of the ioctl parameters are invalid. This is a widely
+              used error code. See the individual ioctl requests for actual causes.</entry>
+      </row>
+      <row>
+       <entry>EINVAL or ENOTTY</entry>
        <entry>The ioctl is not supported by the driver, actually meaning that
               the required functionality is not available.</entry>
       </row>
@@ -25,7 +39,7 @@
       </row>
       <row>
        <entry>ENOSPC</entry>
-       <entry>On USB devices, the stream ioctl's can return this error meaning
+       <entry>On USB devices, the stream ioctl's can return this error, meaning
               that this request would overcommit the usb bandwidth reserved
               for periodic transfers (up to 80% of the USB bandwidth).</entry>
       </row>
index bda8604de15cd1bf9292a712b58eb5b257e5f1da..e0ee285baf1c22e649d5d49958465df86481d330 100644 (file)
   </refsect1>
 
   <refsect1>
-    <title>Return Value</title>
-
-    <para><function>ioctl()</function> returns <returnvalue>0</returnvalue> on
-    success. On failure, <returnvalue>-1</returnvalue> is returned, and the
-    <varname>errno</varname> variable is set appropriately. Generic error codes
-    are listed below, and request-specific error codes are listed in the
+    &return-value;
+    <para>Request-specific error codes are listed in the
     individual requests descriptions.</para>
     <para>When an ioctl that takes an output or read/write parameter fails,
     the parameter remains unmodified.</para>
-
-    <variablelist>
-      <varlistentry>
-       <term><errorcode>EBADF</errorcode></term>
-       <listitem>
-         <para><parameter>fd</parameter> is not a valid open file descriptor.
-         </para>
-       </listitem>
-      </varlistentry>
-      <varlistentry>
-       <term><errorcode>EFAULT</errorcode></term>
-       <listitem>
-         <para><parameter>argp</parameter> references an inaccessible memory
-         area.</para>
-       </listitem>
-      </varlistentry>
-      <varlistentry>
-       <term><errorcode>EINVAL</errorcode></term>
-       <listitem>
-         <para>The <parameter>request</parameter> or the data pointed to by
-         <parameter>argp</parameter> is not valid. This is a very common error
-         code, see the individual ioctl requests listed in
-         <xref linkend="media-user-func" /> for actual causes.</para>
-       </listitem>
-      </varlistentry>
-      <varlistentry>
-       <term><errorcode>ENOMEM</errorcode></term>
-       <listitem>
-         <para>Insufficient kernel memory was available to complete the
-         request.</para>
-       </listitem>
-      </varlistentry>
-      <varlistentry>
-       <term><errorcode>ENOTTY</errorcode></term>
-       <listitem>
-         <para><parameter>fd</parameter> is  not  associated  with  a character
-         special device.</para>
-       </listitem>
-      </varlistentry>
-    </variablelist>
   </refsect1>
 </refentry>
index 1f3237351bba6e306fbdb7332d65aa27ff6d2e3c..2ce521419e67ec5d8b503e6169e9859de6cf7da0 100644 (file)
   </refsect1>
 
   <refsect1>
-    <title>Return value</title>
-    <para>This function doesn't return specific error codes.</para>
+    &return-value;
   </refsect1>
 </refentry>