62 .LP
63 By default, the maximum number of threads that the server will create at any
64 time is 16. This allows the service developer to put a bound on thread
65 resources consumed by a server. If a server needs to process more than 16
66 client requests concurrently, the maximum number of threads must be set to the
67 desired number. This parameter may be set at any time by the server.
68 .sp
69 .LP
70 Set and get operations will succeed even in modes where the operations don't
71 apply. For example, you can set the maximum number of threads in any mode,
72 even though it makes sense only for the Automatic MT mode. All of the get
73 operations except \fBRPC_SVC_MTMODE_GET\fR apply only to the Automatic MT mode,
74 so values returned in other modes may be undefined.
75 .sp
76 .LP
77 By default, \fBRPC\fR servers are limited to a maximum of 1024 file descriptors
78 or connections due to limitations in the historical interfaces
79 \fBsvc_fdset\fR(3NSL) and \fBsvc_getreqset\fR(3NSL). Applications written to
80 use the preferred interfaces of \fBsvc_pollfd\fR(3NSL) and
81 \fBsvc_getreq_poll\fR(3NSL) can use an unlimited number of file descriptors.
82 Setting \fBinfo\fR to point to a non-zero integer and \fIop\fR to
83 \fBRPC_SVC_USE_POLLFD\fR removes the limitation.
84 .sp
85 .LP
86 Connection oriented \fBRPC\fR transports read \fBRPC\fR requests in blocking
87 mode by default. Thus, they may be adversely affected by network delays and
88 broken clients. \fBRPC_SVC_CONNMAXREC_SET\fR enables non-blocking mode and
89 establishes the maximum record size (in bytes) for \fBRPC\fR requests;
90 \fBRPC\fR responses are not affected. Buffer space is allocated as needed up to
91 the specified maximum, starting at the maximum or \fBRPC_MAXDATASIZE\fR,
92 whichever is smaller.
93 .sp
94 .LP
95 The value established by \fBRPC_SVC_CONNMAXREC_SET\fR is used when a connection
96 is created, and it remains in effect for that connection until it is closed. To
97 change the value for existing connections on a per-connection basis, see
98 \fBsvc_control\fR(3NSL).
99 .sp
100 .LP
101 \fBRPC_SVC_CONNMAXREC_GET\fR retrieves the current maximum record size. A zero
102 value means that no maximum is in effect, and that the connections are in
103 blocking mode.
104 .sp
105 .LP
106 \fIinfo\fR is a pointer to an argument of type \fBint\fR. Non-connection RPC
107 transports ignore \fBRPC_SVC_CONNMAXREC_SET\fR and
108 \fBRPC_SVC_CONNMAXREC_GET\fR.
109 .SH RETURN VALUES
110 .sp
111 .LP
112 This routine returns \fBTRUE\fR if the operation was successful and
113 returns\fBFALSE\fR otherwise.
114 .SH ATTRIBUTES
115 .sp
116 .LP
117 See \fBattributes\fR(5) for descriptions of the following attributes:
118 .sp
119
120 .sp
121 .TS
122 box;
123 c | c
124 l | l .
125 ATTRIBUTE TYPE ATTRIBUTE VALUE
126 _
127 MT-Level MT-Safe
128 .TE
129
130 .SH SEE ALSO
131 .sp
132 .LP
133 \fBrpcbind\fR(1M), \fBrpc\fR(3NSL), \fBrpc_svc_calls\fR(3NSL),
|
62 .LP
63 By default, the maximum number of threads that the server will create at any
64 time is 16. This allows the service developer to put a bound on thread
65 resources consumed by a server. If a server needs to process more than 16
66 client requests concurrently, the maximum number of threads must be set to the
67 desired number. This parameter may be set at any time by the server.
68 .sp
69 .LP
70 Set and get operations will succeed even in modes where the operations don't
71 apply. For example, you can set the maximum number of threads in any mode,
72 even though it makes sense only for the Automatic MT mode. All of the get
73 operations except \fBRPC_SVC_MTMODE_GET\fR apply only to the Automatic MT mode,
74 so values returned in other modes may be undefined.
75 .sp
76 .LP
77 By default, \fBRPC\fR servers are limited to a maximum of 1024 file descriptors
78 or connections due to limitations in the historical interfaces
79 \fBsvc_fdset\fR(3NSL) and \fBsvc_getreqset\fR(3NSL). Applications written to
80 use the preferred interfaces of \fBsvc_pollfd\fR(3NSL) and
81 \fBsvc_getreq_poll\fR(3NSL) can use an unlimited number of file descriptors.
82 Setting \fIinfo\fR to point to a non-zero integer and \fIop\fR to
83 \fBRPC_SVC_USE_POLLFD\fR removes the limitation.
84 .sp
85 .LP
86 Connection oriented \fBRPC\fR transports read \fBRPC\fR requests in blocking
87 mode by default. Thus, they may be adversely affected by network delays and
88 broken clients. \fBRPC_SVC_CONNMAXREC_SET\fR enables non-blocking mode and
89 establishes the maximum record size (in bytes) for \fBRPC\fR requests;
90 \fBRPC\fR responses are not affected. Buffer space is allocated as needed up to
91 the specified maximum, starting at the maximum or \fBRPC_MAXDATASIZE\fR,
92 whichever is smaller.
93 .sp
94 .LP
95 The value established by \fBRPC_SVC_CONNMAXREC_SET\fR is used when a connection
96 is created, and it remains in effect for that connection until it is closed. To
97 change the value for existing connections on a per-connection basis, see
98 \fBsvc_control\fR(3NSL).
99 .sp
100 .LP
101 \fBRPC_SVC_CONNMAXREC_GET\fR retrieves the current maximum record size. A zero
102 value means that no maximum is in effect, and that the connections are in
103 blocking mode.
104 .sp
105 .LP
106 \fIinfo\fR is a pointer to an argument of type \fBint\fR. Non-connection RPC
107 transports ignore \fBRPC_SVC_CONNMAXREC_SET\fR and
108 \fBRPC_SVC_CONNMAXREC_GET\fR.
109 .SH RETURN VALUES
110 .sp
111 .LP
112 This routine returns \fBTRUE\fR if the operation was successful and
113 returns \fBFALSE\fR otherwise.
114 .SH ATTRIBUTES
115 .sp
116 .LP
117 See \fBattributes\fR(5) for descriptions of the following attributes:
118 .sp
119
120 .sp
121 .TS
122 box;
123 c | c
124 l | l .
125 ATTRIBUTE TYPE ATTRIBUTE VALUE
126 _
127 MT-Level MT-Safe
128 .TE
129
130 .SH SEE ALSO
131 .sp
132 .LP
133 \fBrpcbind\fR(1M), \fBrpc\fR(3NSL), \fBrpc_svc_calls\fR(3NSL),
|