diff options
| author | Mauro Carvalho Chehab <mchehab@osg.samsung.com> | 2015-05-28 20:43:06 +0300 |
|---|---|---|
| committer | Mauro Carvalho Chehab <mchehab@osg.samsung.com> | 2015-05-30 15:43:09 +0300 |
| commit | d27518ca0c6a33ecc11b7172fb68eb730301a841 (patch) | |
| tree | 653874b7314c1dcd60488bd0f96ce965c0c0630e /Documentation/DocBook | |
| parent | b60da5b2037febd80e6ac680365eb828061c83df (diff) | |
| download | linux-d27518ca0c6a33ecc11b7172fb68eb730301a841.tar.xz | |
[media] DocBook: fix FE_READ_STATUS argument description
What's written there about the arguments for this ioctl
is bogus: it doesn't return an enum (or a typedef)
for enum fe_status. Instead, it returns a bitmask with the
values defined by enum fe_status.
Also, the size of the integer returned is not 16 bits, but,
instead, sizeof(fe_status_t), e. g. sizeof(enum), with is
arch-dependent.
This should of course be fixed, but this should be done on
a separate patch.
Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
Diffstat (limited to 'Documentation/DocBook')
| -rw-r--r-- | Documentation/DocBook/media/dvb/fe-read-status.xml | 20 |
1 files changed, 12 insertions, 8 deletions
diff --git a/Documentation/DocBook/media/dvb/fe-read-status.xml b/Documentation/DocBook/media/dvb/fe-read-status.xml index 9c1810ae920d..bbd0b5bb6b12 100644 --- a/Documentation/DocBook/media/dvb/fe-read-status.xml +++ b/Documentation/DocBook/media/dvb/fe-read-status.xml @@ -16,7 +16,7 @@ <funcdef>int <function>ioctl</function></funcdef> <paramdef>int <parameter>fd</parameter></paramdef> <paramdef>int <parameter>request</parameter></paramdef> - <paramdef>&fe-status; *<parameter>argp</parameter></paramdef> + <paramdef>unsigned int *<parameter>status</parameter></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> @@ -37,9 +37,10 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>argp</parameter></term> + <term><parameter>status</parameter></term> <listitem> - <para>pointer to &fe-status;</para> + <para>pointer to a bitmask integer filled with the values defined by + &fe-status;.</para> </listitem> </varlistentry> </variablelist> @@ -51,16 +52,19 @@ <para>All DVB frontend devices support the <constant>FE_READ_STATUS</constant> ioctl. It is used to check about the locking status of the frontend after being tuned. The ioctl takes a -pointer to a 16-bits number where the status will be written. -&return-value-dvb;. +pointer to an integer where the status will be written. </para> +<para>NOTE: the size of status is actually sizeof(enum fe_status), with varies + according with the architecture. This needs to be fixed in the future.</para> +&return-value-dvb; </refsect1> <section id="fe-status-t"> -<title>enum fe_status</title> +<title>int fe_status</title> -<para>The enum fe_status is used to indicate the current state - and/or state changes of the frontend hardware.</para> +<para>The fe_status parameter is used to indicate the current state + and/or state changes of the frontend hardware. It is produced using + the &fe-status; values on a bitmask</para> <table pgwide="1" frame="none" id="fe-status"> <title>enum fe_status</title> |