Part of lp.hardwaredb.interfaces.hwdb View In Hierarchy
Method | createSubmission | Store submitted raw hardware information in a Librarian file. |
Method | getBySubmissionKey | Return the submission with the given submission key, or None. |
Method | getByFingerprintName | Return the submissions for the given system fingerprint string. |
Method | getByOwner | Return the submissions for the given person. |
Method | submissionIdExists | Return True, if a record with ths ID exists, else return False. |
Method | getByStatus | Return the submissions with the given status. |
Method | search | Return the submissions matiching the given parmeters. |
Method | numSubmissionsWithDevice | Count the number of submissions mentioning a device or a driver. |
Method | numOwnersOfDevice | The number of people owning a device or using a driver. |
Method | deviceDriverOwnersAffectedByBugs | Return persons affected by given bugs and owning a given device. |
Method | hwInfoByBugRelatedUsers | Return a list of owners and devices related to given bugs. |
If a submission with an identical submission_key already exists, an HWSubmissionKeyNotUnique exception is raised.
If a submission is marked as private, it is only returned if user == HWSubmission.owner, of if user is an admin.
If a submission is marked as private, it is only returned if user == HWSubmission.owner, or if user is an admin.
If a submission is marked as private, it is only returned if user == HWSubmission.owner, or if user is an admin.
If no user is specified, only public submissions are returned. If a regular user is specified, public submissions and private submissions owned by the user are returned. For admins and for the janitor, all submissions with the given status are returned.
Parameters | status | A status as enumerated in
HWSubmissionProcessingStatus . |
user | The IPerson running the query. | |
Returns | The submissions having the given status. |
Only one of :distribution: or :distroseries: may be supplied.
Parameters | user | The IPerson running the query. Private submissions
are returned only if the person running the query is the
owner or an admin. |
device | Limit results to submissions containing this
IHWDevice . | |
driver | Limit results to submissions containing devices
that use this IHWDriver . | |
distribution | Limit results to submissions made for
this IDistribution . | |
distroseries | Limit results to submissions made for
this IDistroSeries . | |
architecture | Limit results to submissions made for a specific architecture. | |
owner | Limit results to submissions from this person. | |
created_before | Exclude results created after this date. | |
created_after | Exclude results created before or on this date. | |
submitted_before | Exclude results submitted after this date. | |
submitted_after | Exclude results submitted before or on this date. |
At least each of bus, vendor_id, product_id must not be None or driver_name must not be None.
Parameters | bus | The HWBus of the device (optional). |
vendor_id | The vendor ID of the device (optional). | |
product_id | The product ID of the device (optional). | |
driver_name | The name of the driver used for the device (optional). | |
package_name | The name of the package the driver is a part of. (optional). | |
distro_target | Limit the count to submissions made for the given distribution, distroseries or distroarchseries. (optional). | |
Returns | A tuple (submissions_with_device, all_submissions) where submissions_with_device is the number of submissions having the given device or driver and matching the distro_target criterion and where all_submissions is the number of submissions matching the distro_target criterion. |
At least each of bus, vendor_id, product_id must not be None or driver_name must not be None.
Parameters | bus | The HWBus of the device (optional). |
vendor_id | The vendor ID of the device (optional). | |
product_id | The product ID of the device (optional). | |
driver_name | The name of the driver used for the device (optional). | |
package_name | The name of the package the driver is a part of. (optional). | |
distro_target | Limit the count to submissions made for the given distribution, distroseries or distroarchseries. (optional). | |
Returns | A tuple (device_owners, all_hardware_reporters) where device_owners is the number of people who made a HWDB submission containing the given device or driver, optionally limited to submissions made for the given distro_target. all_hardware_reporters is the number of persons who made a HWDB submission, optionally limited to submission made on the given distro_target installation. |
bug_ids
must be a non-empty sequence of bug IDs, or bug_tags
must be a non-empty sequence of bug tags.
The parameters bus
, vendor_id
, product_id
must not be None, or
driver_name
must not be None.
By default, only those persons are returned which have reported a bug matching the given bug conditions.
Owners of private submissions are returned only if user is the owner of the private submission or if user is an admin.
Parameters | bus | The HWBus of the device. |
vendor_id | The vendor ID of the device. | |
product_id | The product ID of the device. | |
driver_name | Limit the search to devices controlled by the given driver. | |
package_name | Limit the search to devices controlled by a driver from the given package. | |
bug_ids | A sequence of bug IDs for which affected device owners are looked up. | |
bug_tags | A sequence of bug tags. | |
affected_by_bug | If True, those persons are looked up that have marked themselves as being affected by a one of the bugs matching the bug criteria. | |
subscribed_to_bug | If True, those persons are looked up that are subscribed to a bug matching one of the bug criteria. | |
user | The person making the query. |
Actually returns a list of tuples where the tuple is of the form, (person name, bus name, vendor id, product id).`
Parameters | bug_ids | A sequence of bug IDs for which affected are looked up. |
bug_tags | A sequence of bug tags | |
affected_by_bug | If True, those persons are looked up that have marked themselves as being affected by a one of the bugs matching the bug criteria. | |
subscribed_to_bug | If True, those persons are looked up that are subscribed to a bug matching one of the bug criteria. | |
user | The person making the query. |