Libinfo-173.tar.gz
[apple/libinfo.git] / rpc.subproj / pmap_clnt.h
1 /*
2 * Copyright (c) 1999 Apple Computer, Inc. All rights reserved.
3 *
4 * @APPLE_LICENSE_HEADER_START@
5 *
6 * Copyright (c) 1999-2003 Apple Computer, Inc. All Rights Reserved.
7 *
8 * This file contains Original Code and/or Modifications of Original Code
9 * as defined in and that are subject to the Apple Public Source License
10 * Version 2.0 (the 'License'). You may not use this file except in
11 * compliance with the License. Please obtain a copy of the License at
12 * http://www.opensource.apple.com/apsl/ and read it before using this
13 * file.
14 *
15 * The Original Code and all software distributed under the License are
16 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
17 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
18 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
20 * Please see the License for the specific language governing rights and
21 * limitations under the License.
22 *
23 * @APPLE_LICENSE_HEADER_END@
24 */
25 /*
26 * Sun RPC is a product of Sun Microsystems, Inc. and is provided for
27 * unrestricted use provided that this legend is included on all tape
28 * media and as a part of the software program in whole or part. Users
29 * may copy or modify Sun RPC without charge, but are not authorized
30 * to license or distribute it to anyone else except as part of a product or
31 * program developed by the user.
32 *
33 * SUN RPC IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
34 * WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
35 * PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
36 *
37 * Sun RPC is provided with no support and without any obligation on the
38 * part of Sun Microsystems, Inc. to assist in its use, correction,
39 * modification or enhancement.
40 *
41 * SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
42 * INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY SUN RPC
43 * OR ANY PART THEREOF.
44 *
45 * In no event will Sun Microsystems, Inc. be liable for any lost revenue
46 * or profits or other special, indirect and consequential damages, even if
47 * Sun has been advised of the possibility of such damages.
48 *
49 * Sun Microsystems, Inc.
50 * 2550 Garcia Avenue
51 * Mountain View, California 94043
52 *
53 * from: @(#)pmap_clnt.h 1.11 88/02/08 SMI
54 * from: @(#)pmap_clnt.h 2.1 88/07/29 4.0 RPCSRC
55 * $Id: pmap_clnt.h,v 1.2 1999/10/14 21:56:53 wsanchez Exp $
56 */
57
58 /*
59 * pmap_clnt.h
60 * Supplies C routines to get to portmap services.
61 *
62 * Copyright (C) 1984, Sun Microsystems, Inc.
63 */
64
65 /*
66 * Usage:
67 * success = pmap_set(program, version, protocol, port);
68 * success = pmap_unset(program, version);
69 * port = pmap_getport(address, program, version, protocol);
70 * head = pmap_getmaps(address);
71 * clnt_stat = pmap_rmtcall(address, program, version, procedure,
72 * xdrargs, argsp, xdrres, resp, tout, port_ptr)
73 * (works for udp only.)
74 * clnt_stat = clnt_broadcast(program, version, procedure,
75 * xdrargs, argsp, xdrres, resp, eachresult)
76 * (like pmap_rmtcall, except the call is broadcasted to all
77 * locally connected nets. For each valid response received,
78 * the procedure eachresult is called. Its form is:
79 * done = eachresult(resp, raddr)
80 * bool_t done;
81 * caddr_t resp;
82 * struct sockaddr_in raddr;
83 * where resp points to the results of the call and raddr is the
84 * address if the responder to the broadcast.
85 */
86
87 #ifndef _RPC_PMAPCLNT_H
88 #define _RPC_PMAPCLNT_H
89 #include <sys/cdefs.h>
90
91 __BEGIN_DECLS
92 extern bool_t pmap_set __P((u_long, u_long, int, int));
93 extern bool_t pmap_unset __P((u_long, u_long));
94 extern struct pmaplist *pmap_getmaps __P((struct sockaddr_in *));
95 extern enum clnt_stat pmap_rmtcall __P((struct sockaddr_in *,
96 u_long, u_long, u_long,
97 xdrproc_t, caddr_t,
98 xdrproc_t, caddr_t,
99 struct timeval, u_long *));
100 extern enum clnt_stat clnt_broadcast __P((u_long, u_long, u_long,
101 xdrproc_t, char *,
102 xdrproc_t, char *,
103 bool_t (*)()));
104 extern u_short pmap_getport __P((struct sockaddr_in *,
105 u_long, u_long, u_int));
106 __END_DECLS
107
108 #endif /* !_RPC_PMAPCLNT_H */