xdr_rec.c revision 1.4 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