1 .\" @(#)rpcbind.3n 1.25 93/05/07 SMI; from SVr4
2 .\" Copyright 1989 AT&T
3 .\" Copyright (c) 1988 Sun Microsystem's, Inc. - All Right's Reserved.
4 .\" $NetBSD: rpcbind.3,v 1.2 2000/06/03 18:47:28 fvdl Exp $
5 .\" $FreeBSD: src/lib/libc/rpc/rpcbind.3,v 1.5 2002/12/19 09:40:23 ru Exp $
16 .Nd library routines for RPC bind service
20 .Fn rpcb_getmaps "const struct netconfig *netconf" "const char *host"
22 .Fn rpcb_getaddr "const rpcprog_t prognum" "const rpcvers_t versnum" "const struct netconfig *netconf" "struct netbuf *svcaddr" "const char *host"
24 .Fn rpcb_gettime "const char *host" "time_t * timep"
26 .Fn rpcb_rmtcall "const struct netconfig *netconf" "const char *host" "const rpcprog_t prognum, const rpcvers_t versnum" "const rpcproc_t procnum, const xdrproc_t inproc" "const caddr_t in" "const xdrproc_t outproc" "const caddr_t out" "const struct timeval tout, const struct netbuf *svcaddr"
28 .Fn rpcb_set "const rpcprog_t prognum" "const rpcvers_t versnum" "const struct netconfig *netconf" "const struct netbuf *svcaddr"
30 .Fn rpcb_unset "const rpcprog_t prognum" "const rpcvers_t versnum" "const struct netconfig *netconf"
32 These routines allow client C programs to make procedure
33 calls to the RPC binder service.
36 maintains a list of mappings between programs
37 and their universal addresses.
41 An interface to the rpcbind service,
42 which returns a list of the current
43 RPC program-to-address mappings on
45 It uses the transport specified through
47 to contact the remote rpcbind
50 This routine will return
52 if the remote rpcbind could not be contacted.
54 An interface to the rpcbind
55 service, which finds the address of the service on
57 that is registered with program number
61 and speaks the transport protocol associated with
63 The address found is returned in
68 should be preallocated.
74 means that the mapping does not exist
76 system failed to contact the remote
78 In the latter case, the global variable
81 .Xr rpc_clnt_create 3 )
85 This routine returns the time on
94 returns the time on its own machine.
103 can be used to synchronize the time between the
104 client and the remote server.
106 An interface to the rpcbind service, which instructs
110 call on your behalf to a procedure on that host.
113 structure should correspond to a connectionless transport.
117 will be modified to the server's address if the procedure succeeds
124 for the definitions of other arguments).
126 This procedure should normally be used for a
129 This routine allows programs to do lookup and call, all in one step.
131 Note: Even if the server is not running
133 does not return any error messages to the caller.
134 In such a case, the caller times out.
138 is only available for connectionless transports.
140 An interface to the rpcbind
141 service, which establishes a mapping between the triple
142 .Bq Fa prognum , versnum , netconf->nc_netid
145 on the machine's rpcbind
149 must correspond to a network identifier that is defined by the
159 .Xr rpc_svc_calls 3 . )
160 If there already exists such an entry with rpcbind,
164 An interface to the rpcbind
165 service, which destroys the mapping between the triple
166 .Bq Fa prognum , versnum , netconf->nc_netid
167 and the address on the machine's rpcbind
174 destroys all mapping between the triple
175 .Bq Fa prognum , versnum , No all-transports
176 and the addresses on the machine's rpcbind service.
182 Only the owner of the service or the super-user can destroy the mapping.
186 .Xr rpc_svc_calls 3 . )
189 These functions are part of libtirpc.
191 .Xr rpc_clnt_calls 3 ,
192 .Xr rpc_svc_calls 3 ,