xref: /dflybsd-src/include/rpcsvc/pmap_prot.x (revision c4bf625e67439f34b29bfd33c4e2555ffea63ce9)
1 %/*
2 % * Sun RPC is a product of Sun Microsystems, Inc. and is provided for
3 % * unrestricted use provided that this legend is included on all tape
4 % * media and as a part of the software program in whole or part.  Users
5 % * may copy or modify Sun RPC without charge, but are not authorized
6 % * to license or distribute it to anyone else except as part of a product or
7 % * program developed by the user.
8 % *
9 % * SUN RPC IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
10 % * WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
11 % * PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
12 % *
13 % * Sun RPC is provided with no support and without any obligation on the
14 % * part of Sun Microsystems, Inc. to assist in its use, correction,
15 % * modification or enhancement.
16 % *
17 % * SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
18 % * INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY SUN RPC
19 % * OR ANY PART THEREOF.
20 % *
21 % * In no event will Sun Microsystems, Inc. be liable for any lost revenue
22 % * or profits or other special, indirect and consequential damages, even if
23 % * Sun has been advised of the possibility of such damages.
24 % *
25 % * Sun Microsystems, Inc.
26 % * 2550 Garcia Avenue
27 % * Mountain View, California  94043
28 % *
29 % * @(#)pmap_prot.x	1.6	94/04/29 SMI
30 % * $DragonFly: src/include/rpcsvc/pmap_prot.x,v 1.2 2003/06/17 04:25:58 dillon Exp $
31 % */
32 %/*
33 % * Copyright (c) 1984,1989 by Sun Microsystems, Inc.
34 % */
35 
36 %/* from pmap_prot.x */
37 
38 #ifdef RPC_HDR
39 %
40 %#ifndef _KERNEL
41 %
42 #endif
43 
44 /*
45  * Port Mapper Protocol Specification (in RPC Language)
46  * derived from RFC 1057
47  */
48 
49 %/*
50 % * Protocol for the local binder service, or pmap.
51 % *
52 % * Copyright (C) 1984, Sun Microsystems, Inc.
53 % *
54 % * The following procedures are supported by the protocol:
55 % *
56 % * PMAPPROC_NULL() returns ()
57 % * 	takes nothing, returns nothing
58 % *
59 % * PMAPPROC_SET(struct pmap) returns (bool_t)
60 % * 	TRUE is success, FALSE is failure.  Registers the tuple
61 % *	[prog, vers, prot, port].
62 % *
63 % * PMAPPROC_UNSET(struct pmap) returns (bool_t)
64 % *	TRUE is success, FALSE is failure.  Un-registers pair
65 % *	[prog, vers].  prot and port are ignored.
66 % *
67 % * PMAPPROC_GETPORT(struct pmap) returns (long unsigned).
68 % *	0 is failure.  Otherwise returns the port number where the pair
69 % *	[prog, vers] is registered.  It may lie!
70 % *
71 % * PMAPPROC_DUMP() RETURNS (struct pmaplist_ptr)
72 % *
73 % * PMAPPROC_CALLIT(unsigned, unsigned, unsigned, string<>)
74 % * 	RETURNS (port, string<>);
75 % * usage: encapsulatedresults = PMAPPROC_CALLIT(prog, vers, proc,
76 % *						encapsulatedargs);
77 % * 	Calls the procedure on the local machine.  If it is not registered,
78 % *	this procedure is quite; ie it does not return error information!!!
79 % *	This procedure only is supported on rpc/udp and calls via
80 % *	rpc/udp.  This routine only passes null authentication parameters.
81 % *	This file has no interface to xdr routines for PMAPPROC_CALLIT.
82 % *
83 % * The service supports remote procedure calls on udp/ip or tcp/ip socket 111.
84 % */
85 %
86 const PMAPPORT = 111;	/* portmapper port number */
87 %
88 %
89 %/*
90 % * A mapping of (program, version, protocol) to port number
91 % */
92 
93 struct pmap {
94 	unsigned long pm_prog;
95 	unsigned long pm_vers;
96 	unsigned long pm_prot;
97 	unsigned long pm_port;
98 };
99 #ifdef RPC_HDR
100 %
101 %typedef pmap PMAP;
102 %
103 #endif
104 %
105 %/*
106 % * Supported values for the "prot" field
107 % */
108 %
109 const PMAP_IPPROTO_TCP = 6;	/* protocol number for TCP/IP */
110 const PMAP_IPPROTO_UDP = 17;	/* protocol number for UDP/IP */
111 %
112 %
113 %/*
114 % * A list of mappings
115 % *
116 % * Below are two definitions for the pmaplist structure.  This is done because
117 % * xdr_pmaplist() is specified to take a struct pmaplist **, rather than a
118 % * struct pmaplist * that rpcgen would produce.  One version of the pmaplist
119 % * structure (actually called pm__list) is used with rpcgen, and the other is
120 % * defined only in the header file for compatibility with the specified
121 % * interface.
122 % */
123 
124 struct pm__list {
125 	pmap pml_map;
126 	struct pm__list *pml_next;
127 };
128 
129 typedef pm__list *pmaplist_ptr;		/* results of PMAPPROC_DUMP */
130 
131 #ifdef RPC_HDR
132 %
133 %typedef struct pm__list pmaplist;
134 %typedef struct pm__list PMAPLIST;
135 %
136 %#ifndef __cplusplus
137 %struct pmaplist {
138 %	PMAP pml_map;
139 %	struct pmaplist *pml_next;
140 %};
141 %#endif
142 %
143 %#ifdef __cplusplus
144 %extern "C" {
145 %#endif
146 %#ifdef __STDC__
147 %extern  bool_t xdr_pmaplist(XDR *, pmaplist**);
148 %#else /* K&R C */
149 %bool_t xdr_pmaplist();
150 %#endif
151 %#ifdef	__cplusplus
152 %}
153 %#endif
154 %
155 #endif
156 
157 %
158 %/*
159 % * Arguments to callit
160 % */
161 
162 struct rmtcallargs {
163 	unsigned long prog;
164 	unsigned long vers;
165 	unsigned long proc;
166 	opaque args<>;
167 };
168 #ifdef RPC_HDR
169 %
170 %/*
171 % * Client-side only representation of rmtcallargs structure.
172 % *
173 % * The routine that XDRs the rmtcallargs structure must deal with the
174 % * opaque arguments in the "args" structure.  xdr_rmtcall_args() needs to be
175 % * passed the XDR routine that knows the args' structure.  This routine
176 % * doesn't need to go over-the-wire (and it wouldn't make sense anyway) since
177 % * the application being called knows the args structure already.  So we use a
178 % * different "XDR" structure on the client side, p_rmtcallargs, which includes
179 % * the args' XDR routine.
180 % */
181 %struct p_rmtcallargs {
182 %	u_long prog;
183 %	u_long vers;
184 %	u_long proc;
185 %	struct {
186 %		u_int args_len;
187 %		char *args_val;
188 %	} args;
189 %	xdrproc_t	xdr_args;	/* encodes args */
190 %};
191 %
192 #endif	/* def RPC_HDR */
193 %
194 %
195 %/*
196 % * Results of callit
197 % */
198 
199 struct rmtcallres {
200 	unsigned long port;
201 	opaque res<>;
202 };
203 #ifdef RPC_HDR
204 %
205 %/*
206 % * Client-side only representation of rmtcallres structure.
207 % */
208 %struct p_rmtcallres {
209 %	u_long port;
210 %	struct {
211 %		u_int res_len;
212 %		char *res_val;
213 %	} res;
214 %	xdrproc_t	xdr_res;	/* decodes res */
215 %};
216 %
217 #endif	/* def RPC_HDR */
218 
219 /*
220  * Port mapper procedures
221  */
222 
223 program PMAPPROG {
224    version PMAPVERS {
225 	void
226 	PMAPPROC_NULL(void)	= 0;
227 
228 	bool
229 	PMAPPROC_SET(pmap)	= 1;
230 
231 	bool
232 	PMAPPROC_UNSET(pmap)	= 2;
233 
234 	unsigned long
235 	PMAPPROC_GETPORT(pmap)	= 3;
236 
237 	pmaplist_ptr
238 	PMAPPROC_DUMP(void)	= 4;
239 
240 	rmtcallres
241 	PMAPPROC_CALLIT(rmtcallargs)  = 5;
242    } = 2;
243 } = 100000;
244 %
245 #ifdef RPC_HDR
246 %#define PMAPVERS_PROTO		((u_long)2)
247 %#define PMAPVERS_ORIG		((u_long)1)
248 %
249 %#else		/* ndef _KERNEL */
250 %
251 %#include <rpc/pmap_rmt.h>
252 %
253 %#ifdef __cplusplus
254 %extern "C" {
255 %#endif
256 %
257 %#define	PMAPPORT 111
258 %
259 %struct pmap {
260 %	long unsigned pm_prog;
261 %	long unsigned pm_vers;
262 %	long unsigned pm_prot;
263 %	long unsigned pm_port;
264 %};
265 %typedef struct pmap PMAP;
266 %#ifdef __STDC__
267 %extern bool_t xdr_pmap (XDR *, struct pmap *);
268 %#else
269 %extern bool_t xdr_pmap ();
270 %#endif
271 %
272 %struct pmaplist {
273 %	struct pmap pml_map;
274 %	struct pmaplist *pml_next;
275 %};
276 %typedef struct pmaplist PMAPLIST;
277 %typedef struct pmaplist *pmaplist_ptr;
278 %
279 %
280 %#ifdef __cplusplus
281 %}
282 %#endif
283 %
284 %#endif		/* ndef _KERNEL */
285 #endif
286 
287