.\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
.\"
.\" @(#)rpc.3n	2.4 88/08/08 4.0 RPCSRC; from 1.19 88/06/24 SMI
.\"
.\" 2007-12-30, mtk, Convert function prototypes to modern C syntax
.\"
.\" 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 3 2007-12-30 "" "Linux Programmer's Manual"
.SH ̾
rpc \- ּ³ƤӽФ(RPC)ΤΥ饤֥ꡦ롼ƥ
.SH 񼰤
Υ롼ƥ C ץǥͥåȥ̤
¾Υޥ˥ץ뤳Ȥǽˤ롣
ǽ˥饤ȤϥǡѥåȤ򥵡Ф뤿
ץƤӽФ
ФϥѥåȤȡʬ롼ƤӽФ
׵ᤵ줿ӥ˼¹Ԥ֤
Ǹ˥ץ㡦ϥ饤Ȥؤ롣
.\" .LP
.\" ߤ rpc_secure.3 äƤʤ -- MTK, 19 Sep 05
.\" (DES ǧڤˤ) Secure RPC ǻѤ롼ƥˤĤƤ
.\" .BR rpc_secure (3)
.\" ¸ߤ롣 Secure RPC  DES ǧڤѲǽʾˤΤ߻ѤǤ롣
.LP
Υ롼ƥѤˤϡإåե
.I "<rpc/rpc.h>"
򥤥󥯥롼ɤ뤳ȡ

ΥץȥפǤϼηѤƤ롣
.in +4n
.nf

typedef int \fIbool_t\fP;

typedef bool_t (*\fIxdrproc_t\fP) (XDR *, void *,...);

typedef bool_t (*\fIresultproc_t\fP) (caddr_t resp,
                                struct sockaddr_in *raddr);
.fi
.in
.LP

.IR AUTH ,
.IR CLIENT ,
.IR SVCXPRT ,
.IR XDR
ˤĤƤϥإåե򻲾ȡ
.LP
.nf
.BI "void auth_destroy(AUTH *" auth );
.fi
.IP
Υޥ
.I auth
˴Ϣդ줿ǧھ˲롣˲̾ϻŪʥǡ¤
˴ޤǤ롣
.BR auth_destroy ()
ƤӽФ
.I auth
Ѥ뤳Ȥ̤Ǥ롣
.LP
.nf
.BI "AUTH *authnone_create(void);"
.fi
.IP
ƥ⡼ȡץ㡦ǻѤǤʤǧھȤϤ
RPC ǧڥϥɥ֤
 RPC ǻѤǥեȤǧڤǤ롣
.LP
.nf
.BI "AUTH *authunix_create(char *" host ", int " uid ", int " gid ,
.BI "                      int " len ", int *" aup_gids );
.fi
.IP
ǧھޤ RPC ǧڥϥɥ֤
.I host
ѥ᡼Ͼ󤬺줿ޥ̾Ǥ롣
.I uid
ϤΥ桼Υ桼
.SM ID

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

.I aup_gids
ϤΥ桼°륰롼פ򻲾ȤƤ롣
¾Υ桼ˤʤꤹޤȤϴñǤ롣
.LP
.nf
.BI "AUTH *authunix_create_default(void);"
.fi
.IP
Ŭڤʥѥ᡼
.BR authunix_create ()
ƤӽФ
.LP
.nf
.BI "int callrpc(char *" host ", unsigned long " prognum ,
.BI "            unsigned long " versnum ", unsigned long " procnum ,
.BI "            char *" in ", char *" out ,
.BI "            xdrproc_t " inproc ", xdrproc_t " outproc );
.fi
.IP
ޥ
.I host

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

.I out

.BR clnt_broadcast ()
Ϥ
.I out
ƱǤ뤬⡼ȡץ㤫νϤǥɤƤ
ΤߤۤäƤ롣
.I addr
Ϸ̤ä褿ޥΥɥ쥹ؤƤ롣
.BR eachresult ()
֤硢
.BR clnt_broadcast ()
ϤʤԤġǤʤŬڤʾ֤ǽλ롣
.IP
ٹ: ֥ɥ㥹ȡåȤϥǡؤκžñ̤
¤Ƥ롣ͥåȤξ硢ͤ 1500 ХȤǤ롣
.LP
.nf
.BI "enum clnt_stat clnt_call(CLIENT *" clnt ", unsigned long " procnum ,
.BI "                    xdrproc_t " inproc ", xdrproc_t " outproc ,
.BI "                    char *" in ", char *" out ", struct timeval " tout );
.fi
.IP
Υޥϥ饤ȡϥɥ
.I clnt
˴Ϣդ줿
.I procnum
⡼ȡץƤӽФ
饤ȡϥɥ
.BR clnt_create ()
Τ褦
.SM RPC
饤Ⱥ롼ƥˤä롣
ѥ᡼
.I in
ϥץΰΥɥ쥹Ǥ롣
.I out
ϥץ֤ͤǼ륢ɥ쥹Ǥ롣
.I inproc
ϥץΥѥ᡼򥨥󥳡ɤΤ˻Ѥ롣
.I outproc
ϥץ֤ͤǥɤΤ˻Ѥ롣
.I tout
Ϸ̤֤ΤԤĻ֤Ǥ롣
.LP
.nf
.BI "clnt_destroy(CLIENT *" clnt );
.fi
.IP
Υޥϥ饤Ȥ RPC ϥɥ˲롣˲ˤ̾
.I clnt
ȤޤƻŪʥǡ¤Τ˴ޤޤƤ롣
.BR clnt_destroy ()
θƤӽФθ
.I clnt
Ѥ뤳Ȥ̤Ǥ롣
RPC 饤֥꤬Ϣ륽åȤ򥪡ץ󤷤ˤϡ
Ĥ롣ʳξˤϥåȤϥץ󤵤줿ޤޤǤ롣
.LP
.nf
.BI "CLIENT *clnt_create(char *" host ", unsigned long " prog ,
.BI "                    unsigned long " vers ", char *" proto );
.fi
.IP
Ūʥ饤Ȥκ롼ƥǤ롣
.I host
ϥФΤ⡼ȥۥȤ̾ꤹ롣
.I proto
ɤΤ褦̿ץȥѤ뤫ꤹ롣ߤ
ѤǤͤ \(lqudp\(rq  \(lqtcp\(rq Ǥ롣
ǥեȤλڤ줬ꤵ뤬
.BR clnt_control ()
ѤѹǽǤ롣
.IP
ٹ:
UDP ѤˤϷ롣
UDP ˴Ť RPC å
Ǥ 8 KByte Υ󥳡ɥǡݻ
ȤǤʤᡢ礭ʰʷ̤ץ
ϻѤ뤳ȤǤʤ
.LP
.nf
.BI "bool_t clnt_control(CLIENT *" cl ", int " req ", char *" info );
.fi
.IP
ΥޥϳƼ說饤ȤˤĤƾѹꡢ
Τ˻Ѥ롣
.I req
μꤹ롣
.I info
ϾؤΥݥ󥿡Ǥ롣
UDP  TCP ɤξѲǽ
.I req
ͤȡΰηӤƤϰʲ̤Ǥ:
.IP
.in +4n
.nf
.ta +2.0i +2.0i +2.0i
\fBCLSET_TIMEOUT\fP  \fIstruct timeval\fP // ڤꤹ
\fBCLGET_TIMEOUT\fP  \fIstruct timeval\fP // ڤ
.fi
.in
.IP
:
.BR clnt_control ()
ѤƻڤꤷˤϤʸ
.BR clnt_call ()
Ϥڤѥ᡼̵뤵롣
.IP
.in +4n
.nf
\fBCLGET_SERVER_ADDR\fP  \fIstruct sockaddr_in \fP // Хɥ쥹
.fi
.in
.IP
ʲ UDP ξˤΤͭǤ:
.IP
.in +4n
.nf
\fBCLSET_RETRY_TIMEOUT\fP  \fIstruct timeval\fP // ֳ֤ꤹ
\fBCLGET_RETRY_TIMEOUT\fP  \fIstruct timeval\fP // ֳ֤
.fi
.in
.IP
ֳ֤ϼ׵
"UDP RPC" ФβԤĻ֤Ǥ롣
.LP
.nf
.BI "clnt_freeres(CLIENT * " clnt ", xdrproc_t " outproc ", char *" out );
.fi
.IP
Υޥ RPC ƤӽФη̤Υǥɤκݤ
RPC/XDR ƥˤäƳƤ줿ǡ롣
ѥ᡼
.I out
Ϸ̤Υɥ쥹Ǥ롣
.I outproc
Ϸ̤򵭽ҤƤ XDR 롼ƥǤ롣
Υ롼ƥϷ̤βˤ 1 ֤
Ԥˤϥ֤
.LP
.nf
.BI "void clnt_geterr(CLIENT *" clnt ", struct rpc_err *" errp );
.fi
.IP
Υޥϥ饤ȡϥɥΥ顼¤Τ
.I errp
ɥ쥹ǻꤵ줿¤Τإԡ롣
.LP
.nf
.BI "void clnt_pcreateerror(char *" s );
.fi
.IP
ɸ२顼Ϥˡʤ饤 RPC ϥɥκ
ǤʤäˤĤƤΥåɽ롣
åʸ
.I s
ȥ(:)ɽ롣
.BR clnt_create (),
.BR clntraw_create (),
.BR clnttcp_create (),
.BR clntudp_create ()
θƤӽФԤ˻Ѥ뤳ȡ
.LP
.nf
.BI "void clnt_perrno(enum clnt_stat " stat );
.fi
.IP
ɸ२顼Ϥ
.I stat
ˤäƻؼ륨顼֤бåɽ롣
.BR callrpc ()
θ˻Ѥ뤳ȡ
.LP
.nf
.BI "clnt_perror(CLIENT *" clnt ", char *" s );
.fi
.IP
ɸ२顼Ϥˡʤ RPC ƤӽФԤˤĤƤΥåɽ롣
.I clnt
ϥ˻ѤϥɥǤ롣
åʸ
.I s
ȥ(:)ɽ롣
.BR clnt_call ()
Ԥ˻Ѥ뤳ȡ
.LP
.nf
.BI "char *clnt_spcreateerror(char *" s );
.fi
.IP
.BR clnt_pcreateerror ()
ƱͤǤ뤬ɸ२顼Ϥɽ뤫ʸ֤ۤäƤ롣
.IP
Х: ŪΰؤΥݥ󥿡֤ᡢƤӽФȤ˾񤭤롣
.LP
.nf
.BI "char *clnt_sperrno(enum clnt_stat " stat );
.fi
.IP
.BR clnt_perrno ()
Ʊ뤬ʤ
RPC ƤӽФԤˤĤƤΥåɸ२顼Ϥɽ
ˡåǼƤʸؤΥݥ󥿡֤
ʸ NEWLINE() ǽäƤ롣
.IP
.BR clnt_sperrno ()
ϥץबɸ२顼ϤäƤʤ(ץबФȤ
äƤˤϤ褯ꤨ)䡢ץޡå
.BR printf (3)
ǽϤ뤳Ȥ˾ޤʤ䡢åη
.BR clnt_perrno ()
ݡȤΤȤϰۤäƤʤɤ
.BR clnt_perrno ()
Τ˻Ѥ롣
:
.BR clnt_sperror ()

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

.I recvsz
ѤХåեȼХåեΥꤹ뤳ȤǤ롣
ꤷˤŬڤʥǥեȤ򤵤롣
Υ롼ƥϼԤ NULL ֤
.LP
.nf
.BI "CLIENT *clntudp_create(struct sockaddr_in *" addr ,
.BI "                unsigned long " prognum ", unsigned long " versnum ,
.BI "                struct timeval " wait ", int *" sockp );
.fi
.IP
Υ롼ƥϥ⡼ȡץ
.IR prognum 
С
.I versnum
Τ RPC 饤Ȥ롣饤Ȥ̿
UDP/IP Ѥ롣⡼ȡץϥ󥿡ͥåȡɥ쥹
.I *addr
ˤ롣
\fB\%addr\->sin_port\fR ʤСºݤ˥⡼ȡץब
listen ƤݡȤꤵ롣(ξΤ˥⡼Ȥ
.B portmap
ӥѤ롣) ѥ᡼
.I sockp
ϥåȤǤ롣⤷줬
.B RPC_ANYSOCK
ꤵƤϡΥ롼ƥ󤬿åȤ򥪡ץ󤷤
.I sockp
ꤹ롣
UDP ̿ϲ뤫ڤ줬ޤ
.B wait
ֳ֤ǸƤӽФå롣ڤ줬ޤǤι׻֤
.BR clnt_call ()
ǻꤹ롣
.IP
ٹ: UDP ˴Ť
RPC åϺǤ 8 Kbyte ޤǤΥ󥳡ɤ줿ǡ
ݻǤʤᡢ̿礭ʰʷ̤
ץˤϻѤǤʤ
.LP
.nf
.BI "CLIENT *clntudp_bufcreate(struct sockaddr_in *" addr ,
.BI "            unsigned long " prognum ", unsigned long " versnum ,
.BI "            struct timeval " wait ", int *" sockp ,
.BI "            unsigned int " sendsize ", unsigned int "recosize );
.fi
.IP
Υ롼ƥϥ⡼ȡץ
.IR prognum 
С
.I versnum
Τ RPC 饤Ȥ롣饤Ȥ̿
UDP/IP Ѥ롣⡼ȡץϥ󥿡ͥåȡɥ쥹
.I *addr
ˤ롣
\fB\%addr\->sin_port\fR ʤСºݤ˥⡼ȡץब
listen ƤݡȤꤵ롣(ξΤ˥⡼Ȥ
.B portmap
ӥѤ롣) ѥ᡼
.I sockp
ϥåȤǤ롣⤷줬
.B RPC_ANYSOCK
ꤵƤϡΥ롼ƥ󤬿åȤ򥪡ץ󤷤
.I sockp
ꤹ롣
UDP ̿ϲ뤫ڤ줬ޤ
.B wait
ֳ֤ǸƤӽФå롣ڤ줬ޤǤι׻֤
.BR clnt_call ()
ǻꤹ롣
.IP
Ѥ UDP ˴Ť RPC åˤѥåȤ
ѥåȤκ祵ꤹ뤳Ȥǽˤʤ롣
.LP
.nf
.BI "void get_myaddress(struct sockaddr_in *" addr );
.fi
.IP
Υޥ IP ɥ쥹
.I *addr
˳Ǽ롣
.I /etc/hosts
򰷤饤֥ꡦ롼ƥϻѤʤݡֹϾ
.B htons(PMAPPORT)
ꤵ롣
.LP
.nf
.BI "struct pmaplist *pmap_getmaps(struct sockaddr_in *" addr );
.fi
.IP
.B portmap
ӥΤΥ桼󥿡եǤꡢ
IP ɥ쥹
.I *addr
ˤۥȤθߤ RPC ץफݡֹؤΥޥåԥ󥰤ΰ֤
Υ롼ƥ NULL ֤⤢롣
.RB ` "rpcinfo \-p" '
ޥɤϤΥ롼ƥѤƤ롣
.LP
.nf
.BI "unsigned short pmap_getport(struct sockaddr_in *" addr ,
.BI "                    unsigned long " prognum ", unsigned long " versnum ,
.BI "                    unsigned int " protocol );
.fi
.IP
.B portmap
ӥΤΥ桼󥿡եǡ
ץֹ
.IR prognum 
С
.IR versnum 
Ϣդ줿̿ץȥ
.I protocol
򥵥ݡȤ륵ӥԤäƤݡֹ֤
.I protocol
ͤϤۤȤɤξ IPPROTO_UDP  IPPROTO_TCP Ǥ롣
֤ͥϥޥåԥ󥰤¸ߤʤ
RPC ƥब⡼Ȥ
.B portmap
ӥλȤ˼ԤȤ̣롣Ԥξѿ
.I rpc_createerr
 RPC ֤ݻƤ롣
.LP
.nf
.BI "enum clnt_stat pmap_rmtcall(struct sockaddr_in *" addr ,
.BI "                    unsigned long " prognum ", unsigned long " versnum ,
.BI "                    unsigned long " procnum ", char *" in ", char *" out ,
.BI "                    xdrproc_t " inproc ", xdrproc_t " outproc ,
.BI "                    struct timeval " tout ", unsigned long *" portp );
.fi
.IP
.B portmap
ӥΤΥ桼󥿡եǡ
IP ɥ쥹
.I *addr
ΥۥȤ
.B portmap
򻲾Ȥơ
RPC ƤӽФΥۥȾΥץƤӽФ
ѥ᡼
.I *portp
ϥץ㤬ˤϥץΥݡֹ˽롣
¾Υѥ᡼ˤĤƤ
.BR callrpc ()

.BR clnt_call ()
Ƥ롣
Υץ \(lqping\(rq Τߤ˻Ѥ٤Ǥ롣
.BR clnt_broadcast ()
⻲Ȥ뤳ȡ
.LP
.nf
.BI "bool_t pmap_set(unsigned long " prognum ", unsigned long " versnum ,
.BI "                unsigned int " protocol ", unsigned short " port );
.fi
.IP
.B portmap
ӥΤΥ桼󥿡եǡ
.RI [ prognum , versnum , protocol\fR]
Ȥ߹碌
.I port
Ȥδ֤Υޥåԥ󥰤򡢤Υޥ
.B portmap
ӥϿ롣
.I protocol
ϤۤȤɤξ
.B IPPROTO_UDP

.B IPPROTO_TCP
Τɤ餫Ǥ롣
Υ롼ƥˤ 1 ֤Ԥˤϥ֤
.BR svc_register ()
ˤäƼưŪ˼¹Ԥ롣
.LP
.nf
.BI "bool_t pmap_unset(unsigned long " prognum ", unsigned long " versnum );
.fi
.IP
.B portmap
ӥΤΥ桼󥿡եǡ
.RI [ prognum , versnum , *\fR]
Ȥ߹碌
.B ports
δ֤Υޥåԥ󥰤򤽤Υޥ
.B portmap
ӥ롣Υ롼ƥ 1 ֤
Ԥˤ 0 ֤
.LP
.nf
.BI "int registerrpc(unsigned long " prognum ", unsigned long " versnum ,
.BI "                unsigned long " procnum ", char *(*" procname ")(char *),"
.BI "                xdrproc_t " inproc ", xdrproc_t " outproc );
.fi
.IP
RPC ӥѥåѤ
.I procname
ץϿ롣ץ
.IR prognum 
С
.IR versnum 
ץ
.I procnum
ؤ׵᤬Ϥ硢
.I procname
ѥ᡼ؤΥݥ󥿡äƸƤӽФ롣
.I progname
Ūʷ̤ؤΥݥ󥿡֤ɬפ롣
.I inproc
ϥѥ᡼ǥɤ뤿˻Ѥ롣
.I outproc
Ϸ̤򥨥󥳡ɤ뤿˻Ѥ롣
Υ롼ƥϿˤϥ֤
Ԥˤ \-1 ֤
.IP
ٹ: ηϿ줿⡼ȡץ
UDP/IP ̿Ѥ롣¤˴ؤƤ
.BR svcudp_create ()
򻲾Ȥ뤳ȡ
.LP
.nf
.BI "struct rpc_createerr " rpc_createerr ;
.fi
.IP
ʤä RPC 饤롼ƥˤäꤵѿ
.BR clnt_pcreateerror ()
롼ƥͳɽ뤿˻Ѥ롣
.LP
.nf
.BI "void svc_destroy(SVCXPRT *" xprt );
.fi
.IP
Υޥ̿ϥɥ
.I xprt
 RPC ӥ˲롣˲ˤ̾
.I xprt
ޤơŪʥǡ¤Τ˴ޤޤƤ롣
Υ롼ƥƤӽФ
.I xprt
Ѥ뤳Ȥ̤Ǥ롣
.LP
.nf
.BI "fd_set " svc_fdset ;
.fi
.IP
RPC ӥ¦Υե롦ǥץΥӥåȥޥȿǤѿ
.BR select (2)
ƥॳΥѥ᡼ΤѤǤ롣
ӥμԤ
.BR svc_run ()
ƤӽФʤˡȼƱ٥ȽѤˤΤ̣߰롣
ѿɤ߹Ѥ (Τޤ
.BR select (2)
ϤƤϤʤʤ!)
.BR svc_getreqset ()
ƤӽФ롼ƥθѹƤ뤫⤷ʤ
.LP
.nf
.BI "int " svc_fds ;
.fi
.IP
.B svc_fdset
˻Ƥ뤬32 ǥץ¤Ƥ롣
Υ󥿡ե
.B svc_fdset
ˤä֤줿
.LP
.nf
.BI "svc_freeargs(SVCXPRT *" xprt ", xdrproc_t " inproc ", char *" in );
.fi
.IP
Υޥϥӥץ㤬
.BR svc_getargs ()
Ѥưǥɤ
RPC/XDR ƥˤäƳƤ줿ǡ롣
Υ롼ƥϲˤ 1 ֤
Ԥˤϥ֤
.LP
.nf
.BI "svc_getargs(SVCXPRT *" xprt ", xdrproc_t " inproc ", char *" in );
.fi
.IP
Υޥ RPC ӥ̿ϥɥ
.I xprt
˴Ϣդ줿 RPC ׵ΰǥɤ롣ѥ᡼
.I in
ϰγǼ줿ɥ쥹Ǥ롣
.I inproc
ϰǥɤ뤿 XDR 롼ƥǤ롣
Υ롼ƥϥǥɤ 1 ֤
Ԥϥ֤
.LP
.nf
.BI "struct sockaddr_in *svc_getcaller(SVCXPRT *" xprt );
.fi
.IP
RPC ӥ̿ϥɥ
.I xprt
˴Ϣդ줿ץθƤӽФΥͥåȥɥ쥹
뤿ɸŪʼʡ
.LP
.nf
.BI "void svc_getreqset(fd_set *" rdfds );
.fi
.IP
Υ롼ƥϥӥμԤ
.BR svc_run ()
ƤӽФȼƱ٥ȽˤΤ̣߰롣

.BR select (2)
ƥॳ뤬 RPC åȤ
RPC ׵᤬夷֤ˤΤ߸ƤӽФ롣
.I rdfds
Ϸ̤ɤ߹ߥե롦ǥץΥӥåȥޥǤ롣
Υ롼ƥ
.I rdfds
ͤ˴Ϣդ줿ƤΥåȤΥӥԤʤ줿
֤äƤ롣
.LP
.nf
.BI "void svc_getreq(int " rdfds );
.fi
.IP
.BR svc_getreqset ()
˻Ƥ뤬ǥץο 32 ¤Ƥ롣
Υ󥿡ե
.BR svc_getreqset ()
ˤä֤줿
.LP
.nf
.BI "bool_t svc_register(SVCXPRT *" xprt ", unsigned long " prognum ,
.BI "                    unsigned long " versnum ,
.BI "                    void (*" dispatch ")(svc_req *, SVCXPRT *),"
.BI "                    unsigned long " protocol );
.fi
.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
ϥ
.BR IPPROTO_UDP 
.B IPPROTO_TCP
Τɤ줫Ǥ롣)
ץ
.I dispatch
ϰʲηǤ:
.in +4n
.nf

dispatch(struct svc_req *request, SVCXPRT *xprt);
.fi
.in
.IP
.BR svc_register ()
롼ƥ 1 ֤Ԥϥ֤
.LP
.nf
.B "void svc_run(void);"
.fi
.IP
Υ롼ƥäƤʤ
.SM RPC
׵Ԥɤ줫Ϥ
.BR svc_getreq ()
ѤŬڤʥӥץƤӽФ
Υץ̾
.BR select (2)
ƥॳ뤫֤ΤԤäƤ롣
.LP
.nf
.BI "bool_t svc_sendreply(SVCXPRT *" xprt ", xdrproc_t " outproc \
", char *" out );
.fi
.IP
RPC ӥʬ롼ƥˤäƥ⡼ȡץ㡦η̤
֤˸ƤӽФ롣
ѥ᡼
.I xprt
Ϥ׵˴Ϣդ줿̿ϥɥǤ롣
.I outproc
Ϸ̤򥨥󥳡ɤ뤿˻Ѥ XDR 롼ƥǤ롣
.I out
Ϸ̤Υɥ쥹Ǥ롣Υ롼ƥ 1 ֤
Ԥϥ֤
.LP
.nf
.BI "void svc_unregister(unsigned long " prognum ", unsigned long " versnum );
.fi
.IP
ʬ롼ƥ󤫤
.RI [ prognum , versnum ]

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

.I recvsize
ˤХåեȼХåե礭ꤹ롣⤷ꤵ줿
ŬڤʥǥեȤ򤵤롣
.LP
.nf
.BI "SVCXPRT *svcraw_create(void);"
.fi
.IP
Υ롼ƥϵ RPC ӥ̿ơΥݥ󥿡֤
̿ϼºݤˤϤΥץΥɥ쥹֤ˤХåեʤΤ
б RPC 饤ȤƱɥ쥹֤ˤɬפ롣
.BR clntraw_create ()
򻲾Ȥ뤳ȡ
Υ롼ƥ
RPC Υߥ졼䡢ͥ롦󥿡ե˱ƶ줺˱֤ʤɤ
RPC ХإåɤǤ롣Υ롼ƥϼԤ NULL ֤
.LP
.nf
.BI "SVCXPRT *svctcp_create(int " sock ", unsigned int " send_buf_size ,
.BI "                       unsigned int " recv_buf_size );
.fi
.IP
Υ롼ƥ TCP/IP ˴Ť
RPC ӥ̿ؤΥݥ󥿡֤
̿ϥå
.I sock
˷ӤĤ롣
.I sock

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

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