diff options
author | ru <ru@FreeBSD.org> | 2001-03-02 08:09:19 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2001-03-02 08:09:19 +0000 |
commit | 2d4d97b177c92674dae3eab2622a2423bf18e529 (patch) | |
tree | b51cc912760f4e3a0d2695b53020bbe7d12aa8ed | |
parent | 3318e2474c6f0164bfe9d238d69c95fadb49bc0b (diff) | |
download | FreeBSD-src-2d4d97b177c92674dae3eab2622a2423bf18e529.zip FreeBSD-src-2d4d97b177c92674dae3eab2622a2423bf18e529.tar.gz |
Fix the rest of formatting.
-rw-r--r-- | share/man/man9/resource_query_string.9 | 54 |
1 files changed, 27 insertions, 27 deletions
diff --git a/share/man/man9/resource_query_string.9 b/share/man/man9/resource_query_string.9 index 0a2c264..aac98f7 100644 --- a/share/man/man9/resource_query_string.9 +++ b/share/man/man9/resource_query_string.9 @@ -32,8 +32,8 @@ .Dt RESOURCE_QUERY_STRING 9 .Os FreeBSD .Sh NAME -.Nm resource_query_string -.Nd queries the +.Nm resource_query_string , resource_query_name , resource_query_unit +.Nd query the .Dq hints database for matches .Sh SYNOPSIS @@ -45,7 +45,7 @@ database for matches .Ft int .Fn resource_query_unit "int num" .Sh DESCRIPTION -.Fn resouce_query_string +.Fn resource_query_string enumerates all devices in the .Dq hints database whose @@ -64,7 +64,7 @@ This cookie should be passed as the parameter on subsequent calls. A return value of \-1 means no further matches exist. .Pp -.Fn resource_query_name +.Fn resource_query_name returns the name of the device matched by .Fn resource_query_string . .Pp @@ -72,9 +72,9 @@ returns the name of the device matched by returns the unit of the device matched by .Fn resource_query_string . .Pp -.Bl -item -.It -.Fa num +The functions take the following arguments: +.Bl -tag -width "field" +.It Fa num is the .Dq index of the item to lookup. @@ -83,23 +83,22 @@ Set to \-1 for the first call, and the return value of the previous on subsequent calls. The .Dq index -is an opaque coookie. -.It -.Fa field +is an opaque cookie. +.It Fa field is the name of the field in the .Dq hints database to query. -.Pp -.Fa what +.It Fa what is the value of .Fa field in the .Dq hints database for which to search. +.El .Sh RETURN VALUES .Fn resource_query_string -returns \-1 on failure, otherwise a cookie to pass -.Fn resource_query_name +returns \-1 on failure, otherwise a cookie to pass to +.Fn resource_query_name or .Fn resource_query_unit . .Pp @@ -112,32 +111,33 @@ returns the device unit number matching the cookie. The following example will return all the .Dq hints that say they are -at gerbil0. +.Dq Li "at gerbil0" . +.Pp An example hint would be: -.Bd -literal +.Bd -literal -offset indent hint.habitat.0.at="gerbil0" hint.ewheel.0.at="gerbil0" hint.fred.0.at="nexus" .Ed .Pp The following code -.Bd -literal - int i = -1; - while ((i = resource_query_string(i, "at", "gerbil0")) != -1) { - printf("Found %s%d at gerbil0\n", resource_query_name(i), - resource_query_unit(i)); - } +.Bd -literal -offset indent +int i = -1; +while ((i = resource_query_string(i, "at", "gerbil0")) != -1) { + printf("Found %s%d at gerbil0\en", resource_query_name(i), + resource_query_unit(i)); +} .Ed +.Pp would produce two lines: -.Bd -literal +.Bd -literal -offset indent Found habitat0 at gerbil0 Found ewheel0 at gerbil0 .Ed .Sh SEE ALSO -.Xr driver 9 , .Xr device 9 , -.Xr resource_int_value 9 . +.Xr driver 9 , +.Xr resource_int_value 9 .Sh AUTHORS -.An -nosplit -This man page was written by +This manual page was written by .An Warner Losh Aq imp@FreeBSD.org . |