HP-UX Reference (11i v2 04/09) - 3 Library Functions N-Z (vol 7)

r
rpc_svc_create(3N) rpc_svc_create(3N)
NAME
rpc_svc_create(), svc_control(), svc_create(), svc_destroy(), svc_dg_create(), svc_fd_create(),
svc_raw_create(), svc_tli_create(), svc_tp_create(), svc_vc_create() - library routines for the creation of
server handles
SYNOPSIS
#include <rpc/rpc.h>
bool_t svc_control (SVCXPRT *
svc, const u_int
req, void *info);
int svc_create(const void (*
dispatch )(const struct svc_req *,
const SVCXPRT *), const u_long prognum, const u_long
versnum,
const char *nettype );
void svc_destroy(SVCXPRT *
xprt);
SVCXPRT1 *svc_dg_create(const int
fildes, const u_int
sendsz,
const u_int recvsz);
SVCXPRT *svc_fd_create(const int
fildes, const u_int
sendsz,
const u_int recvsz);
SVCXPRT *svc_raw_create(void);
SVCXPRT *svc_tli_create(const int
fildes, const struct netconfig *netconf ,
const struct t_bind *bindaddr, const u_int sendsz, const u_int recvsz);
SVCXPRT *svc_tp_create(const void (*
dispatch )(const struct svc_req *,
const SVCXPRT *), const u_long prognum,
const u_long versnum, const struct netconfig *netconf );
SVCXPRT *svc_vc_create(const int
fildes, const u_int sendsz,
const u_int recvsz);
DESCRIPTION
These routines are part of the RPC library which allows C language programs to make procedure calls on
servers across the network. These routines deal with the creation of service handles. Once the handle is
created, the server can be invoked by calling svc_run().
The HP-UX implementation of RPC only supports the X/Open Transport Interface (XTI). Applications
that are written using the Transport Layer Interface (TLI) and wish to use RPC, must convert their appli-
cation to XTI.
Routines
See rpc(3N) for the definition of the
SVCXPRT data structure.
bool_t svc_control()
A function to change or retrieve various information about a service object. req indicates the type of
operation and info is a pointer to the information. The supported values of req, their argument
types, and what they do are:
SVCGET_VERSQUIET
If a request is received for a program number served by this server but the
version number is outside the range registered with the server, an
RPC_PROGVERSMISMATCH error will normally be returned. info should
be a pointer to an integer. Upon successful completion of the
SVCGET_VERSQUIET request, *info contains an integer which describes
the server’s current behavior: 0 indicates normal server behavior (that is,
an RPC_PROGVERSMISMATCH error will be returned); 1 indicates that the
out of range request will be silently ignored.
SVCSET_VERSQUIET
If a request is received for a program number served by this server but the
version number is outside the range registered with the server, an
RPC_PROGVERSMISMATCH error will normally be returned. It is some-
times desirable to change this behavior. info should be a pointer to an
integer which is either 0 (indicating normal server behavior - an
RPC_PROGVERSMISMATCH error will be returned), or 1 (indicating that
the out of range request should be silently ignored).
HP-UX 11i Version 2: September 2004 − 1 − Hewlett-Packard Company Section 3−−921