xref: /freebsd/share/man/man9/BUS_RESCAN.9 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1*a907c691SJohn Baldwin.\" -*- nroff -*-
2*a907c691SJohn Baldwin.\"
3*a907c691SJohn Baldwin.\" Copyright (c) 2016 John H. Baldwin <jhb@FreeBSD.org>
4*a907c691SJohn Baldwin.\"
5*a907c691SJohn Baldwin.\" Redistribution and use in source and binary forms, with or without
6*a907c691SJohn Baldwin.\" modification, are permitted provided that the following conditions
7*a907c691SJohn Baldwin.\" are met:
8*a907c691SJohn Baldwin.\" 1. Redistributions of source code must retain the above copyright
9*a907c691SJohn Baldwin.\"    notice, this list of conditions and the following disclaimer.
10*a907c691SJohn Baldwin.\" 2. Redistributions in binary form must reproduce the above copyright
11*a907c691SJohn Baldwin.\"    notice, this list of conditions and the following disclaimer in the
12*a907c691SJohn Baldwin.\"    documentation and/or other materials provided with the distribution.
13*a907c691SJohn Baldwin.\"
14*a907c691SJohn Baldwin.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15*a907c691SJohn Baldwin.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16*a907c691SJohn Baldwin.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17*a907c691SJohn Baldwin.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18*a907c691SJohn Baldwin.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19*a907c691SJohn Baldwin.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20*a907c691SJohn Baldwin.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21*a907c691SJohn Baldwin.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22*a907c691SJohn Baldwin.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23*a907c691SJohn Baldwin.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24*a907c691SJohn Baldwin.\" SUCH DAMAGE.
25*a907c691SJohn Baldwin.\"
26*a907c691SJohn Baldwin.Dd April 27, 2016
27*a907c691SJohn Baldwin.Dt BUS_RESCAN 9
28*a907c691SJohn Baldwin.Os
29*a907c691SJohn Baldwin.Sh NAME
30*a907c691SJohn Baldwin.Nm BUS_RESCAN
31*a907c691SJohn Baldwin.Nd "rescan a bus checking for devices that have been added or removed"
32*a907c691SJohn Baldwin.Sh SYNOPSIS
33*a907c691SJohn Baldwin.In sys/param.h
34*a907c691SJohn Baldwin.In sys/bus.h
35*a907c691SJohn Baldwin.Ft void
36*a907c691SJohn Baldwin.Fn BUS_RESCAN "device_t dev"
37*a907c691SJohn Baldwin.Sh DESCRIPTION
38*a907c691SJohn BaldwinThe
39*a907c691SJohn Baldwin.Fn BUS_RESCAN
40*a907c691SJohn Baldwinmethod is called to request a rescan of the child devices on a bus device.
41*a907c691SJohn BaldwinThe method should add any devices that have been added since the previous
42*a907c691SJohn Baldwinscan and remove devices that have been removed.
43*a907c691SJohn BaldwinThis method is not required to re-examine existing devices to determine if
44*a907c691SJohn Baldwintheir properties have changed.
45*a907c691SJohn BaldwinThis method is also not required to propagate the rescan request to child
46*a907c691SJohn Baldwindevices.
47*a907c691SJohn Baldwin.Sh SEE ALSO
48*a907c691SJohn Baldwin.Xr device 9
49