[media] DocBook: update ioctl error codes

ENOTTY is now returned for unimplemented ioctl by dvb-frontend.
Old EOPNOTSUPP & ENOSYS could be still returned by some drivers
as well as other "non standard" error codes.

EAGAIN is returned in case of device is in state where it cannot
perform requested operation. This is for example sleep and statistics
are queried. Quick check for few demodulator drivers reveals there is
a lot of different error codes used in such case currently, few to
mention still: EOPNOTSUPP, ENOSYS, EAGAIN ... Lets try harmonize.

Signed-off-by: Antti Palosaari <crope@iki.fi>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>

diff --git a/Documentation/DocBook/media/v4l/gen-errors.xml b/Documentation/DocBook/media/v4l/gen-errors.xml
index 5bbf3ce1973a8df5d72619ce3df4cc62de52b036..737ecaaa335da5688e17bbbe3b8df2007d539c9e 100644 (file)
--- a/Documentation/DocBook/media/v4l/gen-errors.xml
+++ b/Documentation/DocBook/media/v4l/gen-errors.xml
@@ -6,6 +6,13 @@
     &cs-str;
     <tbody valign="top">
        <!-- Keep it ordered alphabetically -->
+      <row>
+       <entry>EAGAIN</entry>
+       <entry>The ioctl can't be handled because the device is in state where
+              it can't perform it. This could happen for example in case where
+              device is sleeping and ioctl is performed to query statistics.
+       </entry>
+      </row>
       <row>
        <entry>EBADF</entry>
        <entry>The file descriptor is not a valid.</entry>
@@ -50,11 +57,6 @@
               that this request would overcommit the usb bandwidth reserved
               for periodic transfers (up to 80% of the USB bandwidth).</entry>
       </row>
-      <row>
-       <entry>ENOSYS or EOPNOTSUPP</entry>
-       <entry>Function not available for this device (dvb API only. Will likely
-              be replaced anytime soon by ENOTTY).</entry>
-      </row>
       <row>
        <entry>EPERM</entry>
        <entry>Permission denied. Can be returned if the device needs write