svc_tp_create()--Create a Server Handle

 #include <rpc/rpc.h>

 SVCXPRT svc_tp_create(const void
                 (*dispatch)(const svc_req *,
                      const SVCXPRT *),
                  const u_long prognum,
                  const u_long versnum,
                  const struct netconfig *netconf);

The svc_tp_create() function creates a server handle for the network specified by netconf, and registers itself with the RPC service package (RPCBind).

Parameters

dispatch()  (Input) 

The server dispatch function. dispatch() is called when there is a remote procedure call for the given prognum and versnum. The call to dispatch requires calling svc_run() on the server side.

prognum  (Input) 

The program number of the remote program.

vernum  (Input) 

The version number of the remote program.

netconf  (Input) 

The transport protocol to use.

Authorities

No authorization is needed.

Return Value

Error Conditions

This API calls svc_tli_create() and svc_reg() functions in order to perform its task. It inherits all error conditions from those functions, except setnetconfig() and getnetconfig() errors and RPC_UNKNOWNADDR from svc_reg().

Error Messages

Related Information

• svc_create()--Create a Server Handle
• svc_tli_create()--Create a Server Handle

Example

See Code disclaimer information for information pertaining to code examples.

The following example shows how svc_tp_create() 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>

static void exm_proc();
/* Dispatcher routine, defined later in program */

main()
{
  SVCXPRT *transp;
  struct netconfig *nconf;

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

  transp = svc_tp_create(exm_proc, RMTPROGNUM, RMTPROGVER,
                                    nconf);
  if (transp == (SVCXPRT *)NULL) {
    fprintf(stderr, "Cannot create service.\n");
    exit(1);
  }

  ...
  svc_run();
}

/* The server dispatch function */
static void exm_proc(struct svc_req *rqstp, SVCXPRT *transp)
{

  ...

}