mirror of
https://github.com/torvalds/linux.git
synced 2024-12-14 15:13:52 +00:00
c2b66cafdf
Shorten the tables by removing row numbers in comments, allowing for
later insertion of rows with minimal diffs.
All changes have been generated by the following script.
import io
import re
import sys
def process_table(fname, data):
if fname.endswith('hist-v4l2.rst'):
data = re.sub(u'\n{1,2}\t( ?) -( ?) ?', u'\n\t\\1 -\\2', data, flags = re.MULTILINE)
data = re.sub(u'\n(\t| )- \.\. row [0-9]+\n\t ?-( ?) ?', u'\\1* -\\2', data, flags = re.MULTILINE)
else:
data = re.sub(u'\n{1,2} -( ?) ?', u'\n -\\1', data, flags = re.MULTILINE)
data = re.sub(u'(\n?)(\n\n - \.\. row 1\n)', u'\n\\2', data, flags = re.MULTILINE)
data = re.sub(u'\n - \.\. row [0-9]+\n -( ?) ?', u' * -\\1', data, flags = re.MULTILINE)
data = re.sub(u'\n - \.\. row [0-9]+\n \.\. (_[A-Z0-9_`-]*:)', u'\n - .. \\1', data, flags = re.MULTILINE)
data = re.sub(u'\n - \.\. (_[A-Z0-9_`-]*:)\n -', u' * .. \\1\n\n -', data, flags = re.MULTILINE)
data = re.sub(u'^ - ', u' -', data, flags = re.MULTILINE)
data = re.sub(u'^(\t{1,2}) ', u'\\1', data, flags = re.MULTILINE)
return data
def process_file(fname, data):
buf = io.StringIO(data)
output = ''
in_table = False
table_separator = 0
for line in buf.readlines():
if line.find('.. flat-table::') != -1:
in_table = True
table = ''
elif in_table and not re.match('^[\t\n]|( )', line):
in_table = False
output += process_table(fname, table)
if in_table:
table += line
else:
output += line
if in_table:
in_table = False
output += process_table(fname, table)
return output
fname = sys.argv[1]
data = file(fname, 'rb').read().decode('utf-8')
data = process_file(fname, data)
file(fname, 'wb').write(data.encode('utf-8'))
Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
94 lines
2.6 KiB
ReStructuredText
94 lines
2.6 KiB
ReStructuredText
.. -*- coding: utf-8; mode: rst -*-
|
|
|
|
.. _VIDIOC_G_PRIORITY:
|
|
|
|
******************************************
|
|
ioctl VIDIOC_G_PRIORITY, VIDIOC_S_PRIORITY
|
|
******************************************
|
|
|
|
Name
|
|
====
|
|
|
|
VIDIOC_G_PRIORITY - VIDIOC_S_PRIORITY - Query or request the access priority associated with a file descriptor
|
|
|
|
|
|
Synopsis
|
|
========
|
|
|
|
.. c:function:: int ioctl( int fd, VIDIOC_G_PRIORITY, enum v4l2_priority *argp )
|
|
:name: VIDIOC_G_PRIORITY
|
|
|
|
.. c:function:: int ioctl( int fd, VIDIOC_S_PRIORITY, const enum v4l2_priority *argp )
|
|
:name: VIDIOC_S_PRIORITY
|
|
|
|
|
|
Arguments
|
|
=========
|
|
|
|
``fd``
|
|
File descriptor returned by :ref:`open() <func-open>`.
|
|
|
|
``argp``
|
|
Pointer to an enum v4l2_priority type.
|
|
|
|
|
|
Description
|
|
===========
|
|
|
|
To query the current access priority applications call the
|
|
:ref:`VIDIOC_G_PRIORITY <VIDIOC_G_PRIORITY>` ioctl with a pointer to an enum v4l2_priority
|
|
variable where the driver stores the current priority.
|
|
|
|
To request an access priority applications store the desired priority in
|
|
an enum v4l2_priority variable and call :ref:`VIDIOC_S_PRIORITY <VIDIOC_G_PRIORITY>` ioctl
|
|
with a pointer to this variable.
|
|
|
|
|
|
.. c:type:: v4l2_priority
|
|
|
|
.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
|
|
|
|
.. flat-table:: enum v4l2_priority
|
|
:header-rows: 0
|
|
:stub-columns: 0
|
|
:widths: 3 1 4
|
|
|
|
* - ``V4L2_PRIORITY_UNSET``
|
|
- 0
|
|
-
|
|
* - ``V4L2_PRIORITY_BACKGROUND``
|
|
- 1
|
|
- Lowest priority, usually applications running in background, for
|
|
example monitoring VBI transmissions. A proxy application running
|
|
in user space will be necessary if multiple applications want to
|
|
read from a device at this priority.
|
|
* - ``V4L2_PRIORITY_INTERACTIVE``
|
|
- 2
|
|
-
|
|
* - ``V4L2_PRIORITY_DEFAULT``
|
|
- 2
|
|
- Medium priority, usually applications started and interactively
|
|
controlled by the user. For example TV viewers, Teletext browsers,
|
|
or just "panel" applications to change the channel or video
|
|
controls. This is the default priority unless an application
|
|
requests another.
|
|
* - ``V4L2_PRIORITY_RECORD``
|
|
- 3
|
|
- Highest priority. Only one file descriptor can have this priority,
|
|
it blocks any other fd from changing device properties. Usually
|
|
applications which must not be interrupted, like video recording.
|
|
|
|
|
|
Return Value
|
|
============
|
|
|
|
On success 0 is returned, on error -1 and the ``errno`` variable is set
|
|
appropriately. The generic error codes are described at the
|
|
:ref:`Generic Error Codes <gen-errors>` chapter.
|
|
|
|
EINVAL
|
|
The requested priority value is invalid.
|
|
|
|
EBUSY
|
|
Another application already requested higher priority.
|