diff options
author | Jerry Jelinek <jerry.jelinek@joyent.com> | 2017-05-30 12:09:28 +0000 |
---|---|---|
committer | Jerry Jelinek <jerry.jelinek@joyent.com> | 2017-05-30 12:09:28 +0000 |
commit | 539be8d67e75fbd3dbdebfb93ba8ec220779f0dc (patch) | |
tree | 216317390a6e9baedf41b054985ce3860227bc17 /usr/src/man/man3c/door_create.3c | |
parent | eb851a777c457362e68a9c4505129bd23d595b7a (diff) | |
parent | 8186848379535a7535e73f719d8d947abf86522d (diff) | |
download | illumos-joyent-539be8d67e75fbd3dbdebfb93ba8ec220779f0dc.tar.gz |
[illumos-gate merge]
commit 8186848379535a7535e73f719d8d947abf86522d
8271 loader: Replacing iterating over rootpath by strsep
commit 1a1df1dbef1b5c57672433301a296dfe4311e6db
8247 uts: Remove archaic register keyword from zmod
commit 45681b8b0e59cad83c1547d78e25d4b7f218d635
8238 xdr_callmsg() should clear residual bytes
commit d1aea6f139360e9e7f1504facb24f8521047b15c
7768 Avoid vgatext dependency on agpmaster
commit d3d32e94615bd7b44139c48d97167020d74fa5b0
8262 sadp is neither built nor used
commit b521c41bc9226e79d6dea569da64cfe5def2ea19
8279 socketpair(AF_UNIX, SOCK_DGRAM,...) broken after 7590
commit d0d16abc1e2ce70cfd8468614a702b20e1fc7e78
8194 kmfcfg: case value not in enumerated type
commit 84e6955df14dc7f06618ed336ac0a78ba258feb6
8171 loader: distinguish NFS versus TFTP boot by rootpath
commit d993cb83958d44b76c7c56393113c24811dde5f7
8202 doors man pages contain extra whitespace
5180 door_server_create(3c): Incomplete return type
commit 6cf138763efaab6b5998bc1ed6849459e376684d
8170 update CLDR data to v31
commit dea58231324dba08972c488dcdedbab5c528ac8a
8263 pkgchk has unused -Q flag
Diffstat (limited to 'usr/src/man/man3c/door_create.3c')
-rw-r--r-- | usr/src/man/man3c/door_create.3c | 27 |
1 files changed, 11 insertions, 16 deletions
diff --git a/usr/src/man/man3c/door_create.3c b/usr/src/man/man3c/door_create.3c index 74965be5f4..0f04425dd8 100644 --- a/usr/src/man/man3c/door_create.3c +++ b/usr/src/man/man3c/door_create.3c @@ -18,18 +18,17 @@ door_create \- create a door descriptor .fi .SH DESCRIPTION -.sp .LP The \fBdoor_create()\fR function creates a door descriptor that describes the -procedure specified by the function \fIserver_procedure\fR. The data item, -\fIcookie\fR, is associated with the door descriptor, and is passed as an +procedure specified by the function \fIserver_procedure\fR. The data item, +\fIcookie\fR, is associated with the door descriptor, and is passed as an argument to the invoked function \fIserver_procedure\fR during -\fBdoor_call\fR(3C) invocations. Other arguments passed to +\fBdoor_call\fR(3C) invocations. Other arguments passed to \fIserver_procedure\fR from an associated \fBdoor_call()\fR are placed on the stack and include \fIargp\fR and \fIdp\fR. The \fIargp\fR argument points to \fIarg_size\fR bytes of data and the \fIdp\fR argument points to \fIn_desc\fR \fBdoor_desc_t\fR structures. The \fIattributes\fR argument specifies -attributes associated with the newly created door. Valid values for +attributes associated with the newly created door. Valid values for \fIattributes\fR are constructed by OR-ing one or more of the following values: .sp .ne 2 @@ -39,11 +38,11 @@ attributes associated with the newly created door. Valid values for .sp .6 .RS 4n Delivers a special invocation on the door when the number of descriptors that -refer to this door drops to one. In order to trigger this condition, more +refer to this door drops to one. In order to trigger this condition, more than one descriptor must have referred to this door at some time. \fBDOOR_UNREF_DATA\fR designates an unreferenced invocation, as the \fIargp\fR argument passed to \fIserver_procedure\fR. In the case of an unreferenced -invocation, the values for \fIarg_size\fR, \fIdp\fR and \fIn_did\fR are +invocation, the values for \fIarg_size\fR, \fIdp\fR and \fIn_did\fR are \fB0\fR. Only one unreferenced invocation is delivered on behalf of a door. .RE @@ -56,7 +55,7 @@ invocation, the values for \fIarg_size\fR, \fIdp\fR and \fIn_did\fR are .RS 4n Similar to \fBDOOR_UNREF\fR, except multiple unreferenced invocations can be delivered on the same door if the number of descriptors referring to the door -drops to one more than once. Since an additional reference may have been +drops to one more than once. Since an additional reference may have been passed by the time an unreferenced invocation arrives, the \fBDOOR_IS_UNREF\fR attribute returned by the \fBdoor_info\fR(3C) call can be used to determine if the door is still unreferenced. @@ -69,8 +68,8 @@ the door is still unreferenced. .ad .sp .6 .RS 4n -Maintains a separate pool of server threads on behalf of the door. Server -threads are associated with a door's private server pool using +Maintains a separate pool of server threads on behalf of the door. Server +threads are associated with a door's private server pool using \fBdoor_bind\fR(3C). .RE @@ -94,7 +93,7 @@ procedure will always be invoked with an \fIn_desc\fR argument of 0. .sp .6 .RS 4n Clients which abort calls to \fBdoor_call()\fR on this door will not cause the -cancellation of the server thread handling the request. See +cancellation of the server thread handling the request. See \fBcancellation\fR(5). .RE @@ -109,7 +108,7 @@ item \fIcookie\fR. .sp .LP By default, additional threads are created as needed to handle concurrent -\fBdoor_call()\fR invocations. See \fBdoor_server_create\fR(3C) for +\fBdoor_call()\fR invocations. See \fBdoor_server_create\fR(3C) for information on how to change this behavior. .sp .LP @@ -120,13 +119,11 @@ A process can advertise a door in the file system name space using After creation, \fBdoor_setparam\fR(3C) can be used to set limits on the amount of data and descriptors clients can send over the door. .SH RETURN VALUES -.sp .LP Upon successful completion, \fBdoor_create()\fR returns a non-negative value. Otherwise, \fBdoor_create\fR returns \fB\(mi1\fR and sets \fBerrno\fR to indicate the error. .SH ERRORS -.sp .LP The \fBdoor_create()\fR function will fail if: .sp @@ -202,7 +199,6 @@ main(int argc, char *argv[]) .in -2 .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -222,7 +218,6 @@ MT-Level Safe .TE .SH SEE ALSO -.sp .LP \fBdoor_bind\fR(3C), \fBdoor_call\fR(3C), \fBdoor_info\fR(3C), \fBdoor_revoke\fR(3C), \fBdoor_setparam\fR(3C), \fBdoor_server_create\fR(3C), |