Commit 8968da9b authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab

Revert "[media] docs-rst: escape [] characters"

This patch touches on places where it shouldn't: image
files and code examples. Also, it doesn't fix all array
occurrences.

So, let's revert it.

This reverts commit ffbab694.
parent d2cd627b
...@@ -52,7 +52,7 @@ returns the information to the application. The ioctl never fails. ...@@ -52,7 +52,7 @@ returns the information to the application. The ioctl never fails.
- char - char
- ``driver\[32\]`` - ``driver[32]``
- The name of the cec adapter driver. - The name of the cec adapter driver.
...@@ -60,7 +60,7 @@ returns the information to the application. The ioctl never fails. ...@@ -60,7 +60,7 @@ returns the information to the application. The ioctl never fails.
- char - char
- ``name\[32\]`` - ``name[32]``
- The name of this CEC adapter. The combination ``driver`` and - The name of this CEC adapter. The combination ``driver`` and
``name`` must be unique. ``name`` must be unique.
......
...@@ -70,7 +70,7 @@ by a file handle in initiator mode (see ...@@ -70,7 +70,7 @@ by a file handle in initiator mode (see
- The actual logical addresses that were claimed. This is set by the - The actual logical addresses that were claimed. This is set by the
driver. If no logical address could be claimed, then it is set to driver. If no logical address could be claimed, then it is set to
``CEC_LOG_ADDR_INVALID``. If this adapter is Unregistered, then ``CEC_LOG_ADDR_INVALID``. If this adapter is Unregistered, then
``log_addr\[0\]`` is set to 0xf and all others to ``log_addr[0]`` is set to 0xf and all others to
``CEC_LOG_ADDR_INVALID``. ``CEC_LOG_ADDR_INVALID``.
- .. row 2 - .. row 2
...@@ -138,7 +138,7 @@ by a file handle in initiator mode (see ...@@ -138,7 +138,7 @@ by a file handle in initiator mode (see
- char - char
- ``osd_name``\ \[15\] - ``osd_name``\ [15]
- The On-Screen Display name as is returned by the - The On-Screen Display name as is returned by the
``CEC_MSG_SET_OSD_NAME`` message. ``CEC_MSG_SET_OSD_NAME`` message.
...@@ -178,7 +178,7 @@ by a file handle in initiator mode (see ...@@ -178,7 +178,7 @@ by a file handle in initiator mode (see
- __u8 - __u8
- ``features`` [CEC_MAX_LOG_ADDRS]\[12\] - ``features`` [CEC_MAX_LOG_ADDRS][12]
- Features for each logical address. Used to implement the - Features for each logical address. Used to implement the
``CEC_MSG_REPORT_FEATURES`` message. The 12 bytes include both the ``CEC_MSG_REPORT_FEATURES`` message. The 12 bytes include both the
......
...@@ -133,7 +133,7 @@ queue, then it will return -1 and set errno to the EBUSY error code. ...@@ -133,7 +133,7 @@ queue, then it will return -1 and set errno to the EBUSY error code.
- __u8 - __u8
- ``msg``\ \[16\] - ``msg``\ [16]
- The message payload. For :ref:`CEC_TRANSMIT` this is filled in by the - The message payload. For :ref:`CEC_TRANSMIT` this is filled in by the
application. The driver will fill this in for :ref:`CEC_RECEIVE` and application. The driver will fill this in for :ref:`CEC_RECEIVE` and
......
...@@ -77,7 +77,7 @@ ca_msg_t ...@@ -77,7 +77,7 @@ ca_msg_t
unsigned int index; unsigned int index;
unsigned int type; unsigned int type;
unsigned int length; unsigned int length;
unsigned char msg\[256\]; unsigned char msg[256];
} ca_msg_t; } ca_msg_t;
...@@ -92,7 +92,7 @@ ca_descr_t ...@@ -92,7 +92,7 @@ ca_descr_t
typedef struct ca_descr { typedef struct ca_descr {
unsigned int index; unsigned int index;
unsigned int parity; unsigned int parity;
unsigned char cw\[8\]; unsigned char cw[8];
} ca_descr_t; } ca_descr_t;
......
...@@ -15,7 +15,7 @@ DMX_GET_PES_PIDS ...@@ -15,7 +15,7 @@ DMX_GET_PES_PIDS
Synopsis Synopsis
-------- --------
.. cpp:function:: int ioctl(fd, int request = DMX_GET_PES_PIDS, __u16\[5\]) .. cpp:function:: int ioctl(fd, int request = DMX_GET_PES_PIDS, __u16[5])
Arguments Arguments
...@@ -40,7 +40,7 @@ Arguments ...@@ -40,7 +40,7 @@ Arguments
- .. row 3 - .. row 3
- __u16\[5\] - __u16[5]
- Undocumented. - Undocumented.
......
...@@ -13,14 +13,14 @@ struct dtv_property ...@@ -13,14 +13,14 @@ struct dtv_property
struct dtv_property { struct dtv_property {
__u32 cmd; __u32 cmd;
__u32 reserved\[3\]; __u32 reserved[3];
union { union {
__u32 data; __u32 data;
struct dtv_fe_stats st; struct dtv_fe_stats st;
struct { struct {
__u8 data\[32\]; __u8 data[32];
__u32 len; __u32 len;
__u32 reserved1\[3\]; __u32 reserved1[3];
void *reserved2; void *reserved2;
} buffer; } buffer;
} u; } u;
......
...@@ -87,7 +87,7 @@ tuners, but can easily be adjusted for QAM. ...@@ -87,7 +87,7 @@ tuners, but can easily be adjusted for QAM.
struct secCmdSequence scmds; struct secCmdSequence scmds;
struct dmx_pes_filter_params pesFilterParams; struct dmx_pes_filter_params pesFilterParams;
FrontendParameters frp; FrontendParameters frp;
struct pollfd pfd\[1\]; struct pollfd pfd[1];
FrontendEvent event; FrontendEvent event;
int demux1, demux2, demux3, front; int demux1, demux2, demux3, front;
...@@ -143,7 +143,7 @@ tuners, but can easily be adjusted for QAM. ...@@ -143,7 +143,7 @@ tuners, but can easily be adjusted for QAM.
scmd.u.diseqc.addr=0x10; scmd.u.diseqc.addr=0x10;
scmd.u.diseqc.cmd=0x38; scmd.u.diseqc.cmd=0x38;
scmd.u.diseqc.numParams=1; scmd.u.diseqc.numParams=1;
scmd.u.diseqc.params\[0\] = 0xF0 | ((diseqc * 4) & 0x0F) | scmd.u.diseqc.params[0] = 0xF0 | ((diseqc * 4) & 0x0F) |
(scmds.continuousTone == SEC_TONE_ON ? 1 : 0) | (scmds.continuousTone == SEC_TONE_ON ? 1 : 0) |
(scmds.voltage==SEC_VOLTAGE_18 ? 2 : 0); (scmds.voltage==SEC_VOLTAGE_18 ? 2 : 0);
...@@ -168,11 +168,11 @@ tuners, but can easily be adjusted for QAM. ...@@ -168,11 +168,11 @@ tuners, but can easily be adjusted for QAM.
return -1; return -1;
} }
pfd\[0\].fd = front; pfd[0].fd = front;
pfd\[0\].events = POLLIN; pfd[0].events = POLLIN;
if (poll(pfd,1,3000)){ if (poll(pfd,1,3000)){
if (pfd\[0\].revents & POLLIN){ if (pfd[0].revents & POLLIN){
printf("Getting QPSK event\\n"); printf("Getting QPSK event\\n");
if ( ioctl(front, FE_GET_EVENT, &event) if ( ioctl(front, FE_GET_EVENT, &event)
...@@ -324,7 +324,7 @@ recording. ...@@ -324,7 +324,7 @@ recording.
int written; int written;
uint8_t buf[BUFFY]; uint8_t buf[BUFFY];
uint64_t length; uint64_t length;
struct pollfd pfd\[1\]; struct pollfd pfd[1];
int dvr, dvr_out; int dvr, dvr_out;
/* open dvr device */ /* open dvr device */
...@@ -351,13 +351,13 @@ recording. ...@@ -351,13 +351,13 @@ recording.
return -1; return -1;
} }
pfd\[0\].fd = dvr; pfd[0].fd = dvr;
pfd\[0\].events = POLLIN; pfd[0].events = POLLIN;
/* poll for dvr data and write to file */ /* poll for dvr data and write to file */
while (length < MAX_LENGTH ) { while (length < MAX_LENGTH ) {
if (poll(pfd,1,1)){ if (poll(pfd,1,1)){
if (pfd\[0\].revents & POLLIN){ if (pfd[0].revents & POLLIN){
len = read(dvr, buf, BUFFY); len = read(dvr, buf, BUFFY);
if (len < 0){ if (len < 0){
perror("recording"); perror("recording");
......
...@@ -52,9 +52,9 @@ struct dvb_diseqc_slave_reply ...@@ -52,9 +52,9 @@ struct dvb_diseqc_slave_reply
- uint8_t - uint8_t
- msg\[4\] - msg[4]
- DiSEqC message (framing, data\[3\]) - DiSEqC message (framing, data[3])
- .. row 2 - .. row 2
......
...@@ -52,9 +52,9 @@ struct dvb_diseqc_master_cmd ...@@ -52,9 +52,9 @@ struct dvb_diseqc_master_cmd
- uint8_t - uint8_t
- msg\[6\] - msg[6]
- DiSEqC message (framing, address, command, data\[3\]) - DiSEqC message (framing, address, command, data[3])
- .. row 2 - .. row 2
......
...@@ -57,7 +57,7 @@ struct dvb_frontend_info ...@@ -57,7 +57,7 @@ struct dvb_frontend_info
- char - char
- name\[128\] - name[128]
- Name of the frontend - Name of the frontend
......
...@@ -125,7 +125,7 @@ it can be extended safely in the future. ...@@ -125,7 +125,7 @@ it can be extended safely in the future.
} play; } play;
struct { struct {
__u32 data\[16\]; __u32 data[16];
} raw; } raw;
}; };
}; };
...@@ -352,7 +352,7 @@ passed to the ioctl VIDEO_GET_NAVI: ...@@ -352,7 +352,7 @@ passed to the ioctl VIDEO_GET_NAVI:
typedef typedef
struct video_navi_pack { struct video_navi_pack {
int length; /* 0 ... 1024 */ int length; /* 0 ... 1024 */
uint8_t data\[1024\]; uint8_t data[1024];
} video_navi_pack_t; } video_navi_pack_t;
......
...@@ -52,7 +52,7 @@ ioctl never fails. ...@@ -52,7 +52,7 @@ ioctl never fails.
- char - char
- ``driver``\ \[16\] - ``driver``\ [16]
- Name of the driver implementing the media API as a NUL-terminated - Name of the driver implementing the media API as a NUL-terminated
ASCII string. The driver version is stored in the ASCII string. The driver version is stored in the
...@@ -66,7 +66,7 @@ ioctl never fails. ...@@ -66,7 +66,7 @@ ioctl never fails.
- char - char
- ``model``\ \[32\] - ``model``\ [32]
- Device model name as a NUL-terminated UTF-8 string. The device - Device model name as a NUL-terminated UTF-8 string. The device
version is stored in the ``device_version`` field and is not be version is stored in the ``device_version`` field and is not be
...@@ -76,7 +76,7 @@ ioctl never fails. ...@@ -76,7 +76,7 @@ ioctl never fails.
- char - char
- ``serial``\ \[40\] - ``serial``\ [40]
- Serial number as a NUL-terminated ASCII string. - Serial number as a NUL-terminated ASCII string.
...@@ -84,7 +84,7 @@ ioctl never fails. ...@@ -84,7 +84,7 @@ ioctl never fails.
- char - char
- ``bus_info``\ \[32\] - ``bus_info``\ [32]
- Location of the device in the system as a NUL-terminated ASCII - Location of the device in the system as a NUL-terminated ASCII
string. This includes the bus type name (PCI, USB, ...) and a string. This includes the bus type name (PCI, USB, ...) and a
...@@ -120,7 +120,7 @@ ioctl never fails. ...@@ -120,7 +120,7 @@ ioctl never fails.
- __u32 - __u32
- ``reserved``\ \[31\] - ``reserved``\ [31]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
this array to zero. this array to zero.
......
...@@ -75,7 +75,7 @@ id's until they get an error. ...@@ -75,7 +75,7 @@ id's until they get an error.
- char - char
- ``name``\ \[32\] - ``name``\ [32]
- -
- -
...@@ -181,7 +181,7 @@ id's until they get an error. ...@@ -181,7 +181,7 @@ id's until they get an error.
- -
- __u8 - __u8
- ``raw``\ \[184\] - ``raw``\ [184]
- -
- -
......
...@@ -163,7 +163,7 @@ desired arrays with the media graph elements. ...@@ -163,7 +163,7 @@ desired arrays with the media graph elements.
- char - char
- ``name``\ \[64\] - ``name``\ [64]
- Entity name as an UTF-8 NULL-terminated string. - Entity name as an UTF-8 NULL-terminated string.
...@@ -179,7 +179,7 @@ desired arrays with the media graph elements. ...@@ -179,7 +179,7 @@ desired arrays with the media graph elements.
- __u32 - __u32
- ``reserved``\ \[12\] - ``reserved``\ [12]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
this array to zero. this array to zero.
...@@ -221,7 +221,7 @@ desired arrays with the media graph elements. ...@@ -221,7 +221,7 @@ desired arrays with the media graph elements.
- __u32 - __u32
- ``reserved``\ \[9\] - ``reserved``\ [9]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
this array to zero. this array to zero.
...@@ -299,7 +299,7 @@ desired arrays with the media graph elements. ...@@ -299,7 +299,7 @@ desired arrays with the media graph elements.
- __u32 - __u32
- ``reserved``\ \[9\] - ``reserved``\ [9]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
this array to zero. this array to zero.
...@@ -354,7 +354,7 @@ desired arrays with the media graph elements. ...@@ -354,7 +354,7 @@ desired arrays with the media graph elements.
- __u32 - __u32
- ``reserved``\ \[5\] - ``reserved``\ [5]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
this array to zero. this array to zero.
......
...@@ -35,16 +35,16 @@ file: uapi/v4l/keytable.c ...@@ -35,16 +35,16 @@ file: uapi/v4l/keytable.c
struct parse_key *p; struct parse_key *p;
for (p=keynames;p->name!=NULL;p++) { for (p=keynames;p->name!=NULL;p++) {
if (p->value == (unsigned)codes\[1\]) { if (p->value == (unsigned)codes[1]) {
printf("scancode 0x%04x = %s (0x%02x)\\n", codes\[0\], p->name, codes\[1\]); printf("scancode 0x%04x = %s (0x%02x)\\n", codes[0], p->name, codes[1]);
return; return;
} }
} }
if (isprint (codes\[1\])) if (isprint (codes[1]))
printf("scancode %d = '%c' (0x%02x)\\n", codes\[0\], codes\[1\], codes\[1\]); printf("scancode %d = '%c' (0x%02x)\\n", codes[0], codes[1], codes[1]);
else else
printf("scancode %d = 0x%02x\\n", codes\[0\], codes\[1\]); printf("scancode %d = 0x%02x\\n", codes[0], codes[1]);
} }
int parse_code(char *string) int parse_code(char *string)
...@@ -63,7 +63,7 @@ file: uapi/v4l/keytable.c ...@@ -63,7 +63,7 @@ file: uapi/v4l/keytable.c
{ {
int fd; int fd;
unsigned int i, j; unsigned int i, j;
int codes\[2\]; int codes[2];
if (argc<2 || argc>4) { if (argc<2 || argc>4) {
printf ("usage: %s <device> to get table; or\\n" printf ("usage: %s <device> to get table; or\\n"
...@@ -72,7 +72,7 @@ file: uapi/v4l/keytable.c ...@@ -72,7 +72,7 @@ file: uapi/v4l/keytable.c
return -1; return -1;
} }
if ((fd = open(argv\[1\], O_RDONLY)) < 0) { if ((fd = open(argv[1], O_RDONLY)) < 0) {
perror("Couldn't open input device"); perror("Couldn't open input device");
return(-1); return(-1);
} }
...@@ -80,16 +80,16 @@ file: uapi/v4l/keytable.c ...@@ -80,16 +80,16 @@ file: uapi/v4l/keytable.c
if (argc==4) { if (argc==4) {
int value; int value;
value=parse_code(argv\[3\]); value=parse_code(argv[3]);
if (value==-1) { if (value==-1) {
value = strtol(argv\[3\], NULL, 0); value = strtol(argv[3], NULL, 0);
if (errno) if (errno)
perror("value"); perror("value");
} }
codes \[0\] = (unsigned) strtol(argv\[2\], NULL, 0); codes [0] = (unsigned) strtol(argv[2], NULL, 0);
codes \[1\] = (unsigned) value; codes [1] = (unsigned) value;
if(ioctl(fd, EVIOCSKEYCODE, codes)) if(ioctl(fd, EVIOCSKEYCODE, codes))
perror ("EVIOCSKEYCODE"); perror ("EVIOCSKEYCODE");
...@@ -102,9 +102,9 @@ file: uapi/v4l/keytable.c ...@@ -102,9 +102,9 @@ file: uapi/v4l/keytable.c
if (argc==3) { if (argc==3) {
FILE *fin; FILE *fin;
int value; int value;
char *scancode, *keycode, s\[2048\]; char *scancode, *keycode, s[2048];
fin=fopen(argv\[2\],"r"); fin=fopen(argv[2],"r");
if (fin==NULL) { if (fin==NULL) {
perror ("opening keycode file"); perror ("opening keycode file");
return -1; return -1;
...@@ -113,8 +113,8 @@ file: uapi/v4l/keytable.c ...@@ -113,8 +113,8 @@ file: uapi/v4l/keytable.c
/* Clears old table */ /* Clears old table */
for (j = 0; j < 256; j++) { for (j = 0; j < 256; j++) {
for (i = 0; i < 256; i++) { for (i = 0; i < 256; i++) {
codes\[0\] = (j << 8) | i; codes[0] = (j << 8) | i;
codes\[1\] = KEY_RESERVED; codes[1] = KEY_RESERVED;
ioctl(fd, EVIOCSKEYCODE, codes); ioctl(fd, EVIOCSKEYCODE, codes);
} }
} }
...@@ -149,12 +149,12 @@ file: uapi/v4l/keytable.c ...@@ -149,12 +149,12 @@ file: uapi/v4l/keytable.c
perror("value"); perror("value");
} }
codes \[0\] = (unsigned) strtol(scancode, NULL, 0); codes [0] = (unsigned) strtol(scancode, NULL, 0);
codes \[1\] = (unsigned) value; codes [1] = (unsigned) value;
// printf("\\t%04x=%04x\\n",codes\[0\], codes\[1\]); // printf("\\t%04x=%04x\\n",codes[0], codes[1]);
if(ioctl(fd, EVIOCSKEYCODE, codes)) { if(ioctl(fd, EVIOCSKEYCODE, codes)) {
fprintf(stderr, "Setting scancode 0x%04x with 0x%04x via ",codes\[0\], codes\[1\]); fprintf(stderr, "Setting scancode 0x%04x with 0x%04x via ",codes[0], codes[1]);
perror ("EVIOCSKEYCODE"); perror ("EVIOCSKEYCODE");
} }
...@@ -167,8 +167,8 @@ file: uapi/v4l/keytable.c ...@@ -167,8 +167,8 @@ file: uapi/v4l/keytable.c
/* Get scancode table */ /* Get scancode table */
for (j = 0; j < 256; j++) { for (j = 0; j < 256; j++) {
for (i = 0; i < 256; i++) { for (i = 0; i < 256; i++) {
codes\[0\] = (j << 8) | i; codes[0] = (j << 8) | i;
if (!ioctl(fd, EVIOCGKEYCODE, codes) && codes\[1\] != KEY_RESERVED) if (!ioctl(fd, EVIOCGKEYCODE, codes) && codes[1] != KEY_RESERVED)
prtcode(codes); prtcode(codes);
} }
} }
......
...@@ -379,7 +379,7 @@ struct v4l2_plane ...@@ -379,7 +379,7 @@ struct v4l2_plane
- __u32 - __u32
- ``reserved\[11\]`` - ``reserved[11]``
- -
- Reserved for future use. Should be zeroed by drivers and - Reserved for future use. Should be zeroed by drivers and
...@@ -868,7 +868,7 @@ struct v4l2_timecode ...@@ -868,7 +868,7 @@ struct v4l2_timecode
- __u8 - __u8
- ``userbits``\ \[4\] - ``userbits``\ [4]
- The "user group" bits from the timecode. - The "user group" bits from the timecode.
......
...@@ -88,7 +88,7 @@ file: media/v4l/capture.c ...@@ -88,7 +88,7 @@ file: media/v4l/capture.c
switch (io) { switch (io) {
case IO_METHOD_READ: case IO_METHOD_READ:
if (-1 == read(fd, buffers\[0\].start, buffers\[0\].length)) { if (-1 == read(fd, buffers[0].start, buffers[0].length)) {
switch (errno) { switch (errno) {
case EAGAIN: case EAGAIN:
return 0; return 0;
...@@ -103,7 +103,7 @@ file: media/v4l/capture.c ...@@ -103,7 +103,7 @@ file: media/v4l/capture.c
} }
} }
process_image(buffers\[0\].start, buffers\[0\].length); process_image(buffers[0].start, buffers[0].length);
break; break;
case IO_METHOD_MMAP: case IO_METHOD_MMAP:
...@@ -284,7 +284,7 @@ file: media/v4l/capture.c ...@@ -284,7 +284,7 @@ file: media/v4l/capture.c
switch (io) { switch (io) {
case IO_METHOD_READ: case IO_METHOD_READ:
free(buffers\[0\].start); free(buffers[0].start);
break; break;
case IO_METHOD_MMAP: case IO_METHOD_MMAP:
...@@ -311,10 +311,10 @@ file: media/v4l/capture.c ...@@ -311,10 +311,10 @@ file: media/v4l/capture.c
exit(EXIT_FAILURE); exit(EXIT_FAILURE);
} }
buffers\[0\].length = buffer_size; buffers[0].length = buffer_size;
buffers\[0\].start = malloc(buffer_size); buffers[0].start = malloc(buffer_size);
if (!buffers\[0\].start) { if (!buffers[0].start) {
fprintf(stderr, "Out of memory\\n"); fprintf(stderr, "Out of memory\\n");
exit(EXIT_FAILURE); exit(EXIT_FAILURE);
} }
...@@ -575,7 +575,7 @@ file: media/v4l/capture.c ...@@ -575,7 +575,7 @@ file: media/v4l/capture.c
"-f | --format Force format to 640x480 YUYVn" "-f | --format Force format to 640x480 YUYVn"
"-c | --count Number of frames to grab [%i]n" "-c | --count Number of frames to grab [%i]n"
"", "",
argv\[0\], dev_name, frame_count); argv[0], dev_name, frame_count);
} }
static const char short_options[] = "d:hmruofc:"; static const char short_options[] = "d:hmruofc:";
......
...@@ -68,7 +68,7 @@ Example: Finding a framebuffer device for OSD ...@@ -68,7 +68,7 @@ Example: Finding a framebuffer device for OSD
} }
for (i = 0; i < 30; i++) { for (i = 0; i < 30; i++) {
char dev_name\[16\]; char dev_name[16];
struct fb_fix_screeninfo si; struct fb_fix_screeninfo si;
snprintf(dev_name, sizeof(dev_name), "/dev/fb%u", i); snprintf(dev_name, sizeof(dev_name), "/dev/fb%u", i);
......
...@@ -188,7 +188,7 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does ...@@ -188,7 +188,7 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does
service transmissions embedded in the picture. service transmissions embedded in the picture.
An application can set the first or second ``count`` value to zero An application can set the first or second ``count`` value to zero
if no data is required from the respective field; ``count``\ \[1\] if no data is required from the respective field; ``count``\ [1]
if the scanning system is progressive, i. e. not interlaced. The if the scanning system is progressive, i. e. not interlaced. The
corresponding start value shall be ignored by the application and corresponding start value shall be ignored by the application and
driver. Anyway, drivers may not support single field capturing and driver. Anyway, drivers may not support single field capturing and
...@@ -318,7 +318,7 @@ The total size of a frame computes as follows: ...@@ -318,7 +318,7 @@ The total size of a frame computes as follows:
.. code-block:: c .. code-block:: c
(count\[0\] + count\[1\]) * samples_per_line * sample size in bytes (count[0] + count[1]) * samples_per_line * sample size in bytes
The sample size is most likely always one byte, applications must check The sample size is most likely always one byte, applications must check
the ``sample_format`` field though, to function properly with other the ``sample_format`` field though, to function properly with other
......
...@@ -110,7 +110,7 @@ data transfer, set by the driver in order to inform application. ...@@ -110,7 +110,7 @@ data transfer, set by the driver in order to inform application.
- __u8 - __u8
- ``reserved\[24\]`` - ``reserved[24]``
- This array is reserved for future extensions. Drivers and - This array is reserved for future extensions. Drivers and
applications must set it to zero. applications must set it to zero.
......
...@@ -140,7 +140,7 @@ struct v4l2_sliced_vbi_format ...@@ -140,7 +140,7 @@ struct v4l2_sliced_vbi_format
- __u16 - __u16
- ``service_lines``\ \[2\]\[24\] - ``service_lines``\ [2][24]
- :cspan:`2` - :cspan:`2`
...@@ -170,7 +170,7 @@ struct v4l2_sliced_vbi_format ...@@ -170,7 +170,7 @@ struct v4l2_sliced_vbi_format
- -
- -
- ``service_lines``\ \[0\]\[1\] - ``service_lines``\ [0][1]
- 1 - 1
...@@ -180,7 +180,7 @@ struct v4l2_sliced_vbi_format ...@@ -180,7 +180,7 @@ struct v4l2_sliced_vbi_format
- -
- -
- ``service_lines``\ \[0\]\[23\] - ``service_lines``\ [0][23]
- 23 - 23
...@@ -190,7 +190,7 @@ struct v4l2_sliced_vbi_format ...@@ -190,7 +190,7 @@ struct v4l2_sliced_vbi_format
- -
- -
- ``service_lines``\ \[1\]\[1\] - ``service_lines``\ [1][1]
- 264 - 264
...@@ -200,7 +200,7 @@ struct v4l2_sliced_vbi_format ...@@ -200,7 +200,7 @@ struct v4l2_sliced_vbi_format
- -
- -
- ``service_lines``\ \[1\]\[23\] - ``service_lines``\ [1][23]
- 286 - 286
...@@ -210,8 +210,8 @@ struct v4l2_sliced_vbi_format ...@@ -210,8 +210,8 @@ struct v4l2_sliced_vbi_format
- -
- -
- :cspan:`2` Drivers must set ``service_lines`` \[0\]\[0\] and - :cspan:`2` Drivers must set ``service_lines`` [0][0] and
``service_lines``\ \[1\]\[0\] to zero. The ``service_lines``\ [1][0] to zero. The
``V4L2_VBI_ITU_525_F1_START``, ``V4L2_VBI_ITU_525_F2_START``, ``V4L2_VBI_ITU_525_F1_START``, ``V4L2_VBI_ITU_525_F2_START``,
``V4L2_VBI_ITU_625_F1_START`` and ``V4L2_VBI_ITU_625_F2_START`` ``V4L2_VBI_ITU_625_F1_START`` and ``V4L2_VBI_ITU_625_F2_START``
defines give the start line numbers for each field for each 525 or defines give the start line numbers for each field for each 525 or
...@@ -238,7 +238,7 @@ struct v4l2_sliced_vbi_format ...@@ -238,7 +238,7 @@ struct v4l2_sliced_vbi_format
- __u32 - __u32
- ``reserved``\ \[2\] - ``reserved``\ [2]
- :cspan:`2` This array is reserved for future extensions. - :cspan:`2` This array is reserved for future extensions.
Applications and drivers must set it to zero. Applications and drivers must set it to zero.
...@@ -427,7 +427,7 @@ struct v4l2_sliced_vbi_data ...@@ -427,7 +427,7 @@ struct v4l2_sliced_vbi_data
- __u8 - __u8
- ``data``\ \[48\] - ``data``\ [48]
- The packet payload. See :ref:`vbi-services` for the contents and - The packet payload. See :ref:`vbi-services` for the contents and
number of bytes passed for each data type. The contents of padding number of bytes passed for each data type. The contents of padding
...@@ -566,7 +566,7 @@ struct v4l2_mpeg_vbi_fmt_ivtv ...@@ -566,7 +566,7 @@ struct v4l2_mpeg_vbi_fmt_ivtv
- __u8 - __u8
- ``magic``\ \[4\] - ``magic``\ [4]
- -
- A "magic" constant from :ref:`v4l2-mpeg-vbi-fmt-ivtv-magic` that - A "magic" constant from :ref:`v4l2-mpeg-vbi-fmt-ivtv-magic` that
...@@ -662,7 +662,7 @@ struct v4l2_mpeg_vbi_itv0 ...@@ -662,7 +662,7 @@ struct v4l2_mpeg_vbi_itv0
- __le32 - __le32
- ``linemask``\ \[2\] - ``linemask``\ [2]
- Bitmasks indicating the VBI service lines present. These - Bitmasks indicating the VBI service lines present. These
``linemask`` values are stored in little endian byte order in the ``linemask`` values are stored in little endian byte order in the
...@@ -675,30 +675,30 @@ struct v4l2_mpeg_vbi_itv0 ...@@ -675,30 +675,30 @@ struct v4l2_mpeg_vbi_itv0
:: ::
linemask\[0\] b0: line 6 first field linemask[0] b0: line 6 first field
linemask\[0\] b17: line 23 first field linemask[0] b17: line 23 first field
linemask\[0\] b18: line 6 second field linemask[0] b18: line 6 second field
linemask\[0\] b31: line 19 second field linemask[0] b31: line 19 second field
linemask\[1\] b0: line 20 second field linemask[1] b0: line 20 second field
linemask\[1\] b3: line 23 second field linemask[1] b3: line 23 second field
linemask\[1\] b4-b31: unused and set to 0 linemask[1] b4-b31: unused and set to 0
- .. row 2 - .. row 2
- struct - struct
:ref:`v4l2_mpeg_vbi_itv0_line <v4l2-mpeg-vbi-itv0-line>` :ref:`v4l2_mpeg_vbi_itv0_line <v4l2-mpeg-vbi-itv0-line>`
- ``line``\ \[35\] - ``line``\ [35]
- This is a variable length array that holds from 1 to 35 lines of - This is a variable length array that holds from 1 to 35 lines of
sliced VBI data. The sliced VBI data lines present correspond to sliced VBI data. The sliced VBI data lines present correspond to
the bits set in the ``linemask`` array, starting from b\ :sub:`0` the bits set in the ``linemask`` array, starting from b\ :sub:`0`
of ``linemask``\ \[0\] up through b\ :sub:`31` of ``linemask``\ \[0\], of ``linemask``\ [0] up through b\ :sub:`31` of ``linemask``\ [0],
and from b\ :sub:`0` of ``linemask``\ \[1\] up through b\ :sub:`3` of and from b\ :sub:`0` of ``linemask``\ [1] up through b\ :sub:`3` of
``linemask``\ \[1\]. ``line``\ \[0\] corresponds to the first bit ``linemask``\ [1]. ``line``\ [0] corresponds to the first bit
found set in the ``linemask`` array, ``line``\ \[1\] corresponds to found set in the ``linemask`` array, ``line``\ [1] corresponds to
the second bit found set in the ``linemask`` array, etc. If no the second bit found set in the ``linemask`` array, etc. If no
``linemask`` array bits are set, then ``line``\ \[0\] may contain ``linemask`` array bits are set, then ``line``\ [0] may contain
one line of unspecified data that should be ignored by one line of unspecified data that should be ignored by
applications. applications.
...@@ -720,11 +720,11 @@ struct v4l2_mpeg_vbi_ITV0 ...@@ -720,11 +720,11 @@ struct v4l2_mpeg_vbi_ITV0
- struct - struct
:ref:`v4l2_mpeg_vbi_itv0_line <v4l2-mpeg-vbi-itv0-line>` :ref:`v4l2_mpeg_vbi_itv0_line <v4l2-mpeg-vbi-itv0-line>`
- ``line``\ \[36\] - ``line``\ [36]
- A fixed length array of 36 lines of sliced VBI data. ``line``\ \[0\] - A fixed length array of 36 lines of sliced VBI data. ``line``\ [0]
through ``line``\ \[17\] correspond to lines 6 through 23 of the through ``line``\ [17] correspond to lines 6 through 23 of the
first field. ``line``\ \[18\] through ``line``\ \[35\] corresponds to first field. ``line``\ [18] through ``line``\ [35] corresponds to
lines 6 through 23 of the second field. lines 6 through 23 of the second field.
...@@ -754,7 +754,7 @@ struct v4l2_mpeg_vbi_itv0_line ...@@ -754,7 +754,7 @@ struct v4l2_mpeg_vbi_itv0_line
- __u8 - __u8
- ``data``\ \[42\] - ``data``\ [42]
- The sliced VBI data for the line. - The sliced VBI data for the line.
......
...@@ -266,7 +266,7 @@ V4L2 Version 0.20 2000-11-23 ...@@ -266,7 +266,7 @@ V4L2 Version 0.20 2000-11-23
A number of changes were made to the raw VBI interface. A number of changes were made to the raw VBI interface.
1. Figures clarifying the line numbering scheme were added to the V4L2 1. Figures clarifying the line numbering scheme were added to the V4L2
API specification. The ``start``\ \[0\] and ``start``\ \[1\] fields no API specification. The ``start``\ [0] and ``start``\ [1] fields no
longer count line numbers beginning at zero. Rationale: a) The longer count line numbers beginning at zero. Rationale: a) The
previous definition was unclear. b) The ``start``\ [] values are previous definition was unclear. b) The ``start``\ [] values are
ordinal numbers. c) There is no point in inventing a new line ordinal numbers. c) There is no point in inventing a new line
...@@ -274,8 +274,8 @@ A number of changes were made to the raw VBI interface. ...@@ -274,8 +274,8 @@ A number of changes were made to the raw VBI interface.
Compatibility: Add one to the start values. Applications depending on Compatibility: Add one to the start values. Applications depending on
the previous semantics may not function correctly. the previous semantics may not function correctly.
2. The restriction "count\[0\] > 0 and count\[1\] > 0" has been relaxed to 2. The restriction "count[0] > 0 and count[1] > 0" has been relaxed to
"(count\[0\] + count\[1\]) > 0". Rationale: Drivers may allocate "(count[0] + count[1]) > 0". Rationale: Drivers may allocate
resources at scan line granularity and some data services are resources at scan line granularity and some data services are
transmitted only on the first field. The comment that both ``count`` transmitted only on the first field. The comment that both ``count``
values will usually be equal is misleading and pointless and has been values will usually be equal is misleading and pointless and has been
...@@ -649,7 +649,7 @@ This unnamed version was finally merged into Linux 2.5.46. ...@@ -649,7 +649,7 @@ This unnamed version was finally merged into Linux 2.5.46.
memory. It was barely useful and so was removed. memory. It was barely useful and so was removed.
14. In struct :ref:`v4l2_framebuffer <v4l2-framebuffer>` the 14. In struct :ref:`v4l2_framebuffer <v4l2-framebuffer>` the
``base\[3\]`` array anticipating double- and triple-buffering in ``base[3]`` array anticipating double- and triple-buffering in
off-screen video memory, however without defining a synchronization off-screen video memory, however without defining a synchronization
mechanism, was replaced by a single pointer. The mechanism, was replaced by a single pointer. The
``V4L2_FBUF_CAP_SCALEUP`` and ``V4L2_FBUF_CAP_SCALEDOWN`` flags were ``V4L2_FBUF_CAP_SCALEUP`` and ``V4L2_FBUF_CAP_SCALEDOWN`` flags were
...@@ -833,7 +833,7 @@ V4L2 in Linux 2.6.6, 2004-05-09 ...@@ -833,7 +833,7 @@ V4L2 in Linux 2.6.6, 2004-05-09
V4L2 in Linux 2.6.8 V4L2 in Linux 2.6.8
=================== ===================
1. A new field ``input`` (former ``reserved\[0\]``) was added to the 1. A new field ``input`` (former ``reserved[0]``) was added to the
struct :ref:`v4l2_buffer <v4l2-buffer>` structure. Purpose of this struct :ref:`v4l2_buffer <v4l2-buffer>` structure. Purpose of this
field is to alternate between video inputs (e. g. cameras) in step field is to alternate between video inputs (e. g. cameras) in step
with the video capturing process. This function must be enabled with with the video capturing process. This function must be enabled with
......
...@@ -41,7 +41,7 @@ describing all planes of that format. ...@@ -41,7 +41,7 @@ describing all planes of that format.
- __u16 - __u16
- ``reserved\[6\]`` - ``reserved[6]``
- Reserved for future extensions. Should be zeroed by drivers and - Reserved for future extensions. Should be zeroed by drivers and
applications. applications.
...@@ -160,7 +160,7 @@ describing all planes of that format. ...@@ -160,7 +160,7 @@ describing all planes of that format.
- __u8 - __u8
- ``reserved\[7\]`` - ``reserved[7]``
- Reserved for future extensions. Should be zeroed by drivers and - Reserved for future extensions. Should be zeroed by drivers and
applications. applications.
...@@ -92,7 +92,7 @@ Media Bus Formats ...@@ -92,7 +92,7 @@ Media Bus Formats
- __u16 - __u16
- ``reserved``\ \[11\] - ``reserved``\ [11]
- Reserved for future extensions. Applications and drivers must set - Reserved for future extensions. Applications and drivers must set
the array to zero. the array to zero.
......
...@@ -62,7 +62,7 @@ file: media/v4l/v4l2grab.c ...@@ -62,7 +62,7 @@ file: media/v4l/v4l2grab.c
int r, fd = -1; int r, fd = -1;
unsigned int i, n_buffers; unsigned int i, n_buffers;
char *dev_name = "/dev/video0"; char *dev_name = "/dev/video0";
char out_name\[256\]; char out_name[256];
FILE *fout; FILE *fout;
struct buffer *buffers; struct buffer *buffers;
......
...@@ -125,7 +125,7 @@ than the number requested. ...@@ -125,7 +125,7 @@ than the number requested.
- __u32 - __u32
- ``reserved``\ \[8\] - ``reserved``\ [8]
- A place holder for future extensions. Drivers and applications - A place holder for future extensions. Drivers and applications
must set the array to zero. must set the array to zero.
......
...@@ -115,7 +115,7 @@ instructions. ...@@ -115,7 +115,7 @@ instructions.
- -
- char - char
- ``name\[32\]`` - ``name[32]``
- Match a chip by this name, interpreted according to the ``type`` - Match a chip by this name, interpreted according to the ``type``
field. Currently unused. field. Currently unused.
...@@ -142,7 +142,7 @@ instructions. ...@@ -142,7 +142,7 @@ instructions.
- char - char
- ``name\[32\]`` - ``name[32]``
- The name of the chip. - The name of the chip.
...@@ -161,7 +161,7 @@ instructions. ...@@ -161,7 +161,7 @@ instructions.
- __u32 - __u32
- ``reserved\[8\]`` - ``reserved[8]``
- Reserved fields, both application and driver must set these to 0. - Reserved fields, both application and driver must set these to 0.
......
...@@ -123,7 +123,7 @@ instructions. ...@@ -123,7 +123,7 @@ instructions.
- -
- char - char
- ``name\[32\]`` - ``name[32]``
- Match a chip by this name, interpreted according to the ``type`` - Match a chip by this name, interpreted according to the ``type``
field. Currently unused. field. Currently unused.
......
...@@ -178,7 +178,7 @@ introduced in Linux 3.3. ...@@ -178,7 +178,7 @@ introduced in Linux 3.3.
- -
- __u32 - __u32
- ``data``\ \[16\] - ``data``\ [16]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
the array to zero. the array to zero.
......
...@@ -116,7 +116,7 @@ call. ...@@ -116,7 +116,7 @@ call.
- -
- __u8 - __u8
- ``data``\ \[64\] - ``data``\ [64]
- Event data. Defined by the event type. The union should be used to - Event data. Defined by the event type. The union should be used to
define easily accessible type for events. define easily accessible type for events.
...@@ -167,7 +167,7 @@ call. ...@@ -167,7 +167,7 @@ call.
- __u32 - __u32
- ``reserved``\ \[8\] - ``reserved``\ [8]
- -
- Reserved for future extensions. Drivers must set the array to - Reserved for future extensions. Drivers must set the array to
......
...@@ -130,7 +130,7 @@ that doesn't support them will return an ``EINVAL`` error code. ...@@ -130,7 +130,7 @@ that doesn't support them will return an ``EINVAL`` error code.
- __u32 - __u32
- ``reserved``\ \[16\] - ``reserved``\ [16]
- Reserved for future extensions. Drivers must set the array to - Reserved for future extensions. Drivers must set the array to
zero. zero.
...@@ -167,7 +167,7 @@ that doesn't support them will return an ``EINVAL`` error code. ...@@ -167,7 +167,7 @@ that doesn't support them will return an ``EINVAL`` error code.
- __u32 - __u32
- ``reserved``\ \[2\] - ``reserved``\ [2]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
the array to zero. the array to zero.
...@@ -193,7 +193,7 @@ that doesn't support them will return an ``EINVAL`` error code. ...@@ -193,7 +193,7 @@ that doesn't support them will return an ``EINVAL`` error code.
- -
- __u32 - __u32
- ``raw_data``\ \[32\] - ``raw_data``\ [32]
- -
......
...@@ -94,7 +94,7 @@ introduced in Linux 2.6.21. ...@@ -94,7 +94,7 @@ introduced in Linux 2.6.21.
- __u32 - __u32
- ``data``\ \[8\] - ``data``\ [8]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
the array to zero. the array to zero.
......
...@@ -92,7 +92,7 @@ return an ``EINVAL`` error code. ...@@ -92,7 +92,7 @@ return an ``EINVAL`` error code.
- __u32 - __u32
- ``reserved``\ \[2\] - ``reserved``\ [2]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
the array to zero. the array to zero.
......
...@@ -86,7 +86,7 @@ one until ``EINVAL`` is returned. ...@@ -86,7 +86,7 @@ one until ``EINVAL`` is returned.
- __u8 - __u8
- ``description``\ \[32\] - ``description``\ [32]
- Description of the format, a NUL-terminated ASCII string. This - Description of the format, a NUL-terminated ASCII string. This
information is intended for the user, for example: "YUV 4:2:2". information is intended for the user, for example: "YUV 4:2:2".
...@@ -120,7 +120,7 @@ one until ``EINVAL`` is returned. ...@@ -120,7 +120,7 @@ one until ``EINVAL`` is returned.
- __u32 - __u32
- ``reserved``\ \[4\] - ``reserved``\ [4]
- Reserved for future extensions. Drivers must set the array to - Reserved for future extensions. Drivers must set the array to
zero. zero.
......
...@@ -217,7 +217,7 @@ application should zero out all members except for the *IN* fields. ...@@ -217,7 +217,7 @@ application should zero out all members except for the *IN* fields.
- __u32 - __u32
- ``reserved\[2\]`` - ``reserved[2]``
- -
- Reserved space for future use. Must be zeroed by drivers and - Reserved space for future use. Must be zeroed by drivers and
......
...@@ -238,7 +238,7 @@ application should zero out all members except for the *IN* fields. ...@@ -238,7 +238,7 @@ application should zero out all members except for the *IN* fields.
- __u32 - __u32
- ``reserved\[2\]`` - ``reserved[2]``
- -
- Reserved space for future use. Must be zeroed by drivers and - Reserved space for future use. Must be zeroed by drivers and
......
...@@ -140,7 +140,7 @@ of the corresponding tuner/modulator is set. ...@@ -140,7 +140,7 @@ of the corresponding tuner/modulator is set.
- __u32 - __u32
- ``reserved``\ \[9\] - ``reserved``\ [9]
- Reserved for future extensions. Applications and drivers must set - Reserved for future extensions. Applications and drivers must set
the array to zero. the array to zero.
......
...@@ -61,7 +61,7 @@ at index zero, incrementing by one until the driver returns ``EINVAL``. ...@@ -61,7 +61,7 @@ at index zero, incrementing by one until the driver returns ``EINVAL``.
- __u8 - __u8
- ``name``\ \[32\] - ``name``\ [32]
- Name of the video input, a NUL-terminated ASCII string, for - Name of the video input, a NUL-terminated ASCII string, for
example: "Vin (Composite 2)". This information is intended for the example: "Vin (Composite 2)". This information is intended for the
...@@ -141,7 +141,7 @@ at index zero, incrementing by one until the driver returns ``EINVAL``. ...@@ -141,7 +141,7 @@ at index zero, incrementing by one until the driver returns ``EINVAL``.
- __u32 - __u32
- ``reserved``\ \[3\] - ``reserved``\ [3]
- Reserved for future extensions. Drivers must set the array to - Reserved for future extensions. Drivers must set the array to
zero. zero.
......
...@@ -62,7 +62,7 @@ EINVAL. ...@@ -62,7 +62,7 @@ EINVAL.
- __u8 - __u8
- ``name``\ \[32\] - ``name``\ [32]
- Name of the video output, a NUL-terminated ASCII string, for - Name of the video output, a NUL-terminated ASCII string, for
example: "Vout". This information is intended for the user, example: "Vout". This information is intended for the user,
...@@ -131,7 +131,7 @@ EINVAL. ...@@ -131,7 +131,7 @@ EINVAL.
- __u32 - __u32
- ``reserved``\ \[3\] - ``reserved``\ [3]
- Reserved for future extensions. Drivers must set the array to - Reserved for future extensions. Drivers must set the array to
zero. zero.
......
...@@ -78,7 +78,7 @@ or output. [#f1]_ ...@@ -78,7 +78,7 @@ or output. [#f1]_
- __u8 - __u8
- ``name``\ \[24\] - ``name``\ [24]
- Name of the standard, a NUL-terminated ASCII string, for example: - Name of the standard, a NUL-terminated ASCII string, for example:
"PAL-B/G", "NTSC Japan". This information is intended for the "PAL-B/G", "NTSC Japan". This information is intended for the
...@@ -105,7 +105,7 @@ or output. [#f1]_ ...@@ -105,7 +105,7 @@ or output. [#f1]_
- __u32 - __u32
- ``reserved``\ \[4\] - ``reserved``\ [4]
- Reserved for future extensions. Drivers must set the array to - Reserved for future extensions. Drivers must set the array to
zero. zero.
......
...@@ -179,7 +179,7 @@ Examples ...@@ -179,7 +179,7 @@ Examples
- __u32 - __u32
- ``reserved\[11\]`` - ``reserved[11]``
- Reserved field for future use. Drivers and applications must set - Reserved field for future use. Drivers and applications must set
the array to zero. the array to zero.
......
...@@ -70,7 +70,7 @@ return the actual new audio mode. ...@@ -70,7 +70,7 @@ return the actual new audio mode.
- __u8 - __u8
- ``name``\ \[32\] - ``name``\ [32]
- Name of the audio input, a NUL-terminated ASCII string, for - Name of the audio input, a NUL-terminated ASCII string, for
example: "Line In". This information is intended for the user, example: "Line In". This information is intended for the user,
...@@ -97,7 +97,7 @@ return the actual new audio mode. ...@@ -97,7 +97,7 @@ return the actual new audio mode.
- __u32 - __u32
- ``reserved``\ \[2\] - ``reserved``\ [2]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
the array to zero. the array to zero.
......
...@@ -75,7 +75,7 @@ as ``VIDIOC_G_AUDOUT`` does. ...@@ -75,7 +75,7 @@ as ``VIDIOC_G_AUDOUT`` does.
- __u8 - __u8
- ``name``\ \[32\] - ``name``\ [32]
- Name of the audio output, a NUL-terminated ASCII string, for - Name of the audio output, a NUL-terminated ASCII string, for
example: "Line Out". This information is intended for the user, example: "Line Out". This information is intended for the user,
...@@ -103,7 +103,7 @@ as ``VIDIOC_G_AUDOUT`` does. ...@@ -103,7 +103,7 @@ as ``VIDIOC_G_AUDOUT`` does.
- __u32 - __u32
- ``reserved``\ \[2\] - ``reserved``\ [2]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
the array to zero. the array to zero.
......
...@@ -259,7 +259,7 @@ EBUSY ...@@ -259,7 +259,7 @@ EBUSY
- -
- __u32 - __u32
- ``reserved``\ \[32\] - ``reserved``\ [32]
- -
......
...@@ -131,7 +131,7 @@ EDID is no longer available. ...@@ -131,7 +131,7 @@ EDID is no longer available.
- __u32 - __u32
- ``reserved``\ \[5\] - ``reserved``\ [5]
- Reserved for future extensions. Applications and drivers must set - Reserved for future extensions. Applications and drivers must set
the array to zero. the array to zero.
......
...@@ -86,7 +86,7 @@ video elementary streams. ...@@ -86,7 +86,7 @@ video elementary streams.
- __u32 - __u32
- ``reserved``\ \[4\] - ``reserved``\ [4]
- :cspan:`2` Reserved for future extensions. Drivers must set the - :cspan:`2` Reserved for future extensions. Drivers must set the
array to zero. array to zero.
...@@ -153,7 +153,7 @@ video elementary streams. ...@@ -153,7 +153,7 @@ video elementary streams.
- __u32 - __u32
- ``reserved``\ \[2\] - ``reserved``\ [2]
- Reserved for future extensions. Drivers must set the array to - Reserved for future extensions. Drivers must set the array to
zero. zero.
......
...@@ -136,7 +136,7 @@ still cause this situation. ...@@ -136,7 +136,7 @@ still cause this situation.
- __u32 - __u32
- ``reserved2``\ \[1\] - ``reserved2``\ [1]
- -
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
...@@ -338,7 +338,7 @@ still cause this situation. ...@@ -338,7 +338,7 @@ still cause this situation.
- __u32 - __u32
- ``reserved``\ \[2\] - ``reserved``\ [2]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
the array to zero. the array to zero.
......
...@@ -171,7 +171,7 @@ The format as returned by :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>` must be identical ...@@ -171,7 +171,7 @@ The format as returned by :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>` must be identical
- -
- __u8 - __u8
- ``raw_data``\ \[200\] - ``raw_data``\ [200]
- Place holder for future extensions. - Place holder for future extensions.
......
...@@ -102,7 +102,7 @@ write-only ioctl, it does not return the actual new frequency. ...@@ -102,7 +102,7 @@ write-only ioctl, it does not return the actual new frequency.
- __u32 - __u32
- ``reserved``\ \[8\] - ``reserved``\ [8]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
the array to zero. the array to zero.
......
...@@ -94,7 +94,7 @@ encoding. You usually do want to add them. ...@@ -94,7 +94,7 @@ encoding. You usually do want to add them.
- char - char
- ``APP_data``\ \[60\] - ``APP_data``\ [60]
- -
...@@ -110,7 +110,7 @@ encoding. You usually do want to add them. ...@@ -110,7 +110,7 @@ encoding. You usually do want to add them.
- char - char
- ``COM_data``\ \[60\] - ``COM_data``\ [60]
- -
......
...@@ -81,7 +81,7 @@ To change the radio frequency the ...@@ -81,7 +81,7 @@ To change the radio frequency the
- __u8 - __u8
- ``name``\ \[32\] - ``name``\ [32]
- Name of the modulator, a NUL-terminated ASCII string. This - Name of the modulator, a NUL-terminated ASCII string. This
information is intended for the user. information is intended for the user.
...@@ -149,7 +149,7 @@ To change the radio frequency the ...@@ -149,7 +149,7 @@ To change the radio frequency the
- __u32 - __u32
- ``reserved``\ \[3\] - ``reserved``\ [3]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
the array to zero. the array to zero.
......
...@@ -103,7 +103,7 @@ union holding separate parameters for input and output devices. ...@@ -103,7 +103,7 @@ union holding separate parameters for input and output devices.
- -
- __u8 - __u8
- ``raw_data``\ \[200\] - ``raw_data``\ [200]
- A place holder for future extensions. - A place holder for future extensions.
...@@ -183,7 +183,7 @@ union holding separate parameters for input and output devices. ...@@ -183,7 +183,7 @@ union holding separate parameters for input and output devices.
- __u32 - __u32
- ``reserved``\ \[4\] - ``reserved``\ [4]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
the array to zero. the array to zero.
...@@ -271,7 +271,7 @@ union holding separate parameters for input and output devices. ...@@ -271,7 +271,7 @@ union holding separate parameters for input and output devices.
- __u32 - __u32
- ``reserved``\ \[4\] - ``reserved``\ [4]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
the array to zero. the array to zero.
......
...@@ -182,7 +182,7 @@ Selection targets and flags are documented in ...@@ -182,7 +182,7 @@ Selection targets and flags are documented in
- __u32 - __u32
- ``reserved\[9\]`` - ``reserved[9]``
- Reserved fields for future use. Drivers and applications must zero - Reserved fields for future use. Drivers and applications must zero
this array. this array.
......
...@@ -65,7 +65,7 @@ the sliced VBI API is unsupported or ``type`` is invalid. ...@@ -65,7 +65,7 @@ the sliced VBI API is unsupported or ``type`` is invalid.
- __u16 - __u16
- ``service_lines``\ \[2\]\[24\] - ``service_lines``\ [2][24]
- :cspan:`2` Each element of this array contains a set of data - :cspan:`2` Each element of this array contains a set of data
services the hardware can look for or insert into a particular services the hardware can look for or insert into a particular
...@@ -87,7 +87,7 @@ the sliced VBI API is unsupported or ``type`` is invalid. ...@@ -87,7 +87,7 @@ the sliced VBI API is unsupported or ``type`` is invalid.
- -
- -
- ``service_lines``\ \[0\]\[1\] - ``service_lines``\ [0][1]
- 1 - 1
...@@ -97,7 +97,7 @@ the sliced VBI API is unsupported or ``type`` is invalid. ...@@ -97,7 +97,7 @@ the sliced VBI API is unsupported or ``type`` is invalid.
- -
- -
- ``service_lines``\ \[0\]\[23\] - ``service_lines``\ [0][23]
- 23 - 23
...@@ -107,7 +107,7 @@ the sliced VBI API is unsupported or ``type`` is invalid. ...@@ -107,7 +107,7 @@ the sliced VBI API is unsupported or ``type`` is invalid.
- -
- -
- ``service_lines``\ \[1\]\[1\] - ``service_lines``\ [1][1]
- 264 - 264
...@@ -117,7 +117,7 @@ the sliced VBI API is unsupported or ``type`` is invalid. ...@@ -117,7 +117,7 @@ the sliced VBI API is unsupported or ``type`` is invalid.
- -
- -
- ``service_lines``\ \[1\]\[23\] - ``service_lines``\ [1][23]
- 286 - 286
...@@ -147,8 +147,8 @@ the sliced VBI API is unsupported or ``type`` is invalid. ...@@ -147,8 +147,8 @@ the sliced VBI API is unsupported or ``type`` is invalid.
- -
- -
- :cspan:`2` Drivers must set ``service_lines`` \[0\]\[0\] and - :cspan:`2` Drivers must set ``service_lines`` [0][0] and
``service_lines``\ \[1\]\[0\] to zero. ``service_lines``\ [1][0] to zero.
- .. row 12 - .. row 12
...@@ -164,7 +164,7 @@ the sliced VBI API is unsupported or ``type`` is invalid. ...@@ -164,7 +164,7 @@ the sliced VBI API is unsupported or ``type`` is invalid.
- __u32 - __u32
- ``reserved``\ \[3\] - ``reserved``\ [3]
- :cspan:`2` This array is reserved for future extensions. - :cspan:`2` This array is reserved for future extensions.
Applications and drivers must set it to zero. Applications and drivers must set it to zero.
......
...@@ -79,7 +79,7 @@ To change the radio frequency the ...@@ -79,7 +79,7 @@ To change the radio frequency the
- __u8 - __u8
- ``name``\ \[32\] - ``name``\ [32]
- :cspan:`1` - :cspan:`1`
...@@ -246,7 +246,7 @@ To change the radio frequency the ...@@ -246,7 +246,7 @@ To change the radio frequency the
- __u32 - __u32
- ``reserved``\ \[4\] - ``reserved``\ [4]
- :cspan:`1` Reserved for future extensions. Drivers and - :cspan:`1` Reserved for future extensions. Drivers and
applications must set the array to zero. applications must set the array to zero.
......
...@@ -53,7 +53,7 @@ specification the ioctl returns an ``EINVAL`` error code. ...@@ -53,7 +53,7 @@ specification the ioctl returns an ``EINVAL`` error code.
- __u8 - __u8
- ``driver``\ \[16\] - ``driver``\ [16]
- Name of the driver, a unique NUL-terminated ASCII string. For - Name of the driver, a unique NUL-terminated ASCII string. For
example: "bttv". Driver specific applications can use this example: "bttv". Driver specific applications can use this
...@@ -69,7 +69,7 @@ specification the ioctl returns an ``EINVAL`` error code. ...@@ -69,7 +69,7 @@ specification the ioctl returns an ``EINVAL`` error code.
- __u8 - __u8
- ``card``\ \[32\] - ``card``\ [32]
- Name of the device, a NUL-terminated UTF-8 string. For example: - Name of the device, a NUL-terminated UTF-8 string. For example:
"Yoyodyne TV/FM". One driver may support different brands or "Yoyodyne TV/FM". One driver may support different brands or
...@@ -84,7 +84,7 @@ specification the ioctl returns an ``EINVAL`` error code. ...@@ -84,7 +84,7 @@ specification the ioctl returns an ``EINVAL`` error code.
- __u8 - __u8
- ``bus_info``\ \[32\] - ``bus_info``\ [32]
- Location of the device in the system, a NUL-terminated ASCII - Location of the device in the system, a NUL-terminated ASCII
string. For example: "PCI:0000:05:06.0". This information is string. For example: "PCI:0000:05:06.0". This information is
...@@ -166,7 +166,7 @@ specification the ioctl returns an ``EINVAL`` error code. ...@@ -166,7 +166,7 @@ specification the ioctl returns an ``EINVAL`` error code.
- __u32 - __u32
- ``reserved``\ \[3\] - ``reserved``\ [3]
- Reserved for future extensions. Drivers must set this array to - Reserved for future extensions. Drivers must set this array to
zero. zero.
......
...@@ -124,7 +124,7 @@ See also the examples in :ref:`control`. ...@@ -124,7 +124,7 @@ See also the examples in :ref:`control`.
- __u8 - __u8
- ``name``\ \[32\] - ``name``\ [32]
- Name of the control, a NUL-terminated ASCII string. This - Name of the control, a NUL-terminated ASCII string. This
information is intended for the user. information is intended for the user.
...@@ -203,7 +203,7 @@ See also the examples in :ref:`control`. ...@@ -203,7 +203,7 @@ See also the examples in :ref:`control`.
- __u32 - __u32
- ``reserved``\ \[2\] - ``reserved``\ [2]
- Reserved for future extensions. Drivers must set the array to - Reserved for future extensions. Drivers must set the array to
zero. zero.
...@@ -245,7 +245,7 @@ See also the examples in :ref:`control`. ...@@ -245,7 +245,7 @@ See also the examples in :ref:`control`.
- char - char
- ``name``\ \[32\] - ``name``\ [32]
- Name of the control, a NUL-terminated ASCII string. This - Name of the control, a NUL-terminated ASCII string. This
information is intended for the user. information is intended for the user.
...@@ -326,7 +326,7 @@ See also the examples in :ref:`control`. ...@@ -326,7 +326,7 @@ See also the examples in :ref:`control`.
- The size in bytes of a single element of the array. Given a char - The size in bytes of a single element of the array. Given a char
pointer ``p`` to a 3-dimensional array you can find the position pointer ``p`` to a 3-dimensional array you can find the position
of cell ``(z, y, x)`` as follows: of cell ``(z, y, x)`` as follows:
``p + ((z * dims\[1\] + y) * dims\[0\] + x) * elem_size``. ``p + ((z * dims[1] + y) * dims[0] + x) * elem_size``.
``elem_size`` is always valid, also when the control isn't an ``elem_size`` is always valid, also when the control isn't an
array. For string controls ``elem_size`` is equal to array. For string controls ``elem_size`` is equal to
``maximum + 1``. ``maximum + 1``.
...@@ -363,7 +363,7 @@ See also the examples in :ref:`control`. ...@@ -363,7 +363,7 @@ See also the examples in :ref:`control`.
- __u32 - __u32
- ``reserved``\ \[32\] - ``reserved``\ [32]
- Reserved for future extensions. Applications and drivers must set - Reserved for future extensions. Applications and drivers must set
the array to zero. the array to zero.
...@@ -410,7 +410,7 @@ See also the examples in :ref:`control`. ...@@ -410,7 +410,7 @@ See also the examples in :ref:`control`.
- -
- __u8 - __u8
- ``name``\ \[32\] - ``name``\ [32]
- Name of the menu item, a NUL-terminated ASCII string. This - Name of the menu item, a NUL-terminated ASCII string. This
information is intended for the user. This field is valid for information is intended for the user. This field is valid for
......
...@@ -107,7 +107,7 @@ any DMA in progress, an implicit ...@@ -107,7 +107,7 @@ any DMA in progress, an implicit
- __u32 - __u32
- ``reserved``\ \[2\] - ``reserved``\ [2]
- A place holder for future extensions. Drivers and applications - A place holder for future extensions. Drivers and applications
must set the array to zero. must set the array to zero.
......
...@@ -150,7 +150,7 @@ error code is returned and no seek takes place. ...@@ -150,7 +150,7 @@ error code is returned and no seek takes place.
- __u32 - __u32
- ``reserved``\ \[5\] - ``reserved``\ [5]
- Reserved for future extensions. Applications must set the array to - Reserved for future extensions. Applications must set the array to
zero. zero.
......
...@@ -132,7 +132,7 @@ multiple pads of the same sub-device is not defined. ...@@ -132,7 +132,7 @@ multiple pads of the same sub-device is not defined.
- __u32 - __u32
- ``reserved``\ \[8\] - ``reserved``\ [8]
- Reserved for future extensions. Applications and drivers must set - Reserved for future extensions. Applications and drivers must set
the array to zero. the array to zero.
......
...@@ -142,7 +142,7 @@ information about try formats. ...@@ -142,7 +142,7 @@ information about try formats.
- __u32 - __u32
- ``reserved``\ \[8\] - ``reserved``\ [8]
- Reserved for future extensions. Applications and drivers must set - Reserved for future extensions. Applications and drivers must set
the array to zero. the array to zero.
......
...@@ -95,7 +95,7 @@ information about the try formats. ...@@ -95,7 +95,7 @@ information about the try formats.
- __u32 - __u32
- ``reserved``\ \[8\] - ``reserved``\ [8]
- Reserved for future extensions. Applications and drivers must set - Reserved for future extensions. Applications and drivers must set
the array to zero. the array to zero.
......
...@@ -109,7 +109,7 @@ modified format should be as close as possible to the original request. ...@@ -109,7 +109,7 @@ modified format should be as close as possible to the original request.
- __u32 - __u32
- ``reserved``\ \[8\] - ``reserved``\ [8]
- Reserved for future extensions. Applications and drivers must set - Reserved for future extensions. Applications and drivers must set
the array to zero. the array to zero.
......
...@@ -113,7 +113,7 @@ should be as close as possible to the original request. ...@@ -113,7 +113,7 @@ should be as close as possible to the original request.
- __u32 - __u32
- ``reserved``\ \[8\] - ``reserved``\ [8]
- Reserved for future extensions. Applications and drivers must set - Reserved for future extensions. Applications and drivers must set
the array to zero. the array to zero.
......
...@@ -95,7 +95,7 @@ the same sub-device is not defined. ...@@ -95,7 +95,7 @@ the same sub-device is not defined.
- __u32 - __u32
- ``reserved``\ \[9\] - ``reserved``\ [9]
- Reserved for future extensions. Applications and drivers must set - Reserved for future extensions. Applications and drivers must set
the array to zero. the array to zero.
......
...@@ -117,7 +117,7 @@ Selection targets and flags are documented in ...@@ -117,7 +117,7 @@ Selection targets and flags are documented in
- __u32 - __u32
- ``reserved``\ \[8\] - ``reserved``\ [8]
- Reserved for future extensions. Applications and drivers must set - Reserved for future extensions. Applications and drivers must set
the array to zero. the array to zero.
......
...@@ -79,7 +79,7 @@ using the :ref:`VIDIOC_DQEVENT` ioctl. ...@@ -79,7 +79,7 @@ using the :ref:`VIDIOC_DQEVENT` ioctl.
- __u32 - __u32
- ``reserved``\ \[5\] - ``reserved``\ [5]
- Reserved for future extensions. Drivers and applications must set - Reserved for future extensions. Drivers and applications must set
the array to zero. the array to zero.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment