Manualshelf

rpc_svc_create.3n (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
1234
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 );
SVCXPRT *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
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)