.\" 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_FIND_SUBSYS" "" "06 October 2005" "" ""

.SH NAME
pci_find_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_find_subsys  (unsigned int \fIvendor\fB, unsigned int \fIdevice\fB, unsigned int \fIss_vendor\fB, unsigned int \fIss_device\fB, const 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.  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.
.SH "NOTE"
.PP
Do not use this function anymore, use \fBpci_get_subsys\fR instead, as
the pci device returned by this function can disappear at any moment in
time.