rpc_soc.3n (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

rpc_soc(3N) rpc_soc(3N)

(OBSOLETE)

NAME

rpc_soc: authdes_create(), authunix_create(), authunix_create_default(), callrpc(), clnt_broadcast(),

clntraw_create(), clnttcp_create(), clntudp_bufcreate(), clntudp_create(), get_myaddress(),

pmap_getmaps(), pmap_getport(), pmap_rmtcall(), pmap_set(), pmap_unset(), registerrpc(), svc_fds,

svc_getcaller(), svc_getreq(), svc_register(), svc_unregister(), svcfd_create(), svcraw_create(),

svctcp_create(), svcudp_bufcreate(), svcudp_create(), xdr_authunix_parms() - obsolete library routines for

RPC

SYNOPSIS

#define PORTMAP

#include <rpc/rpc.h>

AUTH *authdes_create(char *

name, u_int

window, struct sockaddr_in *syncaddr,

des_block *ckey);

AUTH *authunix_create(char *

host , uid_t

uid, gid_t gid, int grouplen , gid_t

*gidlistp );

AUTH *authunix_create_default(void);

callrpc(char *host , rpcprog_t prognum, rpcvers_t

versnum , rpcproc_t procnum ,

xdrproc_t inproc , char *in, xdrproc_t

outproc , char *out);

enum clnt_stat clnt_broadcast(rpcprog_t

prognum, rpcvers_t versnum ,

rpcproc_t procnum, xdrproc_t inproc, char *in, xdrproc_t outproc , char *out ,

resultproc_t eachresult );

CLIENT *clntraw_create(rpcprog_t

prognum, rpcvers_t versnum);

CLIENT *clnttcp_create(struct sockaddr_in *

addr, rpcprog_t prognum,

rpcvers_t versnum , int *fdp, u_int sendsz, u_int recvsz);

CLIENT *clntudp_bufcreate(struct sockaddr_in *

addr, rpcprog_t prognum,

rpcvers_t versnum , struct timeval wait , int *fdp, u_int sendsz , u_int

recvsz );

CLIENT *clntudp_create(struct sockaddr_in *

addr, rpcprog_t prognum,

rpcvers_t versnum , struct timeval wait , int *fdp );

void get_myaddress(struct sockaddr_in *

addr);

struct pmaplist *pmap_getmaps(struct sockaddr_in *

addr);

u_short pmap_getport(struct sockaddr_in *

addr, rpcprog_t prognum, rpcvers_t

versnum , rpcprot_t protocol );

enum clnt_stat pmap_rmtcall(struct sockaddr_in *

addr, rpcprog_t prognum ,

rpcvers_t versnum , rpcproc_t procnum , xdrproct_t inproc , char *in,

xdrproct_t outproc , char *out, struct timeval tout , rpcport_t *portp );

bool_t pmap_set(rpcprog_t prognum, rpcvers_t versnum , rpcprot_t protocol ,

u_short port );

bool_t pmap_unset(rpcprog_t prognum, rpcvers_t versnum);

int svc_fds;

struct sockaddr_in *svc_getcaller(SVCXPRT *xprt );

void svc_getreq(int rdfds);

SVCXPRT *svcfd_create(int fd, u_int sendsz, u_int recvsz);

SVCXPRT *svcraw_create(void);

SVCXPRT *svctcp_create(int fd, u_int sendsz, u_int recvsz);

SVCXPRT *svcudp_bufcreate(int fd, u_int sendsz, u_int recvsz);

SVCXPRT *svcudp_create(int fd);

registerrpc(rpcprog_t prognum , rpcvers_t versnum , rpcproc_t procnum , char

*(*procname )(), xdrproc_t inproc , xdrproc_t outproc );

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (8 pages)

PAGE 1
rpc_soc(3N) rpc_soc(3N) (OBSOLETE) NAME rpc_soc: authdes_create(), authunix_create(), authunix_create_default(), callrpc(), clnt_broadcast(), clntraw_create(), clnttcp_create(), clntudp_bufcreate(), clntudp_create(), get_myaddress(), pmap_getmaps(), pmap_getport(), pmap_rmtcall(), pmap_set(), pmap_unset(), registerrpc(), svc_fds, svc_getcaller(), svc_getreq(), svc_register(), svc_unregister(), svcfd_create(), svcraw_create(), svctcp_create(), svcudp_bufcreate(), svcudp_create(), xdr_authunix_parms() - obs
PAGE 2
rpc_soc(3N) rpc_soc(3N) (OBSOLETE) bool_t svc_register(SVCXPRT *xprt , rpcprog_t prognum , rpcvers_t versnum , void (*dispatch )(), rpcprot_t protocol ); void svc_unregister(rpcprog_t prognum , rpcvers_t versnum ); bool_t xdr_authunix_parms(XDR *xdrs , struct authunix_parms *aupp ); DESCRIPTION RPC routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a request to the server.
PAGE 3
rpc_soc(3N) rpc_soc(3N) (OBSOLETE) AUTH *authunix_create_default() Call authunix_create() with the appropriate parameters. Warning: this routine exists for backward compatibility only, and is made obsolete by authsys_create_default() (see rpc_clnt_auth(3N)). callrpc() Call the remote procedure associated with prognum , versnum , and procnum on the machine, host .
PAGE 4
rpc_soc(3N) rpc_soc(3N) (OBSOLETE) descriptor, which may be open and bound. If it is RPC_ANYSOCK, then this routine opens a new one and sets *fdp . Refer to the File Descriptor section for more information. The UDP transport resends the call message in intervals of wait time until a response is received or until the call times out. The total time for the call to time out is specified by clnt_call() (see rpc_clnt_calls(3N)). If successful it returns a client handle, otherwise it returns NULL.
PAGE 5
rpc_soc(3N) rpc_soc(3N) (OBSOLETE) Warning: this routine exists for backward compatibility only, enhanced functionality is provided by rpcb_getaddr() (see rpcbind (3N)). enum clnt_stat pmap_rmtcall() Request that the portmap on the host at IP address *addr make an RPC on the behalf of the caller to a procedure on that host. *portp is modified to the program’s port number if the procedure succeeds. The definitions of other parameters are discussed in callrpc() and clnt_call() (see rpc_clnt_calls(3N)).
PAGE 6
rpc_soc(3N) rpc_soc(3N) (OBSOLETE) Warning: this interface is made obsolete by svc_fd_create() (see rpc_svc_create(3N)). SVCXPRT *svcraw_create(); This routine creates an internal, memory-based RPC service transport, to which it returns a pointer. The transport is really a buffer within the process’ address space, so the corresponding RPC client should live in the same address space; see clntraw_create(3N).
PAGE 7
rpc_soc(3N) rpc_soc(3N) (OBSOLETE) mapping of the triple [prognum , versnum , protocol ] to xprt→xp_port is established with the local portmap service (generally, protocol is 0, IPPROTO_UDP, or IPPROTO_TCP). The procedure dispatch has the following form: dispatch(struct svc_req *request , SVCXPRT *xprt ); The svc_register() routine returns 1 if it succeeds, and 0 otherwise.
PAGE 8
(Notes) A (Notes) rA 8 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010