pmap_rmtcall Subroutine

Communications Technical Reference, Volume 1

pmap_rmtcall Subroutine

Purpose

Instructs the portmap daemon to make a remote procedure call.

Library

C Library (libc.a)

Syntax

#include <rpc/rpc.h>

enum clnt_stat pmap_rmtcall (addr, prognum, versnum, procnum) enum clnt_stat pmap_rmtcall (inproc, in, outproc, out, tout, portp)
struct sockaddr_in *addr;
u_long prognum, versnum, procnum;
xdrproc_t inproc;
char *in;
xdrproc_t outproc;
char *out;
struct timeval tout;
u_long *portp;

Description

The pmap_rmtcall subroutine is a user interface to the portmap daemon. The routine instructs the host portmap daemon to make a remote procedure call (RPC). Clients consult the portmap daemon when sending out RPC calls for given program numbers. The portmap daemon tells the client the ports to which to send the calls.

Parameters

addr	Points to the Internet Protocol (IP) address of the host where the remote program that supports the waiting service resides.
prognum	Specifies the program number of the remote program.
versnum	Specifies the version number of the remote program.
procnum	Identifies the procedure to be called.
inproc	Specifies the eXternal Data Representation (XDR) routine that encodes the remote procedure parameters.
in	Points to the address of the procedure arguments.
outproc	Specifies the XDR routine that decodes the remote procedure results.
out	Points to the address where the results are placed.
tout	Sets the time the routine waits for the results to return before sending the call again.
portp	Points to the program port number if the procedure succeeds.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The clnt_broadcast subroutine.

The portmap daemon.

List of RPC Programming References.

Internet Protocol (IP) in AIX Version 4.3 System Management Guide: Communications and Networks.

eXternal Data Representation (XDR) Overview for Programming and Remote Procedure Call (RPC) Overview for Programming in AIX Version 4.3 Communications Programming Concepts.