xref: /freebsd/include/rpc/pmap_clnt.h (revision f126890a)
1 /*	$NetBSD: pmap_clnt.h,v 1.9 2000/06/02 22:57:55 fvdl Exp $	*/
2 
3 /*-
4  * SPDX-License-Identifier: BSD-3-Clause
5  *
6  * Copyright (c) 2009, Sun Microsystems, Inc.
7  * All rights reserved.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions are met:
11  * - Redistributions of source code must retain the above copyright notice,
12  *   this list of conditions and the following disclaimer.
13  * - Redistributions in binary form must reproduce the above copyright notice,
14  *   this list of conditions and the following disclaimer in the documentation
15  *   and/or other materials provided with the distribution.
16  * - Neither the name of Sun Microsystems, Inc. nor the names of its
17  *   contributors may be used to endorse or promote products derived
18  *   from this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
24  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30  * POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 /*
34  * pmap_clnt.h
35  * Supplies C routines to get to portmap services.
36  *
37  * Copyright (C) 1984, Sun Microsystems, Inc.
38  */
39 
40 /*
41  * Usage:
42  *	success = pmap_set(program, version, protocol, port);
43  *	success = pmap_unset(program, version);
44  *	port = pmap_getport(address, program, version, protocol);
45  *	head = pmap_getmaps(address);
46  *	clnt_stat = pmap_rmtcall(address, program, version, procedure,
47  *		xdrargs, argsp, xdrres, resp, tout, port_ptr)
48  *		(works for udp only.)
49  * 	clnt_stat = clnt_broadcast(program, version, procedure,
50  *		xdrargs, argsp,	xdrres, resp, eachresult)
51  *		(like pmap_rmtcall, except the call is broadcasted to all
52  *		locally connected nets.  For each valid response received,
53  *		the procedure eachresult is called.  Its form is:
54  *	done = eachresult(resp, raddr)
55  *		bool_t done;
56  *		caddr_t resp;
57  *		struct sockaddr_in raddr;
58  *		where resp points to the results of the call and raddr is the
59  *		address if the responder to the broadcast.
60  */
61 
62 #ifndef _RPC_PMAP_CLNT_H_
63 #define _RPC_PMAP_CLNT_H_
64 #include <sys/cdefs.h>
65 
66 __BEGIN_DECLS
67 extern bool_t		pmap_set(u_long, u_long, int, int);
68 extern bool_t		pmap_unset(u_long, u_long);
69 extern struct pmaplist	*pmap_getmaps(struct sockaddr_in *);
70 extern enum clnt_stat	pmap_rmtcall(struct sockaddr_in *,
71 				     u_long, u_long, u_long,
72 				     xdrproc_t, caddr_t,
73 				     xdrproc_t, caddr_t,
74 				     struct timeval, u_long *);
75 extern enum clnt_stat	clnt_broadcast(u_long, u_long, u_long,
76 				       xdrproc_t, void *,
77 				       xdrproc_t, void *,
78 				       resultproc_t);
79 extern u_short		pmap_getport(struct sockaddr_in *,
80 				     u_long, u_long, u_int);
81 __END_DECLS
82 
83 #endif /* !_RPC_PMAP_CLNT_H_ */
84