lp.hardwaredb.model.hwdb : API documentation

Class	HWSubmission	See `IHWSubmission`.
Class	HWSubmissionSet	See `IHWSubmissionSet`.
Class	HWSystemFingerprint	Identifiers of a computer system.
Class	HWSystemFingerprintSet	A set of identifiers of a computer system.
Class	HWVendorName	See `IHWVendorName`.
Class	HWVendorNameSet	See `IHWVendorNameSet`.
Function	isValidVendorID	Check that the string id is a valid vendor ID for this bus.
Function	isValidProductID	Check that the string id is a valid product for this bus.
Class	HWVendorID	See `IHWVendorID`.
Class	HWVendorIDSet	See `IHWVendorIDSet`.
Class	HWDevice	See `IHWDevice.`
Class	HWDeviceSet	See `IHWDeviceSet`.
Class	HWDeviceNameVariant	See `IHWDeviceNameVariant`.
Class	HWDeviceNameVariantSet	See `IHWDeviceNameVariantSet`.
Class	HWDriver	See `IHWDriver`.
Class	HWDriverSet	See `IHWDriver`.
Class	HWDriverName	See `IHWDriverName`.
Class	HWDriverPackageName	See `IHWDriverPackageName`.
Class	HWDeviceDriverLink	See `IHWDeviceDriverLink`.
Class	HWDeviceDriverLinkSet	See `IHWDeviceDriverLinkSet`.
Class	HWDeviceClass	See `IHWDeviceClass`.
Class	HWDeviceClassSet	See `IHWDeviceClassSet`.
Class	HWSubmissionDevice	See `IHWSubmissionDevice`.
Class	HWSubmissionDeviceSet	See `IHWSubmissionDeviceSet`.
Class	HWSubmissionBug	See `IHWSubmissionBug`.
Class	HWSubmissionBugSet	See `IHWSubmissionBugSet`.
Function	make_submission_device_statistics_clause	Create a where expression and a table list for selecting devices.
Function	make_distro_target_clause	Create a where expression and a table list to limit results to a
Function	_userCanAccessSubmissionStormClause	Limit results of HWSubmission queries to rows the user can access.

def isValidVendorID(bus, id):

Check that the string id is a valid vendor ID for this bus.

Some busses have constraints for IDs, while some can use arbitrary values, for example the "fake" busses HWBus.SYSTEM and HWBus.SERIAL.

We use a hexadecimal representation of integers like "0x123abc", i.e., the numbers have the prefix "0x"; for the digits > 9 we use the lower case characters a to f.

USB and PCI IDs have always four digits; IEEE1394 IDs have always six digits.

SCSI vendor IDs consist of eight bytes of ASCII data (0x20..0x7e); if a vendor name has less than eight characters, it is padded on the right with spaces (See http://t10.org/ftp/t10/drafts/spc4/spc4r14.pdf, page 45).

Parameters	bus	A `HWBus` indicating the bus type of "id"
	id	A string with the ID
Returns	True, if id is valid, otherwise False

def isValidProductID(bus, id):

Check that the string id is a valid product for this bus.

Some busses have constraints for IDs, while some can use arbitrary values, for example the "fake" busses HWBus.SYSTEM and HWBus.SERIAL.

We use a hexadecimal representation of integers like "0x123abc", i.e., the numbers have the prefix "0x"; for the digits > 9 we use the lower case characters a to f.

USB and PCI IDs have always four digits.

Since IEEE1394 does not specify product IDs, there is no formal check of them.

SCSI product IDs consist of 16 bytes of ASCII data (0x20..0x7e); if a product name has less than 16 characters, it is padded on the right with spaces.

Parameters	bus	A `HWBus` indicating the bus type of "id"
	id	A string with the ID
Returns	True, if id is valid, otherwise False

l.h.m.hwdb : module documentation