1 '\" te
   2 .\"  Copyright 1989 AT&T
   3 .\" Copyright (C) 2004 Sun Microsystems, Inc. All Rights Reserved
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH RPC_SVC_CALLS 3NSL "Jan 26, 2004"
   8 .SH NAME
   9 rpc_svc_calls, svc_dg_enablecache, svc_done, svc_exit, svc_fdset, svc_freeargs,
  10 svc_getargs, svc_getreq_common, svc_getreq_poll, svc_getreqset,
  11 svc_getrpccaller, svc_max_pollfd, svc_pollfd, svc_run, svc_sendreply,
  12 svc_getcallerucred, svc_fd_negotiate_ucred \- library routines for RPC servers
  13 .SH SYNOPSIS
  14 .LP
  15 .nf
  16 \fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lnsl\fR [ \fIlibrary\fR...]
  17 #include <rpc/rpc.h>
  18 
  19 \fBint\fR \fBsvc_dg_enablecache\fR(\fBSVCXPRT *\fR\fIxprt\fR, \fBconst uint_t\fR \fIcache_size\fR);
  20 .fi
  21 
  22 .LP
  23 .nf
  24 \fBint\fR \fBsvc_done\fR(\fBSVCXPRT *\fR\fIxprt\fR);
  25 .fi
  26 
  27 .LP

 191 the \fBsvc_run()\fR function exactly once. In the Automatic MT mode, the
 192 \fBsvc_run()\fR function creates threads to service client requests. In the
 193 User MT mode, the function provides a framework for service developers to
 194 create and manage their own threads for servicing client requests.
 195 .sp
 196 .LP
 197 The \fBsvc_fdset\fR global variable reflects the \fBRPC\fR server's read file
 198 descriptor bit mask. This is only of interest if service implementors do not
 199 call \fBsvc_run()\fR, but rather do their own asynchronous event processing.
 200 This variable is read-only may change after calls to \fBsvc_getreqset()\fR or
 201 after any creation routine. Do not pass its address to \fBselect\fR(3C).
 202 Instead, pass the address of a copy. multithreaded applications executing in
 203 either the Automatic MT mode or the user MT mode should never read this
 204 variable. They should use auxiliary threads to do asynchronous event
 205 processing. The \fBsvc_fdset\fR variable is limited to 1024 file descriptors
 206 and is considered obsolete. Use of \fBsvc_pollfd\fR is recommended instead.
 207 .sp
 208 .LP
 209 The \fBsvc_pollfd\fR global variable points to an array of \fBpollfd_t\fR
 210 structures that reflect the \fBRPC\fR server's read file descriptor array. This
 211 is only of interest if service service implementors do not call \fBsvc_run()\fR
 212 but rather do their own asynchronous event processing. This variable is
 213 read-only, and it may change after calls to \fBsvc_getreg_poll()\fR or any
 214 creation routines. Do no pass its address to \fBpoll\fR(2). Instead, pass the
 215 address of a copy. By default, \fBsvc_pollfd\fR is limited to 1024 entries. Use
 216 \fBrpc_control\fR(3NSL) to remove this limitation. multithreaded applications
 217 executing in either the Automatic MT mode or the user MT mode should never be
 218 read this variable. They should use auxiliary threads to do asynchronous event
 219 processing.
 220 .sp
 221 .LP
 222 The \fBsvc_max_pollfd\fR global variable contains the maximum length of the
 223 \fBsvc_pollfd\fR array. This variable is read-only, and it may change after
 224 calls to \fBsvc_getreg_poll()\fR or any creation routines.
 225 .sp
 226 .LP
 227 The \fBsvc_sendreply()\fR function is called by an \fBRPC\fR service dispatch
 228 routine to send the results of a remote procedure call. The \fIxprt\fR
 229 parameter is the transport handle of the request. The \fIoutproc\fR parameter
 230 is the \fBXDR\fR routine used to encode the results. The \fIout\fR parameter is
 231 the address of the results. This routine returns \fBTRUE\fR if it succeeds,

   1 '\" te
   2 .\"  Copyright 1989 AT&T
   3 .\" Copyright (C) 2004 Sun Microsystems, Inc. All Rights Reserved
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH RPC_SVC_CALLS 3NSL "Oct 28, 2013"
   8 .SH NAME
   9 rpc_svc_calls, svc_dg_enablecache, svc_done, svc_exit, svc_fdset, svc_freeargs,
  10 svc_getargs, svc_getreq_common, svc_getreq_poll, svc_getreqset,
  11 svc_getrpccaller, svc_max_pollfd, svc_pollfd, svc_run, svc_sendreply,
  12 svc_getcallerucred, svc_fd_negotiate_ucred \- library routines for RPC servers
  13 .SH SYNOPSIS
  14 .LP
  15 .nf
  16 \fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lnsl\fR [ \fIlibrary\fR...]
  17 #include <rpc/rpc.h>
  18 
  19 \fBint\fR \fBsvc_dg_enablecache\fR(\fBSVCXPRT *\fR\fIxprt\fR, \fBconst uint_t\fR \fIcache_size\fR);
  20 .fi
  21 
  22 .LP
  23 .nf
  24 \fBint\fR \fBsvc_done\fR(\fBSVCXPRT *\fR\fIxprt\fR);
  25 .fi
  26 
  27 .LP

 191 the \fBsvc_run()\fR function exactly once. In the Automatic MT mode, the
 192 \fBsvc_run()\fR function creates threads to service client requests. In the
 193 User MT mode, the function provides a framework for service developers to
 194 create and manage their own threads for servicing client requests.
 195 .sp
 196 .LP
 197 The \fBsvc_fdset\fR global variable reflects the \fBRPC\fR server's read file
 198 descriptor bit mask. This is only of interest if service implementors do not
 199 call \fBsvc_run()\fR, but rather do their own asynchronous event processing.
 200 This variable is read-only may change after calls to \fBsvc_getreqset()\fR or
 201 after any creation routine. Do not pass its address to \fBselect\fR(3C).
 202 Instead, pass the address of a copy. multithreaded applications executing in
 203 either the Automatic MT mode or the user MT mode should never read this
 204 variable. They should use auxiliary threads to do asynchronous event
 205 processing. The \fBsvc_fdset\fR variable is limited to 1024 file descriptors
 206 and is considered obsolete. Use of \fBsvc_pollfd\fR is recommended instead.
 207 .sp
 208 .LP
 209 The \fBsvc_pollfd\fR global variable points to an array of \fBpollfd_t\fR
 210 structures that reflect the \fBRPC\fR server's read file descriptor array. This
 211 is only of interest if service implementors do not call \fBsvc_run()\fR
 212 but rather do their own asynchronous event processing. This variable is
 213 read-only, and it may change after calls to \fBsvc_getreg_poll()\fR or any
 214 creation routines. Do no pass its address to \fBpoll\fR(2). Instead, pass the
 215 address of a copy. By default, \fBsvc_pollfd\fR is limited to 1024 entries. Use
 216 \fBrpc_control\fR(3NSL) to remove this limitation. multithreaded applications
 217 executing in either the Automatic MT mode or the user MT mode should never be
 218 read this variable. They should use auxiliary threads to do asynchronous event
 219 processing.
 220 .sp
 221 .LP
 222 The \fBsvc_max_pollfd\fR global variable contains the maximum length of the
 223 \fBsvc_pollfd\fR array. This variable is read-only, and it may change after
 224 calls to \fBsvc_getreg_poll()\fR or any creation routines.
 225 .sp
 226 .LP
 227 The \fBsvc_sendreply()\fR function is called by an \fBRPC\fR service dispatch
 228 routine to send the results of a remote procedure call. The \fIxprt\fR
 229 parameter is the transport handle of the request. The \fIoutproc\fR parameter
 230 is the \fBXDR\fR routine used to encode the results. The \fIout\fR parameter is
 231 the address of the results. This routine returns \fBTRUE\fR if it succeeds,