Lines Matching +full:not +full:- +full:used
15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
188 set of functions are used for managing PCI devices.
199 function is used to read data from the PCI configuration
210 function is used to write the value
223 function is used to modify the value of a register in the PCI-express
235 Any bits not specified in
242 function is used to read the value of a register in the PCI-express
253 function is used to write the value
255 to a register in the PCI-express capability register set of device
265 is not available via another
281 which does not necessarily indicate its geographic location
288 .Bd -literal -offset indent
305 which does not necessarily indicate its geographic location
322 function is used to locate the first instance of a PCI capability
337 If the capability is not found or the device does not support capabilities,
342 function is used to locate the next instance of a PCI capability
359 function is used to locate the first instance of a PCI-express
374 If the extended capability is not found or the device is not a
375 PCI-express device,
380 function is used to locate the next instance of a PCI-express
397 function is used to locate the first instance of a HyperTransport capability
412 If the capability is not found or the device is not a HyperTransport device,
417 function is used to locate the next instance of a HyperTransport capability
434 function walks up the PCI device hierarchy to locate the PCI-express root
437 If a root port is not found,
444 function is used to read an identifier from a device.
447 flag is used to specify which identifier to read.
449 .Bl -hang -width ".Dv PCI_ID_RID"
454 This is needed by some interrupt controllers to route MSI and MSI-X interrupts.
459 function is used to fetch a device's Vital Product Data
467 is set to point at a read-only, null-terminated copy of the identifier
472 If the device does not support VPD or does not provide an identifier
480 function is used to fetch the value of a single VPD read-only keyword
485 If the device supports VPD and provides a read-only value for the
489 is set to point at a read-only, null-terminated copy of the value,
493 If the device does not support VPD or does not provide the requested
506 device is not a PCI-express device,
511 this function returns the maxmimum timeout that would be used if timeouts
520 pending flag in the PCI-express device status register.
542 is not a PCI-express device.
578 Device drivers should generally not use these routines directly.
591 PCI-express device.
594 device is not a PCI-express device,
601 PCI-express device.
604 device is not a PCI-express device,
610 sets the PCI-express maximum read request size for
620 device is not a PCI-express device,
628 If the device does not support power management capabilities, then the default
633 .Bl -hang -width ".Dv PCI_POWERSTATE_UNKNOWN"
639 Class-specific low-power state in which device context may or
640 may not be lost.
644 Class-specific low-power state in which device context may or
645 may not be lost.
653 State in which the device is off and not running.
662 function is used to transition the device
666 If the device does not support power management capabilities or
667 it does not support the specific power state
674 function is used to advertise that the given device
676 supports PCI Single-Root I/O Virtualization
677 .Pq SR-IOV .
678 A driver that supports SR-IOV must implement the
688 still successfully attaches, but runs with SR-IOV disabled.
693 parameters are used to define what device-specific configuration parameters the
694 device driver accepts when SR-IOV is enabled for the Physical Function
709 will return an error and SR-IOV will not be available on the PF device.
710 If a driver does not accept configuration parameters for either the PF device
712 The SR-IOV infrastructure takes ownership of the
735 function is used to advise the SR-IOV infrastructure that the driver for the
736 given device is attempting to detach and that all SR-IOV resources for the
744 has not subsequently been called on the device and returned no error.
759 functions can be used by a device driver to save and restore standard PCI
765 can be used.
766 If the device is not in the fully-powered state
783 is not a PCI-express device or does not support Function Level Resets via
784 the PCI-express device control register,
801 busmastering is re-enabled and
817 does not save and restore any state around the reset.
824 .Pq MSI-X
830 MSI and MSI-X interrupts are available to PCI devices as one or more
833 A driver must ask the PCI bus to allocate MSI or MSI-X interrupts
838 before it can use MSI or MSI-X
841 A driver is not allowed to use the legacy INTx
843 resource if MSI or MSI-X interrupts have been allocated,
844 and attempts to allocate MSI or MSI-X interrupts will fail if the
848 A driver is only allowed to use either MSI or MSI-X,
849 but not both.
856 If the device does not support MSI,
885 is not able to allocate any messages,
888 requests to allocate a non-power of two count of messages will fail.
892 function is used to release any allocated MSI or MSI-X messages back
894 If any MSI or MSI-X
906 function returns the maximum number of MSI-X messages supported by the
909 If the device does not support MSI-X,
918 containing the MSI-X Pending Bit Array (PBA) for device
920 The returned value can be used as the resource ID with
925 If the device does not support MSI-X,
928 returns -1.
933 containing the MSI-X vector table for device
935 The returned value can be used as the resource ID with
940 If the device does not support MSI-X,
943 returns -1.
949 MSI-X messages for the device
957 or if the system has a shortage of available MSI-X messages.
963 For MSI-X messages,
966 resource identifies the index in the MSI-X table of the
968 A resource ID of one maps to the first index of the MSI-X table;
979 is not able to allocate any messages,
982 MSI-X does not require message counts that are powers of two.
984 The BARs containing the MSI-X vector table and PBA must be
989 and must not be released until after calling
999 to determine the pending status of the MSI-X message at table index
1002 this function returns a non-zero value;
1011 MSI-X messages are initially assigned to the first N table entries.
1031 The array maps directly to the MSI-X table in that the first entry in
1032 the array specifies the message used for the first entry in the MSI-X
1035 MSI-X table,
1038 that no message should be assigned to the corresponding MSI-X table entry,
1045 corresponding MSI-X table entry.
1050 each MSI-X table entry with a non-zero vector will have an associated
1055 MSI-X table entries that with a vector of zero will not have an
1062 are not used in the new distribution of messages in the MSI-X table,
1070 function will fail if this condition is not met.
1075 This includes the creation of Virtual Functions via SR-IOV.
1105 .%U https://docs.freebsd.org/en/books/developers-handbook/
1112 .%I Addison-Wesley
1113 .%O ISBN 0-201-30974-2
1116 .An -nosplit
1124 These do not refer to the geographic location of PCI devices,
1129 The PCI bus driver should allocate the MSI-X vector table and PBA internally