Changeset View
Changeset View
Standalone View
Standalone View
share/man/man9/DEVICE_ATTACH.9
| Show All 12 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 January 15, 2017 | .Dd May 20, 2018 | ||||
| .Dt DEVICE_ATTACH 9 | .Dt DEVICE_ATTACH 9 | ||||
| .Os | .Os | ||||
| .Sh NAME | .Sh NAME | ||||
| .Nm DEVICE_ATTACH | .Nm DEVICE_ATTACH | ||||
| .Nd attach a device | .Nd attach a device | ||||
| .Sh SYNOPSIS | .Sh SYNOPSIS | ||||
| .In sys/param.h | .In sys/param.h | ||||
| .In sys/bus.h | .In sys/bus.h | ||||
| Show All 12 Lines | |||||
| entries). | entries). | ||||
| .Pp | .Pp | ||||
| Devices which implement buses should use this method to probe for | Devices which implement buses should use this method to probe for | ||||
| the existence of devices attached to the bus and add them as | the existence of devices attached to the bus and add them as | ||||
| children. | children. | ||||
| If this is combined with the use of | If this is combined with the use of | ||||
| .Xr bus_generic_attach 9 | .Xr bus_generic_attach 9 | ||||
| the child devices will be automatically probed and attached. | the child devices will be automatically probed and attached. | ||||
| .Pp | |||||
| If | |||||
| .Fn DEVICE_DELAY_ATTACH | |||||
| is implemented, | |||||
| .Fn DEVICE_ATTACH | |||||
| will not be called until | |||||
| .Fn DEVICE_DELAY_ATTACH | |||||
| returns true, even after a successful probe. | |||||
bcr: You need to start a new sentence on a new line after the sentence stop.
Run textproc/igor and… | |||||
| This can be used to delay attachment until after other devices in | |||||
| the tree on which this device depends have successfully attached in | |||||
| cases where | |||||
| .Fn EARLY_DRIVER_MODULE | |||||
| is insufficient. | |||||
| .Sh RETURN VALUES | .Sh RETURN VALUES | ||||
| Zero is returned on success, otherwise an appropriate error is returned. | Zero is returned on success, otherwise an appropriate error is returned. | ||||
| .Sh SEE ALSO | .Sh SEE ALSO | ||||
| .Xr devfs 5 , | .Xr devfs 5 , | ||||
| .Xr device 9 , | .Xr device 9 , | ||||
| .Xr DEVICE_DETACH 9 , | .Xr DEVICE_DETACH 9 , | ||||
| .Xr DEVICE_DELAY_ATTACH 9 , | |||||
| .Xr DEVICE_IDENTIFY 9 , | .Xr DEVICE_IDENTIFY 9 , | ||||
| .Xr DEVICE_PROBE 9 , | .Xr DEVICE_PROBE 9 , | ||||
| .Xr DEVICE_SHUTDOWN 9 | .Xr DEVICE_SHUTDOWN 9 | ||||
| .Sh AUTHORS | .Sh AUTHORS | ||||
| This manual page was written by | This manual page was written by | ||||
| .An Doug Rabson Aq Mt dfr@FreeBSD.org . | .An Doug Rabson Aq Mt dfr@FreeBSD.org . | ||||
| Context not available. | |||||
You need to start a new sentence on a new line after the sentence stop.
Run textproc/igor and it will tell you those.