svc_create()--Create a Server Handle

 #include <rpc/rpc.h>

 int svc_create(const void
                (*dispatch)(const svc_req *,
                     const  SVCXPRT *),
                const u_long prognum,
                const u_long versnum,
                const char *nettype);

The svc_create() function creates server handles for all the transports belonging to the class nettype.

svc_create() tries all the transports of the nettype class that are available from the /etc/netconfig file in top-to-bottom order. svc_create() registers itself with the RPCBind service.

Parameters

dispatch  (Input) 

The server dispatch function. dispatch is called when there is a remote procedure call for the given prognum and versnum.

prognum  (Input) 

The program number of the remote program.

vernum  (Input) 

The version number of the remote program

nettype  (Input) 

The following classes of transport protocol are valid: NETPATH, VISIBLE, CIRCUIT_V, DATAGRAM_V, CIRCUIT_N, DATAGRAM_N, TCP, and UDP.

Authorities

The caller of the svc_create() API must have execute (*X) authority to the /etc directory and must have read (*R) authority to the netconfig file.

Return Value

Error Conditions

This API calls setnetconfig() and getnetconfig() APIs in order to perform its task. The API inherits all error conditions from those APIs. It also inherits all error conditions from svc_tp_create() API except EINVAL.

Error Messages

Related Information

• svc_tp_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_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>

static void exm_proc();

main()
{
  int transpnum;

  ...
  transpnum = svc_create(exm_proc, RMTPROGNUM, RMTPROGVER,
                                    "VISIBLE");
  if (transpnum == 0){
    fprintf(stderr, "Cannot create a service.\n");
    exit(1);
  }
  svc_run();        /* No return */
}

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

  ...

}