1.. Permission is granted to copy, distribute and/or modify this
2.. document under the terms of the GNU Free Documentation License,
3.. Version 1.1 or any later version published by the Free Software
4.. Foundation, with no Invariant Sections, no Front-Cover Texts
5.. and no Back-Cover Texts. A copy of the license is included at
6.. Documentation/userspace-api/media/fdl-appendix.rst.
7..
8.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
9
10.. _DMX_START:
11
12=========
13DMX_START
14=========
15
16Name
17----
18
19DMX_START
20
21
22Synopsis
23--------
24
25.. c:function:: int ioctl( int fd, DMX_START)
26    :name: DMX_START
27
28
29Arguments
30---------
31
32``fd``
33    File descriptor returned by :c:func:`open() <dvb-dmx-open>`.
34
35Description
36-----------
37
38This ioctl call is used to start the actual filtering operation defined
39via the ioctl calls :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER`.
40
41
42Return Value
43------------
44
45On success 0 is returned.
46
47On error -1 is returned, and the ``errno`` variable is set
48appropriately.
49
50.. tabularcolumns:: |p{2.5cm}|p{15.0cm}|
51
52.. flat-table::
53    :header-rows:  0
54    :stub-columns: 0
55
56
57    -  .. row 1
58
59       -  ``EINVAL``
60
61       -  Invalid argument, i.e. no filtering parameters provided via the
62	  :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER` ioctls.
63
64    -  .. row 2
65
66       -  ``EBUSY``
67
68       -  This error code indicates that there are conflicting requests.
69	  There are active filters filtering data from another input source.
70	  Make sure that these filters are stopped before starting this
71	  filter.
72
73
74The generic error codes are described at the
75:ref:`Generic Error Codes <gen-errors>` chapter.
76