PMAP_CLNT(3R)PMAP_CLNT(3R)NAME
pmap_clnt: pmap_getmaps, pmap_getport, pmap_rmtcall, pmap_set,
pmap_setrmtcalltimeout, pmap_settimeouts, pmap_unset - library routines
for RPC portmap service
SYNOPSIS AND DESCRIPTION
This page describes functions from Irix standard C library (libc) which
are used to interact with RPC portmap service.
#include <rpc/rpc.h>
struct pmaplist *
pmap_getmaps(struct sockaddr_in *addr)
A user interface to the portmap service, which returns a list of the
current RPC program-to-port mappings on the host located at IP
address *addr. This routine can return NULL. The command `rpcinfo
-p' uses this routine.
u_short
pmap_getport(struct sockaddr_in *addr, rpcprog_t prognum,
rpcvers_t versnum, u_int protocol)
A user interface to the portmap service, which returns the port
number on which waits a service that supports program number
prognum, version versnum, and speaks the transport protocol
associated with protocol. The value of protocol is most likely
IPPROTO_UDP or IPPROTO_TCP. A return value of 0 means that the
mapping does not exist or that the RPC system failured to contact
the remote portmap service. In the latter case, the global variable
rpc_createerr() contains the RPC status.
enum clnt_stat
pmap_rmtcall(struct sockaddr_in *addr,
rpcprog_t prognum, rpcvers_t versnum, rpcproc_t procnum,
xdrproc_t inproc, void *in,
xdrproc_t outproc, void *out,
struct timeval tout, u_long *portp)
A user interface to the portmap service, which instructs portmap on
the host at IP address *addr to make an RPC call on your behalf to a
procedure on that host. The parameter *portp will be modified to
the program's port number if the procedure succeeds. The definitions
of other parameters are discussed in callrpc() and clnt_call().
This procedure should be used for a ping and nothing else. See also
clnt_broadcast(). pmap_settimeouts(), and pmap_setrmtcalltimeout().
Page 1
PMAP_CLNT(3R)PMAP_CLNT(3R)
bool_t
pmap_set(rpcprog_t prognum, rpcvers_t versnum,
u_long protocol, u_short port)
A user interface to the portmap service, which establishes a mapping
between the triple [prognum, versnum, protocol] and port on the
machine's portmap service. The value of protocol is most likely
IPPROTO_UDP or IPPROTO_TCP. This routine returns 1 if it succeeds,
0 otherwise. Automatically done by svc_register().
void
pmap_setrmtcalltimeout(struct timeval intertry)
Set the retry timeout for pmap_rmtcall(). Note that the total
timeout per call is an argument to pmap_rmtcall().
void
pmap_settimeouts(struct timeval intertry,
struct timeval percall)
Set the retry and total timeouts for RPCs to the portmapper. These
timeouts are used explicitly by pmap_set() and pmap_getport(), and
implicitly by clnt*_create().
bool_t
pmap_unset(rpcprog_t prognum, rpcvers_t versnum)
A user interface to the portmap service, which destroys all mapping
between the triple [prognum, versnum, *] and ports on the machine's
portmap service. This routine returns 1 if it succeeds, 0 otherwise.
SEE ALSOportmap(1M), rpcbind(1M), rpcbind (3R), rpc(3R), rpc_clnt_cr(3R),
xdr(3R), IRIX Network Programming Guide.
Page 2
