Changeset View
Changeset View
Standalone View
Standalone View
share/man/man9/DEVICE_PROBE.9
| Show All 22 Lines | |||||
| .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | ||||
| .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | ||||
| .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | ||||
| .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | ||||
| .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | ||||
| .\" | .\" | ||||
| .\" $FreeBSD$ | .\" $FreeBSD$ | ||||
| .\" | .\" | ||||
| .Dd February 8, 2012 | .Dd January 17, 2022 | ||||
| .Dt DEVICE_PROBE 9 | .Dt DEVICE_PROBE 9 | ||||
| .Os | .Os | ||||
| .Sh NAME | .Sh NAME | ||||
| .Nm DEVICE_PROBE | .Nm DEVICE_PROBE | ||||
| .Nd probe for device existence | .Nd probe for device existence | ||||
| .Sh SYNOPSIS | .Sh SYNOPSIS | ||||
| .In sys/param.h | .In sys/param.h | ||||
| .In sys/bus.h | .In sys/bus.h | ||||
| ▲ Show 20 Lines • Show All 54 Lines • ▼ Show 20 Lines | |||||
| possible other driver may exist (typically legacy drivers who don't follow | possible other driver may exist (typically legacy drivers who don't follow | ||||
| all the rules, or special needs drivers). | all the rules, or special needs drivers). | ||||
| .It BUS_PROBE_VENDOR | .It BUS_PROBE_VENDOR | ||||
| The device is supported by a vendor driver. | The device is supported by a vendor driver. | ||||
| This is for source or binary drivers that are not yet integrated into the | This is for source or binary drivers that are not yet integrated into the | ||||
| .Fx | .Fx | ||||
| tree. | tree. | ||||
| Its use in the base OS is prohibited. | Its use in the base OS is prohibited. | ||||
| .It BUS_PROBE_HIGH_PRIORITY | |||||
| The driver is a more desirable driver for a given plug and play ID. | |||||
| The driver has special requirements like when there are two drivers | |||||
| that support overlapping series of hardware devices and the driver | |||||
| needs to raise its priority over BUS_PROBE_DEFAULT. | |||||
| This may be the case when one driver is using a general framework | |||||
| which is used by multiple drivers and its priority cannot be changed | |||||
| (e.g., LinuxKPI). | |||||
| This value should be used with care. | |||||
| In most cases BUS_PROBE_LOW_PRIORITY and BUS_PROBE_DEFAULT are the | |||||
| correct solution. | |||||
pauamma_gundo.com: I think I understand what you meant, but it took me several minutes. Please check that my… | |||||
| .It BUS_PROBE_DEFAULT | .It BUS_PROBE_DEFAULT | ||||
| The device is a normal device matching some plug and play ID. | The device is a normal device matching some plug and play ID. | ||||
| This is | This is | ||||
| the normal return value for drivers to use. | the normal return value for drivers to use. | ||||
| It is intended that nearly all of the drivers in the tree should return | It is intended that nearly all of the drivers in the tree should return | ||||
| this value. | this value. | ||||
| .It BUS_PROBE_LOW_PRIORITY | .It BUS_PROBE_LOW_PRIORITY | ||||
| The driver is a legacy driver, or an otherwise less desirable driver | The driver is a legacy driver, or an otherwise less desirable driver | ||||
| Show All 31 Lines | |||||
I think I understand what you meant, but it took me several minutes. Please check that my rewording for clarity is indeed what you meant and is consistent with the comment in sys/sys/bus.h.
Also, you may need to reflow my revised paragraph since I didn't check line lengths.