154f38fcaSMauro Carvalho Chehab.. Permission is granted to copy, distribute and/or modify this
254f38fcaSMauro Carvalho Chehab.. document under the terms of the GNU Free Documentation License,
354f38fcaSMauro Carvalho Chehab.. Version 1.1 or any later version published by the Free Software
454f38fcaSMauro Carvalho Chehab.. Foundation, with no Invariant Sections, no Front-Cover Texts
554f38fcaSMauro Carvalho Chehab.. and no Back-Cover Texts. A copy of the license is included at
654f38fcaSMauro Carvalho Chehab.. Documentation/userspace-api/media/fdl-appendix.rst.
754f38fcaSMauro Carvalho Chehab..
854f38fcaSMauro Carvalho Chehab.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
954f38fcaSMauro Carvalho Chehab
1054f38fcaSMauro Carvalho Chehab.. _DMX_START:
1154f38fcaSMauro Carvalho Chehab
1254f38fcaSMauro Carvalho Chehab=========
1354f38fcaSMauro Carvalho ChehabDMX_START
1454f38fcaSMauro Carvalho Chehab=========
1554f38fcaSMauro Carvalho Chehab
1654f38fcaSMauro Carvalho ChehabName
1754f38fcaSMauro Carvalho Chehab----
1854f38fcaSMauro Carvalho Chehab
1954f38fcaSMauro Carvalho ChehabDMX_START
2054f38fcaSMauro Carvalho Chehab
2154f38fcaSMauro Carvalho Chehab
2254f38fcaSMauro Carvalho ChehabSynopsis
2354f38fcaSMauro Carvalho Chehab--------
2454f38fcaSMauro Carvalho Chehab
2554f38fcaSMauro Carvalho Chehab.. c:function:: int ioctl( int fd, DMX_START)
2654f38fcaSMauro Carvalho Chehab    :name: DMX_START
2754f38fcaSMauro Carvalho Chehab
2854f38fcaSMauro Carvalho Chehab
2954f38fcaSMauro Carvalho ChehabArguments
3054f38fcaSMauro Carvalho Chehab---------
3154f38fcaSMauro Carvalho Chehab
3254f38fcaSMauro Carvalho Chehab``fd``
3354f38fcaSMauro Carvalho Chehab    File descriptor returned by :c:func:`open() <dvb-dmx-open>`.
3454f38fcaSMauro Carvalho Chehab
3554f38fcaSMauro Carvalho ChehabDescription
3654f38fcaSMauro Carvalho Chehab-----------
3754f38fcaSMauro Carvalho Chehab
3854f38fcaSMauro Carvalho ChehabThis ioctl call is used to start the actual filtering operation defined
3954f38fcaSMauro Carvalho Chehabvia the ioctl calls :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER`.
4054f38fcaSMauro Carvalho Chehab
4154f38fcaSMauro Carvalho Chehab
4254f38fcaSMauro Carvalho ChehabReturn Value
4354f38fcaSMauro Carvalho Chehab------------
4454f38fcaSMauro Carvalho Chehab
4554f38fcaSMauro Carvalho ChehabOn success 0 is returned.
4654f38fcaSMauro Carvalho Chehab
4754f38fcaSMauro Carvalho ChehabOn error -1 is returned, and the ``errno`` variable is set
4854f38fcaSMauro Carvalho Chehabappropriately.
4954f38fcaSMauro Carvalho Chehab
5054f38fcaSMauro Carvalho Chehab.. tabularcolumns:: |p{2.5cm}|p{15.0cm}|
5154f38fcaSMauro Carvalho Chehab
5254f38fcaSMauro Carvalho Chehab.. flat-table::
5354f38fcaSMauro Carvalho Chehab    :header-rows:  0
5454f38fcaSMauro Carvalho Chehab    :stub-columns: 0
5554f38fcaSMauro Carvalho Chehab
5654f38fcaSMauro Carvalho Chehab
5754f38fcaSMauro Carvalho Chehab    -  .. row 1
5854f38fcaSMauro Carvalho Chehab
5954f38fcaSMauro Carvalho Chehab       -  ``EINVAL``
6054f38fcaSMauro Carvalho Chehab
6154f38fcaSMauro Carvalho Chehab       -  Invalid argument, i.e. no filtering parameters provided via the
6254f38fcaSMauro Carvalho Chehab	  :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER` ioctls.
6354f38fcaSMauro Carvalho Chehab
6454f38fcaSMauro Carvalho Chehab    -  .. row 2
6554f38fcaSMauro Carvalho Chehab
6654f38fcaSMauro Carvalho Chehab       -  ``EBUSY``
6754f38fcaSMauro Carvalho Chehab
6854f38fcaSMauro Carvalho Chehab       -  This error code indicates that there are conflicting requests.
6954f38fcaSMauro Carvalho Chehab	  There are active filters filtering data from another input source.
7054f38fcaSMauro Carvalho Chehab	  Make sure that these filters are stopped before starting this
7154f38fcaSMauro Carvalho Chehab	  filter.
7254f38fcaSMauro Carvalho Chehab
7354f38fcaSMauro Carvalho Chehab
7454f38fcaSMauro Carvalho ChehabThe generic error codes are described at the
7554f38fcaSMauro Carvalho Chehab:ref:`Generic Error Codes <gen-errors>` chapter.
76