driver-api/media/dtv-demux.rst

1 .. SPDX-License-Identifier: GPL-2.0
4 ---------------------
9 The Kernel Digital TV Demux kABI defines a driver-internal interface for
10 registering low-level, hardware specific driver to a hardware independent
12 The header file for this kABI is named ``demux.h`` and located in
15 The demux kABI should be implemented for each demux in the system. It is
20 Each demux receives its TS input from a DVB front-end or from memory, as
21 set via this demux kABI. In a system with more than one front-end, the kABI
22 can be used to select one of the DVB front-ends as a TS source for a demux,
23 unless this is fixed in the HW platform.
25 The demux kABI only controls front-ends regarding to their connections with
26 demuxes; the kABI used to set the other front-end parameters, such as
29 The functions that implement the abstract interface demux should be defined
31 access. It is not necessary to implement every function in the struct
37 Whenever the functions of the demux API modify shared data, the
41 Note that functions called from a bottom half context must not sleep.
42 Even a simple memory allocation without using ``GFP_ATOMIC`` can result in a
44 Linux Kernel calls the functions of a network device interface from a
51 This kernel-space API comprises the callback functions that deliver filtered
52 data to the demux client. Unlike the other DVB kABIs, these functions are
56 structure as in the other demux APIs, because the callback functions are
58 for the API client to provide several callback functions for receiving TS
61 The functions that implement the callback API need not be re-entrant: when
62 a demux driver calls one of these functions, the driver is not allowed to
71 Digital TV Demux device registration functions and data structures
74 .. kernel-doc:: include/media/dmxdev.h
76 High-level Digital TV demux interface
79 .. kernel-doc:: include/media/dvb_demux.h
81 Driver-internal low-level hardware specific driver demux interface
84 .. kernel-doc:: include/media/demux.h