summaryrefslogtreecommitdiff
path: root/share/man
diff options
context:
space:
mode:
authorMark Kettenis <kettenis@cvs.openbsd.org>2014-02-08 20:29:02 +0000
committerMark Kettenis <kettenis@cvs.openbsd.org>2014-02-08 20:29:02 +0000
commit59cc1d8c03734c9e96334a2d76a2b989f1bde0e9 (patch)
treed21fd6dc89c29f504013242c0e3c74e2099654cd /share/man
parent3f429afd845f8e311ef9f094b08294a456b0f479 (diff)
Add extent_alloc_with_descr(9) as a wrapper around
extent_alloc_subregion_with_descr(9) mirroring extent_alloc(9). ok jmc@
Diffstat (limited to 'share/man')
-rw-r--r--share/man/man9/extent.935
1 files changed, 21 insertions, 14 deletions
diff --git a/share/man/man9/extent.9 b/share/man/man9/extent.9
index 05d8c36a37e..5734476912d 100644
--- a/share/man/man9/extent.9
+++ b/share/man/man9/extent.9
@@ -1,4 +1,4 @@
-.\" $OpenBSD: extent.9,v 1.17 2014/01/21 21:46:54 kettenis Exp $
+.\" $OpenBSD: extent.9,v 1.18 2014/02/08 20:29:01 kettenis Exp $
.\" $NetBSD: extent.9,v 1.15 1999/03/16 00:40:47 garbled Exp $
.\"
.\" Copyright (c) 1996, 1998 The NetBSD Foundation, Inc.
@@ -28,13 +28,14 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: January 21 2014 $
+.Dd $Mdocdate: February 8 2014 $
.Dt EXTENT 9
.Os
.Sh NAME
.Nm extent_create ,
.Nm extent_destroy ,
.Nm extent_alloc ,
+.Nm extent_alloc_with_descr ,
.Nm extent_alloc_subregion ,
.Nm extent_alloc_subregion_with_descr ,
.Nm extent_alloc_region ,
@@ -51,6 +52,8 @@
.Ft int
.Fn extent_alloc "struct extent *ex" "u_long size" "u_long alignment" "u_long skew" "u_long boundary" "int flags" "u_long *result"
.Ft int
+.Fn extent_alloc_with_descr "struct extent *ex" "u_long size" "u_long alignment" "u_long skew" "u_long boundary" "int flags" "struct extent_region *rp" "u_long *result"
+.Ft int
.\" too many arguments for a single .Fn
.Fo extent_alloc_subregion
.Fa "struct extent *ex"
@@ -243,25 +246,29 @@ Upon successful completion,
.Fa *result
will contain the start of the allocated region.
.Pp
-.Fn extent_alloc_subregion
-is a generalized version of
-.Fn extent_alloc
-that also allows the caller to specify that the allocated region must
-fall within the subregion from
-.Fa substart
-to
-.Fa subend
-inclusive.
-.Pp
-.Fn extent_alloc_subregion_with_descr
+.Fn extent_alloc_with_descr
is similar to
-.Fn extent_alloc_subregion
+.Fn extent_alloc
but allows the caller to provide a pre-allocated region descriptor instead
of having the function allocate one.
This function can only be used with extents that have the
.Dv EX_NOCOALESCE
property.
.Pp
+.Fn extent_alloc_subregion
+and
+.Fn extent_alloc_subregion_with_descr
+are generalized versions of
+.Fn extent_alloc
+and
+.Fn extent_alloc_with_descr
+that allow the caller to specify that the allocated region must fall
+within the subregion from
+.Fa substart
+to
+.Fa subend
+inclusive.
+.Pp
.Fn extent_alloc_region
allocates the specific region in the extent map
.Fa ex