This is an automatic generated email to let you know that the following patch 
were queued at the 
http://git.linuxtv.org/cgit.cgi/media_tree.git tree:

Subject: [media] DocBook: some fixes for DVB FE open()
Author:  Mauro Carvalho Chehab <[email protected]>
Date:    Mon Jun 1 05:54:20 2015 -0300

The changeset dc9ef7d11207 change the open() ioctl documentation to
match the V4L2 open(). However, some cut-and-pasted stuff doesn't
match what actually happens at the DVB core.

So, fix the documentation entry to be more accurate with the DVB
frontend open() specifics.

Signed-off-by: Mauro Carvalho Chehab <[email protected]>

 Documentation/DocBook/media/dvb/frontend.xml |   28 ++++++++++++++-----------
 1 files changed, 16 insertions(+), 12 deletions(-)

---

http://git.linuxtv.org/cgit.cgi/media_tree.git/commit/?id=6fd877748a9c4133e37417061e426188fcb00fea

diff --git a/Documentation/DocBook/media/dvb/frontend.xml 
b/Documentation/DocBook/media/dvb/frontend.xml
index c7fa3d8..9d8e95c 100644
--- a/Documentation/DocBook/media/dvb/frontend.xml
+++ b/Documentation/DocBook/media/dvb/frontend.xml
@@ -61,7 +61,7 @@ specification is available at
 
 <refentry id="frontend_f_open">
   <refmeta>
-    <refentrytitle>open()</refentrytitle>
+    <refentrytitle>DVB frontend open()</refentrytitle>
     &manvol;
   </refmeta>
 
@@ -94,20 +94,19 @@ specification is available at
       <varlistentry>
        <term><parameter>flags</parameter></term>
        <listitem>
-         <para>Open flags. Access mode must be
-<constant>O_RDWR</constant>. This is just a technicality, input devices
-still support only reading and output devices only writing.</para>
-         <para>When the <constant>O_NONBLOCK</constant> flag is
-given, the read() function will return the &EAGAIN; when no data is available,
-otherwise these functions block until data becomes
-available. Other flags have no effect.</para>
+         <para>Open flags. Access can either be
+              <constant>O_RDWR</constant> or 
<constant>O_RDONLY</constant>.</para>
+          <para>Multiple opens are allowed with <constant>O_RDONLY</constant>. 
In this mode, only query and read ioctls are allowed.</para>
+          <para>Only one open is allowed in <constant>O_RDWR</constant>. In 
this mode, all ioctls are allowed.</para>
+         <para>When the <constant>O_NONBLOCK</constant> flag is given, the 
system calls may return &EAGAIN; when no data is available or when the device 
driver is temporarily busy.</para>
+         <para>Other flags have no effect.</para>
        </listitem>
       </varlistentry>
     </variablelist>
   </refsect1>
   <refsect1>
     <title>Description</title>
-<para>This system call opens a named frontend device 
(/dev/dvb/adapter0/frontend0)
+    <para>This system call opens a named frontend device 
(<constant>/dev/dvb/adapter?/frontend?</constant>)
  for subsequent use. Usually the first thing to do after a successful open is 
to
  find out the frontend type with <link 
linkend="FE_GET_INFO">FE_GET_INFO</link>.</para>
 <para>The device can be opened in read-only mode, which only allows monitoring 
of
@@ -145,8 +144,7 @@ device.</para>
       <varlistentry>
        <term><errorcode>EBUSY</errorcode></term>
        <listitem>
-         <para>The driver does not support multiple opens and the
-device is already in use.</para>
+         <para>The the device driver is already in use.</para>
        </listitem>
       </varlistentry>
       <varlistentry>
@@ -177,13 +175,19 @@ files open.</para>
 system has been reached.</para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><errorcode>ENODEV</errorcode></term>
+       <listitem>
+         <para>The device got removed.</para>
+       </listitem>
+      </varlistentry>
     </variablelist>
   </refsect1>
 </refentry>
 
 <refentry id="frontend_f_close">
   <refmeta>
-    <refentrytitle>close()</refentrytitle>
+    <refentrytitle>DVB frontend close()</refentrytitle>
     &manvol;
   </refmeta>
 

_______________________________________________
linuxtv-commits mailing list
[email protected]
http://www.linuxtv.org/cgi-bin/mailman/listinfo/linuxtv-commits

Reply via email to