[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, 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 (addrprognumversnumprocnum) enum clnt_stat pmap_rmtcall (inprocinoutprocouttoutportp)
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 5L Version 5.1 System Management Guide: Communications and Networks.

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


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]