xref: /netbsd-src/lib/libc/rpc/xdr_rec.c (revision ae9172d6cd9432a6a1a56760d86b32c57a66c39c)
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 #if defined(LIBC_SCCS) && !defined(lint)
30 /*static char *sccsid = "from: @(#)xdr_rec.c 1.21 87/08/11 Copyr 1984 Sun Micro";*/
31 /*static char *sccsid = "from: @(#)xdr_rec.c	2.2 88/08/01 4.0 RPCSRC";*/
32 static char *rcsid = "$Id: xdr_rec.c,v 1.4 1994/12/04 01:13:42 cgd Exp $";
33 #endif
34 
35 /*
36  * xdr_rec.c, Implements TCP/IP based XDR streams with a "record marking"
37  * layer above tcp (for rpc's use).
38  *
39  * Copyright (C) 1984, Sun Microsystems, Inc.
40  *
41  * These routines interface XDRSTREAMS to a tcp/ip connection.
42  * There is a record marking layer between the xdr stream
43  * and the tcp transport level.  A record is composed on one or more
44  * record fragments.  A record fragment is a thirty-two bit header followed
45  * by n bytes of data, where n is contained in the header.  The header
46  * is represented as a htonl(u_long).  Thegh order bit encodes
47  * whether or not the fragment is the last fragment of the record
48  * (1 => fragment is last, 0 => more fragments to follow.
49  * The other 31 bits encode the byte length of the fragment.
50  */
51 
52 #include <stdio.h>
53 #include <stdlib.h>
54 #include <rpc/types.h>
55 #include <rpc/xdr.h>
56 #include <netinet/in.h>
57 
58 static u_int	fix_buf_size();
59 static bool_t	flush_out();
60 static bool_t	get_input_bytes();
61 static bool_t	set_input_fragment();
62 static bool_t	skip_input_bytes();
63 
64 static bool_t	xdrrec_getlong();
65 static bool_t	xdrrec_putlong();
66 static bool_t	xdrrec_getbytes();
67 static bool_t	xdrrec_putbytes();
68 static u_int	xdrrec_getpos();
69 static bool_t	xdrrec_setpos();
70 static int32_t *xdrrec_inline();
71 static void	xdrrec_destroy();
72 
73 static struct  xdr_ops xdrrec_ops = {
74 	xdrrec_getlong,
75 	xdrrec_putlong,
76 	xdrrec_getbytes,
77 	xdrrec_putbytes,
78 	xdrrec_getpos,
79 	xdrrec_setpos,
80 	xdrrec_inline,
81 	xdrrec_destroy
82 };
83 
84 /*
85  * A record is composed of one or more record fragments.
86  * A record fragment is a two-byte header followed by zero to
87  * 2**32-1 bytes.  The header is treated as a long unsigned and is
88  * encode/decoded to the network via htonl/ntohl.  The low order 31 bits
89  * are a byte count of the fragment.  The highest order bit is a boolean:
90  * 1 => this fragment is the last fragment of the record,
91  * 0 => this fragment is followed by more fragment(s).
92  *
93  * The fragment/record machinery is not general;  it is constructed to
94  * meet the needs of xdr and rpc based on tcp.
95  */
96 
97 #define LAST_FRAG ((u_int32_t)(1 << 31))
98 
99 typedef struct rec_strm {
100 	caddr_t tcp_handle;
101 	caddr_t the_buffer;
102 	/*
103 	 * out-goung bits
104 	 */
105 	int (*writeit) __P((caddr_t, caddr_t, int));
106 	caddr_t out_base;	/* output buffer (points to frag header) */
107 	caddr_t out_finger;	/* next output position */
108 	caddr_t out_boundry;	/* data cannot up to this address */
109 	u_int32_t *frag_header;	/* beginning of curren fragment */
110 	bool_t frag_sent;	/* true if buffer sent in middle of record */
111 	/*
112 	 * in-coming bits
113 	 */
114 	int (*readit) __P((caddr_t, caddr_t, int));
115 	u_long in_size;	/* fixed size of the input buffer */
116 	caddr_t in_base;
117 	caddr_t in_finger;	/* location of next byte to be had */
118 	caddr_t in_boundry;	/* can read up to this location */
119 	long fbtbc;		/* fragment bytes to be consumed */
120 	bool_t last_frag;
121 	u_int sendsize;
122 	u_int recvsize;
123 } RECSTREAM;
124 
125 
126 /*
127  * Create an xdr handle for xdrrec
128  * xdrrec_create fills in xdrs.  Sendsize and recvsize are
129  * send and recv buffer sizes (0 => use default).
130  * tcp_handle is an opaque handle that is passed as the first parameter to
131  * the procedures readit and writeit.  Readit and writeit are read and
132  * write respectively.   They are like the system
133  * calls expect that they take an opaque handle rather than an fd.
134  */
135 void
136 xdrrec_create(xdrs, sendsize, recvsize, tcp_handle, readit, writeit)
137 	register XDR *xdrs;
138 	register u_int sendsize;
139 	register u_int recvsize;
140 	caddr_t tcp_handle;
141 	int (*readit)();  /* like read, but pass it a tcp_handle, not sock */
142 	int (*writeit)();  /* like write, but pass it a tcp_handle, not sock */
143 {
144 	register RECSTREAM *rstrm =
145 		(RECSTREAM *)mem_alloc(sizeof(RECSTREAM));
146 
147 	if (rstrm == NULL) {
148 		(void)fprintf(stderr, "xdrrec_create: out of memory\n");
149 		/*
150 		 *  This is bad.  Should rework xdrrec_create to
151 		 *  return a handle, and in this case return NULL
152 		 */
153 		return;
154 	}
155 	/*
156 	 * adjust sizes and allocate buffer quad byte aligned
157 	 */
158 	rstrm->sendsize = sendsize = fix_buf_size(sendsize);
159 	rstrm->recvsize = recvsize = fix_buf_size(recvsize);
160 	rstrm->the_buffer = mem_alloc(sendsize + recvsize + BYTES_PER_XDR_UNIT);
161 	if (rstrm->the_buffer == NULL) {
162 		(void)fprintf(stderr, "xdrrec_create: out of memory\n");
163 		return;
164 	}
165 	for (rstrm->out_base = rstrm->the_buffer;
166 		(u_long)rstrm->out_base % BYTES_PER_XDR_UNIT != 0;
167 		rstrm->out_base++);
168 	rstrm->in_base = rstrm->out_base + sendsize;
169 	/*
170 	 * now the rest ...
171 	 */
172 	xdrs->x_ops = &xdrrec_ops;
173 	xdrs->x_private = (caddr_t)rstrm;
174 	rstrm->tcp_handle = tcp_handle;
175 	rstrm->readit = readit;
176 	rstrm->writeit = writeit;
177 	rstrm->out_finger = rstrm->out_boundry = rstrm->out_base;
178 	rstrm->frag_header = (u_int32_t *)rstrm->out_base;
179 	rstrm->out_finger += sizeof(u_int32_t);
180 	rstrm->out_boundry += sendsize;
181 	rstrm->frag_sent = FALSE;
182 	rstrm->in_size = recvsize;
183 	rstrm->in_boundry = rstrm->in_base;
184 	rstrm->in_finger = (rstrm->in_boundry += recvsize);
185 	rstrm->fbtbc = 0;
186 	rstrm->last_frag = TRUE;
187 }
188 
189 
190 /*
191  * The reoutines defined below are the xdr ops which will go into the
192  * xdr handle filled in by xdrrec_create.
193  */
194 
195 static bool_t
196 xdrrec_getlong(xdrs, lp)
197 	XDR *xdrs;
198 	long *lp;
199 {
200 	register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
201 	register int32_t *buflp = (int32_t *)(rstrm->in_finger);
202 	int32_t mylong;
203 
204 	/* first try the inline, fast case */
205 	if ((rstrm->fbtbc >= sizeof(int32_t)) &&
206 		(((long)rstrm->in_boundry - (long)buflp) >= sizeof(int32_t))) {
207 		*lp = (long)ntohl((u_int32_t)(*buflp));
208 		rstrm->fbtbc -= sizeof(int32_t);
209 		rstrm->in_finger += sizeof(int32_t);
210 	} else {
211 		if (! xdrrec_getbytes(xdrs, (caddr_t)&mylong, sizeof(int32_t)))
212 			return (FALSE);
213 		*lp = (long)ntohl((u_int32_t)mylong);
214 	}
215 	return (TRUE);
216 }
217 
218 static bool_t
219 xdrrec_putlong(xdrs, lp)
220 	XDR *xdrs;
221 	long *lp;
222 {
223 	register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
224 	register int32_t *dest_lp = ((int32_t *)(rstrm->out_finger));
225 
226 	if ((rstrm->out_finger += sizeof(int32_t)) > rstrm->out_boundry) {
227 		/*
228 		 * this case should almost never happen so the code is
229 		 * inefficient
230 		 */
231 		rstrm->out_finger -= sizeof(int32_t);
232 		rstrm->frag_sent = TRUE;
233 		if (! flush_out(rstrm, FALSE))
234 			return (FALSE);
235 		dest_lp = ((int32_t *)(rstrm->out_finger));
236 		rstrm->out_finger += sizeof(int32_t);
237 	}
238 	*dest_lp = (int32_t)htonl((u_int32_t)(*lp));
239 	return (TRUE);
240 }
241 
242 static bool_t  /* must manage buffers, fragments, and records */
243 xdrrec_getbytes(xdrs, addr, len)
244 	XDR *xdrs;
245 	register caddr_t addr;
246 	register u_int len;
247 {
248 	register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
249 	register int current;
250 
251 	while (len > 0) {
252 		current = rstrm->fbtbc;
253 		if (current == 0) {
254 			if (rstrm->last_frag)
255 				return (FALSE);
256 			if (! set_input_fragment(rstrm))
257 				return (FALSE);
258 			continue;
259 		}
260 		current = (len < current) ? len : current;
261 		if (! get_input_bytes(rstrm, addr, current))
262 			return (FALSE);
263 		addr += current;
264 		rstrm->fbtbc -= current;
265 		len -= current;
266 	}
267 	return (TRUE);
268 }
269 
270 static bool_t
271 xdrrec_putbytes(xdrs, addr, len)
272 	XDR *xdrs;
273 	register caddr_t addr;
274 	register u_int len;
275 {
276 	register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
277 	register long current;
278 
279 	while (len > 0) {
280 		current = (u_long)rstrm->out_boundry -
281 		    (u_long)rstrm->out_finger;
282 		current = (len < current) ? len : current;
283 		bcopy(addr, rstrm->out_finger, current);
284 		rstrm->out_finger += current;
285 		addr += current;
286 		len -= current;
287 		if (rstrm->out_finger == rstrm->out_boundry) {
288 			rstrm->frag_sent = TRUE;
289 			if (! flush_out(rstrm, FALSE))
290 				return (FALSE);
291 		}
292 	}
293 	return (TRUE);
294 }
295 
296 static u_int
297 xdrrec_getpos(xdrs)
298 	register XDR *xdrs;
299 {
300 	register RECSTREAM *rstrm = (RECSTREAM *)xdrs->x_private;
301 	register long pos;
302 
303 	pos = lseek((off_t)(long)rstrm->tcp_handle, 0, 1);
304 	if (pos != -1)
305 		switch (xdrs->x_op) {
306 
307 		case XDR_ENCODE:
308 			pos += rstrm->out_finger - rstrm->out_base;
309 			break;
310 
311 		case XDR_DECODE:
312 			pos -= rstrm->in_boundry - rstrm->in_finger;
313 			break;
314 
315 		default:
316 			pos = (u_int) -1;
317 			break;
318 		}
319 	return ((u_int) pos);
320 }
321 
322 static bool_t
323 xdrrec_setpos(xdrs, pos)
324 	register XDR *xdrs;
325 	u_int pos;
326 {
327 	register RECSTREAM *rstrm = (RECSTREAM *)xdrs->x_private;
328 	u_int currpos = xdrrec_getpos(xdrs);
329 	int delta = currpos - pos;
330 	caddr_t newpos;
331 
332 	if ((int)currpos != -1)
333 		switch (xdrs->x_op) {
334 
335 		case XDR_ENCODE:
336 			newpos = rstrm->out_finger - delta;
337 			if ((newpos > (caddr_t)(rstrm->frag_header)) &&
338 				(newpos < rstrm->out_boundry)) {
339 				rstrm->out_finger = newpos;
340 				return (TRUE);
341 			}
342 			break;
343 
344 		case XDR_DECODE:
345 			newpos = rstrm->in_finger - delta;
346 			if ((delta < (int)(rstrm->fbtbc)) &&
347 				(newpos <= rstrm->in_boundry) &&
348 				(newpos >= rstrm->in_base)) {
349 				rstrm->in_finger = newpos;
350 				rstrm->fbtbc -= delta;
351 				return (TRUE);
352 			}
353 			break;
354 		}
355 	return (FALSE);
356 }
357 
358 static int32_t *
359 xdrrec_inline(xdrs, len)
360 	register XDR *xdrs;
361 	int len;
362 {
363 	register RECSTREAM *rstrm = (RECSTREAM *)xdrs->x_private;
364 	int32_t *buf = NULL;
365 
366 	switch (xdrs->x_op) {
367 
368 	case XDR_ENCODE:
369 		if ((rstrm->out_finger + len) <= rstrm->out_boundry) {
370 			buf = (int32_t *) rstrm->out_finger;
371 			rstrm->out_finger += len;
372 		}
373 		break;
374 
375 	case XDR_DECODE:
376 		if ((len <= rstrm->fbtbc) &&
377 			((rstrm->in_finger + len) <= rstrm->in_boundry)) {
378 			buf = (int32_t *) rstrm->in_finger;
379 			rstrm->fbtbc -= len;
380 			rstrm->in_finger += len;
381 		}
382 		break;
383 	}
384 	return (buf);
385 }
386 
387 static void
388 xdrrec_destroy(xdrs)
389 	register XDR *xdrs;
390 {
391 	register RECSTREAM *rstrm = (RECSTREAM *)xdrs->x_private;
392 
393 	mem_free(rstrm->the_buffer,
394 		rstrm->sendsize + rstrm->recvsize + BYTES_PER_XDR_UNIT);
395 	mem_free((caddr_t)rstrm, sizeof(RECSTREAM));
396 }
397 
398 
399 /*
400  * Exported routines to manage xdr records
401  */
402 
403 /*
404  * Before reading (deserializing from the stream, one should always call
405  * this procedure to guarantee proper record alignment.
406  */
407 bool_t
408 xdrrec_skiprecord(xdrs)
409 	XDR *xdrs;
410 {
411 	register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
412 
413 	while (rstrm->fbtbc > 0 || (! rstrm->last_frag)) {
414 		if (! skip_input_bytes(rstrm, rstrm->fbtbc))
415 			return (FALSE);
416 		rstrm->fbtbc = 0;
417 		if ((! rstrm->last_frag) && (! set_input_fragment(rstrm)))
418 			return (FALSE);
419 	}
420 	rstrm->last_frag = FALSE;
421 	return (TRUE);
422 }
423 
424 /*
425  * Look ahead fuction.
426  * Returns TRUE iff there is no more input in the buffer
427  * after consuming the rest of the current record.
428  */
429 bool_t
430 xdrrec_eof(xdrs)
431 	XDR *xdrs;
432 {
433 	register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
434 
435 	while (rstrm->fbtbc > 0 || (! rstrm->last_frag)) {
436 		if (! skip_input_bytes(rstrm, rstrm->fbtbc))
437 			return (TRUE);
438 		rstrm->fbtbc = 0;
439 		if ((! rstrm->last_frag) && (! set_input_fragment(rstrm)))
440 			return (TRUE);
441 	}
442 	if (rstrm->in_finger == rstrm->in_boundry)
443 		return (TRUE);
444 	return (FALSE);
445 }
446 
447 /*
448  * The client must tell the package when an end-of-record has occurred.
449  * The second paraemters tells whether the record should be flushed to the
450  * (output) tcp stream.  (This let's the package support batched or
451  * pipelined procedure calls.)  TRUE => immmediate flush to tcp connection.
452  */
453 bool_t
454 xdrrec_endofrecord(xdrs, sendnow)
455 	XDR *xdrs;
456 	bool_t sendnow;
457 {
458 	register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
459 	register u_long len;  /* fragment length */
460 
461 	if (sendnow || rstrm->frag_sent ||
462 		((u_long)rstrm->out_finger + sizeof(u_int32_t) >=
463 		(u_long)rstrm->out_boundry)) {
464 		rstrm->frag_sent = FALSE;
465 		return (flush_out(rstrm, TRUE));
466 	}
467 	len = (u_long)(rstrm->out_finger) - (u_long)(rstrm->frag_header) -
468 	   sizeof(u_int32_t);
469 	*(rstrm->frag_header) = htonl((u_long)len | LAST_FRAG);
470 	rstrm->frag_header = (u_int32_t *)rstrm->out_finger;
471 	rstrm->out_finger += sizeof(u_int32_t);
472 	return (TRUE);
473 }
474 
475 
476 /*
477  * Internal useful routines
478  */
479 static bool_t
480 flush_out(rstrm, eor)
481 	register RECSTREAM *rstrm;
482 	bool_t eor;
483 {
484 	register u_long eormask = (eor == TRUE) ? LAST_FRAG : 0;
485 	register u_int32_t len = (u_long)(rstrm->out_finger) -
486 		(u_long)(rstrm->frag_header) - sizeof(u_int32_t);
487 
488 	*(rstrm->frag_header) = htonl(len | eormask);
489 	len = (u_long)(rstrm->out_finger) - (u_long)(rstrm->out_base);
490 	if ((*(rstrm->writeit))(rstrm->tcp_handle, rstrm->out_base, (int)len)
491 		!= (int)len)
492 		return (FALSE);
493 	rstrm->frag_header = (u_int32_t *)rstrm->out_base;
494 	rstrm->out_finger = (caddr_t)rstrm->out_base + sizeof(u_int32_t);
495 	return (TRUE);
496 }
497 
498 static bool_t  /* knows nothing about records!  Only about input buffers */
499 fill_input_buf(rstrm)
500 	register RECSTREAM *rstrm;
501 {
502 	register caddr_t where;
503 	u_long i;
504 	register long len;
505 
506 	where = rstrm->in_base;
507 	i = (u_long)rstrm->in_boundry % BYTES_PER_XDR_UNIT;
508 	where += i;
509 	len = rstrm->in_size - i;
510 	if ((len = (*(rstrm->readit))(rstrm->tcp_handle, where, len)) == -1)
511 		return (FALSE);
512 	rstrm->in_finger = where;
513 	where += len;
514 	rstrm->in_boundry = where;
515 	return (TRUE);
516 }
517 
518 static bool_t  /* knows nothing about records!  Only about input buffers */
519 get_input_bytes(rstrm, addr, len)
520 	register RECSTREAM *rstrm;
521 	register caddr_t addr;
522 	register int len;
523 {
524 	register long current;
525 
526 	while (len > 0) {
527 		current = (long)rstrm->in_boundry - (long)rstrm->in_finger;
528 		if (current == 0) {
529 			if (! fill_input_buf(rstrm))
530 				return (FALSE);
531 			continue;
532 		}
533 		current = (len < current) ? len : current;
534 		bcopy(rstrm->in_finger, addr, current);
535 		rstrm->in_finger += current;
536 		addr += current;
537 		len -= current;
538 	}
539 	return (TRUE);
540 }
541 
542 static bool_t  /* next two bytes of the input stream are treated as a header */
543 set_input_fragment(rstrm)
544 	register RECSTREAM *rstrm;
545 {
546 	u_int32_t header;
547 
548 	if (! get_input_bytes(rstrm, (caddr_t)&header, sizeof(header)))
549 		return (FALSE);
550 	header = (long)ntohl(header);
551 	rstrm->last_frag = ((header & LAST_FRAG) == 0) ? FALSE : TRUE;
552 	rstrm->fbtbc = header & (~LAST_FRAG);
553 	return (TRUE);
554 }
555 
556 static bool_t  /* consumes input bytes; knows nothing about records! */
557 skip_input_bytes(rstrm, cnt)
558 	register RECSTREAM *rstrm;
559 	long cnt;
560 {
561 	register long current;
562 
563 	while (cnt > 0) {
564 		current = (long)rstrm->in_boundry - (long)rstrm->in_finger;
565 		if (current == 0) {
566 			if (! fill_input_buf(rstrm))
567 				return (FALSE);
568 			continue;
569 		}
570 		current = (cnt < current) ? cnt : current;
571 		rstrm->in_finger += current;
572 		cnt -= current;
573 	}
574 	return (TRUE);
575 }
576 
577 static u_int
578 fix_buf_size(s)
579 	register u_int s;
580 {
581 
582 	if (s < 100)
583 		s = 4000;
584 	return (RNDUP(s));
585 }
586