xref: /freebsd/share/man/man9/BUS_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.\"
284ef60d26SJohn Baldwin.Dd June 8, 2009
294ef60d26SJohn Baldwin.Dt BUS_NEW_PASS 9
304ef60d26SJohn Baldwin.Os
314ef60d26SJohn Baldwin.Sh NAME
324ef60d26SJohn Baldwin.Nm BUS_NEW_PASS
334ef60d26SJohn Baldwin.Nd "notify a bus that the pass level has been changed"
344ef60d26SJohn Baldwin.Sh SYNOPSIS
354ef60d26SJohn Baldwin.In sys/param.h
364ef60d26SJohn Baldwin.In sys/bus.h
374ef60d26SJohn Baldwin.Ft void
384ef60d26SJohn Baldwin.Fn BUS_NEW_PASS "device_t dev"
394ef60d26SJohn Baldwin.Sh DESCRIPTION
404ef60d26SJohn BaldwinThe
414ef60d26SJohn Baldwin.Fn BUS_NEW_PASS
424ef60d26SJohn Baldwinmethod is called on each bus device to rescan the device tree when the pass
434ef60d26SJohn Baldwinlevel has been changed.
444ef60d26SJohn BaldwinThis method is responsible for invoking
45*16e36754SEdward Tomasz Napierala.Nm
46f6ac2391SJoel Dahlon child bus devices to propagate the rescan to child devices.
474ef60d26SJohn BaldwinIt is also responsible for reprobing any unattached child devices and
484ef60d26SJohn Baldwinallowing drivers for the current pass to identify new children.
494ef60d26SJohn BaldwinA default implementation is provided by
504ef60d26SJohn Baldwin.Xr bus_generic_new_pass 9 .
514ef60d26SJohn Baldwin.Sh SEE ALSO
524ef60d26SJohn Baldwin.Xr bus_generic_new_pass 9 ,
534ef60d26SJohn Baldwin.Xr bus_set_pass 9 ,
544ef60d26SJohn Baldwin.Xr device 9
55