[ новости /+++ | форум | теги | ]

NAME

rpc_svc_reg

 
rpc_reg

 
svc_reg

 
svc_unreg

 
svc_auth_reg

 
xprt_register

 
xprt_unregister

 - library routines for registering servers

 

LIBRARY

Lb libc

 

SYNOPSIS

DESCRIPTION

Routines

Fn rpc_reg

Register program Fa prognum , procedure Fa procname , and version Fa versnum with the RPC service package. If a request arrives for program Fa prognum , version Fa versnum , and procedure Fa procnum , Fa procname is called with a pointer to its argument(s); Fa procname should return a pointer to its static result(s); Fa inproc is the XDR function used to decode the arguments while Fa outproc is the XDR function used to encode the results. Procedures are registered on all available transports of the class Fa nettype . See rpc(3). This routine returns 0 if the registration succeeded, -1 otherwise.

Fn svc_reg

Associates Fa prognum and Fa versnum with the service dispatch procedure, Fa dispatch . If Fa netconf is NULL the service is not registered with the rpcbind(8) service. If Fa netconf is non-zero, then a mapping of the triple Bq Fa prognum , versnum , netconf->nc_netid to Fa xprt->xp_ltaddr is established with the local rpcbind service.

The svc_reg ();
routine returns 1 if it succeeds, and 0 otherwise.

Fn svc_unreg

Remove from the rpcbind service, all mappings of the triple Bq Fa prognum , versnum , No all-transports to network address and all mappings within the RPC service package of the double Bq Fa prognum , versnum to dispatch routines.

Fn svc_auth_reg

Registers the service authentication routine Fa handler with the dispatch mechanism so that it can be invoked to authenticate RPC requests received with authentication type Fa cred_flavor . This interface allows developers to add new authentication types to their RPC applications without needing to modify the libraries. Service implementors usually do not need this routine.

Typical service application would call svc_auth_reg ();
after registering the service and prior to calling svc_run (.);
When needed to process an RPC credential of type Fa cred_flavor , the Fa handler procedure will be called with two arguments, Fa struct svc_req *rqst and Fa struct rpc_msg *msg , and is expected to return a valid Vt enum auth_stat value. There is no provision to change or delete an authentication handler once registered.

The svc_auth_reg ();
routine returns 0 if the registration is successful, 1 if Fa cred_flavor already has an authentication handler registered for it, and -1 otherwise.

Fn xprt_register

After RPC service transport handle Fa xprt is created, it is registered with the RPC service package. This routine modifies the global variable svc_fdset (see rpc_svc_calls3). Service implementors usually do not need this routine.

Fn xprt_unregister

Before an RPC service transport handle Fa xprt is destroyed, it unregisters itself with the RPC service package. This routine modifies the global variable svc_fdset (see rpc_svc_calls3). Service implementors usually do not need this routine.

SEE ALSO

Index

NAME

LIBRARY

SYNOPSIS

DESCRIPTION

Routines

SEE ALSO

Партнёры:

Хостинг: