getrpcbyname()

The getrpcbyname() call returns an RPC program entry specified by a name in the RPC file.

Syntax

#include <rpcnetdb.h>

struct rpcent *getrpcbyname(name)
char  *name;

Parameters

name

Pointer to the specified RPC program.

Description

The getrpcbyname() call sequentially searches from the beginning of the TCPIP\ETC\RPC file until it finds a matching RPC program name or encounters EOF.

Return Values

The getrpcbyname() call returns a pointer to an object with the rpcent structure for the RPC program specified on the call. The rpcent structure is defined in the <RPC\RPCNETDB.H> header file and contains the following elements:

Element

Description

ThenameoftheserverforthisRPCprogram

AzeroterminatedlistofalternatenamesfortheRPCprogram

TheRPCprogramnumberforthisservice

The return value points to static data that later calls overwrite. A pointer to an rpcent structure indicates success. A NULL pointer indicates an error or EOF.

Related Calls

getrpcbynumber() getrpcent()