getrpcport(3RPC)

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUES | RESTRICTIONS | ATTRIBUTES

NAME

getrpcport- get RPC port number

SYNOPSIS

$(OS_DIR)/lib/librpc.a

int getrpcport(char *host, int prognum, int versnum, int proto);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

FEATURES

POSIX_SOCKETS

DESCRIPTION

The getrpcport() function returns the port number for version versnum, of the RPC program prognum, running on host and using protocol proto. Version mismatch is detected upon the first call to the service.

RETURN VALUES

getrpcport() returns 0 if it cannot contact the port mapper, or if prognum is not registered. If prognum is registered but not with version versnum, it will still return a port number (for some versions of the program) indicating that the program is registered.

RESTRICTIONS

This library call does not support multi-threaded applications.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving
MT-Level	Unsafe

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUES | RESTRICTIONS | ATTRIBUTES