summaryrefslogtreecommitdiffstats
path: root/share/man/man9/rman.9
diff options
context:
space:
mode:
Diffstat (limited to 'share/man/man9/rman.9')
-rw-r--r--share/man/man9/rman.931
1 files changed, 30 insertions, 1 deletions
diff --git a/share/man/man9/rman.9 b/share/man/man9/rman.9
index 9b9e84f..6da8321 100644
--- a/share/man/man9/rman.9
+++ b/share/man/man9/rman.9
@@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd May 19, 2016
+.Dd May 20, 2016
.Dt RMAN 9
.Os
.Sh NAME
@@ -49,6 +49,8 @@
.Nm rman_get_device ,
.Nm rman_get_size ,
.Nm rman_get_flags ,
+.Nm rman_set_mapping ,
+.Nm rman_get_mapping ,
.Nm rman_set_virtual ,
.Nm rman_get_virtual ,
.Nm rman_set_bustag ,
@@ -106,6 +108,10 @@
.Ft u_int
.Fn rman_get_flags "struct resource *r"
.Ft void
+.Fn rman_set_mapping "struct resource *r" "struct resource_map *map"
+.Ft void
+.Fn rman_get_mapping "struct resource *r" "struct resource_map *map"
+.Ft void
.Fn rman_set_virtual "struct resource *r" "void *v"
.Ft "void *"
.Fn rman_get_virtual "struct resource *r"
@@ -140,6 +146,7 @@ represented by a 16-bit flag register, as follows.
#define RF_SHAREABLE 0x0004 /* resource permits contemporaneous sharing */
#define RF_FIRSTSHARE 0x0020 /* first in sharing list */
#define RF_PREFETCHABLE 0x0040 /* resource is prefetchable */
+#define RF_UNMAPPED 0x0100 /* don't map resource when activating */
.Ed
.Pp
Bits 15:10 of the flag register are used to represent the desired alignment
@@ -424,6 +431,26 @@ The
function can be used to retrieve the KVA once set.
.Pp
The
+.Fn rman_set_mapping
+function is used to associate a resource mapping with a resource
+.Fa r .
+The mapping must cover the entire resource.
+Setting a mapping sets the associated
+.Xr bus_space 9
+handle and tag for
+.Fa r
+as well as the kernel virtual address if the mapping contains one.
+These individual values can be retrieved via
+.Fn rman_get_bushandle ,
+.Fn rman_get_bustag ,
+and
+.Fn rman_get_virtual .
+.Pp
+The
+.Fn rman_get_mapping
+function can be used to retrieve the associated resource mapping once set.
+.Pp
+The
.Fn rman_set_rid
function associates a resource identifier with a resource
.Fa r .
@@ -439,7 +466,9 @@ function returns a pointer to the device which reserved the resource
.Xr bus_activate_resource 9 ,
.Xr bus_adjust_resource 9 ,
.Xr bus_alloc_resource 9 ,
+.Xr bus_map_resource 9 ,
.Xr bus_release_resource 9 ,
+.Xr bus_space 9 ,
.Xr bus_set_resource 9 ,
.Xr mutex 9
.Sh AUTHORS
OpenPOWER on IntegriCloud