1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3.. _DMX_START:
4
5=========
6DMX_START
7=========
8
9Name
10----
11
12DMX_START
13
14
15Synopsis
16--------
17
18.. c:function:: int ioctl( int fd, DMX_START)
19    :name: DMX_START
20
21
22Arguments
23---------
24
25``fd``
26    File descriptor returned by :c:func:`open() <dvb-dmx-open>`.
27
28Description
29-----------
30
31This ioctl call is used to start the actual filtering operation defined
32via the ioctl calls :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER`.
33
34
35Return Value
36------------
37
38On success 0 is returned.
39
40On error -1 is returned, and the ``errno`` variable is set
41appropriately.
42
43.. tabularcolumns:: |p{2.5cm}|p{15.0cm}|
44
45.. flat-table::
46    :header-rows:  0
47    :stub-columns: 0
48
49
50    -  .. row 1
51
52       -  ``EINVAL``
53
54       -  Invalid argument, i.e. no filtering parameters provided via the
55	  :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER` ioctls.
56
57    -  .. row 2
58
59       -  ``EBUSY``
60
61       -  This error code indicates that there are conflicting requests.
62	  There are active filters filtering data from another input source.
63	  Make sure that these filters are stopped before starting this
64	  filter.
65
66
67The generic error codes are described at the
68:ref:`Generic Error Codes <gen-errors>` chapter.
69