.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "PCI_GET_SUBSYS" "" "06 October 2005" "" ""

.SH NAME
pci_get_subsys \- begin or continue searching for a PCI device by vendor/subvendor/device/subdevice id
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
struct pci_dev * pci_get_subsys  (unsigned int \fIvendor\fB, unsigned int \fIdevice\fB, unsigned int \fIss_vendor\fB, unsigned int \fIss_device\fB, struct pci_dev * \fIfrom\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIvendor\fB\fR
PCI vendor id to match, or PCI_ANY_ID to match all vendor ids
.TP
\fB\fIdevice\fB\fR
PCI device id to match, or PCI_ANY_ID to match all device ids
.TP
\fB\fIss_vendor\fB\fR
PCI subsystem vendor id to match, or PCI_ANY_ID to match all vendor ids
.TP
\fB\fIss_device\fB\fR
PCI subsystem device id to match, or PCI_ANY_ID to match all device ids
.TP
\fB\fIfrom\fB\fR
Previous PCI device found in search, or NULL for new search.
.SH "DESCRIPTION"
.PP
Iterates through the list of known PCI devices.  If a PCI device is
found with a matching \fIvendor\fR, \fIdevice\fR, \fIss_vendor\fR and \fIss_device\fR, a pointer to its
device structure is returned, and the reference count to the device is
incremented.  Otherwise, NULL is returned.  A new search is initiated by
passing NULL to the \fIfrom\fR argument.  Otherwise if \fIfrom\fR is not NULL,
searches continue from next device on the global list.
The reference count for \fIfrom\fR is always decremented if it is not NULL\&.