.\" @(#)rpc.3n	2.4 88/08/08 4.0 RPCSRC; from 1.19 88/06/24 SMI
.\" 
.\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
.\"         all rights reserved.
.\" Translated Tue Jan  4 20:48:23 JST 2000
.\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
.\" Updated & Modified Sun Oct 21 01:07:09 JST 2001
.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
.\"
.TH RPC 3N 1988-02-16 
.SH ̾
rpc \- ּ³ƤӽФ(RPC)ΤΥ饤֥ꡦ롼ƥ
.SH 񼰤
Υ롼ƥ C ץǥͥåȥ̤
¾Υޥ˥ץ뤳Ȥǽˤ롣
ǽ˥饤ȤϥǡѥåȤ򥵡Ф뤿
ץƤӽФ
ФϥѥåȤȡʬ롼ƤӽФ
׵ᤵ줿ӥ˼¹Ԥ֤
Ǹ˥ץ㡦ϥ饤Ȥؤ롣
.LP
(DES ǧڤˤ) Secure RPC ǻѤ롼ƥˤĤƤ
.BR rpc_secure (3N)
¸ߤ롣 Secure RPC  DES ǧڤѲǽʾˤΤ߻ѤǤ롣
.LP
.ft B
.nf
.sp .5
#include <rpc/rpc.h>
.fi
.ft R
.br
.if t .ne 8
.LP
.ft B
.nf
.sp .5
void
auth_destroy(auth)
\s-1AUTH\s0 *auth;
.fi
.ft R
.IP
Υޥ
.I auth
˴Ϣդ줿ǧھ˲롣˲̾ϻŪʥǡ¤
˴ޤǤ롣
.B auth_destroy() 
ƤӽФ
.I auth
Ѥ뤳Ȥ̤Ǥ롣
.br
.if t .ne 6
.LP
.ft B
.nf
.sp .5
\s-1AUTH\s0 *
authnone_create()
.fi
.ft R
.IP
ƥ⡼ȡץ㡦ǻѤǤʤǧھȤϤ
.SM RPC
ǧڥϥɥ֤
.SM RPC
ǻѤǥեȤǧڤǤ롣
.if t .ne 10
.LP
.ft B
.nf
.sp .5
\s-1AUTH\s0 *
authunix_create(host, uid, gid, len, aup_gids)
char *host;
int uid, gid, len, *aup.gids;
.fi
.ft R
.IP
UNIX ǧھޤ
.SM RPC
ǧڥϥɥ֤
.I host
ѥ᡼Ͼ󤬺줿ޥ̾Ǥ롣
.I uid
ϤΥ桼Υ桼
.SM ID

.I gid
ϤΥ桼θߤΥ롼
.SM ID
Ǥ롣
.I len

.I aup_gids
ϤΥ桼°륰롼פ򻲾ȤƤ롣
¾Υ桼ˤʤꤹޤȤϴñǤ롣
.br
.if t .ne 5
.LP
.ft B
.nf
.sp .5
\s-1AUTH\s0 *
authunix_create_default()
.fi
.ft R
.IP
Ŭڤʥѥ᡼
.B authunix_create()
ƤӽФ
.br
.if t .ne 13
.LP
.ft B
.nf
.sp .5
callrpc(host, prognum, versnum, procnum, inproc, in, outproc, out)
char *host;
u_long prognum, versnum, procnum;
char *in, *out;
xdrproc_t inproc, outproc;
.fi
.ft R
.IP
ޥ
.I host

.IR prognum ,
.IR versnum ,
.I procnum
˴Ϣդ줿⡼ȡץƤӽФ
ѥ᡼
.I in
ϥץΰΥɥ쥹Ǥ
.I out
Ϸ̤Ǽ륢ɥ쥹Ǥ롣
.I inproc
ϥץΥѥ᡼򥨥󥳡ɤΤ˻Ѥ졢
.I outproc
Ϸ̤ǥɤΤ˻Ѥ롣
Υ롼ƥˤϥ֤Ԥˤ
.B "enum clnt_stat"
˥㥹Ȥ֤ͤ
.B clnt_perrno()
롼ƥ󤬼Ԥξ֤åѴΤ˻ѤǤ롣
.IP
ٹ: Υ롼ƥǥ⡼ȡץƤӽФ̿ˤ
.SM UDP/IP
Ѥ롣κݤ¤ˤĤƤ
.B clntudp_create()
򻲾Ȥ뤳ȡΥ롼ƥѤǧڤڤ
뤳ȤϤǤʤ
.br
.if t .ne 16
.LP
.ft B
.nf
.sp .5
enum clnt_stat
clnt_broadcast(prognum, versnum, procnum, inproc, in, outproc, out, eachresult)
u_long prognum, versnum, procnum;
char *in, *out;
xdrproc_t inproc, outproc;
resultproc_t eachresult;
.fi
.ft R
.IP
.B callrpc() 
ƱͤǤ뤬åΥ֥ɥ㥹ȡͥåȥ
Τؤȥ֥ɥ㥹ȤۤäƤ롣٤
Υ롼ƥϰʲη
.B eachresult()
ƤӽФ
.IP
.RS 1i
.ft B
.nf
eachresult(out, addr)
char *out;
struct sockaddr_in *addr;
.ft R
.fi
.RE
.IP

.I out

.B clnt_broadcast()
Ϥ
.I out
ƱǤ뤬⡼ȡץ㤫νϤǥɤƤ
ΤߤۤäƤ롣
.I addr
Ϸ̤ä褿ޥΥɥ쥹ؤƤ롣
.B eachresult()
֤硢
.B clnt_broadcast()
ϤʤԤġǤʤŬڤʾ֤ǽλ롣
.IP
ٹ: ֥ɥ㥹ȡåȤϥǡؤκžñ̤
¤Ƥ롣ͥåȤξ硢ͤ 1500 ХȤǤ롣
.br
.if t .ne 13
.LP
.ft B
.nf
.sp .5
enum clnt_stat
clnt_call(clnt, procnum, inproc, in, outproc, out, tout)
\s-1CLIENT\s0 *clnt;
u_long
procnum;
xdrproc_t inproc, outproc;
char *in, *out;
struct timeval tout;
.fi
.ft R
.IP
Υޥϥ饤ȡϥɥ
.IR clnt
˴Ϣդ줿
.I procnum
⡼ȡץƤӽФ
饤ȡϥɥ
.B clnt_create() 
Τ褦
.SM RPC
饤Ⱥ롼ƥˤä롣
ѥ᡼
.I in
ϥץΰΥɥ쥹Ǥ롣
.I out
ϥץ֤ͤǼ륢ɥ쥹Ǥ롣
.I inproc
ϥץΥѥ᡼򥨥󥳡ɤΤ˻Ѥ롣
.I outproc
ϥץ֤ͤǥɤΤ˻Ѥ롣
.I tout
Ϸ̤֤ΤԤĻ֤Ǥ롣
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
clnt_destroy(clnt)
\s-1CLIENT\s0 *clnt;
.fi
.ft R
.IP
Υޥϥ饤Ȥ
.SM RPC
ϥɥ˲롣˲ˤ̾
.I clnt
ȤޤƻŪʥǡ¤Τ˴ޤޤƤ롣
.B clnt_destroy()
θƤӽФθ
.I clnt
Ѥ뤳Ȥ̤Ǥ롣
.SM RPC
饤֥꤬Ϣ륽åȤ򥪡ץ󤷤ˤϡ
Ĥ롣ʳξˤϥåȤϥץ󤵤줿ޤޤǤ롣
.br
.if t .ne 10
.LP
.ft B
.nf
.sp .5
\s-1CLIENT\s0 *
clnt_create(host, prog, vers, proto)
char *host;
u_long prog, vers;
char *proto;
.fi
.ft R
.IP
Ūʥ饤Ȥκ롼ƥǤ롣
.I host
ϥФΤ⡼ȥۥȤ̾ꤹ롣
.I proto
ɤΤ褦̿ץȥѤ뤫ꤹ롣ߤ
ѤǤͤ \(lqudp\(rq  \(lqtcp\(rq Ǥ롣
ǥեȤλڤ줬ꤵ뤬
.B clnt_control()
ѤѹǽǤ롣
.IP
ٹ:
.SM UDP
ѤˤϷ롣
.SM UDP
˴Ť
.SM RPC
åϺǤ 8 KByte Υ󥳡ɥǡݻ
ȤǤʤᡢ礭ʰʷ̤ץ
ϻѤ뤳ȤǤʤ
.br
.if t .ne 10
.LP
.ft B
.nf
.sp .5
bool_t
clnt_control(cl, req, info)
\s-1CLIENT\s0 *cl;
char *info;
.fi
.ft R
.IP
ΥޥϳƼ說饤ȤˤĤƾѹꡢ
Τ˻Ѥ롣
.I req
μꤹ롣
.I info
ϾؤΥݥ󥿡Ǥ롣
.SM UDP

.SM TCP
ɤξѲǽ
.I req
ͤȡΰηӤƤϰʲ̤Ǥ:
.IP
.nf
.ta +2.0i +2.0i +2.0i
.SM CLSET_TIMEOUT\s0	struct timeval	ڤꤹ
.SM CLGET_TIMEOUT\s0	struct timeval	ڤ
.fi
.IP
: 
.B clnt_control()
ѤƻڤꤷˤϤʸ
.B clnt_call()
Ϥڤѥ᡼̵뤵롣
.IP
.nf
.SM CLGET_SERVER_ADDR\s0	struct sockaddr_in 	Хɥ쥹
.fi
.br
.IP
ʲ
.SM UDP
ξˤΤͭǤ:
.IP
.nf
.ta +2.0i +2.0i +2.0i
.SM CLSET_RETRY_TIMEOUT\s0	struct timeval	ֳ֤ꤹ
.SM CLGET_RETRY_TIMEOUT\s0	struct timeval	ֳ֤
.fi
.br
.IP
ֳ֤ϼ׵
.SM "UDP RPC"
ФβԤĻ֤Ǥ롣
.br
.if t .ne 10
.LP
.ft B
.nf
.sp .5
clnt_freeres(clnt, outproc, out)
\s-1CLIENT\s0 *clnt;
xdrproc_t outproc;
char *out;
.fi
.ft R
.IP
Υޥ
.SM RPC
ƤӽФη̤Υǥɤκݤ
.SM RPC/XDR
ƥˤäƳƤ줿ǡ롣
ѥ᡼
.I out
Ϸ̤Υɥ쥹Ǥ롣
.I outproc
Ϸ̤򵭽ҤƤ
.SM XDR
롼ƥǤ롣Υ롼ƥϷ̤βˤ 1 ֤
Ԥˤϥ֤
.br
.if t .ne 6
.LP
.ft B
.nf
.sp .5
void
clnt_geterr(clnt, errp)
\s-1CLIENT\s0 *clnt;
struct rpc_err *errp;
.fi
.ft R
.IP
Υޥϥ饤ȡϥɥΥ顼¤Τ
.I errp 
ɥ쥹ǻꤵ줿¤Τإԡ롣
.br
.if t .ne 8
.LP
.ft B
.nf
.sp .5
void
clnt_pcreateerror(s)
char *s;
.fi
.ft R
.IP
ɸ२顼Ϥˡʤ饤
.SM RPC
ϥɥκǤʤäˤĤƤΥåɽ롣
åʸ
.I s
ȥ(:)ɽ롣
.BR clnt_create() ,
.BR clntraw_create() ,
.BR clnttcp_create() ,
.B clntudp_create()
θƤӽФԤ˻Ѥ뤳ȡ
.br
.if t .ne 8
.LP
.ft B
.nf
.sp .5
void
clnt_perrno(stat)
enum clnt_stat stat;
.fi
.ft R
.IP
ɸ२顼Ϥ
.IR stat
ˤäƻؼ륨顼֤бåɽ롣
.B callrpc()
θ˻Ѥ뤳ȡ
.br
.if t .ne 8
.LP
.ft B
.nf
.sp .5
clnt_perror(clnt, s)
\s-1CLIENT\s0 *clnt;
char *s;
.fi
.ft R
.IP
ɸ२顼Ϥˡʤ
.SM RPC
ƤӽФԤˤĤƤΥåɽ롣
.I clnt
ϥ˻ѤϥɥǤ롣
åʸ
.I s
ȥ(:)ɽ롣
.B clnt_call()
Ԥ˻Ѥ뤳ȡ
.br
.if t .ne 9
.LP
.ft B
.nf
.sp .5
char *
clnt_spcreateerror
char *s;
.fi
.ft R
.IP
.B clnt_pcreateerror()
ƱͤǤ뤬ɸ२顼Ϥɽ뤫ʸ֤ۤäƤ롣
.IP
Х: ŪΰؤΥݥ󥿡֤ᡢƤӽФȤ˾񤭤롣
.br
.if t .ne 9
.LP
.ft B
.nf
.sp .5
char *
clnt_sperrno(stat)
enum clnt_stat stat;
.fi
.ft R
.IP
.B clnt_perrno() 
Ʊ뤬ʤ
.SM RPC
ƤӽФԤˤĤƤΥåɸ२顼Ϥɽ
ˡåǼƤʸؤΥݥ󥿡֤
ʸ
.SM  NEWLINE()
ǽäƤ롣
.IP
.B clnt_sperrno()
ϥץबɸ२顼ϤäƤʤ(ץबФȤ
äƤˤϤ褯ꤨ)䡢ץޡå
.B printf 
ǽϤ뤳Ȥ˾ޤʤ䡢åη
.B clnt_perrno()
ݡȤΤȤϰۤäƤʤɤ
.B clnt_perrno()
Τ˻Ѥ롣
:
.B clnt_sperror() 

.B clnt_spcreaterror()
Ȥϰä
.B clnt_sperrno()
ŪǡؤΥݥ󥿡֤ƤӽФȤ˾񤭤뤳ȤϤʤ
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
char *
clnt_sperror(rpch, s)
\s-1CLIENT\s0 *rpch;
char *s;
.fi
.ft R
.IP
.B clnt_perror() 
ƱͤǤ뤬ɸ२顼Ϥɽ
.RB ( clnt_sperrno()
Τ褦) ʸؤΥݥ󥿡֤ۤäƤ롣
.IP
Х: ƤӽФȤ˾񤭤ŪǡؤΥݥ󥿡֤
.br
.if t .ne 10
.LP
.ft B
.nf
.sp .5
\s-1CLIENT\s0 *
clntraw_create(prognum, versnum)
u_long prognum, versnum;
.fi
.ft R
.IP
Υ롼ƥϥ⡼ȡץ
.IR prognum 
С
.I versnum 
Τε
.SM RPC
饤Ȥ롣å򥵡ӥϤ˻Ѥ
̿ϼºݤˤϤΥץΥɥ쥹֤ˤХåեǤ롣
ǡб
.SM RPC
ФƱɥ쥹֤ˤʤФʤʤ
.B svcraw_create() 
򻲾Ȥ뤳ȡ
ˤ
.SM RPC
Υߥ졼䡢ͥ롦󥿡ե˱ƶ줺˱֤ʤɤ
.SM RPC
ХإåɤγǤ롣ԤˤϤΥ롼ƥ
.SM NULL
֤
.br
.if t .ne 15
.LP
.ft B
.nf
.sp .5
\s-1CLIENT\s0 *
clnttcp_create(addr, prognum, versnum, sockp, sendsz, recvsz)
struct sockaddr_in *addr;
u_long prognum, versnum;
int *sockp;
u_int sendsz, recvsz;
.fi
.ft R
.IP
Υ롼ƥϥ⡼ȡץ
.IR prognum 
С
.I versnum 
Τ
.SM RPC
饤Ȥ롣饤Ȥ̿
.SM TCP/IP
Ѥ롣⡼ȡץϥ󥿡ͥåȡɥ쥹
.IR *addr 
ˤ롣
.\"The following in-line font conversion is necessary for the hyphen indicator
\fB\%addr\->sin_port\fR ʤСºݤ˥⡼ȡץब
listen ƤݡȤꤵ롣(ξΤ˥⡼Ȥ
.B portmap
ӥѤ롣) ѥ᡼
.I sockp
ϥåȤǤ롣⤷줬
.B \s-1RPC_ANYSOCK\s0 
ꤵƤϡΥ롼ƥ󤬿åȤ򥪡ץ󤷤
.I sockp 
ꤹ롣
.SM TCP
˴Ť
.SM RPC
ϥХåե줿
.SM I/O 
Ѥ뤿ᡢ桼ϥѥ᡼
.I sendsz

.I recvsz
ѤХåեȼХåեΥꤹ뤳ȤǤ롣
ꤷˤŬڤʥǥեȤ򤵤롣
Υ롼ƥϼԤ
.SM NULL
֤
.br
.if t .ne 15
.LP
.ft B
.nf
.sp .5
\s-1CLIENT\s0 *
clntudp_create(addr, prognum, versnum, wait, sockp)
struct sockaddr_in *addr;
u_long prognum, versnum;
struct timeval wait;
int *sockp;
.fi
.ft R
.IP
Υ롼ƥϥ⡼ȡץ
.IR prognum 
С
.I versnum 
Τ
.SM RPC
饤Ȥ롣饤Ȥ̿
.SM UDP/IP
Ѥ롣⡼ȡץϥ󥿡ͥåȡɥ쥹
.IR *addr 
ˤ롣
\fB\%addr\->sin_port\fR ʤСºݤ˥⡼ȡץब
listen ƤݡȤꤵ롣(ξΤ˥⡼Ȥ
.B portmap
ӥѤ롣) ѥ᡼
.I sockp
ϥåȤǤ롣⤷줬
.B \s-1RPC_ANYSOCK\s0 
ꤵƤϡΥ롼ƥ󤬿åȤ򥪡ץ󤷤
.I sockp 
ꤹ롣
.SM UDP
̿ϲ뤫ڤ줬ޤ
.B wait
ֳ֤ǸƤӽФå롣ڤ줬ޤǤι׻֤
.B clnt_call() 
ǻꤹ롣
.IP
ٹ:
.SM UDP
˴Ť
.SM RPC
åϺǤ 8 Kbyte ޤǤΥ󥳡ɤ줿ǡ
ݻǤʤᡢ̿礭ʰʷ̤
ץˤϻѤǤʤ
.br
.if t .ne 8
.LP
.ft B
.nf
.sp .5
\s-1CLIENT\s0 *
clntudp_bufcreate(addr, prognum, versnum, wait, sockp, sendsize, recosize)
struct sockaddr_in *addr;
u_long prognum, versnum;
struct timeval wait;
int *sockp;
unsigned int sendsize;
unsigned int recosize;
.fi
.ft R
.IP
Υ롼ƥϥ⡼ȡץ
.IR prognum 
С
.I versnum 
Τ
.SM RPC
饤Ȥ롣饤Ȥ̿
.SM UDP/IP
Ѥ롣⡼ȡץϥ󥿡ͥåȡɥ쥹
.IR *addr 
ˤ롣
\fB\%addr\->sin_port\fR ʤСºݤ˥⡼ȡץब
listen ƤݡȤꤵ롣(ξΤ˥⡼Ȥ
.B portmap
ӥѤ롣) ѥ᡼
.I sockp
ϥåȤǤ롣⤷줬
.B \s-1RPC_ANYSOCK\s0 
ꤵƤϡΥ롼ƥ󤬿åȤ򥪡ץ󤷤
.I sockp 
ꤹ롣
.SM UDP
̿ϲ뤫ڤ줬ޤ
.B wait
ֳ֤ǸƤӽФå롣ڤ줬ޤǤι׻֤
.B clnt_call() 
ǻꤹ롣
.IP
Ѥ
.SM UDP
˴Ť
.SM RPC
åˤѥåȤѥåȤκ祵ꤹ뤳
ǽˤʤ롣
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
void
get_myaddress(addr)
struct sockaddr_in *addr;
.fi
.ft R
.IP
Υޥ
.SM IP
ɥ쥹
.I *addr 
˳Ǽ롣
.BR /etc/hosts 
򰷤饤֥ꡦ롼ƥϻѤʤݡֹϾ
.B htons(\s-1PMAPPORT\s0)
ꤵ롣
.br
.if t .ne 10
.LP
.ft B
.nf
.sp .5
struct pmaplist *
pmap_getmaps(addr)
struct sockaddr_in *addr;
.fi
.ft R
.IP
.B portmap
ӥΤΥ桼󥿡եǤꡢ
.SM IP
ɥ쥹
.I *addr 
ˤۥȤθߤ
.SM RPC
ץफݡֹؤΥޥåԥ󥰤ΰ֤
Υ롼ƥ
.SM NULL 
֤⤢롣
.RB ` "rpcinfo \-p" '
ޥɤϤΥ롼ƥѤƤ롣
.br
.if t .ne 12
.LP
.ft B
.nf
.sp .5
u_short
pmap_getport(addr, prognum, versnum, protocol)
struct sockaddr_in *addr;
u_long prognum, versnum, protocol;
.fi
.ft R
.IP
.B portmap
ӥΤΥ桼󥿡եǡ
ץֹ
.IR prognum 
С
.IR versnum 
Ϣդ줿̿ץȥ
.I protocol 
򥵥ݡȤ륵ӥԤäƤݡֹ֤
.I protocol
ͤϤۤȤɤξ
.SM IPPROTO_UDP

.SM IPPROTO_TCP
Ǥ롣֤ͥϥޥåԥ󥰤¸ߤʤ
.SM RPC
ƥब⡼Ȥ
.B portmap
ӥλȤ˼ԤȤ̣롣Ԥξѿ
.B rpc_createerr()

.SM RPC
֤ݻƤ롣
.br
.if t .ne 15
.LP
.ft B
.nf
.sp .5
enum clnt_stat
pmap_rmtcall(addr, prognum, versnum, procnum, inproc, in, outproc, out, tout, portp)
struct sockaddr_in *addr;
u_long prognum, versnum, procnum;
char *in, *out;
xdrproc_t inproc, outproc;
struct timeval tout;
u_long *portp;
.fi
.ft R
.IP
.B portmap
ӥΤΥ桼󥿡եǡ
.SM IP
ɥ쥹
.I *addr
ΥۥȤ
.B portmap
򻲾Ȥơ
.SM RPC
ƤӽФΥۥȾΥץƤӽФ
ѥ᡼
.I *portp
ϥץ㤬ˤϥץΥݡֹ˽롣
¾Υѥ᡼ˤĤƤ
.B callrpc()

.BR clnt_call()
Ƥ롣
Υץ \(lqping\(rq Τߤ˻Ѥ٤Ǥ롣
.B clnt_broadcast() 
⻲Ȥ뤳ȡ
.br
.if t .ne 9
.LP
.ft B
.nf
.sp .5
pmap_set(prognum, versnum, protocol, port)
u_long prognum, versnum, protocol;
u_short port;
.fi
.ft R
.IP
.B portmap
ӥΤΥ桼󥿡եǡ
.RI [ prognum , versnum , protocol\fR]
Ȥ߹碌
.I port
Ȥδ֤Υޥåԥ󥰤򡢤Υޥ
.B portmap
ӥϿ롣
.I protocol
ϤۤȤɤξ
.SM IPPROTO_UDP

.SM IPPROTO_TCP
Τɤ餫Ǥ롣
Υ롼ƥˤ 1 ֤Ԥˤϥ֤
.B svc_register() 
ˤäƼưŪ˼¹Ԥ롣
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
pmap_unset(prognum, versnum)
u_long prognum, versnum;
.fi
.ft R
.IP
.B portmap
ӥΤΥ桼󥿡եǡ
.RI [ prognum , versnum , *\fR]
Ȥ߹碌
.B ports
δ֤Υޥåԥ󥰤򤽤Υޥ
.B portmap
ӥ롣Υ롼ƥ 1 ֤
Ԥˤ 0 ֤
.br
.if t .ne 15
.LP
.ft B
.nf
.sp .5
registerrpc(prognum, versnum, procnum, procname, inproc, outproc)
u_long prognum, versnum, procnum;
char *(*procname) () ;
xdrproc_t inproc, outproc;
.fi
.ft R
.IP
.SM RPC
ӥѥåѤ
.I procname
ץϿ롣ץ
.IR prognum 
С
.IR versnum 
ץ
.I procnum 
ؤ׵᤬Ϥ硢
.I procname
ѥ᡼ؤΥݥ󥿡äƸƤӽФ롣
.I progname
Ūʷ̤ؤΥݥ󥿡֤ɬפ롣
.I inproc
ϥѥ᡼ǥɤ뤿˻Ѥ롣
.I outproc
Ϸ̤򥨥󥳡ɤ뤿˻Ѥ롣
Υ롼ƥϿˤϥ֤
Ԥˤ \-1֤
.IP
ٹ: ηϿ줿⡼ȡץ
.SM UDP/IP
̿Ѥ롣¤˴ؤƤ
.B svcudp_create()
򻲾Ȥ뤳ȡ
.br
.if t .ne 5
.LP
.ft B
.nf
.sp .5
struct rpc_createerr     rpc_createerr;
.fi
.ft R
.IP
ʤä
.SM RPC
饤롼ƥˤäꤵѿ
.B clnt_pcreateerror()
롼ƥͳɽ뤿˻Ѥ롣
.if t .ne 7
.LP
.ft B
.nf
.sp .5
svc_destroy(xprt)
\s-1SVCXPRT\s0 *
xprt;
.fi
.ft R
.IP
Υޥ̿ϥɥ
.IR xprt 

.SM RPC
ӥ˲롣˲ˤ̾
.I xprt
ޤơŪʥǡ¤Τ˴ޤޤƤ롣
Υ롼ƥƤӽФ
.I xprt
Ѥ뤳Ȥ̤Ǥ롣
.br
.if t .ne 8
.LP
.ft B
.nf
.sp .5
fd_set svc_fdset;
.fi
.ft R
.IP
.SM RPC
ӥ¦Υե롦ǥץΥӥåȥޥȿǤѿ
.B select
ƥॳΥѥ᡼ΤѤǤ롣
ӥμԤ
.BR svc_run() 
ƤӽФʤˡȼƱ٥ȽѤˤΤ̣߰롣
ѿɤ߹Ѥ (Τޤ
.B select
ϤƤϤʤʤ!)
.B svc_getreqset()
ƤӽФ롼ƥθѹƤ뤫⤷ʤ
.br
.if t .ne 6
.LP
.ft B
.nf
.sp .5
int svc_fds;
.fi
.ft R
.IP
.B svc_fedset() 
˻Ƥ뤬32 ǥץ¤Ƥ롣
Υ󥿡ե
.B svc_fdset() 
ˤä֤줿
.br
.if t .ne 9
.LP
.ft B
.nf
.sp .5
svc_freeargs(xprt, inproc, in)
\s-1SVCXPRT\s0 *xprt;
xdrproc_t inproc;
char *in;
.fi
.ft R
.IP
Υޥϥӥץ㤬
.BR svc_getargs() 
Ѥưǥɤ
.SM RPC/XDR
ƥˤäƳƤ줿ǡ롣
Υ롼ƥϲˤ 1 ֤
Ԥˤϥ֤
.br
.if t .ne 10
.LP
.ft B
.nf
.sp .5
svc_getargs(xprt, inproc, in)
\s-1SVCXPRT\s0 *xprt;
xdrproc_t inproc;
char *in;
.fi
.ft R
.IP
Υޥ
.SM RPC
ӥ̿ϥɥ
.I xprt 
˴Ϣդ줿
.SM RPC
׵ΰǥɤ롣ѥ᡼
.I in
ϰγǼ줿ɥ쥹Ǥ롣
.I inproc
ϰǥɤ뤿
.SM XDR
롼ƥǤ롣
Υ롼ƥϥǥɤ 1 ֤
Ԥϥ֤
.br
.if t .ne 9
.LP
.ft B
.nf
.sp .5
struct sockaddr_in *
svc_getcaller(xprt)
\s-1SVCXPRT\s0 *xprt;
.fi
.ft R
.IP
.SM RPC
ӥ̿ϥɥ
.I xprt
˴Ϣդ줿ץθƤӽФΥͥåȥɥ쥹
뤿ɸŪʼʡ
.br
.if t .ne 9
.LP
.ft B
.nf
.sp .5
svc_getreqset(rdfds)
fd_set *rdfds;
.fi
.ft R
.IP
Υ롼ƥϥӥμԤ
.BR svc_run() 
ƤӽФȼƱ٥ȽˤΤ̣߰롣

.B select
ƥॳ뤬
.SM RPC
åȤ
.SM RPC
׵᤬夷֤ˤΤ߸ƤӽФ롣
.I rdfds
Ϸ̤ɤ߹ߥե롦ǥץΥӥåȥޥǤ롣
Υ롼ƥ
.I rdfds
ͤ˴Ϣդ줿ƤΥåȤΥӥԤʤ줿
֤äƤ롣
.br
.if t .ne 6
.LP
.ft B
.nf
.sp .5
svc_getreq(rdfds)
int rdfds;
.fi
.ft R
.IP
.B svc_getreqset() 
˻Ƥ뤬ǥץο 32 ¤Ƥ롣
Υ󥿡ե
.B svc_getreqset()
ˤä֤줿
.br
.if t .ne 17
.LP
.ft B
.nf
.sp .5
svc_register(xprt, prognum, versnum, dispatch, protocol)
\s-1SVCXPRT\s0 *xprt;
u_long prognum, versnum;
void (*dispatch) ();
u_long protocol;
.fi
.ft R
.IP
.I prognum

.I versnum
򥵡ӥʬץ
.I dispatch 
ǴϢդ롣
.I protocol
ξ硢ӥ
.B portmap
ӥˤϿʤ
.I protocol
ʳξ硢
.RI [ prognum , versnum , protocol\fR]
Ȥ߹碌 \fB\%xprt\->xp_port\fR ȤΥޥåԥ󥰤
.B portmap
ӥϿ롣(Ū
.I protocol
ϥ
.SM IPPROTO_UDP

.SM IPPROTO_TCP
Τɤ줫Ǥ롣)
ץ
.I dispatch
ϰʲηǤ:
.RS 1i
.ft B
.nf
dispatch(request, xprt)
struct svc_req *request;
\s-1SVCXPRT\s0 *xprt;
.ft R
.fi
.RE
.IP
.B svc_register()
롼ƥ 1 ֤Ԥϥ֤
.br
.if t .ne 6
.LP
.ft B
.nf
.sp .5
svc_run()
.fi
.ft R
.IP
Υ롼ƥäƤʤ
.SM RPC
׵Ԥɤ줫Ϥ
.B svc_getreq()
ѤŬڤʥӥץƤӽФ
Υץ̾
.B select()
ƥॳ뤫֤ΤԤäƤ롣
.br
.if t .ne 9
.LP
.ft B
.nf
.sp .5
svc_sendreply(xprt, outproc, out)
\s-1SVCXPRT\s0 *xprt;
xdrproc_t outproc;
char *out;
.fi
.ft R
.IP
.SM RPC
ӥʬ롼ƥˤäƥ⡼ȡץ㡦η̤
֤˸ƤӽФ롣
ѥ᡼
.I xprt
Ϥ׵˴Ϣդ줿̿ϥɥǤ롣
.I outproc
Ϸ̤򥨥󥳡ɤ뤿˻Ѥ
.SM XDR
롼ƥǤ롣
.I out
Ϸ̤Υɥ쥹Ǥ롣Υ롼ƥ 1 ֤
Ԥϥ֤
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
void
svc_unregister(prognum, versnum)
u_long prognum, versnum;
.fi
.ft R
.IP
ʬ롼ƥ󤫤
.RI [ prognum , versnum ]

.RI [ prognum , versnum , *\fR]
Ȥ߹碌ݡֹؤΥޥåԥ󥰤ƺ롣
.br
.if t .ne 9
.LP
.ft B
.nf
.sp .5
void
svcerr_auth(xprt, why)
\s-1SVCXPRT\s0 *xprt;
enum auth_stat why;
.fi
.ft R
.IP
ǧڥ顼ˤ⡼ȡץ㡦μ¹Ԥݤ줿
˥ӥʬ롼ƥˤäƸƤӽФ롣
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
void
svcerr_decode(xprt)
\s-1SVCXPRT\s0 *xprt;
.fi
.ft R
.IP
ѥ᡼Υǥɤ˼Ԥ
ӥʬ롼ƥˤäƸƤӽФ롣
.B svc_getargs() 
⻲Ȥ뤳ȡ
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
void
svcerr_noproc(xprt)
\s-1SVCXPRT\s0 *xprt;
.fi
.ft R
.IP
׵Τäץֹ椬Ƥʤ
ӥʬ롼ƥƤӽФ롣
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
void
svcerr_noprog(xprt)
\s-1SVCXPRT\s0 *xprt;
.fi
.ft R
.IP
.SM RPC
ѥå׵ᤵ줿ץबϿƤʤ˸ƤӽФ롣
ӥμˤ̾Υ롼ƥɬפʤ
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
void
svcerr_progvers(xprt)
\s-1SVCXPRT\s0 *xprt;
.fi
.ft R
.IP
.SM RPC
ѥå׵ᤵ줿СΥץबϿƤʤ
ƤӽФ롣ӥμˤ̾Υ롼ƥɬפʤ
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
void
svcerr_systemerr(xprt)
\s-1SVCXPRT\s0 *xprt;
.fi
.ft R
.IP
ΥץȥˤäƥСƤʥƥࡦ顼
Ф줿˥ӥʬ롼ƥˤäƸƤӽФ롣
㤨Сӥʾ塢֤Ƥ뤳ȤǤʤˤ
Υ롼ƥ󤬸ƤӽФ뤫⤷ʤ
.br
.if t .ne 8
.LP
.ft B
.nf
.sp .5
void
svcerr_weakauth(xprt)
\s-1SVCXPRT\s0 *xprt;
.fi
.ft R
.IP
ǧڥѥ᡼­ʤ˥⡼ȡץ㡦μ¹Ԥ
ݤ줿˥ӥʬ롼ƥˤäƸƤӽФ롣
Υ롼ƥ
.BR "svcerr_auth(xprt, \s-1AUTH_TOOWEAK\s0)"
ƤӽФ
.br
.if t .ne 11
.LP
.ft B
.nf
.sp .5
\s-1SVCXPRT\s0 *
svcfd_create(fd, sendsize, recvsize)
int fd;
u_int sendsize;
u_int recvsize;
.fi
.ft R
.IP
ǤդΥץ󤵤줿ǥץ˥ӥ롣
ŵŪˡǥץ
.SM TCP
Τ褦ʥȥ꡼ࡦץȥ³줿åȤǤ롣
.I sendsize

.I recvsize
ˤХåեȼХåե礭ꤹ롣⤷ꤵ줿
ŬڤʥǥեȤ򤵤롣
.br
.if t .ne 11
.LP
.ft B
.nf
.sp .5
\s-1SVCXPRT\s0 *
svcraw_create()
.fi
.ft R
.IP
Υ롼ƥϵ
.SM RPC
ӥ̿ơΥݥ󥿡֤
̿ϼºݤˤϤΥץΥɥ쥹֤ˤХåեʤΤ
б
.SM RPC
饤ȤƱɥ쥹֤ˤɬפ롣
.B clntraw_create() 
򻲾Ȥ뤳ȡ
Υ롼ƥ
.SM RPC
Υߥ졼䡢ͥ롦󥿡ե˱ƶ줺˱֤ʤɤ
.SM RPC
ХإåɤǤ롣Υ롼ƥϼԤ
.SM NULL
֤
.br
.if t .ne 11
.LP
.ft B
.nf
.sp .5
\s-1SVCXPRT\s0 *
svctcp_create(sock, send_buf_size, recv_buf_size)
int sock;
u_int send_buf_size, recv_buf_size;
.fi
.ft R
.IP
Υ롼ƥ
.SM TCP/IP
˴Ť
.SM RPC
ӥ̿ؤΥݥ󥿡֤
̿ϥå
.IR sock
˷ӤĤ롣
.IR sock

.B RPC_ANYSOCK
ǤɤξϿåȤ롣
⤷åȤ
.SM TCP
ݡȤ bind ƤʾϡΥ롼ƥŬʥݡȤ
bind 롣䴰줿硢\fB\%xprt\->xp_sock\fR ˤ̿Υåȡ
ǥץ\fB\%xprt\->xp_port\fR ˤ̿Υݡֹ椬
ꤵ롣
Υ롼ƥϼԤ
.SM NULL
֤
.SM TCP
˴Ť
.SM RPC
ϥХåե줿
.SM I/O 
Ѥ뤿ᡢ桼ϥХåե礭Ǥ롣
ꤷŬڤʥǥեȤ򤵤롣
.br
.if t .ne 10
.LP
.ft B
.nf
.sp .5
\s-1SVCXPRT\s0 *
svcudp_bufcreate(sock, sendsize, recosize)
int sock;
.fi
.ft R
.IP
Υ롼ƥ
.SM UDP/IP
˴Ť
.SM RPC
ӥ̿Υݥ󥿡֤
̿ϥå
.IR sock 
˴Ϣդ롣
.IR sock 

.B RPC_ANYSOCK
ǤɤξϿåȤ롣
åȤ
.SM UDP
ݡȤ bind ƤʤˤϤΥ롼ƥŬʥݡȤ
bind 롣䴰줿硢\fB\%xprt\->xp_sock\fR ̿ΥåȤ
ǥץ\fB\%xprt\->xp_port\fR ̿Υݡֹ椬
ꤵ롣Υ롼ƥϼԤˤ
.SM NULL
֤
.IP
ˤ桼
.SM UDP
˴Ť
.SM RPC 
åǻѤǤѥåȤӼѥåȤκ祵Ǥ롣
.br
.if t .ne 5
.LP
.ft B
.nf
.sp .5
\s-1SVCXPRT\s0 *
svcudp_create(sock)
int sock;
.fi
.ft R
.IP
ѥåȤȼѥåȤΥƱǥեȤ \fISZ\fP ˻ꤷ
\fIsvcudp_bufcreate(sock,SZ,SZ)\fP Ǥ롣
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
xdr_accepted_reply(xdrs, ar)
\s-1XDR\s0 *xdrs;
struct accepted_reply *ar;
.fi
.ft R
.IP
.SM RPC
å򥨥󥳡ɤΤ˻Ѥ롣Υ롼ƥ
.SM RPC
ѥåѤ
\s-1RPC\s0-
Υå褦ȤǤ롣
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
xdr_authunix_parms(xdrs, aupp)
\s-1XDR\s0 *xdrs;
struct authunix_parms *aupp;
.fi
.ft R
.IP
.SM UNIX
ξ򵭽Ҥ뤿˻Ѥ롣Υ롼ƥ
.SM RPC
ǧڥѥåѤˤξ褦Ȥ
Ǥ롣
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
void
xdr_callhdr(xdrs, chdr)
\s-1XDR\s0 *xdrs;
struct rpc_msg *chdr;
.fi
.ft R
.IP
.SM RPC
ƤӽФΥإåå򵭽Ҥ뤿˻Ѥ롣
Υ롼ƥ
.SM RPC
ѥåѤ
.SM RPC\s0-
Υå褦ȤǤ롣
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
xdr_callmsg(xdrs, cmsg)
\s-1XDR\s0 *xdrs;
struct rpc_msg *cmsg;
.fi
.ft R
.IP
.SM RPC
ƤӽФå򵭽ҤΤ˻Ѥ롣
Υ롼ƥ
.SM RPC
ѥåѤ
.SM RPC\s0-
Υå褦ȤǤ롣
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
xdr_opaque_auth(xdrs, ap)
\s-1XDR\s0 *xdrs;
struct opaque_auth *ap;
.fi
.ft R
.IP
.SM PRC
ǧھå򵭽Ҥ뤿˻Ѥ롣
Υ롼ƥ
.SM RPC
ѥåѤ
.SM RPC\s0-
Υå褦ȤǤ롣
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
xdr_pmap(xdrs, regs)
\s-1XDR\s0 *xdrs;
struct pmap *regs;
.fi
.ft R
.IP
Ƽ
.B portmap
ץؤΥѥ᡼Ū˵Ҥ뤿˻Ѥ롣
Υ롼ƥ
.B pmap
󥿡եѤˡΥѥ᡼
Ǥ롣
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
xdr_pmaplist(xdrs, rp)
\s-1XDR\s0 *xdrs;
struct pmaplist **rp;
.fi
.ft R
.IP
ݡȤΥޥåԥ󥰤ΥꥹȤŪ˵Ҥ뤿˻Ѥ롣
Υ롼ƥ
.B pmap
󥿡եѤˡΥѥ᡼
Ǥ롣
.br
.if t .ne 7
.LP
.ft B
.nf
.sp .5
xdr_rejected_reply(xdrs, rr)
\s-1XDR\s0 *xdrs;
struct rejected_reply *rr;
.fi
.ft R
.IP
.SM RPC
å򵭽Ҥ뤿˻Ѥ롣Υ롼ƥ
.SM RPC
ѥåѤˡ
.SM RPC\s0-
ΥåǤ롣
.br
.if t .ne 8
.LP
.ft B
.nf
.sp .5
xdr_replymsg(xdrs, rmsg)
\s-1XDR\s0 *xdrs;
struct rpc_msg *rmsg;
.fi
.ft R
.IP
.SM RPC
å򵭽Ҥ뤿˻Ѥ롣
Υ롼ƥ
.SM RPC
ѥåѤˡ
.SM RPC
ΥåǤ롣
.br
.if t .ne 8
.LP
.ft B
.nf
.sp .5
void
xprt_register(xprt)
\s-1SVCXPRT\s0 *xprt;
.fi
.ft R
.IP
.SM RPC
ӥ̿ϥɥˡ鼫Ȥ
.SM RPC
ӥѥåϿɬפ롣
Υ롼ƥѿ
.BR svc_fds() 
롣ӥμԤ̾Υ롼ƥɬפʤ
.br
.if t .ne 8
.LP
.ft B
.nf
.sp .5
void
xprt_unregister(xprt)
\s-1SVCXPRT\s0 *xprt;
.fi
.ft R
.IP
.SM RPC
ӥ̿ϥɥ˲ˡ
.SM RPC
̿ѥåϿɬפ롣
Υ롼ƥѿ
.B svc_fds()
롣ӥμԤ̾Υ롼ƥɬפʤ
.SH Ϣ
.BR rpc_secure (3N),
.BR xdr (3N)
.br
ʲΥޥ˥奢:
.RS
.ft I
Remote Procedure Calls: Protocol Specification
.br
Remote Procedure Call Programming Guide
.br
rpcgen Programming Guide
.br
.ft R
.RE
.IR "\s-1RPC\s0: Remote Procedure Call Protocol Specification" ,
.SM RFC1050, Sun Microsystems, Inc.,
.SM USC-ISI\s0.