diff --git a/Documentation/DocBook/media/v4l/io.xml b/Documentation/DocBook/media/v4l/io.xml
index bfe666204888..7bbc2a48911e 100644
--- a/Documentation/DocBook/media/v4l/io.xml
+++ b/Documentation/DocBook/media/v4l/io.xml
@@ -841,15 +841,15 @@ is the file descriptor associated with a DMABUF buffer.
__u32reserved2
- A place holder for future extensions. Applications
-should set this to 0.
+ A place holder for future extensions. Drivers and applications
+must set this to 0.__u32reserved
- A place holder for future extensions. Applications
-should set this to 0.
+ A place holder for future extensions. Drivers and applications
+must set this to 0.
@@ -930,8 +930,8 @@ should set this to 0.
__u32reserved[11]
- Reserved for future use. Should be zeroed by an
- application.
+ Reserved for future use. Should be zeroed by drivers and
+ applications.
diff --git a/Documentation/DocBook/media/v4l/pixfmt.xml b/Documentation/DocBook/media/v4l/pixfmt.xml
index e7d88482a522..965ea916784a 100644
--- a/Documentation/DocBook/media/v4l/pixfmt.xml
+++ b/Documentation/DocBook/media/v4l/pixfmt.xml
@@ -198,8 +198,8 @@ see .
__u16reserved[6]
- Reserved for future extensions. Should be zeroed by the
- application.
+ Reserved for future extensions. Should be zeroed by drivers and
+ applications.
@@ -283,8 +283,8 @@ see .
__u8reserved[7]
- Reserved for future extensions. Should be zeroed by the
- application.
+ Reserved for future extensions. Should be zeroed by drivers
+ and applications.
diff --git a/Documentation/DocBook/media/v4l/vidioc-create-bufs.xml b/Documentation/DocBook/media/v4l/vidioc-create-bufs.xml
index 9b700a5f4df7..8ffe74f84af1 100644
--- a/Documentation/DocBook/media/v4l/vidioc-create-bufs.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-create-bufs.xml
@@ -134,7 +134,8 @@ information.
__u32reserved[8]
- A place holder for future extensions.
+ A place holder for future extensions. Drivers and applications
+must set the array to zero.
diff --git a/Documentation/DocBook/media/v4l/vidioc-enum-frameintervals.xml b/Documentation/DocBook/media/v4l/vidioc-enum-frameintervals.xml
index 5fd72c4c33e3..7c839ab0afbb 100644
--- a/Documentation/DocBook/media/v4l/vidioc-enum-frameintervals.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-enum-frameintervals.xml
@@ -217,7 +217,8 @@ enumerated.
__u32reserved[2]
- Reserved space for future use.
+ Reserved space for future use. Must be zeroed by drivers and
+ applications.
diff --git a/Documentation/DocBook/media/v4l/vidioc-enum-framesizes.xml b/Documentation/DocBook/media/v4l/vidioc-enum-framesizes.xml
index a78454b5abcd..9ed68ac8f474 100644
--- a/Documentation/DocBook/media/v4l/vidioc-enum-framesizes.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-enum-framesizes.xml
@@ -223,7 +223,8 @@ application should zero out all members except for the
__u32reserved[2]
- Reserved space for future use.
+ Reserved space for future use. Must be zeroed by drivers and
+ applications.
diff --git a/Documentation/DocBook/media/v4l/vidioc-expbuf.xml b/Documentation/DocBook/media/v4l/vidioc-expbuf.xml
index 4165e7bfa4ff..a78c9207422f 100644
--- a/Documentation/DocBook/media/v4l/vidioc-expbuf.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-expbuf.xml
@@ -184,7 +184,8 @@ of open() for more details.
__u32reserved[11]
- Reserved field for future use. Must be set to zero.
+ Reserved field for future use. Drivers and applications must
+set the array to zero.
diff --git a/Documentation/DocBook/media/v4l/vidioc-g-selection.xml b/Documentation/DocBook/media/v4l/vidioc-g-selection.xml
index 0bb5c060db27..7865351688da 100644
--- a/Documentation/DocBook/media/v4l/vidioc-g-selection.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-g-selection.xml
@@ -199,7 +199,7 @@ exist no rectangle that satisfies the constraints.
__u32reserved[9]
- Reserved fields for future use.
+ Reserved fields for future use. Drivers and applications must zero this array.
diff --git a/Documentation/DocBook/media/v4l/vidioc-querybuf.xml b/Documentation/DocBook/media/v4l/vidioc-querybuf.xml
index a597155c052d..50bfcb5e8508 100644
--- a/Documentation/DocBook/media/v4l/vidioc-querybuf.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-querybuf.xml
@@ -60,7 +60,8 @@ buffer at any time after buffers have been allocated with the
field. Valid index numbers range from zero
to the number of buffers allocated with &VIDIOC-REQBUFS;
(&v4l2-requestbuffers; count) minus one.
-The reserved field should to set to 0.
+The reserved and reserved2
+fields must be set to 0.
When using the multi-planar API, the
m.planes field must contain a userspace pointer to an
array of &v4l2-plane; and the length field has
diff --git a/Documentation/DocBook/media/v4l/vidioc-reqbufs.xml b/Documentation/DocBook/media/v4l/vidioc-reqbufs.xml
index 78a06a9a5ece..0f193fda0470 100644
--- a/Documentation/DocBook/media/v4l/vidioc-reqbufs.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-reqbufs.xml
@@ -112,8 +112,8 @@ as the &v4l2-format; type field. See __u32reserved[2]
- A place holder for future extensions. This array should
-be zeroed by applications.
+ A place holder for future extensions. Drivers and applications
+must set the array to zero.