svc_tp_create()--Create a Server Handle
Syntax
#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);
Service Program Name: QZNFTRPC
Default Public Authority: *USE
Threadsafe: No
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
xprt | Upon successful completion, this function returns the service handle. |
NULL | svc_tp_create() was not successful. The errno variable is set to indicate the reason. |
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
Message ID | Error Message Text |
---|---|
CPIA1B1 I | A problem was encountered in the RPC client. |
CPIA1B2 I | TI-RPC encountered a problem in the transport protocol. |
CPIA1B3 I | TI-RPC encountered a problem in the server. |
CPIA1B8 I | A problem occurred while trying to contact the RPCBind daemon. |
CPE3418 E | Possible APAR condition or hardware failure. |
CPF3CF2 E | Error(s) occurred during running of &1 API. |
CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
Related Information
Example
The following example shows how svc_tp_create() is used.
Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.
/* 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) { ... }
API introduced: V4R2
[ Back to top | Remote Procedure Call (RPC) APIs | APIs by category ]