diff options
| author | Robert Mustacchi <rm@joyent.com> | 2016-08-02 23:37:13 -0700 |
|---|---|---|
| committer | Robert Mustacchi <rm@joyent.com> | 2016-08-09 09:47:04 -0700 |
| commit | 1dcf899fd5767e21079d727344315efe1b329039 (patch) | |
| tree | ccef5b87162ca27b527b64a98a61daf5352afcb5 /usr/src/man | |
| parent | 158dfbe4529de26c7bd687efe70e837858cbf8cf (diff) | |
| download | illumos-joyent-1dcf899fd5767e21079d727344315efe1b329039.tar.gz | |
7271 Cleanup minor issues in id_space(9F)
Reviewed by: Garrett D'Amore <garrett@damore.org>
Approved by: Richard Lowe <richlowe@richlowe.net>
Diffstat (limited to 'usr/src/man')
| -rw-r--r-- | usr/src/man/man9f/id_space.9f | 37 |
1 files changed, 15 insertions, 22 deletions
diff --git a/usr/src/man/man9f/id_space.9f b/usr/src/man/man9f/id_space.9f index b9770cab1f..c077fd9434 100644 --- a/usr/src/man/man9f/id_space.9f +++ b/usr/src/man/man9f/id_space.9f @@ -11,7 +11,7 @@ .\" .\" Copyright 2016 Joyent, Inc. .\" -.Dd June 04, 2016 +.Dd Aug 02, 2016 .Dt ID_SPACE 9F .Os .Sh NAME @@ -82,12 +82,12 @@ function. .It Fa id An identifier, a signed 32-bit integer. .It Fa name -A null-terminated ASCII character string to call the identifier space. +An ASCII character string to call the identifier space. .It Fa low The lower end of an identifier space. This value is included in the range. .It Fa high -The upper end of an identifier space. This value is excluded in the +The upper end of an identifier space. This value is excluded from the range. .El .Sh DESCRIPTION @@ -153,12 +153,9 @@ All three of these functions, .Fn id_space_create , .Fn id_space_extend , and -.Fn id_space_destory +.Fn id_space_destroy may block. They should only be called from a context where it's safe for -it to block. This is logically the equivalent of calling -.Xr kmem_alloc 9F -with the flag -.Dv KMEM_SLEEP . +it to block. This is equivalent to performing a blocking memory allocation. .Ss Allocating Identifiers Once an id space has been created with the .Fn id_space_create @@ -219,22 +216,18 @@ It is a programmer error to call the .Fn id_free function on an identifier that has not been allocated. .Sh CONTEXT -In general, all the functions listed here may be executed in either -.Sy user , -.Sy kernel , +All of these functions may be called in +.Sy user or -.Sy interrupt -context. However, the functions -.Fn id_space_create , -.Fn id_space_destroy , -.Fn id_space_extend , -.Fn id_alloc , +.Sy kernel +context. The +.Fn id_alloc_nosleep , +.Fn id_allocff_nosleep , and -.Fn id_allocff -must be called from a context where it is safe to block and sleep. If -the caller is not in such a context, then it must only use the -.Sy '_nosleep' -functions. +.Fn id_alloc_specific_nosleep +functions may be called in +.Sy interrupt +context. .Sh RETURN VALUES Upon successful completion, the .Fn id_space_create |