SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

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

RPCBIND

Section: C Library Functions (3)
Index
BSD mandoc
 

NAME

rpcb_getmaps rpcb_getaddr rpcb_gettime rpcb_rmtcall rpcb_set rpcb_unset - library routines for RPC bind service 

SYNOPSIS

In rpc/rpc.hFt rpcblist *Fn rpcb_getmaps const struct netconfig *netconf const char *hostFt bool_tFn rpcb_getaddr const rpcprog_t prognum const rpcvers_t versnum const struct netconfig *netconf struct netbuf *svcaddr const char *hostFt bool_tFn rpcb_gettime const char *host time_t * timepFt enum clnt_statFn rpcb_rmtcall const struct netconfig *netconf const char *host const rpcprog_t prognum, const rpcvers_t versnum const rpcproc_t procnum, const xdrproc_t inproc const caddr_t in const xdrproc_t outproc const caddr_t out const struct timeval tout, const struct netbuf *svcaddrFt bool_tFn rpcb_set const rpcprog_t prognum const rpcvers_t versnum const struct netconfig *netconf const struct netbuf *svcaddrFt bool_tFn rpcb_unset const rpcprog_t prognum const rpcvers_t versnum const struct netconfig *netconf 

DESCRIPTION

These routines allow client C programs to make procedurecalls to the RPC binder service.(seerpcbind(8))maintains a list of mappings between programsand their universal addresses. 

Routines

Fn rpcb_getmaps
An interface to the rpcbind service,which returns a list of the currentRPC program-to-address mappings onFa host .It uses the transport specified throughFa netconfto contact the remote rpcbindservice onFa host .This routine will returnNULL if the remote rpcbind could not be contacted.
Fn rpcb_getaddr
An interface to the rpcbindservice, which finds the address of the service onFa hostthat is registered with program numberFa prognum ,versionFa versnum ,and speaks the transport protocol associated withFa netconf .The address found is returned inFa svcaddr .TheFa svcaddrargumentshould be preallocated.This routine returnsTRUEif it succeeds.A return value ofFALSEmeans that the mapping does not existor that the RPCsystem failed to contact the remoterpcbind service.In the latter case, the global variablerpc_createerr(seerpc_clnt_create3)contains theRPC status.
Fn rpcb_gettime
This routine returns the time onFa hostinFa timep .IfFa hostisNULL Fn rpcb_gettimereturns the time on its own machine.This routine returnsTRUEif it succeeds,FALSEif it fails.TheFn rpcb_gettimefunctioncan be used to synchronize the time between theclient and the remote server.
Fn rpcb_rmtcall
An interface to the rpcbind service, which instructsrpcbind onFa hostto make an RPCcall on your behalf to a procedure on that host.TheFn netconfigstructure should correspond to a connectionless transport.TheFa svcaddrargumentwill be modified to the server's address if the procedure succeeds(seeFn rpc_callandFn clnt_callinrpc_clnt_calls3for the definitions of other arguments).

This procedure should normally be used for a``ping''and nothing else.This routine allows programs to do lookup and call, all in one step.

Note: Even if the server is not runningFn rpcb_rmtcalldoes not return any error messages to the caller.In such a case, the caller times out.

Note:Fn rpcb_rmtcallis only available for connectionless transports.

Fn rpcb_set
An interface to the rpcbindservice, which establishes a mapping between the tripleBq Fa prognum , versnum , netconf->nc_netidandFa svcaddron the machine's rpcbindservice.The value ofFa nc_netidmust correspond to a network identifier that is defined by thenetconfig database.This routine returnsTRUEif it succeeds,FALSEotherwise.(See alsoFn svc_reginrpc_svc_calls3.)If there already exists such an entry with rpcbind,Fn rpcb_setwill fail.
Fn rpcb_unset
An interface to the rpcbindservice, which destroys the mapping between the tripleBq Fa prognum , versnum , netconf->nc_netidand the address on the machine's rpcbindservice.IfFa netconfisNULL Fn rpcb_unsetdestroys all mapping between the tripleBq Fa prognum , versnum , No all-transportsand the addresses on the machine's rpcbind service.This routine returnsTRUEif it succeeds,FALSEotherwise.Only the owner of the service or the super-user can destroy the mapping.(See alsoFn svc_unreginrpc_svc_calls3.)

 

AVAILABILITY

These functions are part of libtirpc. 

SEE ALSO

rpc_clnt_calls3,rpc_svc_calls3,rpcbind(8),rpcinfo(8)


 

Index

NAME
SYNOPSIS
DESCRIPTION
Routines
AVAILABILITY
SEE ALSO

This document was created byman2html,using the manual pages.