aboutsummaryrefslogtreecommitdiff
path: root/share/man/man9/bus_child_present.9
diff options
context:
space:
mode:
authorRuslan Ermilov <ru@FreeBSD.org>2003-05-30 21:13:32 +0000
committerRuslan Ermilov <ru@FreeBSD.org>2003-05-30 21:13:32 +0000
commit3e1cee04f8b33031d7d2640344d5b93d45e21b8f (patch)
tree8d41dbf814083034fe68b357fd0e043a54498dd0 /share/man/man9/bus_child_present.9
parentc94433875066ef93ba011f59ddfe2134914e9d40 (diff)
Assorted mdoc(7) fixes.
Notes
Notes: svn path=/head/; revision=115418
Diffstat (limited to 'share/man/man9/bus_child_present.9')
-rw-r--r--share/man/man9/bus_child_present.935
1 files changed, 20 insertions, 15 deletions
diff --git a/share/man/man9/bus_child_present.9 b/share/man/man9/bus_child_present.9
index 995a48208016..1b7ff4dbb3d4 100644
--- a/share/man/man9/bus_child_present.9
+++ b/share/man/man9/bus_child_present.9
@@ -33,7 +33,7 @@
.Os
.Sh NAME
.Nm bus_child_present
-.Nd Ask the bus driver to see if this device is still really present.
+.Nd "ask the bus driver to see if this device is still really present"
.Sh SYNOPSIS
.In sys/param.h
.In sys/bus.h
@@ -44,18 +44,22 @@
.Ft int
.Fn bus_child_present "device_t dev"
.Sh DESCRIPTION
-Requests that the parent device driver of
+The
+.Fn bus_child_present
+function requests that the parent device driver of
.Fa dev
check to see if the
hardware represented by
-.Fa dev
+.Fa dev
is still physically accessible at this time.
While the notion of accessible varies from bus to bus, generally
-hardware that is not acceessible cannot be accessed via the bus_space
-methods that would otherwise be used to acceess the device.
+hardware that is not acceessible cannot be accessed via the
+.Fn bus_space*
+methods that would otherwise be used to access the device.
.Pp
-This does not ask the question 'does this device have children?' which
-can better be answered by
+This does not ask the question
+.Dq does this device have children?
+which can better be answered by
.Xr device_get_children 9 .
.Sh RETURN VALUES
A zero return value indicates that the device is not present in the
@@ -64,19 +68,20 @@ A non-zero return value indicates that the device is present in the
system, or that the state of the device cannot be determined.
.Sh EXAMPLES
This is some example code.
-It only calls stop when the dc device is actually present.
-.Bd -literal
- device_t dev;
- dc_softc *sc;
+It only calls stop when the
+.Xr dc 4
+device is actually present.
+.Bd -literal -offset indent
+device_t dev;
+dc_softc *sc;
- sc = device_get_softc(dev);
- if (bus_child_present(dev))
- dc_stop(sc);
+sc = device_get_softc(dev);
+if (bus_child_present(dev))
+ dc_stop(sc);
.Ed
.Sh SEE ALSO
.Xr device 9 ,
.Xr driver 9
.Sh AUTHORS
-.An -nosplit
This man page was written by
.An Warner Losh Aq imp@FreeBSD.org .