Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought



RPC(3N)                 COMMAND REFERENCE                 RPC(3N)



NAME
     rpc - library routines for remote procedure calls

DESCRIPTION
     These routines allow C programs to make procedure calls on
     other machines across the network.  First, the client calls
     a procedure sending a data packet to the server.  Upon
     receipt of the packet, the server calls a dispatch routine
     performing the requested service, and then sends back a
     reply.  Finally, the procedure call returns to the client.

     Functions

     auth_destroy()      Destroy authentication information
                         handle

     authnone_create()   Return RPC authentication handle with no
                         checking

     authunix_create()   Return RPC authentication handle with
                         UNIXr permissions

     authunix_create_default()
                         Return default UNIXr authentication
                         handle

     callrpc()           Call remote procedure, given
                         [prognum,versnum,procnum]

     clnt_broadcast()    Broadcast remote procedure call
                         everywhere

     clnt_call()         Call remote procedure associated with
                         client handle

     clnt_destroy()      Destroy client's RPC handle

     clnt_freeres()      Free data allocated by RPC/XDR system
                         when decoding results

     clnt_geterr()       Copy error information from client
                         handle to error structure

     clnt_pcreateerror() Print message to stderr about why client
                         handle creation failed

     clnt_perrno()       Print message to stderr corresponding to
                         condition given

     clnt_perror()       Print message to stderr about why RPC
                         call failed




Printed 3/13/89                                                 1





RPC(3N)                 COMMAND REFERENCE                 RPC(3N)



     clnt_sperrno()      Print message to a string corresponding
                         to condition given

     clnt_sperror()      Print message to a string

     clntraw_create()    Create toy RPC client for simulation

     clnttcp_create()    Create RPC client using TCP transport

     clntudp_create()    Create RPC client using UDP transport

     get_myaddress()     Get the machine's IP address

     pmap_getmaps()      Return list of RPC program-to-port
                         mappings

     pmap_getport()      Return port number on which waits
                         supporting service

     pmap_rmtcall()      Instructs portmapper to make an RPC call

     pmap_set()          Establish mapping between
                         [prognum,versnum,procnum] and port

     pmap_unset()        Destroy mapping between
                         [prognum,versnum,procnum] and port

     registerrpc()       Register procedure with RPC service
                         package

     rpc_createerr       Global variable indicating reason why
                         client creation failed

     svc_destroy()       Destroy RPC service transport handle

     svc_fds             Global variable with RPC service file
                         descriptor mask

     svc_freeargs()      Free data allocated by RPC/XDR system
                         when decoding arguments

     svc_getargs()       Decodes the arguments of an RPC request

     svc_getcaller()     Get the network address of the caller of
                         a procedure

     svc_getreq()        Returns when all associated sockets have
                         been serviced

     svc_register()      Associates prognum and versnum with
                         service dispatch procedure




Printed 3/13/89                                                 2





RPC(3N)                 COMMAND REFERENCE                 RPC(3N)



     svc_run()           Wait for RPC requests to arrive and call
                         appropriate service

     svc_sendreply()     Send back results of a remote procedure
                         call

     svc_unregister()    Remove mapping of [prognum,versnum] to
                         dispatch routines

     svcerr_auth()       Called when refusing service because of
                         authentication error

     svcerr_decode()     Called when service cannot decode its
                         parameters

     svcerr_noproc()     Called when service hasn't implemented
                         the desired procedure

     svcerr_noprog()     Called when program is not registered
                         with RPC package

     svcerr_progvers()   Called when version is not registered
                         with RPC package

     svcerr_systemerr()  Called when service detects system error

     svcerr_weakauth()   Called when refusing service because of
                         insufficient authentication

     svcraw_create()     Creates a toy RPC service transport for
                         testing

     svctcp_create()     Creates an RPC service based on TCP
                         transport

     svcudp_create()     Creates an RPC service based on UDP
                         transport

     xdr_accepted_reply()
                         Generates RPC-style replies without
                         using RPC package

     xdr_authunix_parms()
                         Generates UNIXr credentials without
                         using RPC package

     xdr_callhdr()       Generates RPC-style headers without
                         using RPC package

     xdr_callmsg()       Generates RPC-style messages without
                         using RPC package




Printed 3/13/89                                                 3





RPC(3N)                 COMMAND REFERENCE                 RPC(3N)



     xdr_opaque_auth()   Describes RPC messages, externally

     xdr_pmap()          Describes parameters for portmap
                         procedures, externally

     xdr_pmaplist()      Describes a list of port mappings,
                         externally

     xdr_rejected_reply()
                         Generates RPC-style rejections without
                         using RPC package

     xdr_replymsg()      Generates RPC-style replies without
                         using RPC package

     xprt_register()     Registers RPC service transport with RPC
                         package

     xprt_unregister()   Unregisters RPC service transport from
                         RPC package

REFERENCES
     RPC Programming Guide in The Network File System, Tektronix
     part number 070-6628-00.































Printed 3/13/89                                                 4



%%index%%
na:240,101;
de:341,2291;2944,2314;5570,2248;8130,874;
re:9004,312;
%%index%%000000000100

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026