RPCBIND(3N-SVR4)    RISC/os Reference Manual     RPCBIND(3N-SVR4)



NAME
     rpcbind: rpcb_getmaps, rpcb_getaddr, rpcb_gettime,
          rpcb_rmtcall, rpcb_set, rpcb_unset - library routines
          for RPC bind service

DESCRIPTION
     These routines allow client C programs to make procedure
     calls to the RPC binder service.  rpcbind [see rpcbind(1M)]
     maintains a list of mappings between programs and their
     universal addresses.

   Routines
     #include <rpc/rpc.h>

     struct rpcblist *
     rpcbgetmaps(const struct netconfig *netconf, const char *host);

          A user interface to the rpcbind service, which returns
          a list of the current RPC program-to-address mappings
          on the host named.  It uses the transport specified
          through netconf to contact the remote rpcbind service
          on host host.  This routine will return NULL, if the
          remote rpcbind could not be contacted.

     boolt
     rpcbgetaddr(const ulong prognum, const ulong versnum,
          const struct netconfig *netconf, struct netbuf *svcaddr,
          const char *host);

          A user interface to the rpcbind service, which finds
          the address of the service on host that is registered
          with program number prognum, version versnum, and
          speaks the transport protocol associated with netconf.
          The address found is returned in svcaddr.  svcaddr
          should be preallocated.  This routine returns 1 if it
          succeeds.  A return value of 0 means that the mapping
          does not exist or that the RPC system failed to contact
          the remote rpcbind service.  In the latter case, the
          global variable rpc_createerr contains the RPC status.

     boolt
     rpcbgettime(const char *host, timet *timep);

          This routine returns the time on host in timep.  If
          host is NULL, rpcbgettime returns the time on its own
          machine.  This routine returns 1 if it succeeds, 0 if
          it fails.  rpcbgettime can be used to synchronize the
          time between the client and the remote server. This
          routine is particularly useful for secure RPC.

     enum clntstat
     rpcbrmtcall(const struct netconfig *netconf, const char *host,



                        Printed 11/19/92                   Page 1

RPCBIND(3N-SVR4)    RISC/os Reference Manual     RPCBIND(3N-SVR4)



          const ulong prognum, const ulong versnum, const ulong procnum,
          const xdrproct inproc, const caddrt in,
          const xdrproct outproc, const caddrt out,
          const struct timeval tout, struct netbuf  *svcaddr);

          A user interface to the rpcbind service, which
          instructs rpcbind on host to make an RPC call on your
          behalf to a procedure on that host.  The parameter
          *svcaddr will be modified to the server's address if
          the procedure succeeds [see rpc_call and clnt_call in
          rpc_clnt_calls(3N) for the definitions of other parame-
          ters].  This procedure should normally be used for a
          ping and nothing else [see rpc_broadcast in
          rpc_clnt_calls(3N)].  This routine allows programs to
          do lookup and call, all in one step.

     boolt
     rpcbset(const ulong prognum, const ulong versnum,
          const struct netconfig *netconf, const struct netbuf *svcaddr);

          A user interface to the rpcbind service, which estab-
          lishes a mapping between the triple [prognum, versnum,
          netconf->nc_netid] and svcaddr on the machine's rpcbind
          service.  The value of transport must correspond to a
          network token that is defined by the netconfig data-
          base.  This routine returns 1 if it succeeds, 0 other-
          wise.  [See also svc_reg in rpc_svc_calls(3N)].

     boolt
     rpcbunset(const ulong prognum, const ulong versnum,
          const struct netconfig *netconf);

          A user interface to the rpcbind service, which destroys
          all mapping between the triple [prognum, versnum,
          netconf->nc_netid] and the address on the machine's
          rpcbind service.  If netconf is NULL, rpcbunset des-
          troys all mapping between the triple [prognum, versnum,
          *] and the addresses on the machine's rpcbind service.
          This routine returns 1 if it succeeds, 0 otherwise.
          [See also svc_unreg in rpc_svc_calls(3N)].

SEE ALSO
     rpc_clnt_calls(3N), rpc_svc_calls(3N), rpcbind(1M),
     rpcinfo(1M).











 Page 2                 Printed 11/19/92