aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/DocBook
diff options
context:
space:
mode:
authorHans Verkuil <hans.verkuil@cisco.com>2013-04-03 03:08:19 -0400
committerMauro Carvalho Chehab <mchehab@redhat.com>2013-04-14 18:46:02 -0400
commit3eef25107cab65a1158b11ba373fb9b4fc25b4b8 (patch)
treeab964c2868826e14c4a8ccf83f4e6703d4b97402 /Documentation/DocBook
parentcd634f1bfc182e564f33809fdca33027bb99fceb (diff)
[media] v4l2: drop V4L2_CHIP_MATCH_SUBDEV_NAME
After using the new VIDIOC_DBG_G_CHIP_NAME ioctl I realized that the matching by name possibility is useless. Just drop it and rename MATCH_SUBDEV_IDX to just MATCH_SUBDEV. The v4l2-dbg utility is much better placed to match by name by just enumerating all bridge and subdev devices until chip_name.name matches. Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com> Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
Diffstat (limited to 'Documentation/DocBook')
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-dbg-g-chip-ident.xml7
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-dbg-g-chip-name.xml18
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-dbg-g-register.xml17
3 files changed, 5 insertions, 37 deletions
diff --git a/Documentation/DocBook/media/v4l/vidioc-dbg-g-chip-ident.xml b/Documentation/DocBook/media/v4l/vidioc-dbg-g-chip-ident.xml
index 82e43c6c72b8..921e18550d26 100644
--- a/Documentation/DocBook/media/v4l/vidioc-dbg-g-chip-ident.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-dbg-g-chip-ident.xml
@@ -221,13 +221,8 @@ the values from <xref linkend="chip-ids" />.</entry>
221 <entry>Match the nth anciliary AC97 chip.</entry> 221 <entry>Match the nth anciliary AC97 chip.</entry>
222 </row> 222 </row>
223 <row> 223 <row>
224 <entry><constant>V4L2_CHIP_MATCH_SUBDEV_NAME</constant></entry> 224 <entry><constant>V4L2_CHIP_MATCH_SUBDEV</constant></entry>
225 <entry>4</entry> 225 <entry>4</entry>
226 <entry>Match the sub-device by name. Can't be used with this ioctl.</entry>
227 </row>
228 <row>
229 <entry><constant>V4L2_CHIP_MATCH_SUBDEV_IDX</constant></entry>
230 <entry>5</entry>
231 <entry>Match the nth sub-device. Can't be used with this ioctl.</entry> 226 <entry>Match the nth sub-device. Can't be used with this ioctl.</entry>
232 </row> 227 </row>
233 </tbody> 228 </tbody>
diff --git a/Documentation/DocBook/media/v4l/vidioc-dbg-g-chip-name.xml b/Documentation/DocBook/media/v4l/vidioc-dbg-g-chip-name.xml
index 5fce8d84288e..fa3bd42ab167 100644
--- a/Documentation/DocBook/media/v4l/vidioc-dbg-g-chip-name.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-dbg-g-chip-name.xml
@@ -87,16 +87,7 @@ connected to the PCI or USB bus. Non-zero numbers identify specific
87parts of the bridge chip such as an AC97 register block.</para> 87parts of the bridge chip such as an AC97 register block.</para>
88 88
89 <para>When <structfield>match.type</structfield> is 89 <para>When <structfield>match.type</structfield> is
90<constant>V4L2_CHIP_MATCH_SUBDEV_NAME</constant>, 90<constant>V4L2_CHIP_MATCH_SUBDEV</constant>,
91<structfield>match.name</structfield> contains the name of a sub-device.
92For instance
93<constant>"saa7127 6-0044"</constant> will match the saa7127 sub-device
94at the given i2c bus. This match type is not very useful for this ioctl
95and is here only for consistency.
96</para>
97
98 <para>When <structfield>match.type</structfield> is
99<constant>V4L2_CHIP_MATCH_SUBDEV_IDX</constant>,
100<structfield>match.addr</structfield> selects the nth sub-device. This 91<structfield>match.addr</structfield> selects the nth sub-device. This
101allows you to enumerate over all sub-devices.</para> 92allows you to enumerate over all sub-devices.</para>
102 93
@@ -207,13 +198,8 @@ is set, then the driver supports reading registers from the device. If
207 <entry>Match the nth anciliary AC97 chip. Can't be used with this ioctl.</entry> 198 <entry>Match the nth anciliary AC97 chip. Can't be used with this ioctl.</entry>
208 </row> 199 </row>
209 <row> 200 <row>
210 <entry><constant>V4L2_CHIP_MATCH_SUBDEV_NAME</constant></entry> 201 <entry><constant>V4L2_CHIP_MATCH_SUBDEV</constant></entry>
211 <entry>4</entry> 202 <entry>4</entry>
212 <entry>Match the sub-device by name.</entry>
213 </row>
214 <row>
215 <entry><constant>V4L2_CHIP_MATCH_SUBDEV_IDX</constant></entry>
216 <entry>5</entry>
217 <entry>Match the nth sub-device.</entry> 203 <entry>Match the nth sub-device.</entry>
218 </row> 204 </row>
219 </tbody> 205 </tbody>
diff --git a/Documentation/DocBook/media/v4l/vidioc-dbg-g-register.xml b/Documentation/DocBook/media/v4l/vidioc-dbg-g-register.xml
index 3082b4149dbe..db7844f2439f 100644
--- a/Documentation/DocBook/media/v4l/vidioc-dbg-g-register.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-dbg-g-register.xml
@@ -123,15 +123,7 @@ bus address.</para>
123on the TV card.</para> 123on the TV card.</para>
124 124
125 <para>When <structfield>match.type</structfield> is 125 <para>When <structfield>match.type</structfield> is
126<constant>V4L2_CHIP_MATCH_SUBDEV_NAME</constant>, 126<constant>V4L2_CHIP_MATCH_SUBDEV</constant>,
127<structfield>match.name</structfield> contains the sub-device name.
128For instance
129<constant>"saa7127 6-0044"</constant> will match this specific saa7127
130sub-device. Again with the &VIDIOC-DBG-G-CHIP-NAME; ioctl you can find
131out which sub-devices are present.</para>
132
133 <para>When <structfield>match.type</structfield> is
134<constant>V4L2_CHIP_MATCH_SUBDEV_IDX</constant>,
135<structfield>match.addr</structfield> selects the nth sub-device.</para> 127<structfield>match.addr</structfield> selects the nth sub-device.</para>
136 128
137 <note> 129 <note>
@@ -250,13 +242,8 @@ register.</entry>
250 <entry>Match the nth anciliary AC97 chip.</entry> 242 <entry>Match the nth anciliary AC97 chip.</entry>
251 </row> 243 </row>
252 <row> 244 <row>
253 <entry><constant>V4L2_CHIP_MATCH_SUBDEV_NAME</constant></entry> 245 <entry><constant>V4L2_CHIP_MATCH_SUBDEV</constant></entry>
254 <entry>4</entry> 246 <entry>4</entry>
255 <entry>Match the sub-device by name.</entry>
256 </row>
257 <row>
258 <entry><constant>V4L2_CHIP_MATCH_SUBDEV_IDX</constant></entry>
259 <entry>5</entry>
260 <entry>Match the nth sub-device.</entry> 247 <entry>Match the nth sub-device.</entry>
261 </row> 248 </row>
262 </tbody> 249 </tbody>