rpcb_set()--Register the Server Address with the RPCBind

 #include <rpc/rpc.h>
 #include <netconfig.h>

 bool_t rpcb_set(const u_long prognum,
                 const u_long versnum,
                 const struct netconfig *netconf,
                 const struct netbuf *svcaddr);

The rpcb_set() function is an interface to the RPC service package (RPCBind) daemon. The function establishes a mapping between the triple (prognum, versnum, netconf->nc_netid) and svcaddr on the machine's RPCBind service. The value of netconf->nc_netid must correspond to a network identifier that is defined by the netconfig database.

Parameters

prognum  (Input) 

The program number of the remote program.

vernum  (Input) 

The version number of the remote program.

netconf  (Input) 

The transport protocol.

svcaddr  (Input) 

A pointer to the local address of the service.

Authorities

No authorization is required.

Return Value

Error Conditions

Upon failure, rpcb_set() sets the global structure rpc_createerr. The rpc_createerr.cf_stat variable contains a status value, which indicates the error reason. The rpc_createerr.cf_error.re_errno variable is meaningful when some status values are set.

The rpc_createerr.cf_stat variable can be set to one of the following values:

This API calls clnt_tli_create() and clnt_call() APIs in order to perform its task. It inherits RPC_SYSTEMERROR from clnt_tli_create() API and it inherits all error conditions from clnt_call() API except RPC_TIMEDOUT and RPC_FAILED.

Error Messages

Related Information

• rpcb_unset()--Unregister Their Addresses

Example

See Code disclaimer information for information pertaining to code examples.

The following example shows how rpcb_set() is used:

/* Define remote program number and version */
#define RMTPROGNUM (u_long)0x3fffffffL
#define RMTPROGVER (u_long)0x1

#include <stdio.h>
#include <rpc/rpc.h>
#include <netconfig.h>

main()
{
  struct netconfig *nconf;
  struct netbuf *svcaddr;

  ...

  /* Returns a pointer to nconf corresponding to NETCONF */
  if ((nconf = getnetconfigent("UDP")) ==
               (struct netconfig *)NULL) {
    fprintf(stderr, "Cannot get netconfig entry for UDP\n");
    exit(1);
  }

  ...

  /* Register to the RPCBind */
  if (!rpcb_set(RMTPROGNUM, RMTPROGVER, nconf, svcaddr)){
    fprintf(stderr, "rpcb_set failed!!\n");
    exit(1);
  }

  ...

}