[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Communications Technical Reference, Volume 1

clntraw_create Subroutine

Purpose

Creates a toy Remote Procedure Call (RPC) client for simulation.

Library

C Library (libc.a)

Syntax

#include <rpc/rpc.h>
CLIENT *clntraw_create (prognum, versnum)
u_long prognum, versnum;

Description

The clntraw_create subroutine creates a toy RPC client for simulation of a remote program. This toy client uses a buffer located within the address space of the process for the transport to pass messages to the service. If the corresponding RPC server lives in the same address space, simulation of RPC and acquisition of RPC overheads, such as round-trip times, are done without kernel interference.

Parameters

prognum Specifies the program number of the remote program.
versnum Specifies the version number of the remote program.

Return Values

Upon successful completion, this subroutine returns a pointer to a valid RPC client. If unsuccessful, it returns a value of NULL.

Implementation Specifics

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

Related Information

The clnt_pcreateerror subroutine, svcraw_create subroutine.

List of RPC Programming References.

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


[ Previous | Next | Contents | Glossary | Home | Search ]