tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1.. -*- coding: utf-8; mode: rst -*-
2
3.. _DMX_GET_EVENT:
4
5=============
6DMX_GET_EVENT
7=============
8
9Name
10----
11
12DMX_GET_EVENT
13
14
15Synopsis
16--------
17
18.. c:function:: int ioctl( int fd, DMX_GET_EVENT, struct dmx_event *ev)
19 :name: DMX_GET_EVENT
20
21
22Arguments
23---------
24
25``fd``
26 File descriptor returned by :c:func:`open() <dvb-dmx-open>`.
27
28``ev``
29 Pointer to the location where the event is to be stored.
30
31
32Description
33-----------
34
35This ioctl call returns an event if available. If an event is not
36available, the behavior depends on whether the device is in blocking or
37non-blocking mode. In the latter case, the call fails immediately with
38errno set to ``EWOULDBLOCK``. In the former case, the call blocks until an
39event becomes available.
40
41
42Return Value
43------------
44
45On success 0 is returned, on error -1 and the ``errno`` variable is set
46appropriately. The generic error codes are described at the
47:ref:`Generic Error Codes <gen-errors>` chapter.
48
49
50
51.. flat-table::
52 :header-rows: 0
53 :stub-columns: 0
54
55
56 - .. row 1
57
58 - ``EWOULDBLOCK``
59
60 - There is no event pending, and the device is in non-blocking mode.