162306a36Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 262306a36Sopenharmony_ci.. c:namespace:: DTV.fe 362306a36Sopenharmony_ci 462306a36Sopenharmony_ci.. _FE_GET_EVENT: 562306a36Sopenharmony_ci 662306a36Sopenharmony_ci************ 762306a36Sopenharmony_ciFE_GET_EVENT 862306a36Sopenharmony_ci************ 962306a36Sopenharmony_ci 1062306a36Sopenharmony_ciName 1162306a36Sopenharmony_ci==== 1262306a36Sopenharmony_ci 1362306a36Sopenharmony_ciFE_GET_EVENT 1462306a36Sopenharmony_ci 1562306a36Sopenharmony_ci.. attention:: This ioctl is deprecated. 1662306a36Sopenharmony_ci 1762306a36Sopenharmony_ciSynopsis 1862306a36Sopenharmony_ci======== 1962306a36Sopenharmony_ci 2062306a36Sopenharmony_ci.. c:macro:: FE_GET_EVENT 2162306a36Sopenharmony_ci 2262306a36Sopenharmony_ci``int ioctl(int fd, FE_GET_EVENT, struct dvb_frontend_event *ev)`` 2362306a36Sopenharmony_ci 2462306a36Sopenharmony_ciArguments 2562306a36Sopenharmony_ci========= 2662306a36Sopenharmony_ci 2762306a36Sopenharmony_ci``fd`` 2862306a36Sopenharmony_ci File descriptor returned by :c:func:`open()`. 2962306a36Sopenharmony_ci 3062306a36Sopenharmony_ci``ev`` 3162306a36Sopenharmony_ci Points to the location where the event, if any, is to be stored. 3262306a36Sopenharmony_ci 3362306a36Sopenharmony_ciDescription 3462306a36Sopenharmony_ci=========== 3562306a36Sopenharmony_ci 3662306a36Sopenharmony_ciThis ioctl call returns a frontend event if available. If an event is 3762306a36Sopenharmony_cinot available, the behavior depends on whether the device is in blocking 3862306a36Sopenharmony_cior non-blocking mode. In the latter case, the call fails immediately 3962306a36Sopenharmony_ciwith errno set to ``EWOULDBLOCK``. In the former case, the call blocks until 4062306a36Sopenharmony_cian event becomes available. 4162306a36Sopenharmony_ci 4262306a36Sopenharmony_ciReturn Value 4362306a36Sopenharmony_ci============ 4462306a36Sopenharmony_ci 4562306a36Sopenharmony_ciOn success 0 is returned. 4662306a36Sopenharmony_ci 4762306a36Sopenharmony_ciOn error -1 is returned, and the ``errno`` variable is set 4862306a36Sopenharmony_ciappropriately. 4962306a36Sopenharmony_ci 5062306a36Sopenharmony_ci.. flat-table:: 5162306a36Sopenharmony_ci :header-rows: 0 5262306a36Sopenharmony_ci :stub-columns: 0 5362306a36Sopenharmony_ci 5462306a36Sopenharmony_ci - .. row 1 5562306a36Sopenharmony_ci 5662306a36Sopenharmony_ci - ``EWOULDBLOCK`` 5762306a36Sopenharmony_ci 5862306a36Sopenharmony_ci - There is no event pending, and the device is in non-blocking mode. 5962306a36Sopenharmony_ci 6062306a36Sopenharmony_ci - .. row 2 6162306a36Sopenharmony_ci 6262306a36Sopenharmony_ci - ``EOVERFLOW`` 6362306a36Sopenharmony_ci 6462306a36Sopenharmony_ci - Overflow in event queue - one or more events were lost. 6562306a36Sopenharmony_ci 6662306a36Sopenharmony_ciGeneric error codes are described at the 6762306a36Sopenharmony_ci:ref:`Generic Error Codes <gen-errors>` chapter. 68