SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from PCLinuxOS lib64tirpc-devel-1.0.1-1pclos2017.x86_64.rpm

RPC_SOC

Section: C Library Functions (3)
Index
BSD mandoc
 

NAME

rpc_soc auth_destroy authnone_create authunix_create authunix_create_default callrpc clnt_broadcast clnt_call clnt_control clnt_create clnt_destroy clnt_freeres clnt_geterr clnt_pcreateerror clnt_perrno clnt_perror clnt_spcreateerror clnt_sperrno clnt_sperror clntraw_create clnttcp_create clntudp_bufcreate clntudp_create clntunix_create get_myaddress pmap_getmaps pmap_getport pmap_rmtcall pmap_set pmap_unset registerrpc rpc_createerr svc_destroy svc_fds svc_fdset svc_getargs svc_getcaller svc_getreq svc_getreqset svc_register svc_run svc_sendreply svc_unregister svcerr_auth svcerr_decode svcerr_noproc svcerr_noprog svcerr_progvers svcerr_systemerr svcerr_weakauth svcfd_create svcunixfd_create svcraw_create svcunix_create xdr_accepted_reply xdr_authunix_parms xdr_callhdr xdr_callmsg xdr_opaque_auth xdr_pmap xdr_pmaplist xdr_rejected_reply xdr_replymsg xprt_register xprt_unregister - library routines for remote procedure calls 

SYNOPSIS

In rpc/rpc.h

SeeSx DESCRIPTIONfor function declarations. 

DESCRIPTION

Bf -symbolicTheFn svc_*andFn clnt_*functions described in this page are the old, TS-RPCinterface to the XDR and RPC library, and exist for backward compatibility.The new interface is described in the pagesreferenced fromrpc(3).Ef

These routines allow C programs to make procedurecalls on other machines across the network.First, the client calls a procedure to send adata packet to the server.Upon receipt of the packet, the server calls a dispatch routineto perform the requested service, and then sends back areply.Finally, the procedure call returns to the client.

Routines that are used for SecureRPC ( DESauthentication) are described inrpc_secure3.SecureRPCcan be used only ifDESencryption is available.

Ft void
Fn auth_destroy AUTH *auth

A macro that destroys the authentication information associated withFa auth .Destruction usually involves deallocation of private datastructures.The use ofFa authis undefined after callingFn auth_destroy .

Ft AUTH *
Fn authnone_create

Create and return anRPCauthentication handle that passes nonusable authenticationinformation with each remote procedure call.This is thedefault authentication used byRPC

Ft AUTH *
Fn authunix_create char *host int uid int gid int len int *aup_gids

Create and return anRPCauthentication handle that containsUNIXauthentication information.TheFa hostargumentis the name of the machine on which the information wascreated;Fa uidis the user's user ID;Fa gidis the user's current group ID;Fa lenandFa aup_gidsrefer to a counted array of groups to which the user belongs.It is easy to impersonate a user.

Ft AUTH *
Fn authunix_create_default

CallsFn authunix_createwith the appropriate arguments.

Ft intFo callrpcFa char *hostFa u_long prognumFa u_long versnumFa u_long procnumFa xdrproc_t inprocFa void *inFa xdrproc_t outprocFa void *outFc

Call the remote procedure associated withFa prognum ,Fa versnum ,andFa procnumon the machineFa host .TheFa inargumentis the address of the procedure's argument(s), andFa outis the address of where to place the result(s);Fa inprocis used to encode the procedure's arguments, andFa outprocis used to decode the procedure's results.This routine returns zero if it succeeds, or the value ofVt enum clnt_statcast to an integer if it fails.The routineFn clnt_perrnois handy for translating failure statuses into messages.

Warning: calling remote procedures with this routineusesUDP/IPas a transport; seeFn clntudp_createfor restrictions.You do not have control of timeouts or authentication usingthis routine.

Ft enum clnt_stat
Fo clnt_broadcastFa u_long prognumFa u_long versnumFa u_long procnumFa xdrproc_t inprocFa char *inFa xdrproc_t outprocFa char *outFa bool_t (*eachresult)(caddr_t, struct sockaddr_in *)Fc

LikeFn callrpc ,except the call message is broadcast to all locallyconnected broadcast nets.Each time it receives aresponse, this routine callsFn eachresult ,whose form is:
Ft bool_tFn eachresult caddr_t out struct sockaddr_in *addr

whereFa outis the same asFa outpassed toFn clnt_broadcast ,except that the remote procedure's output is decoded there;Fa addrpoints to the address of the machine that sent the results.IfFn eachresultreturns zero,Fn clnt_broadcastwaits for more replies; otherwise it returns with appropriatestatus.

Warning: broadcast sockets are limited in size to themaximum transfer unit of the data link.For ethernet,this value is 1500 bytes.

Ft enum clnt_stat
Fo clnt_callFa CLIENT *clntFa u_long procnumFa xdrproc_t inprocFa char *inFa xdrproc_t outprocFa char *outFa struct timeval toutFc

A macro that calls the remote procedureFa procnumassociated with the client handle,Fa clnt ,which is obtained with anRPCclient creation routine such asFn clnt_create .TheFa inargumentis the address of the procedure's argument(s), andFa outis the address of where to place the result(s);Fa inprocis used to encode the procedure's arguments, andFa outprocis used to decode the procedure's results;Fa toutis the time allowed for results to come back.

Ft voidFn clnt_destroy CLIENT *clnt

A macro that destroys the client'sRPChandle.Destruction usually involves deallocationof private data structures, includingFa clntitself.Use ofFa clntis undefined after callingFn clnt_destroy .If theRPClibrary opened the associated socket, it will close it also.Otherwise, the socket remains open.

Ft CLIENT *
Fn clnt_create char *host u_long prog u_long vers char *proto

Generic client creation routine.TheFa hostargumentidentifies the name of the remote host where the serveris located.TheFa protoargumentindicates which kind of transport protocol to use.Thecurrently supported values for this field areQq Li udpandQq Li tcp .Default timeouts are set, but can be modified usingFn clnt_control .

Warning: UsingUDPhas its shortcomings.SinceUDP -basedRPCmessages can only hold up to 8 Kbytes of encoded data,this transport cannot be used for procedures that takelarge arguments or return huge results.

Ft bool_t
Fn clnt_control CLIENT *cl u_int req char *info

A macro used to change or retrieve various informationabout a client object.TheFa reqargumentindicates the type of operation, andFa infois a pointer to the information.For bothUDPandTCP the supported values ofFa reqand their argument types and what they do are:

CLSET_TIMEOUT Ta Vt struct timeval Ta set total timeout
CLGET_TIMEOUT Ta Vt struct timeval Ta get total timeout

Note: if you set the timeout usingFn clnt_control ,the timeout argument passed toFn clnt_callwill be ignored in all future calls.

CLGET_SERVER_ADDR Ta Vt struct sockaddr_in Ta get server's address

The following operations are valid forUDPonly:

CLSET_RETRY_TIMEOUT Ta Vt struct timeval Ta set the retry timeout
CLGET_RETRY_TIMEOUT Ta Vt struct timeval Ta get the retry timeout

The retry timeout is the time thatUDP RPCwaits for the server to reply beforeretransmitting the request.

Ft bool_tFn clnt_freeres CLIENT *clnt xdrproc_t outproc char *out

A macro that frees any data allocated by theRPC/XDRsystem when it decoded the results of anRPCcall.TheFa outargumentis the address of the results, andFa outprocis theXDRroutine describing the results.This routine returns one if the results were successfullyfreed,and zero otherwise.

Ft void
Fn clnt_geterr CLIENT *clnt struct rpc_err *errp

A macro that copies the error structure out of the clienthandleto the structure at addressFa errp .

Ft void
Fn clnt_pcreateerror char *s

prints a message to standard error indicatingwhy a clientRPChandle could not be created.The message is prepended with stringFa sand a colon.A newline is appended at the end of the message.Used when aFn clnt_create ,Fn clntraw_create ,Fn clnttcp_create ,orFn clntudp_createcall fails.

Ft void
Fn clnt_perrno enum clnt_stat stat

Print a message to standard error correspondingto the condition indicated byFa stat .A newline is appended at the end of the message.Used afterFn callrpc .

Ft voidFn clnt_perror CLIENT *clnt char *s

Print a message to standard error indicating why anRPCcall failed;Fa clntis the handle used to do the call.The message is prepended with stringFa sand a colon.A newline is appended at the end of the message.Used afterFn clnt_call .

Ft char *
Fn clnt_spcreateerror char *s

LikeFn clnt_pcreateerror ,except that it returns a stringinstead of printing to the standard error.

Bugs: returns pointer to static data that is overwrittenon each call.

Ft char *
Fn clnt_sperrno enum clnt_stat stat

Take the same arguments asFn clnt_perrno ,but instead of sending a message to the standard errorindicating why anRPCcall failed, return a pointer to a string which containsthe message.

TheFn clnt_sperrnofunctionis used instead ofFn clnt_perrnoif the program does not have a standard error (as a programrunning as a server quite likely does not), or if theprogrammerdoes not want the message to be output withFn printf ,or if a message format different from that supported byFn clnt_perrnois to be used.

Note: unlikeFn clnt_sperrorandFn clnt_spcreateerror ,Fn clnt_sperrnoreturns pointer to static data, but theresult will not get overwritten on each call.

Ft char *
Fn clnt_sperror CLIENT *rpch char *s

LikeFn clnt_perror ,except that (likeFn clnt_sperrno )it returns a string instead of printing to standard error.

Bugs: returns pointer to static data that is overwrittenon each call.

Ft CLIENT *
Fn clntraw_create u_long prognum u_long versnum

This routine creates a toyRPCclient for the remote programFa prognum ,versionFa versnum .The transport used to pass messages to the service isactually a buffer within the process's address space, so thecorrespondingRPCserver should live in the same address space; seeFn svcraw_create .This allows simulation ofRPCand acquisition ofRPCoverheads, such as round trip times, without anykernel interference.This routine returnsNULLif it fails.

Ft CLIENT *
Fo clnttcp_createFa struct sockaddr_in *addrFa u_long prognumFa u_long versnumFa int *sockpFa u_int sendszFa u_int recvszFc

This routine creates anRPCclient for the remote programFa prognum ,versionFa versnum ;the client usesTCP/IPas a transport.The remote program is located at InternetaddressFa addr .IfFa addr->sin_portis zero, then it is set to the actual port that the remoteprogram is listening on (the remoterpcbind(8)service is consulted for this information).TheFa sockpargumentis a socket; if it isRPC_ANYSOCK then this routine opens a new one and setsFa sockp .SinceTCP -basedRPCuses bufferedI/O the user may specify the size of the send and receive bufferswith theFa sendszandFa recvszarguments;values of zero choose suitable defaults.This routine returnsNULLif it fails.

Ft CLIENT *
Fo clntudp_createFa struct sockaddr_in *addrFa u_long prognumFa u_long versnumFa struct timeval waitFa int *sockpFc

This routine creates anRPCclient for the remote programFa prognum ,versionFa versnum ;the client usesUDP/IPas a transport.The remote program is located at InternetaddressFa addr .IfFa addr->sin_portis zero, then it is set to actual port that the remoteprogram is listening on (the remoterpcbind(8)service is consulted for this information).TheFa sockpargumentis a socket; if it isRPC_ANYSOCK then this routine opens a new one and setsFa sockp .TheUDPtransport resends the call message in intervals ofFa waittime until a response is received or until the call timesout.The total time for the call to time out is specified byFn clnt_call .

Warning: sinceUDP -basedRPCmessages can only hold up to 8 Kbytesof encoded data, this transport cannot be used for proceduresthat take large arguments or return huge results.

Ft CLIENT *
Fo clntudp_bufcreateFa struct sockaddr_in *addrFa u_long prognumFa u_long versnumFa struct timeval waitFa int *sockpFa unsigned int sendsizeFa unsigned int recosizeFc

This routine creates anRPCclient for the remote programFa prognum ,onFa versnum ;the client usesUDP/IPas a transport.The remote program is located at InternetaddressFa addr .IfFa addr->sin_portis zero, then it is set to actual port that the remoteprogram is listening on (the remoterpcbind(8)service is consulted for this information).TheFa sockpargumentis a socket; if it isRPC_ANYSOCK then this routine opens a new one and setsFa sockp .TheUDPtransport resends the call message in intervals ofFa waittime until a response is received or until the call timesout.The total time for the call to time out is specified byFn clnt_call .

This allows the user to specify the maximum packet sizefor sending and receivingUDP -basedRPCmessages.

Ft CLIENT *
Fo clntunix_createFa struct sockaddr_un *raddrFa u_long prognumFa u_long versnumFa int *sockpFa u_int sendszFa u_int recvszFc

This routine creates anRPCclient for the localprogramFa prognum ,versionFa versnum ;the client usesUNIXsockets as a transport.The local program is located at theFa *raddr .TheFa sockpargumentis a socket; if it isRPC_ANYSOCK then this routine opens a new one and setsFa sockp .SinceUNIXRPCuses bufferedI/O the user may specify the size of the send and receive bufferswith theFa sendszandFa recvszarguments;values of zero choose suitable defaults.This routine returnsNULLif it fails.

Ft int
Fn get_myaddress struct sockaddr_in *addr

Stuff the machine'sIPaddress intoFa addr ,without consulting the library routines that deal with/etc/hosts The port number is always set toFn htons PMAPPORT .Returns zero on success, non-zero on failure.

Ft struct pmaplist *
Fn pmap_getmaps struct sockaddr_in *addr

A user interface to therpcbind(8)service, which returns a list of the currentRPCprogram-to-port mappingson the host located atIPaddressFa addr .This routine can returnNULL The command``rpcinfo -p''uses this routine.

Ft u_short
Fo pmap_getportFa struct sockaddr_in *addrFa u_long prognumFa u_long versnumFa u_long protocolFc

A user interface to therpcbind(8)service, which returns the port numberon which waits a service that supports program numberFa prognum ,versionFa versnum ,and speaks the transport protocol associated withFa protocol .The value ofFa protocolis most likelyIPPROTO_UDPorIPPROTO_TCP A return value of zero means that the mapping does not existor thattheRPCsystem failed to contact the remoterpcbind(8)service.In the latter case, the global variablerpc_createerrcontains theRPCstatus.

Ft enum clnt_stat
Fo pmap_rmtcallFa struct sockaddr_in *addrFa u_long prognumFa u_long versnumFa u_long procnumFa xdrproc_t inprocFa char *inFa xdrproc_t outprocFa char *outFa struct timeval toutFa u_long *portpFc

A user interface to therpcbind(8)service, which instructsrpcbind(8)on the host atIPaddressFa addrto make anRPCcall on your behalf to a procedure on that host.TheFa portpargumentwill be modified to the program's port number if theproceduresucceeds.The definitions of other arguments are discussedinFn callrpcandFn clnt_call .This procedure should be used for a``ping''and nothingelse.See alsoFn clnt_broadcast .

Ft bool_tFn pmap_set u_long prognum u_long versnum u_long protocol u_short port

A user interface to therpcbind(8)service, which establishes a mapping between the triple(Fa prognum , versnum , protocol)andFa porton the machine'srpcbind(8)service.The value ofFa protocolis most likelyIPPROTO_UDPorIPPROTO_TCP This routine returns one if it succeeds, zero otherwise.Automatically done byFn svc_register .

Ft bool_tFn pmap_unset u_long prognum u_long versnum

A user interface to therpcbind(8)service, which destroys all mapping between the triple(Fa prognum , versnum ,) andFa portson the machine'srpcbind(8)service.This routine returns one if it succeeds, zerootherwise.

Ft bool_tFo registerrpcFa u_long prognumFa u_long versnumFa u_long procnumFa char *(*procname)(void)Fa xdrproc_t inprocFa xdrproc_t outprocFc

Register procedureFa procnamewith theRPCservice package.If a request arrives for programFa prognum ,versionFa versnum ,and procedureFa procnum ,Fa procnameis called with a pointer to its argument(s);Fa prognameshould return a pointer to its static result(s);Fa inprocis used to decode the arguments whileFa outprocis used to encode the results.This routine returns zero if the registration succeeded, -1otherwise.

Warning: remote procedures registered in this formare accessed using theUDP/IPtransport; seeFn svcudp_createfor restrictions.

Vt struct rpc_createerr rpc_createerr ;

A global variable whose value is set by anyRPCclient creation routinethat does not succeed.Use the routineFn clnt_pcreateerrorto print the reason why.

Ft bool_tFn svc_destroy SVCXPRT * xprt

A macro that destroys theRPCservice transport handle,Fa xprt .Destruction usually involves deallocationof private data structures, includingFa xprtitself.Use ofFa xprtis undefined after calling this routine.

Vt fd_set svc_fdset ;

A global variable reflecting theRPCservice side'sread file descriptor bit mask; it is suitable as a template argumentto theselect(2)system call.This is only of interestif a service implementor does not callFn svc_run ,but rather does his own asynchronous event processing.This variable is read-only (do not pass its address toselect(2)!),yet it may change after calls toFn svc_getreqsetor any creation routines.As well, note that if the process has descriptor limitswhich are extended beyondFD_SETSIZE this variable will only be usable for the firstFD_SETSIZEdescriptors.

Vt int svc_fds ;

Similar tosvc_fdset but limited to 32 descriptors.Thisinterface is obsoleted bysvc_fdset

Ft bool_tFn svc_freeargs SVCXPRT *xprt xdrproc_t inproc char *in

A macro that frees any data allocated by theRPC/XDRsystem when it decoded the arguments to a service procedureusingFn svc_getargs .This routine returns 1 if the results were successfullyfreed,and zero otherwise.

Ft bool_tFn svc_getargs SVCXPRT *xprt xdrproc_t inproc char *in

A macro that decodes the arguments of anRPCrequestassociated with theRPCservice transport handle,Fa xprt .TheFa inargumentis the address where the arguments will be placed;Fa inprocis theXDRroutine used to decode the arguments.This routine returns one if decoding succeeds, and zerootherwise.

Ft struct sockaddr_in *
Fn svc_getcaller SVCXPRT *xprt

The approved way of getting the network address of the callerof a procedure associated with theRPCservice transport handle,Fa xprt .

Ft voidFn svc_getreqset fd_set *rdfds

This routine is only of interest if a service implementordoes not callFn svc_run ,but instead implements custom asynchronous event processing.It is called when theselect(2)system call has determined that anRPCrequest has arrived on someRPCsocket(s);Fa rdfdsis the resultant read file descriptor bit mask.The routine returns when all sockets associated with thevalue ofFa rdfdshave been serviced.

Ft voidFn svc_getreq int rdfds

Similar toFn svc_getreqset ,but limited to 32 descriptors.This interface is obsoleted byFn svc_getreqset .

Ft bool_tFo svc_registerFa SVCXPRT *xprtFa u_long prognumFa u_long versnumFa void (*dispatch)(struct svc_req *, SVCXPRT *)Fa int protocolFc

AssociatesFa prognumandFa versnumwith the service dispatch procedure,Fn dispatch .IfFa protocolis zero, the service is not registered with therpcbind(8)service.IfFa protocolis non-zero, then a mapping of the triple(Fa prognum , versnum , protocol)toFa xprt->xp_portis established with the localrpcbind(8)service (generallyFa protocolis zero,IPPROTO_UDPorIPPROTO_TCP ) The procedureFn dispatchhas the following form:
Ft bool_tFn dispatch struct svc_req *request SVCXPRT *xprt

TheFn svc_registerroutine returns one if it succeeds, and zero otherwise.

Fn svc_run

This routine never returns.It waits forRPCrequests to arrive, and calls the appropriate serviceprocedure usingFn svc_getreqwhen one arrives.This procedure is usually waiting for aselect(2)system call to return.

Ft bool_tFn svc_sendreply SVCXPRT *xprt xdrproc_t outproc char *out

Called by anRPCservice's dispatch routine to send the results of aremote procedure call.TheFa xprtargumentis the request's associated transport handle;Fa outprocis theXDRroutine which is used to encode the results; andFa outis the address of the results.This routine returns one if it succeeds, zero otherwise.

Ft void
Fn svc_unregister u_long prognum u_long versnum

Remove all mapping of the double(Fa prognum , versnum)to dispatch routines, and of the triple(Fa prognum , versnum ,) to port number.

Ft void
Fn svcerr_auth SVCXPRT *xprt enum auth_stat why

Called by a service dispatch routine that refuses to performa remote procedure call due to an authentication error.

Ft void
Fn svcerr_decode SVCXPRT *xprt

Called by a service dispatch routine that cannot successfullydecode its arguments.See alsoFn svc_getargs .

Ft void
Fn svcerr_noproc SVCXPRT *xprt

Called by a service dispatch routine that does not implementthe procedure number that the caller requests.

Ft void
Fn svcerr_noprog SVCXPRT *xprt

Called when the desired program is not registered with theRPCpackage.Service implementors usually do not need this routine.

Ft void
Fn svcerr_progvers SVCXPRT *xprt u_long low_vers u_long high_vers

Called when the desired version of a program is not registeredwith theRPCpackage.Service implementors usually do not need this routine.

Ft void
Fn svcerr_systemerr SVCXPRT *xprt

Called by a service dispatch routine when it detects a systemerrornot covered by any particular protocol.For example, if a service can no longer allocate storage,it may call this routine.

Ft void
Fn svcerr_weakauth SVCXPRT *xprt

Called by a service dispatch routine that refuses to performa remote procedure call due to insufficientauthentication arguments.The routine callsFn svcerr_auth xprt AUTH_TOOWEAK .

Ft SVCXPRT *
Fn svcraw_create void

This routine creates a toyRPCservice transport, to which it returns a pointer.The transportis really a buffer within the process's address space,so the correspondingRPCclient should live in the sameaddress space;seeFn clntraw_create .This routine allows simulation ofRPCand acquisition ofRPCoverheads (such as round trip times), without any kernelinterference.This routine returnsNULLif it fails.

Ft SVCXPRT *
Fn svctcp_create int sock u_int send_buf_size u_int recv_buf_size

This routine creates aTCP/IP -basedRPCservice transport, to which it returns a pointer.The transport is associated with the socketFa sock ,which may beRPC_ANYSOCK in which case a new socket is created.If the socket is not bound to a localTCPport, then this routine binds it to an arbitrary port.Upon completion,Fa xprt->xp_fdis the transport's socket descriptor, andFa xprt->xp_portis the transport's port number.This routine returnsNULLif it fails.SinceTCP -basedRPCuses bufferedI/O users may specify the size of buffers; values of zerochoose suitable defaults.

Ft SVCXPRT *
Fn svcunix_create int sock u_int send_buf_size u_int recv_buf_size char *path

This routine creates aUNIXRPCservice transport, to which it returns a pointer.The transport is associated with the socketFa sock ,which may beRPC_ANYSOCK in which case a new socket is created.TheFa *pathargumentis a variable-length file system pathname ofat most 104 characters.This file isnotremoved when the socket is closed.Theunlink(2)system call must be used to remove the file.Upon completion,Fa xprt->xp_fdis the transport's socket descriptor.This routine returnsNULLif it fails.SinceUNIXRPCuses bufferedI/O users may specify the size of buffers; values of zerochoose suitable defaults.

Ft SVCXPRT *
Fn svcunixfd_create int fd u_int sendsize u_int recvsize

Create a service on top of any open descriptor.TheFa sendsizeandFa recvsizeargumentsindicate sizes for the send and receive buffers.If they arezero, a reasonable default is chosen.

Ft SVCXPRT *
Fn svcfd_create int fd u_int sendsize u_int recvsize

Create a service on top of any open descriptor.Typically,thisdescriptor is a connected socket for a stream protocol suchasTCP TheFa sendsizeandFa recvsizeargumentsindicate sizes for the send and receive buffers.If they arezero, a reasonable default is chosen.

Ft SVCXPRT *
Fn svcudp_bufcreate int sock u_int sendsize u_int recvsize

This routine creates aUDP/IP -basedRPCservice transport, to which it returns a pointer.The transport is associated with the socketFa sock ,which may beRPC_ANYSOCK in which case a new socket is created.If the socket is not bound to a localUDPport, then this routine binds it to an arbitrary port.Uponcompletion,Fa xprt->xp_fdis the transport's socket descriptor, andFa xprt->xp_portis the transport's port number.This routine returnsNULLif it fails.

This allows the user to specify the maximum packet size for sending andreceivingUDP -basedRPCmessages.

Ft bool_tFn xdr_accepted_reply XDR *xdrs struct accepted_reply *ar

Used for encodingRPCreply messages.This routine is useful for users whowish to generateRPC -stylemessages without using theRPCpackage.

Ft bool_tFn xdr_authunix_parms XDR *xdrs struct authunix_parms *aupp

Used for describingUNIXcredentials.This routine is useful for userswho wish to generate these credentials without using theRPCauthentication package.

Ft void
Ft bool_tFn xdr_callhdr XDR *xdrs struct rpc_msg *chdr

Used for describingRPCcall header messages.This routine is useful for users who wish to generateRPC -stylemessages without using theRPCpackage.

Ft bool_tFn xdr_callmsg XDR *xdrs struct rpc_msg *cmsg

Used for describingRPCcall messages.This routine is useful for users who wish to generateRPC -stylemessages without using theRPCpackage.

Ft bool_tFn xdr_opaque_auth XDR *xdrs struct opaque_auth *ap

Used for describingRPCauthentication information messages.This routine is useful for users who wish to generateRPC -stylemessages without using theRPCpackage.

Vt struct pmap ;
Ft bool_tFn xdr_pmap XDR *xdrs struct pmap *regs

Used for describing arguments to variousrpcbind(8)procedures, externally.This routine is useful for users who wish to generatethese arguments without using theFn pmap_*interface.

Ft bool_tFn xdr_pmaplist XDR *xdrs struct pmaplist **rp

Used for describing a list of port mappings, externally.This routine is useful for users who wish to generatethese arguments without using theFn pmap_*interface.

Ft bool_tFn xdr_rejected_reply XDR *xdrs struct rejected_reply *rr

Used for describingRPCreply messages.This routine is useful for users who wish to generateRPC -stylemessages without using theRPCpackage.

Ft bool_tFn xdr_replymsg XDR *xdrs struct rpc_msg *rmsg

Used for describingRPCreply messages.This routine is useful for users who wish to generateRPCstyle messages without using theRPCpackage.

Ft void
Fn xprt_register SVCXPRT *xprt

AfterRPCservice transport handles are created,they should register themselves with theRPCservice package.This routine modifies the global variablesvc_fds Service implementors usually do not need this routine.

Ft void
Fn xprt_unregister SVCXPRT *xprt

Before anRPCservice transport handle is destroyed,it should unregister itself with theRPCservice package.This routine modifies the global variablesvc_fds Service implementors usually do not need this routine.

 

AVAILABILITY

These functions are part of libtirpc. 

SEE ALSO

rpc_secure3,xdr(3)
"Remote Procedure Calls: Protocol Specification"
"Remote Procedure Call Programming Guide"
"rpcgen Programming Guide"
"RPC: Remote Procedure Call Protocol Specification"RFC1050"Sun Microsystems, Inc., USC-ISI"


 

Index

NAME
SYNOPSIS
DESCRIPTION
AVAILABILITY
SEE ALSO

This document was created byman2html,using the manual pages.