aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/DocBook/media/v4l
diff options
context:
space:
mode:
authorMauro Carvalho Chehab <mchehab@redhat.com>2011-07-06 13:42:08 -0300
committerMauro Carvalho Chehab <mchehab@redhat.com>2011-07-27 17:53:38 -0300
commit66b30b5d510f46c47beb330932afdcb7943d1d78 (patch)
treed59dd5b5698f5c387ce4626785dcebe7eab0d5c7 /Documentation/DocBook/media/v4l
parent16d6c0b02c555b93034ffef4bf1b2d8ae80d8102 (diff)
[media] DocBook/dvb: Use generic descriptions for the frontend API
Move generic stuff into gen-errors.xml, and remove them from DVB API. While here, removes two bogus error codes that aren't supported or used on Linux: EINTERNAL and ENOSIGNAL. Acked-by: Hans Verkuil <hans.verkuil@cisco.com> Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
Diffstat (limited to 'Documentation/DocBook/media/v4l')
-rw-r--r--Documentation/DocBook/media/v4l/gen-errors.xml24
1 files changed, 19 insertions, 5 deletions
diff --git a/Documentation/DocBook/media/v4l/gen-errors.xml b/Documentation/DocBook/media/v4l/gen-errors.xml
index c9818799764..7c1980e8747 100644
--- a/Documentation/DocBook/media/v4l/gen-errors.xml
+++ b/Documentation/DocBook/media/v4l/gen-errors.xml
@@ -8,7 +8,7 @@
<!-- Keep it ordered alphabetically -->
<row>
<entry>EBADF</entry>
- <entry><parameter>fd</parameter> is not a valid open file descriptor.</entry>
+ <entry>The file descriptor is not a valid.</entry>
</row>
<row>
<entry>EBUSY</entry>
@@ -21,18 +21,21 @@
</row>
<row>
<entry>EFAULT</entry>
- <entry><parameter>fd</parameter> is not a valid open file descriptor.</entry>
+ <entry>There was a failure while copying data from/to userspace,
+ probably caused by an invalid pointer reference.</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>
+ <entry>One or more of the ioctl parameters are invalid or out of the
+ allowed range. This is a widely used error code. See the individual
+ ioctl requests for specific 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, or the file
- descriptor is not for a media device.</entry>
+ descriptor is not for a media device. The usage of EINVAL is
+ deprecated and will be fixed on a latter patch.</entry>
</row>
<row>
<entry>ENODEV</entry>
@@ -49,6 +52,17 @@
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
+ permission, or some special capabilities is needed
+ (e. g. root)</entry>
+ </row>
+ <row>
<entry>EWOULDBLOCK</entry>
<entry>Operation would block. Used when the ioctl would need to wait
for an event, but the device was opened in non-blocking mode.</entry>