Documentation/DocBook/media_api.tmpl

   1 <?xml version="1.0"?>
   2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   3         "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
   4 <!ENTITY % media-entities SYSTEM "./media-entities.tmpl"> %media-entities;
   5 <!ENTITY media-indices SYSTEM "./media-indices.tmpl">
   6
   7 <!ENTITY eg                     "e.&nbsp;g.">
   8 <!ENTITY ie                     "i.&nbsp;e.">
   9 <!ENTITY fd                     "File descriptor returned by <link linkend='func-open'><function>open()</function></link>.">
  10 <!ENTITY i2c                    "I<superscript>2</superscript>C">
  11 <!ENTITY return-value           "<title>Return Value</title><para>On success <returnvalue>0</returnvalue> is returned, on error <returnvalue>-1</returnvalue> and the <varname>errno</varname> variable is set appropriately. The generic error codes are described at the <link linkend='gen-errors'>Generic Error Codes</link> chapter.</para>">
  12 <!ENTITY return-value-dvb       "<para>RETURN VALUE</para><para>On success <returnvalue>0</returnvalue> is returned, on error <returnvalue>-1</returnvalue> and the <varname>errno</varname> variable is set appropriately. The generic error codes are described at the <link linkend='gen-errors'>Generic Error Codes</link> chapter.</para>">
  13 <!ENTITY manvol                 "<manvolnum>2</manvolnum>">
  14
  15 <!-- Table templates: structs, structs w/union, defines. -->
  16 <!ENTITY cs-str                 "<colspec colname='c1' colwidth='1*' /><colspec colname='c2' colwidth='1*' /><colspec colname='c3' colwidth='2*' /><spanspec spanname='hspan' namest='c1' nameend='c3' />">
  17 <!ENTITY cs-ustr                "<colspec colname='c1' colwidth='1*' /><colspec colname='c2' colwidth='1*' /><colspec colname='c3' colwidth='1*' /><colspec colname='c4' colwidth='2*' /><spanspec spanname='hspan' namest='c1' nameend='c4' />">
  18 <!ENTITY cs-def                 "<colspec colname='c1' colwidth='3*' /><colspec colname='c2' colwidth='1*' /><colspec colname='c3' colwidth='4*' /><spanspec spanname='hspan' namest='c1' nameend='c3' />">
  19
  20 <!-- Video for Linux mailing list address. -->
  21 <!ENTITY v4l-ml                 "<ulink url='http://www.linuxtv.org/lists.php'>http://www.linuxtv.org/lists.php</ulink>">
  22
  23 <!-- LinuxTV v4l-dvb repository. -->
  24 <!ENTITY v4l-dvb                "<ulink url='http://linuxtv.org/repo/'>http://linuxtv.org/repo/</ulink>">
  25 <!ENTITY dash-ent-8             "<entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry>">
  26 <!ENTITY dash-ent-10            "<entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry>">
  27 <!ENTITY dash-ent-12            "<entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry>">
  28 <!ENTITY dash-ent-14            "<entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry>">
  29 <!ENTITY dash-ent-16            "<entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry>">
  30 <!ENTITY dash-ent-20            "<entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry>">
  31 <!ENTITY dash-ent-22            "<entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry>">
  32 <!ENTITY dash-ent-24            "<entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry><entry>-</entry>">
  33 ]>
  34
  35 <book id="media_api">
  36 <bookinfo>
  37 <title>LINUX MEDIA INFRASTRUCTURE API</title>
  38
  39 <copyright>
  40         <year>2009-2012</year>
  41         <holder>LinuxTV Developers</holder>
  42 </copyright>
  43
  44 <legalnotice>
  45
  46 <para>Permission is granted to copy, distribute and/or modify
  47 this document under the terms of the GNU Free Documentation License,
  48 Version 1.1 or any later version published by the Free Software
  49 Foundation. A copy of the license is included in the chapter entitled
  50 "GNU Free Documentation License"</para>
  51 </legalnotice>
  52
  53 </bookinfo>
  54
  55 <toc></toc> <!-- autogenerated -->
  56
  57 <preface>
  58         <title>Introduction</title>
  59
  60         <para>This document covers the Linux Kernel to Userspace API's used by
  61                 video and radio straming devices, including video cameras,
  62                 analog and digital TV receiver cards, AM/FM receiver cards,
  63                 streaming capture devices.</para>
  64         <para>It is divided into four parts.</para>
  65         <para>The first part covers radio, capture,
  66                 cameras and analog TV devices.</para>
  67         <para>The second part covers the
  68                 API used for digital TV and Internet reception via one of the
  69                 several digital tv standards. While it is called as DVB API,
  70                 in fact it covers several different video standards including
  71                 DVB-T, DVB-S, DVB-C and ATSC. The API is currently being updated
  72                 to documment support also for DVB-S2, ISDB-T and ISDB-S.</para>
  73         <para>The third part covers the Remote Controller API.</para>
  74         <para>The fourth part covers the Media Controller API.</para>
  75         <para>For additional information and for the latest development code,
  76                 see: <ulink url="http://linuxtv.org">http://linuxtv.org</ulink>.</para>
  77         <para>For discussing improvements, reporting troubles, sending new drivers, etc, please mail to: <ulink url="http://vger.kernel.org/vger-lists.html#linux-media">Linux Media Mailing List (LMML).</ulink>.</para>
  78
  79 </preface>
  80
  81 <part id="v4l2spec">
  82 &sub-v4l2;
  83 </part>
  84 <part id="dvbapi">
  85 &sub-dvbapi;
  86 </part>
  87 <part id="v4ldvb_common">
  88 <partinfo>
  89 <authorgroup>
  90 <author>
  91 <firstname>Mauro</firstname>
  92 <surname>Chehab</surname>
  93 <othername role="mi">Carvalho</othername>
  94 <affiliation><address><email>mchehab@redhat.com</email></address></affiliation>
  95 <contrib>Initial version.</contrib>
  96 </author>
  97 </authorgroup>
  98 <copyright>
  99         <year>2009-2012</year>
 100         <holder>Mauro Carvalho Chehab</holder>
 101 </copyright>
 102
 103 <revhistory>
 104 <!-- Put document revisions here, newest first. -->
 105 <revision>
 106 <revnumber>1.0.0</revnumber>
 107 <date>2009-09-06</date>
 108 <authorinitials>mcc</authorinitials>
 109 <revremark>Initial revision</revremark>
 110 </revision>
 111 </revhistory>
 112 </partinfo>
 113
 114 <title>Remote Controller API</title>
 115 <chapter id="remote_controllers">
 116 &sub-remote_controllers;
 117 </chapter>
 118 </part>
 119 <part id="media_common">
 120 &sub-media-controller;
 121 </part>
 122
 123 <chapter id="gen_errors">
 124 &sub-gen-errors;
 125 </chapter>
 126
 127
 128 &sub-fdl-appendix;
 129
 130 </book>