xref: /freebsd/share/man/man9/bus_generic_new_pass.9 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
14ef60d26SJohn Baldwin.\" -*- nroff -*-
24ef60d26SJohn Baldwin.\"
3179fa75eSJohn Baldwin.\" Copyright (c) 2009 Hudson River Trading LLC
44ef60d26SJohn Baldwin.\" Written by: John H. Baldwin <jhb@FreeBSD.org>
54ef60d26SJohn Baldwin.\" All rights reserved.
64ef60d26SJohn Baldwin.\"
74ef60d26SJohn Baldwin.\" Redistribution and use in source and binary forms, with or without
84ef60d26SJohn Baldwin.\" modification, are permitted provided that the following conditions
94ef60d26SJohn Baldwin.\" are met:
104ef60d26SJohn Baldwin.\" 1. Redistributions of source code must retain the above copyright
114ef60d26SJohn Baldwin.\"    notice, this list of conditions and the following disclaimer.
124ef60d26SJohn Baldwin.\" 2. Redistributions in binary form must reproduce the above copyright
134ef60d26SJohn Baldwin.\"    notice, this list of conditions and the following disclaimer in the
144ef60d26SJohn Baldwin.\"    documentation and/or other materials provided with the distribution.
154ef60d26SJohn Baldwin.\"
164ef60d26SJohn Baldwin.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
174ef60d26SJohn Baldwin.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
184ef60d26SJohn Baldwin.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
194ef60d26SJohn Baldwin.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
204ef60d26SJohn Baldwin.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
214ef60d26SJohn Baldwin.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
224ef60d26SJohn Baldwin.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
234ef60d26SJohn Baldwin.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
244ef60d26SJohn Baldwin.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
254ef60d26SJohn Baldwin.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
264ef60d26SJohn Baldwin.\" SUCH DAMAGE.
274ef60d26SJohn Baldwin.\"
28*db4fcadfSConrad Meyer.Dd January 15, 2017
29134d45e8SUlrich Spörlein.Dt BUS_GENERIC_NEW_PASS 9
304ef60d26SJohn Baldwin.Os
314ef60d26SJohn Baldwin.Sh NAME
324ef60d26SJohn Baldwin.Nm bus_generic_new_pass
334ef60d26SJohn Baldwin.Nd "generic implementation of BUS_NEW_PASS for bus devices"
344ef60d26SJohn Baldwin.Sh SYNOPSIS
354ef60d26SJohn Baldwin.In sys/param.h
364ef60d26SJohn Baldwin.In sys/bus.h
374ef60d26SJohn Baldwin.Ft void
384ef60d26SJohn Baldwin.Fn bus_generic_new_pass "device_t dev"
394ef60d26SJohn Baldwin.Sh DESCRIPTION
404ef60d26SJohn BaldwinThis function provides an implementation of the
414ef60d26SJohn Baldwin.Xr BUS_NEW_PASS 9
424ef60d26SJohn Baldwinmethod which can be used by bus drivers.
434ef60d26SJohn BaldwinIt first invokes the
444ef60d26SJohn Baldwin.Xr DEVICE_IDENTIFY 9
454ef60d26SJohn Baldwinmethod for any drivers whose pass level is equal to the new pass level.
464ef60d26SJohn BaldwinThen, for each attached child device it calls
474ef60d26SJohn Baldwin.Xr BUS_NEW_PASS 9
48*db4fcadfSConrad Meyerto rescan child buses,
494ef60d26SJohn Baldwinand for each unattached child device it calls
504ef60d26SJohn Baldwin.Xr device_probe_and_attach 9 .
514ef60d26SJohn Baldwin.Sh SEE ALSO
524ef60d26SJohn Baldwin.Xr BUS_NEW_PASS 9 ,
534ef60d26SJohn Baldwin.Xr bus_set_pass 9 ,
544ef60d26SJohn Baldwin.Xr device 9 ,
554ef60d26SJohn Baldwin.Xr DEVICE_IDENTIFY 9
56