pmap_set Subroutine

AIX Version 4.3 Communications Technical Reference, Volume 1

pmap_set Subroutine

Purpose

Maps a remote procedure call to a port.

Library

C Library (libc.a)

Syntax

#include <rpc/rpc.h>

pmap_set (prognum, versnum, protocol, port)
u_long prognum, versnum, protocol;
u_short port;

Description

The pmap_set subroutine acts as a user interface to the portmap daemon to map the program number, version number, and protocol of a remote procedure call to a port on the machine portmap daemon.

Note: The pmap_set subroutine is called by the svc_register subroutine.

Parameters

prognum	Specifies the program number of the remote program.
versnum	Specifies the version number of the remote program.
protocol	Specifies the transport protocol that the service recognizes. The values for this parameter can be IPPROTO_UDP or IPPROTO_TCP.
port	Specifies the port on the machine's portmap daemon.

Return Values

Upon successful completion, this routine returns a value of 1. If unsuccessful, it returns a value of 0.

Implementation Specifics

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

Related Information

The portmap daemon.

The pmap_getmaps subroutine, pmap_unset subroutine, svc_register subroutine.

TCP/IP Protocols in AIX Version 4.3 System Management Guide: Communications and Networks.

List of RPC Programming References.

Remote Procedure Call (RPC) Overview for Programming in AIX Version 4.3 Communications Programming Concepts.