| 1 |
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later |
| 2 |
.. c:namespace:: V4L |
| 3 |
|
| 4 |
.. _app-pri: |
| 5 |
|
| 6 |
******************** |
| 7 |
Application Priority |
| 8 |
******************** |
| 9 |
|
| 10 |
When multiple applications share a device it may be desirable to assign |
| 11 |
them different priorities. Contrary to the traditional "rm -rf /" school |
| 12 |
of thought, a video recording application could for example block other |
| 13 |
applications from changing video controls or switching the current TV |
| 14 |
channel. Another objective is to permit low priority applications |
| 15 |
working in background, which can be preempted by user controlled |
| 16 |
applications and automatically regain control of the device at a later |
| 17 |
time. |
| 18 |
|
| 19 |
Since these features cannot be implemented entirely in user space V4L2 |
| 20 |
defines the :ref:`VIDIOC_G_PRIORITY <VIDIOC_G_PRIORITY>` and |
| 21 |
:ref:`VIDIOC_S_PRIORITY <VIDIOC_G_PRIORITY>` ioctls to request and |
| 22 |
query the access priority associate with a file descriptor. Opening a |
| 23 |
device assigns a medium priority, compatible with earlier versions of |
| 24 |
V4L2 and drivers not supporting these ioctls. Applications requiring a |
| 25 |
different priority will usually call :ref:`VIDIOC_S_PRIORITY |
| 26 |
<VIDIOC_G_PRIORITY>` after verifying the device with the |
| 27 |
:ref:`VIDIOC_QUERYCAP` ioctl. |
| 28 |
|
| 29 |
Ioctls changing driver properties, such as |
| 30 |
:ref:`VIDIOC_S_INPUT <VIDIOC_G_INPUT>`, return an ``EBUSY`` error code |
| 31 |
after another application obtained higher priority. |