1059b1c5bSMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2f9b2e8aaSMauro Carvalho Chehab.. c:namespace:: DTV.dmx
354f38fcaSMauro Carvalho Chehab
454f38fcaSMauro Carvalho Chehab.. _DMX_START:
554f38fcaSMauro Carvalho Chehab
654f38fcaSMauro Carvalho Chehab=========
754f38fcaSMauro Carvalho ChehabDMX_START
854f38fcaSMauro Carvalho Chehab=========
954f38fcaSMauro Carvalho Chehab
1054f38fcaSMauro Carvalho ChehabName
1154f38fcaSMauro Carvalho Chehab----
1254f38fcaSMauro Carvalho Chehab
1354f38fcaSMauro Carvalho ChehabDMX_START
1454f38fcaSMauro Carvalho Chehab
1554f38fcaSMauro Carvalho ChehabSynopsis
1654f38fcaSMauro Carvalho Chehab--------
1754f38fcaSMauro Carvalho Chehab
18f9b2e8aaSMauro Carvalho Chehab.. c:macro:: DMX_START
1954f38fcaSMauro Carvalho Chehab
20f9b2e8aaSMauro Carvalho Chehab``int ioctl(int fd, DMX_START)``
2154f38fcaSMauro Carvalho Chehab
2254f38fcaSMauro Carvalho ChehabArguments
2354f38fcaSMauro Carvalho Chehab---------
2454f38fcaSMauro Carvalho Chehab
2554f38fcaSMauro Carvalho Chehab``fd``
26f9b2e8aaSMauro Carvalho Chehab    File descriptor returned by :c:func:`open()`.
2754f38fcaSMauro Carvalho Chehab
2854f38fcaSMauro Carvalho ChehabDescription
2954f38fcaSMauro Carvalho Chehab-----------
3054f38fcaSMauro Carvalho Chehab
3154f38fcaSMauro Carvalho ChehabThis ioctl call is used to start the actual filtering operation defined
3254f38fcaSMauro Carvalho Chehabvia the ioctl calls :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER`.
3354f38fcaSMauro Carvalho Chehab
3454f38fcaSMauro Carvalho ChehabReturn Value
3554f38fcaSMauro Carvalho Chehab------------
3654f38fcaSMauro Carvalho Chehab
3754f38fcaSMauro Carvalho ChehabOn success 0 is returned.
3854f38fcaSMauro Carvalho Chehab
3954f38fcaSMauro Carvalho ChehabOn error -1 is returned, and the ``errno`` variable is set
4054f38fcaSMauro Carvalho Chehabappropriately.
4154f38fcaSMauro Carvalho Chehab
4254f38fcaSMauro Carvalho Chehab.. tabularcolumns:: |p{2.5cm}|p{15.0cm}|
4354f38fcaSMauro Carvalho Chehab
4454f38fcaSMauro Carvalho Chehab.. flat-table::
4554f38fcaSMauro Carvalho Chehab    :header-rows:  0
4654f38fcaSMauro Carvalho Chehab    :stub-columns: 0
4754f38fcaSMauro Carvalho Chehab
4854f38fcaSMauro Carvalho Chehab    -  .. row 1
4954f38fcaSMauro Carvalho Chehab
5054f38fcaSMauro Carvalho Chehab       -  ``EINVAL``
5154f38fcaSMauro Carvalho Chehab
5254f38fcaSMauro Carvalho Chehab       -  Invalid argument, i.e. no filtering parameters provided via the
5354f38fcaSMauro Carvalho Chehab	  :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER` ioctls.
5454f38fcaSMauro Carvalho Chehab
5554f38fcaSMauro Carvalho Chehab    -  .. row 2
5654f38fcaSMauro Carvalho Chehab
5754f38fcaSMauro Carvalho Chehab       -  ``EBUSY``
5854f38fcaSMauro Carvalho Chehab
5954f38fcaSMauro Carvalho Chehab       -  This error code indicates that there are conflicting requests.
6054f38fcaSMauro Carvalho Chehab	  There are active filters filtering data from another input source.
6154f38fcaSMauro Carvalho Chehab	  Make sure that these filters are stopped before starting this
6254f38fcaSMauro Carvalho Chehab	  filter.
6354f38fcaSMauro Carvalho Chehab
6454f38fcaSMauro Carvalho ChehabThe generic error codes are described at the
6554f38fcaSMauro Carvalho Chehab:ref:`Generic Error Codes <gen-errors>` chapter.
66