Documentation/DocBook/media/v4l/v4l2.xml

   1  <partinfo>
   2     <authorgroup>
   3       <author>
   4         <firstname>Michael</firstname>
   5         <surname>Schimek</surname>
   6         <othername role="mi">H</othername>
   7         <affiliation>
   8           <address>
   9             <email>mschimek@gmx.at</email>
  10           </address>
  11         </affiliation>
  12       </author>
  13
  14       <author>
  15         <firstname>Bill</firstname>
  16         <surname>Dirks</surname>
  17         <!-- Commented until Bill opts in to be spammed.
  18         <affiliation>
  19           <address>
  20             <email>bill@thedirks.org</email>
  21           </address>
  22         </affiliation> -->
  23         <contrib>Original author of the V4L2 API and
  24 documentation.</contrib>
  25       </author>
  26
  27       <author>
  28         <firstname>Hans</firstname>
  29         <surname>Verkuil</surname>
  30         <contrib>Designed and documented the VIDIOC_LOG_STATUS ioctl,
  31 the extended control ioctls, major parts of the sliced VBI API, the
  32 MPEG encoder and decoder APIs and the DV Timings API.</contrib>
  33         <affiliation>
  34           <address>
  35             <email>hverkuil@xs4all.nl</email>
  36           </address>
  37         </affiliation>
  38       </author>
  39
  40       <author>
  41         <firstname>Martin</firstname>
  42         <surname>Rubli</surname>
  43         <!--
  44         <affiliation>
  45           <address>
  46             <email>martin_rubli@logitech.com</email>
  47           </address>
  48         </affiliation> -->
  49         <contrib>Designed and documented the VIDIOC_ENUM_FRAMESIZES
  50 and VIDIOC_ENUM_FRAMEINTERVALS ioctls.</contrib>
  51       </author>
  52
  53       <author>
  54         <firstname>Andy</firstname>
  55         <surname>Walls</surname>
  56         <contrib>Documented the fielded V4L2_MPEG_STREAM_VBI_FMT_IVTV
  57 MPEG stream embedded, sliced VBI data format in this specification.
  58 </contrib>
  59         <affiliation>
  60           <address>
  61             <email>awalls@md.metrocast.net</email>
  62           </address>
  63         </affiliation>
  64       </author>
  65
  66       <author>
  67         <firstname>Mauro</firstname>
  68         <surname>Carvalho Chehab</surname>
  69         <contrib>Documented libv4l, designed and added v4l2grab example,
  70 Remote Controller chapter.</contrib>
  71         <affiliation>
  72           <address>
  73             <email>m.chehab@samsung.com</email>
  74           </address>
  75         </affiliation>
  76       </author>
  77
  78       <author>
  79         <firstname>Muralidharan</firstname>
  80         <surname>Karicheri</surname>
  81         <contrib>Documented the Digital Video timings API.</contrib>
  82         <affiliation>
  83           <address>
  84             <email>m-karicheri2@ti.com</email>
  85           </address>
  86         </affiliation>
  87       </author>
  88
  89       <author>
  90         <firstname>Pawel</firstname>
  91         <surname>Osciak</surname>
  92         <contrib>Designed and documented the multi-planar API.</contrib>
  93         <affiliation>
  94           <address>
  95             <email>pawel AT osciak.com</email>
  96           </address>
  97         </affiliation>
  98       </author>
  99
 100       <author>
 101         <firstname>Sakari</firstname>
 102         <surname>Ailus</surname>
 103         <contrib>Subdev selections API.</contrib>
 104         <affiliation>
 105           <address>
 106             <email>sakari.ailus@iki.fi</email>
 107           </address>
 108         </affiliation>
 109       </author>
 110       <author>
 111         <firstname>Antti</firstname>
 112         <surname>Palosaari</surname>
 113         <contrib>SDR API.</contrib>
 114         <affiliation>
 115           <address>
 116             <email>crope@iki.fi</email>
 117           </address>
 118         </affiliation>
 119       </author>
 120     </authorgroup>
 121
 122     <copyright>
 123       <year>1999</year>
 124       <year>2000</year>
 125       <year>2001</year>
 126       <year>2002</year>
 127       <year>2003</year>
 128       <year>2004</year>
 129       <year>2005</year>
 130       <year>2006</year>
 131       <year>2007</year>
 132       <year>2008</year>
 133       <year>2009</year>
 134       <year>2010</year>
 135       <year>2011</year>
 136       <year>2012</year>
 137       <year>2013</year>
 138       <year>2014</year>
 139       <year>2015</year>
 140       <holder>Bill Dirks, Michael H. Schimek, Hans Verkuil, Martin
 141 Rubli, Andy Walls, Muralidharan Karicheri, Mauro Carvalho Chehab,
 142         Pawel Osciak</holder>
 143     </copyright>
 144     <legalnotice>
 145     <para>Except when explicitly stated as GPL, programming examples within
 146             this part can be used and distributed without restrictions.</para>
 147     </legalnotice>
 148     <revhistory>
 149       <!-- Put document revisions here, newest first. -->
 150       <!-- API revisions (changes and additions of defines, enums,
 151 structs, ioctls) must be noted in more detail in the history chapter
 152 (compat.xml), along with the possible impact on existing drivers and
 153 applications. -->
 154       <revision>
 155         <revnumber>4.4</revnumber>
 156         <date>2015-05-26</date>
 157         <authorinitials>ap</authorinitials>
 158         <revremark>Renamed V4L2_TUNER_ADC to V4L2_TUNER_SDR.
 159 Added V4L2_CID_RF_TUNER_RF_GAIN control.
 160 Added transmitter support for Software Defined Radio (SDR) Interface.
 161         </revremark>
 162       </revision>
 163
 164       <revision>
 165         <revnumber>4.1</revnumber>
 166         <date>2015-02-13</date>
 167         <authorinitials>mcc</authorinitials>
 168         <revremark>Fix documentation for media controller device nodes and add support for DVB device nodes.
 169 Add support for Tuner sub-device.
 170         </revremark>
 171       </revision>
 172       <revision>
 173         <revnumber>3.19</revnumber>
 174         <date>2014-12-05</date>
 175         <authorinitials>hv</authorinitials>
 176         <revremark>Rewrote Colorspace chapter, added new &v4l2-ycbcr-encoding; and &v4l2-quantization; fields
 177 to &v4l2-pix-format;, &v4l2-pix-format-mplane; and &v4l2-mbus-framefmt;.
 178         </revremark>
 179       </revision>
 180
 181       <revision>
 182         <revnumber>3.17</revnumber>
 183         <date>2014-08-04</date>
 184         <authorinitials>lp, hv</authorinitials>
 185         <revremark>Extended &v4l2-pix-format;. Added format flags. Added compound control types
 186 and VIDIOC_QUERY_EXT_CTRL.
 187         </revremark>
 188       </revision>
 189
 190       <revision>
 191         <revnumber>3.15</revnumber>
 192         <date>2014-02-03</date>
 193         <authorinitials>hv, ap</authorinitials>
 194         <revremark>Update several sections of "Common API Elements": "Opening and Closing Devices"
 195 "Querying Capabilities", "Application Priority", "Video Inputs and Outputs", "Audio Inputs and Outputs"
 196 "Tuners and Modulators", "Video Standards" and "Digital Video (DV) Timings". Added SDR API.
 197         </revremark>
 198       </revision>
 199
 200       <revision>
 201         <revnumber>3.14</revnumber>
 202         <date>2013-11-25</date>
 203         <authorinitials>rr</authorinitials>
 204         <revremark>Set width and height as unsigned on v4l2_rect.
 205         </revremark>
 206       </revision>
 207
 208       <revision>
 209         <revnumber>3.11</revnumber>
 210         <date>2013-05-26</date>
 211         <authorinitials>hv</authorinitials>
 212         <revremark>Remove obsolete VIDIOC_DBG_G_CHIP_IDENT ioctl.
 213         </revremark>
 214       </revision>
 215
 216       <revision>
 217         <revnumber>3.10</revnumber>
 218         <date>2013-03-25</date>
 219         <authorinitials>hv</authorinitials>
 220         <revremark>Remove obsolete and unused DV_PRESET ioctls:
 221         VIDIOC_G_DV_PRESET, VIDIOC_S_DV_PRESET, VIDIOC_QUERY_DV_PRESET and
 222         VIDIOC_ENUM_DV_PRESET. Remove the related v4l2_input/output capability
 223         flags V4L2_IN_CAP_PRESETS and V4L2_OUT_CAP_PRESETS. Added VIDIOC_DBG_G_CHIP_INFO.
 224         </revremark>
 225       </revision>
 226
 227       <revision>
 228         <revnumber>3.9</revnumber>
 229         <date>2012-12-03</date>
 230         <authorinitials>sa, sn</authorinitials>
 231         <revremark>Added timestamp types to v4l2_buffer.
 232         Added V4L2_EVENT_CTRL_CH_RANGE control event changes flag.
 233         </revremark>
 234       </revision>
 235
 236       <revision>
 237         <revnumber>3.6</revnumber>
 238         <date>2012-07-02</date>
 239         <authorinitials>hv</authorinitials>
 240         <revremark>Added VIDIOC_ENUM_FREQ_BANDS.
 241         </revremark>
 242       </revision>
 243
 244       <revision>
 245         <revnumber>3.5</revnumber>
 246         <date>2012-05-07</date>
 247         <authorinitials>sa, sn, hv</authorinitials>
 248         <revremark>Added V4L2_CTRL_TYPE_INTEGER_MENU and V4L2 subdev
 249             selections API. Improved the description of V4L2_CID_COLORFX
 250             control, added V4L2_CID_COLORFX_CBCR control.
 251             Added camera controls V4L2_CID_AUTO_EXPOSURE_BIAS,
 252             V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE, V4L2_CID_IMAGE_STABILIZATION,
 253             V4L2_CID_ISO_SENSITIVITY, V4L2_CID_ISO_SENSITIVITY_AUTO,
 254             V4L2_CID_EXPOSURE_METERING, V4L2_CID_SCENE_MODE,
 255             V4L2_CID_3A_LOCK, V4L2_CID_AUTO_FOCUS_START,
 256             V4L2_CID_AUTO_FOCUS_STOP, V4L2_CID_AUTO_FOCUS_STATUS
 257             and V4L2_CID_AUTO_FOCUS_RANGE.
 258             Added VIDIOC_ENUM_DV_TIMINGS, VIDIOC_QUERY_DV_TIMINGS and
 259             VIDIOC_DV_TIMINGS_CAP.
 260         </revremark>
 261       </revision>
 262
 263       <revision>
 264         <revnumber>3.4</revnumber>
 265         <date>2012-01-25</date>
 266         <authorinitials>sn</authorinitials>
 267         <revremark>Added <link linkend="jpeg-controls">JPEG compression
 268             control class.</link>
 269         </revremark>
 270       </revision>
 271
 272       <revision>
 273         <revnumber>3.3</revnumber>
 274         <date>2012-01-11</date>
 275         <authorinitials>hv</authorinitials>
 276         <revremark>Added device_caps field to struct v4l2_capabilities.</revremark>
 277       </revision>
 278
 279       <revision>
 280         <revnumber>3.2</revnumber>
 281         <date>2011-08-26</date>
 282         <authorinitials>hv</authorinitials>
 283         <revremark>Added V4L2_CTRL_FLAG_VOLATILE.</revremark>
 284       </revision>
 285
 286       <revision>
 287         <revnumber>3.1</revnumber>
 288         <date>2011-06-27</date>
 289         <authorinitials>mcc, po, hv</authorinitials>
 290         <revremark>Documented that VIDIOC_QUERYCAP now returns a per-subsystem version instead of a per-driver one.
 291                    Standardize an error code for invalid ioctl.
 292                    Added V4L2_CTRL_TYPE_BITMASK.</revremark>
 293       </revision>
 294
 295       <revision>
 296         <revnumber>2.6.39</revnumber>
 297         <date>2011-03-01</date>
 298         <authorinitials>mcc, po</authorinitials>
 299         <revremark>Removed VIDIOC_*_OLD from videodev2.h header and update it to reflect latest changes. Added the <link linkend="planar-apis">multi-planar API</link>.</revremark>
 300       </revision>
 301
 302       <revision>
 303         <revnumber>2.6.37</revnumber>
 304         <date>2010-08-06</date>
 305         <authorinitials>hv</authorinitials>
 306         <revremark>Removed obsolete vtx (videotext) API.</revremark>
 307       </revision>
 308
 309       <revision>
 310         <revnumber>2.6.33</revnumber>
 311         <date>2009-12-03</date>
 312         <authorinitials>mk</authorinitials>
 313         <revremark>Added documentation for the Digital Video timings API.</revremark>
 314       </revision>
 315
 316       <revision>
 317         <revnumber>2.6.32</revnumber>
 318         <date>2009-08-31</date>
 319         <authorinitials>mcc</authorinitials>
 320         <revremark>Now, revisions will match the kernel version where
 321 the V4L2 API changes will be used by the Linux Kernel.
 322 Also added Remote Controller chapter.</revremark>
 323       </revision>
 324
 325       <revision>
 326         <revnumber>0.29</revnumber>
 327         <date>2009-08-26</date>
 328         <authorinitials>ev</authorinitials>
 329         <revremark>Added documentation for string controls and for FM Transmitter controls.</revremark>
 330       </revision>
 331
 332       <revision>
 333         <revnumber>0.28</revnumber>
 334         <date>2009-08-26</date>
 335         <authorinitials>gl</authorinitials>
 336         <revremark>Added V4L2_CID_BAND_STOP_FILTER documentation.</revremark>
 337       </revision>
 338
 339       <revision>
 340         <revnumber>0.27</revnumber>
 341         <date>2009-08-15</date>
 342         <authorinitials>mcc</authorinitials>
 343         <revremark>Added libv4l and Remote Controller documentation;
 344 added v4l2grab and keytable application examples.</revremark>
 345       </revision>
 346
 347       <revision>
 348         <revnumber>0.26</revnumber>
 349         <date>2009-07-23</date>
 350         <authorinitials>hv</authorinitials>
 351         <revremark>Finalized the RDS capture API. Added modulator and RDS encoder
 352 capabilities. Added support for string controls.</revremark>
 353       </revision>
 354
 355       <revision>
 356         <revnumber>0.25</revnumber>
 357         <date>2009-01-18</date>
 358         <authorinitials>hv</authorinitials>
 359         <revremark>Added pixel formats VYUY, NV16 and NV61, and changed
 360 the debug ioctls VIDIOC_DBG_G/S_REGISTER and VIDIOC_DBG_G_CHIP_IDENT.
 361 Added camera controls V4L2_CID_ZOOM_ABSOLUTE, V4L2_CID_ZOOM_RELATIVE,
 362 V4L2_CID_ZOOM_CONTINUOUS and V4L2_CID_PRIVACY.</revremark>
 363       </revision>
 364
 365       <revision>
 366         <revnumber>0.24</revnumber>
 367         <date>2008-03-04</date>
 368         <authorinitials>mhs</authorinitials>
 369         <revremark>Added pixel formats Y16 and SBGGR16, new controls
 370 and a camera controls class. Removed VIDIOC_G/S_MPEGCOMP.</revremark>
 371       </revision>
 372
 373       <revision>
 374         <revnumber>0.23</revnumber>
 375         <date>2007-08-30</date>
 376         <authorinitials>mhs</authorinitials>
 377         <revremark>Fixed a typo in VIDIOC_DBG_G/S_REGISTER.
 378 Clarified the byte order of packed pixel formats.</revremark>
 379       </revision>
 380
 381       <revision>
 382         <revnumber>0.22</revnumber>
 383         <date>2007-08-29</date>
 384         <authorinitials>mhs</authorinitials>
 385         <revremark>Added the Video Output Overlay interface, new MPEG
 386 controls, V4L2_FIELD_INTERLACED_TB and V4L2_FIELD_INTERLACED_BT,
 387 VIDIOC_DBG_G/S_REGISTER, VIDIOC_(TRY_)ENCODER_CMD,
 388 VIDIOC_G_CHIP_IDENT, VIDIOC_G_ENC_INDEX, new pixel formats.
 389 Clarifications in the cropping chapter, about RGB pixel formats, the
 390 mmap(), poll(), select(), read() and write() functions. Typographical
 391 fixes.</revremark>
 392       </revision>
 393
 394       <revision>
 395         <revnumber>0.21</revnumber>
 396         <date>2006-12-19</date>
 397         <authorinitials>mhs</authorinitials>
 398         <revremark>Fixed a link in the VIDIOC_G_EXT_CTRLS section.</revremark>
 399       </revision>
 400
 401       <revision>
 402         <revnumber>0.20</revnumber>
 403         <date>2006-11-24</date>
 404         <authorinitials>mhs</authorinitials>
 405         <revremark>Clarified the purpose of the audioset field in
 406 struct v4l2_input and v4l2_output.</revremark>
 407       </revision>
 408
 409       <revision>
 410         <revnumber>0.19</revnumber>
 411         <date>2006-10-19</date>
 412         <authorinitials>mhs</authorinitials>
 413         <revremark>Documented V4L2_PIX_FMT_RGB444.</revremark>
 414       </revision>
 415
 416       <revision>
 417         <revnumber>0.18</revnumber>
 418         <date>2006-10-18</date>
 419         <authorinitials>mhs</authorinitials>
 420         <revremark>Added the description of extended controls by Hans
 421 Verkuil. Linked V4L2_PIX_FMT_MPEG to V4L2_CID_MPEG_STREAM_TYPE.</revremark>
 422       </revision>
 423
 424       <revision>
 425         <revnumber>0.17</revnumber>
 426         <date>2006-10-12</date>
 427         <authorinitials>mhs</authorinitials>
 428         <revremark>Corrected V4L2_PIX_FMT_HM12 description.</revremark>
 429       </revision>
 430
 431       <revision>
 432         <revnumber>0.16</revnumber>
 433         <date>2006-10-08</date>
 434         <authorinitials>mhs</authorinitials>
 435         <revremark>VIDIOC_ENUM_FRAMESIZES and
 436 VIDIOC_ENUM_FRAMEINTERVALS are now part of the API.</revremark>
 437       </revision>
 438
 439       <revision>
 440         <revnumber>0.15</revnumber>
 441         <date>2006-09-23</date>
 442         <authorinitials>mhs</authorinitials>
 443         <revremark>Cleaned up the bibliography, added BT.653 and
 444 BT.1119. capture.c/start_capturing() for user pointer I/O did not
 445 initialize the buffer index. Documented the V4L MPEG and MJPEG
 446 VID_TYPEs and V4L2_PIX_FMT_SBGGR8. Updated the list of reserved pixel
 447 formats. See the history chapter for API changes.</revremark>
 448       </revision>
 449
 450       <revision>
 451         <revnumber>0.14</revnumber>
 452         <date>2006-09-14</date>
 453         <authorinitials>mr</authorinitials>
 454         <revremark>Added VIDIOC_ENUM_FRAMESIZES and
 455 VIDIOC_ENUM_FRAMEINTERVALS proposal for frame format enumeration of
 456 digital devices.</revremark>
 457       </revision>
 458
 459       <revision>
 460         <revnumber>0.13</revnumber>
 461         <date>2006-04-07</date>
 462         <authorinitials>mhs</authorinitials>
 463         <revremark>Corrected the description of struct v4l2_window
 464 clips. New V4L2_STD_ and V4L2_TUNER_MODE_LANG1_LANG2
 465 defines.</revremark>
 466       </revision>
 467
 468       <revision>
 469         <revnumber>0.12</revnumber>
 470         <date>2006-02-03</date>
 471         <authorinitials>mhs</authorinitials>
 472         <revremark>Corrected the description of struct
 473 v4l2_captureparm and v4l2_outputparm.</revremark>
 474       </revision>
 475
 476       <revision>
 477         <revnumber>0.11</revnumber>
 478         <date>2006-01-27</date>
 479         <authorinitials>mhs</authorinitials>
 480         <revremark>Improved the description of struct
 481 v4l2_tuner.</revremark>
 482       </revision>
 483
 484       <revision>
 485         <revnumber>0.10</revnumber>
 486         <date>2006-01-10</date>
 487         <authorinitials>mhs</authorinitials>
 488         <revremark>VIDIOC_G_INPUT and VIDIOC_S_PARM
 489 clarifications.</revremark>
 490       </revision>
 491
 492       <revision>
 493         <revnumber>0.9</revnumber>
 494         <date>2005-11-27</date>
 495         <authorinitials>mhs</authorinitials>
 496         <revremark>Improved the 525 line numbering diagram. Hans
 497 Verkuil and I rewrote the sliced VBI section. He also contributed a
 498 VIDIOC_LOG_STATUS page. Fixed VIDIOC_S_STD call in the video standard
 499 selection example. Various updates.</revremark>
 500       </revision>
 501
 502       <revision>
 503         <revnumber>0.8</revnumber>
 504         <date>2004-10-04</date>
 505         <authorinitials>mhs</authorinitials>
 506         <revremark>Somehow a piece of junk slipped into the capture
 507 example, removed.</revremark>
 508       </revision>
 509
 510       <revision>
 511         <revnumber>0.7</revnumber>
 512         <date>2004-09-19</date>
 513         <authorinitials>mhs</authorinitials>
 514         <revremark>Fixed video standard selection, control
 515 enumeration, downscaling and aspect example. Added read and user
 516 pointer i/o to video capture example.</revremark>
 517       </revision>
 518
 519       <revision>
 520         <revnumber>0.6</revnumber>
 521         <date>2004-08-01</date>
 522         <authorinitials>mhs</authorinitials>
 523         <revremark>v4l2_buffer changes, added video capture example,
 524 various corrections.</revremark>
 525       </revision>
 526
 527       <revision>
 528         <revnumber>0.5</revnumber>
 529         <date>2003-11-05</date>
 530         <authorinitials>mhs</authorinitials>
 531         <revremark>Pixel format erratum.</revremark>
 532       </revision>
 533
 534       <revision>
 535         <revnumber>0.4</revnumber>
 536         <date>2003-09-17</date>
 537         <authorinitials>mhs</authorinitials>
 538         <revremark>Corrected source and Makefile to generate a PDF.
 539 SGML fixes. Added latest API changes. Closed gaps in the history
 540 chapter.</revremark>
 541       </revision>
 542
 543       <revision>
 544         <revnumber>0.3</revnumber>
 545         <date>2003-02-05</date>
 546         <authorinitials>mhs</authorinitials>
 547         <revremark>Another draft, more corrections.</revremark>
 548       </revision>
 549
 550       <revision>
 551         <revnumber>0.2</revnumber>
 552         <date>2003-01-15</date>
 553         <authorinitials>mhs</authorinitials>
 554         <revremark>Second draft, with corrections pointed out by Gerd
 555 Knorr.</revremark>
 556       </revision>
 557
 558       <revision>
 559         <revnumber>0.1</revnumber>
 560         <date>2002-12-01</date>
 561         <authorinitials>mhs</authorinitials>
 562         <revremark>First draft, based on documentation by Bill Dirks
 563 and discussions on the V4L mailing list.</revremark>
 564       </revision>
 565     </revhistory>
 566 </partinfo>
 567
 568 <title>Video for Linux Two API Specification</title>
 569  <subtitle>Revision 4.4</subtitle>
 570
 571   <chapter id="common">
 572     &sub-common;
 573   </chapter>
 574
 575   <chapter id="pixfmt">
 576     &sub-pixfmt;
 577   </chapter>
 578
 579   <chapter id="io">
 580     &sub-io;
 581   </chapter>
 582
 583   <chapter id="devices">
 584     <title>Interfaces</title>
 585
 586     <section id="capture"> &sub-dev-capture; </section>
 587     <section id="overlay"> &sub-dev-overlay; </section>
 588     <section id="output"> &sub-dev-output; </section>
 589     <section id="osd"> &sub-dev-osd; </section>
 590     <section id="codec"> &sub-dev-codec; </section>
 591     <section id="effect"> &sub-dev-effect; </section>
 592     <section id="raw-vbi"> &sub-dev-raw-vbi; </section>
 593     <section id="sliced"> &sub-dev-sliced-vbi; </section>
 594     <section id="ttx"> &sub-dev-teletext; </section>
 595     <section id="radio"> &sub-dev-radio; </section>
 596     <section id="rds"> &sub-dev-rds; </section>
 597     <section id="sdr"> &sub-dev-sdr; </section>
 598     <section id="event"> &sub-dev-event; </section>
 599     <section id="subdev"> &sub-dev-subdev; </section>
 600   </chapter>
 601
 602   <chapter id="driver">
 603           &sub-driver;
 604   </chapter>
 605
 606   <chapter id="libv4l">
 607           &sub-libv4l;
 608   </chapter>
 609
 610   <chapter id="compat">
 611           &sub-compat;
 612   </chapter>
 613
 614   <appendix id="user-func">
 615   <title>Function Reference</title>
 616
 617     <!-- Keep this alphabetically sorted. -->
 618
 619     &sub-close;
 620     &sub-ioctl;
 621     <!-- All ioctls go here. -->
 622     &sub-create-bufs;
 623     &sub-cropcap;
 624     &sub-dbg-g-chip-info;
 625     &sub-dbg-g-register;
 626     &sub-decoder-cmd;
 627     &sub-dqevent;
 628     &sub-dv-timings-cap;
 629     &sub-encoder-cmd;
 630     &sub-enumaudio;
 631     &sub-enumaudioout;
 632     &sub-enum-dv-timings;
 633     &sub-enum-fmt;
 634     &sub-enum-framesizes;
 635     &sub-enum-frameintervals;
 636     &sub-enum-freq-bands;
 637     &sub-enuminput;
 638     &sub-enumoutput;
 639     &sub-enumstd;
 640     &sub-expbuf;
 641     &sub-g-audio;
 642     &sub-g-audioout;
 643     &sub-g-crop;
 644     &sub-g-ctrl;
 645     &sub-g-dv-timings;
 646     &sub-g-edid;
 647     &sub-g-enc-index;
 648     &sub-g-ext-ctrls;
 649     &sub-g-fbuf;
 650     &sub-g-fmt;
 651     &sub-g-frequency;
 652     &sub-g-input;
 653     &sub-g-jpegcomp;
 654     &sub-g-modulator;
 655     &sub-g-output;
 656     &sub-g-parm;
 657     &sub-g-priority;
 658     &sub-g-selection;
 659     &sub-g-sliced-vbi-cap;
 660     &sub-g-std;
 661     &sub-g-tuner;
 662     &sub-log-status;
 663     &sub-overlay;
 664     &sub-prepare-buf;
 665     &sub-qbuf;
 666     &sub-querybuf;
 667     &sub-querycap;
 668     &sub-queryctrl;
 669     &sub-query-dv-timings;
 670     &sub-querystd;
 671     &sub-reqbufs;
 672     &sub-s-hw-freq-seek;
 673     &sub-streamon;
 674     &sub-subdev-enum-frame-interval;
 675     &sub-subdev-enum-frame-size;
 676     &sub-subdev-enum-mbus-code;
 677     &sub-subdev-g-crop;
 678     &sub-subdev-g-fmt;
 679     &sub-subdev-g-frame-interval;
 680     &sub-subdev-g-selection;
 681     &sub-subscribe-event;
 682     <!-- End of ioctls. -->
 683     &sub-mmap;
 684     &sub-munmap;
 685     &sub-open;
 686     &sub-poll;
 687     &sub-read;
 688     &sub-select;
 689     &sub-write;
 690   </appendix>
 691
 692   <appendix>
 693     <title>Common definitions for V4L2 and V4L2 subdev interfaces</title>
 694       &sub-selections-common;
 695   </appendix>
 696
 697   <appendix id="videodev">
 698     <title>Video For Linux Two Header File</title>
 699     &sub-videodev2-h;
 700   </appendix>
 701
 702   <appendix id="capture-example">
 703     <title>Video Capture Example</title>
 704     &sub-capture-c;
 705   </appendix>
 706
 707   <appendix id="v4l2grab-example">
 708     <title>Video Grabber example using libv4l</title>
 709     <para>This program demonstrates how to grab V4L2 images in ppm format by
 710 using libv4l handlers. The advantage is that this grabber can potentially work
 711 with any V4L2 driver.</para>
 712     &sub-v4l2grab-c;
 713   </appendix>
 714
 715   &sub-media-indices;
 716
 717   &sub-biblio;
 718