Changeset View
Changeset View
Standalone View
Standalone View
head/share/man/man4/pci.4
Show All 18 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd January 3, 2008 | .Dd August 9, 2016 | ||||
.Dt PCI 4 | .Dt PCI 4 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm pci | .Nm pci | ||||
.Nd generic PCI driver | .Nd generic PCI driver | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Cd device pci | .Cd device pci | ||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
▲ Show 20 Lines • Show All 188 Lines • ▼ Show 20 Lines | |||||
If the device list has changed, a status of | If the device list has changed, a status of | ||||
.Va PCI_GETCONF_LIST_CHANGED | .Va PCI_GETCONF_LIST_CHANGED | ||||
will be passed back. | will be passed back. | ||||
.It status | .It status | ||||
The status tells the user the disposition of his request for a device list. | The status tells the user the disposition of his request for a device list. | ||||
The possible status values are: | The possible status values are: | ||||
.Bl -ohang | .Bl -ohang | ||||
.It PCI_GETCONF_LAST_DEVICE | .It PCI_GETCONF_LAST_DEVICE | ||||
This means that there are no more devices in the PCI device list after the | This means that there are no more devices in the PCI device list matching | ||||
the specified criteria after the | |||||
ones returned in the | ones returned in the | ||||
.Va matches | .Va matches | ||||
buffer. | buffer. | ||||
.It PCI_GETCONF_LIST_CHANGED | .It PCI_GETCONF_LIST_CHANGED | ||||
This status tells the user that the | This status tells the user that the | ||||
.Tn PCI | .Tn PCI | ||||
device list has changed since his last call to the | device list has changed since his last call to the | ||||
.Dv PCIOCGETCONF | .Dv PCIOCGETCONF | ||||
ioctl and he must reset the | ioctl and he must reset the | ||||
.Va offset | .Va offset | ||||
and | and | ||||
.Va generation | .Va generation | ||||
to zero to start over at the beginning of the list. | to zero to start over at the beginning of the list. | ||||
.It PCI_GETCONF_MORE_DEVS | .It PCI_GETCONF_MORE_DEVS | ||||
This tells the user that his buffer was not large enough to hold all of the | This tells the user that his buffer was not large enough to hold all of the | ||||
remaining devices in the device list that possibly match his criteria. | remaining devices in the device list that match his criteria. | ||||
It is possible for this status to be returned, even when none of the remaining | |||||
devices in the list would match the user's criteria. | |||||
.It PCI_GETCONF_ERROR | .It PCI_GETCONF_ERROR | ||||
This indicates a general error while servicing the user's request. | This indicates a general error while servicing the user's request. | ||||
If the | If the | ||||
.Va pat_buf_len | .Va pat_buf_len | ||||
is not equal to | is not equal to | ||||
.Va num_patterns | .Va num_patterns | ||||
times | times | ||||
.Fn sizeof "struct pci_match_conf" , | .Fn sizeof "struct pci_match_conf" , | ||||
▲ Show 20 Lines • Show All 85 Lines • Show Last 20 Lines |