Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit cd56c8dd authored by Hans Verkuil's avatar Hans Verkuil Committed by Mauro Carvalho Chehab
Browse files

[media] DocBook: bus_info can no longer be empty 



During the 2012 Media Workshop it was decided that bus_info as returned
by VIDIOC_QUERYCAP can no longer be empty. It should be a unique identifier,
and empty strings are obviously not unique.

Signed-off-by: default avatarHans Verkuil <hans.verkuil@cisco.com>
Reviewed-by: default avatarSylwester Nawrocki <s.nawrocki@samsung.com>
Reviewed-by: default avatarSakari Ailus <sakari.ailus@iki.fi>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@redhat.com>
parent 93828d64

Documentation/DocBook/media/v4l/vidioc-querycap.xml

+6 −4
Original line number Diff line number Diff line
@@ -90,11 +90,13 @@ ambiguities.</entry> 
	    <entry>__u8</entry>

	    <entry><structfield>bus_info</structfield>[32]</entry>

	    <entry>Location of the device in the system, a

NUL-terminated ASCII string. For example: "PCI Slot 4". This

NUL-terminated ASCII string. For example: "PCI:0000:05:06.0". This

information is intended for users, to distinguish multiple

identical devices. If no such information is available the field may

simply count the devices controlled by the driver, or contain the

empty string (<structfield>bus_info</structfield>[0] = 0).<!-- XXX pci_dev->slot_name example --></entry>

identical devices. If no such information is available the field must

simply count the devices controlled by the driver ("platform:vivi-000").

The bus_info must start with "PCI:" for PCI boards, "PCIe:" for PCI Express boards,

"usb-" for USB devices, "I2C:" for i2c devices, "ISA:" for ISA devices,

"parport" for parallel port devices and "platform:" for platform devices.</entry>

	  </row>

	  <row>

	    <entry>__u32</entry>