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