summaryrefslogtreecommitdiff
path: root/usr/src
diff options
context:
space:
mode:
authorMarcel Telka <marcel.telka@nexenta.com>2014-11-24 21:24:12 +0100
committerDan McDonald <danmcd@omniti.com>2014-11-24 16:42:20 -0500
commit22fec8cf7c90530cbbeb80ea11190db467cb2e21 (patch)
treef274bfcebb6c4b909693a2bea4af2362fa668846 /usr/src
parent6aa4fc89ec1cf2cdf7d7c3b9ec059802ac9abe65 (diff)
downloadillumos-joyent-22fec8cf7c90530cbbeb80ea11190db467cb2e21.tar.gz
4305 rpc(3nsl): svc_sendreply is in rpc_svc_calls(3nsl)
Reviewed by: Richard Lowe <richlowe@richlowe.net> Reviewed by: Gordon Ross <gordon.ross@nexenta.com> Reviewed by: Yuri Pankov <yuri.pankov@nexenta.com> Approved by: Dan McDonald <danmcd@omniti.com>
Diffstat (limited to 'usr/src')
-rw-r--r--usr/src/man/man3nsl/rpc.3nsl51
-rw-r--r--usr/src/man/man3nsl/rpc_svc_calls.3nsl6
-rw-r--r--usr/src/man/man3nsl/rpc_svc_create.3nsl9
-rw-r--r--usr/src/man/man3nsl/rpc_svc_err.3nsl9
-rw-r--r--usr/src/man/man3nsl/rpcbind.3nsl11
5 files changed, 32 insertions, 54 deletions
diff --git a/usr/src/man/man3nsl/rpc.3nsl b/usr/src/man/man3nsl/rpc.3nsl
index 5bbcf7b7f4..b6b75deb37 100644
--- a/usr/src/man/man3nsl/rpc.3nsl
+++ b/usr/src/man/man3nsl/rpc.3nsl
@@ -1,10 +1,11 @@
'\" te
+.\" Copyright 2014 Nexenta Systems, Inc. All Rights Reserved.
.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved
.\" Copyright 1989 AT&T
.\" 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.
.\" 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.
.\" 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]
-.TH RPC 3NSL "Jun 5, 2001"
+.TH RPC 3NSL "Nov 24, 2014"
.SH NAME
rpc \- library routines for remote procedure calls
.SH SYNOPSIS
@@ -16,7 +17,6 @@ rpc \- library routines for remote procedure calls
.fi
.SH DESCRIPTION
-.sp
.LP
These routines allow C language programs to make procedure calls on other
machines across a network. First, the client sends a request to the server. On
@@ -29,7 +29,6 @@ take a \fBnetconfig\fR structure also require that \fB<netconfig.h>\fR be
included. Applications using \fBRPC\fR and \fBXDR\fR routines should be
linked with the \fBlibnsl\fR library.
.SS "Multithread Considerations"
-.sp
.LP
In the case of multithreaded applications, the \fB-mt\fR option must be
specified on the command line at compilation time to enable a thread-specific
@@ -51,8 +50,7 @@ contains a single data area for decoding arguments and encoding results. See
between threads that call functions that do this. Routines that are affected
by this restriction are marked as unsafe for MT applications. See
\fBrpc_svc_calls\fR(3NSL).
-.SS "Nettyp"
-.sp
+.SS "Nettype"
.LP
Some of the high-level \fBRPC\fR interface routines take a \fInettype\fR string
as one of the parameters (for example, \fBclnt_create()\fR, \fBsvc_create()\fR,
@@ -149,7 +147,6 @@ If \fInettype\fR is \fINULL\fR, it defaults to \fBnetpath\fR. The transports
are tried in left to right order in the \fBNETPATH\fR variable or in top to
down order in the \fB/etc/netconfig\fR file.
.SS "Derived Types"
-.sp
.LP
In a 64-bit environment, the derived types are defined as follows:
.sp
@@ -184,11 +181,9 @@ l l l .
.TE
.SS "Data Structures"
-.sp
.LP
Some of the data structures used by the \fBRPC\fR package are shown below.
.SS "The \fBAUTH\fR Structure"
-.sp
.in +2
.nf
union des_block {
@@ -228,7 +223,6 @@ struct opaque_auth {
.in -2
.SS "The \fBCLIENT\fR Structure"
-.sp
.in +2
.nf
/*
@@ -255,7 +249,6 @@ struct opaque_auth {
.in -2
.SS "The \fBSVCXPRT\fR Structure"
-.sp
.in +2
.nf
enum xprt_stat {
@@ -299,7 +292,6 @@ typedef struct {
.in -2
.SS "The \fBsvc_reg\fR Structure"
-.sp
.in +2
.nf
struct svc_req {
@@ -315,7 +307,6 @@ struct svc_req {
.in -2
.SS "The \fBXDR\fR Structure"
-.sp
.in +2
.nf
/*
@@ -379,7 +370,6 @@ XDR;
.in -2
.SS "Index to Routines"
-.sp
.LP
The following table lists \fBRPC\fR routines and the manual reference pages on
which they are described:
@@ -638,25 +628,25 @@ which they are described:
.sp
.ne 2
.na
-\fB\fBclnt_udpcreate\fR\fR
+\fB\fBclnt_vc_create\fR\fR
.ad
.RS 27n
-\fBrpc_soc\fR(3NSL)
+\fBrpc_clnt_create\fR(3NSL)
.RE
.sp
.ne 2
.na
-\fB\fBclnt_vc_create\fR\fR
+\fB\fBclntraw_create\fR\fR
.ad
.RS 27n
-\fBrpc_clnt_create\fR(3NSL)
+\fBrpc_soc\fR(3NSL)
.RE
.sp
.ne 2
.na
-\fB\fBclntraw_create\fR\fR
+\fB\fBclnttcp_create\fR\fR
.ad
.RS 27n
\fBrpc_soc\fR(3NSL)
@@ -665,7 +655,7 @@ which they are described:
.sp
.ne 2
.na
-\fB\fBclnttcp_create\fR\fR
+\fB\fBclntudp_bufcreate\fR\fR
.ad
.RS 27n
\fBrpc_soc\fR(3NSL)
@@ -674,7 +664,7 @@ which they are described:
.sp
.ne 2
.na
-\fB\fBclntudp_bufcreate\fR\fR
+\fB\fBclntudp_create\fR\fR
.ad
.RS 27n
\fBrpc_soc\fR(3NSL)
@@ -848,7 +838,7 @@ which they are described:
\fB\fBrpc_reg\fR\fR
.ad
.RS 27n
-\fBrpc_svc_calls\fR(3NSL)
+\fBrpc_svc_reg\fR(3NSL)
.RE
.sp
@@ -911,7 +901,7 @@ which they are described:
\fB\fBsvc_freeargs\fR\fR
.ad
.RS 27n
-\fBrpc_svc_reg\fR(3NSL)
+\fBrpc_svc_calls\fR(3NSL)
.RE
.sp
@@ -920,7 +910,7 @@ which they are described:
\fB\fBsvc_getargs\fR\fR
.ad
.RS 27n
-\fBrpc_svc_reg\fR(3NSL)
+\fBrpc_svc_calls\fR(3NSL)
.RE
.sp
@@ -974,7 +964,7 @@ which they are described:
\fB\fBsvc_reg\fR\fR
.ad
.RS 27n
-\fBrpc_svc_calls\fR(3NSL)
+\fBrpc_svc_reg\fR(3NSL)
.RE
.sp
@@ -992,7 +982,7 @@ which they are described:
\fB\fBsvc_run\fR\fR
.ad
.RS 27n
-\fBrpc_svc_reg\fR(3NSL)
+\fBrpc_svc_calls\fR(3NSL)
.RE
.sp
@@ -1001,7 +991,7 @@ which they are described:
\fB\fBsvc_sendreply\fR\fR
.ad
.RS 27n
-\fBrpc_svc_reg\fR(3NSL)
+\fBrpc_svc_calls\fR(3NSL)
.RE
.sp
@@ -1028,7 +1018,7 @@ which they are described:
\fB\fBsvc_unreg\fR\fR
.ad
.RS 27n
-\fBrpc_svc_calls\fR(3NSL)
+\fBrpc_svc_reg\fR(3NSL)
.RE
.sp
@@ -1244,7 +1234,7 @@ which they are described:
\fB\fBxprt_register\fR\fR
.ad
.RS 27n
-\fBrpc_svc_calls\fR(3NSL)
+\fBrpc_svc_reg\fR(3NSL)
.RE
.sp
@@ -1253,15 +1243,13 @@ which they are described:
\fB\fBxprt_unregister\fR\fR
.ad
.RS 27n
-\fBrpc_svc_calls\fR(3NSL)
+\fBrpc_svc_reg\fR(3NSL)
.RE
.SH FILES
-.sp
.LP
\fB/etc/netconfig\fR
.SH ATTRIBUTES
-.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
@@ -1277,7 +1265,6 @@ MT-Level MT-Safe with exceptions
.TE
.SH SEE ALSO
-.sp
.LP
\fBgetnetconfig\fR(3NSL), \fBgetnetpath\fR(3NSL), \fBrpc_clnt_auth\fR(3NSL),
\fBrpc_clnt_calls\fR(3NSL), \fBrpc_clnt_create\fR(3NSL),
diff --git a/usr/src/man/man3nsl/rpc_svc_calls.3nsl b/usr/src/man/man3nsl/rpc_svc_calls.3nsl
index f0170dc52a..5ca2a7d18c 100644
--- a/usr/src/man/man3nsl/rpc_svc_calls.3nsl
+++ b/usr/src/man/man3nsl/rpc_svc_calls.3nsl
@@ -135,8 +135,8 @@ other than the User MT mode.
The \fBsvc_exit()\fR function when called by any of the RPC server procedures
or otherwise, destroys all services registered by the server and causes
\fBsvc_run()\fR to return. If RPC server activity is to be resumed, services
-must be reregistered with the RPC library either through one of the
-\fBrpc_svc_create\fR(3NSL) functions, or using \fBxprt_register\fR(3NSL). The
+must be reregistered with the RPC library through one of the
+\fBrpc_svc_reg\fR(3NSL) functions. The
\fBsvc_exit()\fR function has global scope and ends all RPC server activity.
.sp
.LP
@@ -284,4 +284,4 @@ multithreaded applications and should be called only from the main thread.
\fBrpcgen\fR(1), \fBpoll\fR(2), \fBgetpeerucred\fR(3C), \fBrpc\fR(3NSL),
\fBrpc_control\fR(3NSL), \fBrpc_svc_create\fR(3NSL), \fBrpc_svc_err\fR(3NSL),
\fBrpc_svc_reg\fR(3NSL), \fBselect\fR(3C), \fBucred_free\fR(3C),
-\fBxprt_register\fR(3NSL), \fBattributes\fR(5)
+\fBattributes\fR(5)
diff --git a/usr/src/man/man3nsl/rpc_svc_create.3nsl b/usr/src/man/man3nsl/rpc_svc_create.3nsl
index e4af0db7eb..4344a399a5 100644
--- a/usr/src/man/man3nsl/rpc_svc_create.3nsl
+++ b/usr/src/man/man3nsl/rpc_svc_create.3nsl
@@ -1,10 +1,11 @@
'\" te
+.\" Copyright 2014 Nexenta Systems, Inc. All Rights Reserved.
.\" Copyright 1989 AT&T
.\" Copyright (C) 2005, Sun Microsystems, Inc. All Rights Reserved.
.\" 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.
.\" 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.
.\" 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]
-.TH RPC_SVC_CREATE 3NSL "Dec 27, 2013"
+.TH RPC_SVC_CREATE 3NSL "Nov 24, 2014"
.SH NAME
rpc_svc_create, svc_control, svc_create, svc_destroy, svc_dg_create,
svc_fd_create, svc_raw_create, svc_tli_create, svc_tp_create, svc_vc_create,
@@ -74,14 +75,12 @@ svc_door_create \- server handle creation routines
.fi
.SH DESCRIPTION
-.sp
.LP
These routines are part of the \fBRPC\fR library which allows C language
programs to make procedure calls on servers across the network. These routines
deal with the creation of service handles. Once the handle is created, the
server can be invoked by calling \fBsvc_run()\fR.
.SS "Routines"
-.sp
.LP
See \fBrpc\fR(3NSL) for the definition of the \fBSVCXPRT\fR data structure.
.sp
@@ -230,7 +229,7 @@ is \fINULL,\fR it defaults to \fBnetpath\fR.
\fBsvc_create()\fR registers itself with the \fBrpcbind\fR service (see
\fBrpcbind\fR(1M)). \fIdispatch\fR is called when there is a remote procedure
call for the given \fIprognum\fR and \fIversnum\fR; this requires calling
-\fBsvc_run()\fR (see \fBsvc_run()\fR in \fBrpc_svc_reg\fR(3NSL)). If
+\fBsvc_run()\fR (see \fBsvc_run()\fR in \fBrpc_svc_calls\fR(3NSL)). If
\fBsvc_create()\fR succeeds, it returns the number of server handles it
created, otherwise it returns \fB0\fR and an error message is logged.
.RE
@@ -364,7 +363,6 @@ change the maximum allowed request size for the doors transport.
.RE
.SH ATTRIBUTES
-.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
@@ -384,7 +382,6 @@ MT-Level MT-Safe
.TE
.SH SEE ALSO
-.sp
.LP
\fBrpcbind\fR(1M), \fBrpc\fR(3NSL), \fBrpc_clnt_create\fR(3NSL),
\fBrpc_svc_calls\fR(3NSL), \fBrpc_svc_err\fR(3NSL), \fBrpc_svc_reg\fR(3NSL),
diff --git a/usr/src/man/man3nsl/rpc_svc_err.3nsl b/usr/src/man/man3nsl/rpc_svc_err.3nsl
index 48ead4a90d..4c97f9e899 100644
--- a/usr/src/man/man3nsl/rpc_svc_err.3nsl
+++ b/usr/src/man/man3nsl/rpc_svc_err.3nsl
@@ -1,15 +1,15 @@
'\" te
+.\" Copyright 2014 Nexenta Systems, Inc. All Rights Reserved.
.\" Copyright 1989 AT&T Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
.\" 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.
.\" 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.
.\" 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]
-.TH RPC_SVC_ERR 3NSL "Feb 20, 1998"
+.TH RPC_SVC_ERR 3NSL "Nov 24, 2014"
.SH NAME
rpc_svc_err, svcerr_auth, svcerr_decode, svcerr_noproc, svcerr_noprog,
svcerr_progvers, svcerr_systemerr, svcerr_weakauth \- library routines for
server side remote procedure call errors
.SH DESCRIPTION
-.sp
.LP
These routines are part of the \fBRPC\fR library which allows C language
programs to make procedure calls on other machines across the network.
@@ -18,7 +18,6 @@ programs to make procedure calls on other machines across the network.
These routines can be called by the server side dispatch function if there is
any error in the transaction with the client.
.SS "Routines"
-.sp
.LP
See \fBrpc\fR(3NSL) for the definition of the \fBSVCXPRT\fR data structure.
.sp
@@ -49,7 +48,7 @@ call due to an authentication error.
.sp .6
.RS 4n
Called by a service dispatch routine that cannot successfully decode the remote
-parameters (see \fBsvc_getargs()\fR in \fBrpc_svc_reg\fR(3NSL)).
+parameters (see \fBsvc_getargs()\fR in \fBrpc_svc_calls\fR(3NSL)).
.RE
.sp
@@ -113,7 +112,6 @@ calls \fBsvcerr_auth(xprt, AUTH_TOOWEAK)\fR.
.RE
.SH ATTRIBUTES
-.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
@@ -129,7 +127,6 @@ MT-Level MT-Safe
.TE
.SH SEE ALSO
-.sp
.LP
\fBrpc\fR(3NSL), \fBrpc_svc_calls\fR(3NSL), \fBrpc_svc_create\fR(3NSL),
\fBrpc_svc_reg\fR(3NSL), \fBattributes\fR(5)
diff --git a/usr/src/man/man3nsl/rpcbind.3nsl b/usr/src/man/man3nsl/rpcbind.3nsl
index df915fca10..03963556ef 100644
--- a/usr/src/man/man3nsl/rpcbind.3nsl
+++ b/usr/src/man/man3nsl/rpcbind.3nsl
@@ -1,9 +1,10 @@
'\" te
+.\" Copyright 2014 Nexenta Systems, Inc. All Rights Reserved.
.\" Copyright 1989 AT&T Copyright (c) 1997, Sun Microsystems, Inc. All Rights Reserved
.\" 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.
.\" 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.
.\" 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]
-.TH RPCBIND 3NSL "Dec 27, 2013"
+.TH RPCBIND 3NSL "Nov 24, 2014"
.SH NAME
rpcbind, rpcb_getmaps, rpcb_getaddr, rpcb_gettime, rpcb_rmtcall, rpcb_set,
rpcb_unset \- library routines for RPC bind service
@@ -53,13 +54,11 @@ rpcb_unset \- library routines for RPC bind service
.fi
.SH DESCRIPTION
-.sp
.LP
These routines allow client C programs to make procedure calls to the RPC
binder service. \fBrpcbind\fR maintains a list of mappings between programs and
their universal addresses. See \fBrpcbind\fR(1M).
.SS "Routines"
-.sp
.ne 2
.na
\fB\fBrpcb_getmaps()\fR\fR
@@ -135,7 +134,7 @@ the triple [\fIprognum\fR, \fIversnum\fR, \fInetconf\fR->\fInc_netid]\fR and
\fIsvcaddr\fR on the machine's \fBrpcbind\fR service. The value of
\fInc_netid\fR must correspond to a network identifier that is defined by the
netconfig database. This routine returns \fBTRUE\fR if it succeeds, \fBFALSE\fR
-otherwise. See also \fBsvc_reg()\fR in \fBrpc_svc_calls\fR(3NSL). If there
+otherwise. See also \fBsvc_reg()\fR in \fBrpc_svc_reg\fR(3NSL). If there
already exists such an entry with \fBrpcbind\fR, \fBrpcb_set()\fR will fail.
.RE
@@ -153,11 +152,10 @@ the address on the machine's \fBrpcbind\fR service. If \fInetconf\fR is
machine's \fBrpcbind\fR service. This routine returns \fBTRUE\fR if it
succeeds, \fBFALSE\fR otherwise. Only the owner of the service or the
super-user can destroy the mapping. See also \fBsvc_unreg()\fR in
-\fBrpc_svc_calls\fR(3NSL).
+\fBrpc_svc_reg\fR(3NSL).
.RE
.SH ATTRIBUTES
-.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
@@ -173,7 +171,6 @@ MT-Level MT-Safe
.TE
.SH SEE ALSO
-.sp
.LP
\fBrpcbind\fR(1M), \fBrpcinfo\fR(1M), \fBrpc_clnt_calls\fR(3NSL),
\fBrpc_clnt_create\fR(3NSL), \fBrpc_svc_calls\fR(3NSL), \fBattributes\fR(5)