68 lines · plain
1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later2.. c:namespace:: DTV.fe3 4.. _FE_GET_EVENT:5 6************7FE_GET_EVENT8************9 10Name11====12 13FE_GET_EVENT14 15.. attention:: This ioctl is deprecated.16 17Synopsis18========19 20.. c:macro:: FE_GET_EVENT21 22``int ioctl(int fd, FE_GET_EVENT, struct dvb_frontend_event *ev)``23 24Arguments25=========26 27``fd``28 File descriptor returned by :c:func:`open()`.29 30``ev``31 Points to the location where the event, if any, is to be stored.32 33Description34===========35 36This ioctl call returns a frontend event if available. If an event is37not available, the behavior depends on whether the device is in blocking38or non-blocking mode. In the latter case, the call fails immediately39with errno set to ``EWOULDBLOCK``. In the former case, the call blocks until40an event becomes available.41 42Return Value43============44 45On success 0 is returned.46 47On error -1 is returned, and the ``errno`` variable is set48appropriately.49 50.. flat-table::51 :header-rows: 052 :stub-columns: 053 54 - .. row 155 56 - ``EWOULDBLOCK``57 58 - There is no event pending, and the device is in non-blocking mode.59 60 - .. row 261 62 - ``EOVERFLOW``63 64 - Overflow in event queue - one or more events were lost.65 66Generic error codes are described at the67:ref:`Generic Error Codes <gen-errors>` chapter.68