xdr_rec.c
上传用户:nvosite88
上传日期:2007-01-17
资源大小:4983k
文件大小:17k
源码类别:

VxWorks

开发平台:

C/C++

  1. /* xdr_rec.c - TCP/IP based XDR streams */
  2. /* Copyright 1984-2001 Wind River Systems, Inc. */
  3. #include "copyright_wrs.h"
  4. /*
  5.  * Copyright (C) 1984, Sun Microsystems, Inc.
  6.  *
  7.  * Sun RPC is a product of Sun Microsystems, Inc. and is provided for
  8.  * unrestricted use provided that this legend is included on all tape
  9.  * media and as a part of the software program in whole or part.  Users
  10.  * may copy or modify Sun RPC without charge, but are not authorized
  11.  * to license or distribute it to anyone else except as part of a product or
  12.  * program developed by the user.
  13.  *
  14.  * SUN RPC IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
  15.  * WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
  16.  * PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
  17.  *
  18.  * Sun RPC is provided with no support and without any obligation on the
  19.  * part of Sun Microsystems, Inc. to assist in its use, correction,
  20.  * modification or enhancement.
  21.  *
  22.  * SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
  23.  * INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY SUN RPC
  24.  * OR ANY PART THEREOF.
  25.  *
  26.  * In no event will Sun Microsystems, Inc. be liable for any lost revenue
  27.  * or profits or other special, indirect and consequential damages, even if
  28.  * Sun has been advised of the possibility of such damages.
  29.  *
  30.  * Sun Microsystems, Inc.
  31.  * 2550 Garcia Avenue
  32.  * Mountain View, California  94043
  33.  */
  34. /*
  35. modification history
  36. --------------------
  37. 01l,05nov01,vvv  fixed compilation warnings
  38. 01k,18apr00,ham  fixed compilation warnings. corrected xdrrec_ops[].
  39. 01j,04jun92,wmd  added forward declarations required for gcc960 v2.0.
  40. 01i,26may92,rrr  the tree shuffle
  41.   -changed includes to have absolute path from h/
  42. 01h,04oct91,rrr  passed through the ansification filter
  43.   -changed includes to have absolute path from h/
  44.   -changed copyright notice
  45. 01g,25oct90,dnw   removed include of utime.h.
  46. 01f,19apr90,hjb   de-linted.
  47. 01e,31oct89,hjb   deleted "char *mem_alloc()" declaration since it's a macro
  48.   in vxWorks.
  49. 01d,27oct89,hjb   upgraded to 4.0
  50. 01c,05apr88,gae   changed fprintf() to printErr().
  51. 01b,11nov87,jlf   added wrs copyright, title, mod history, etc.
  52. 01a,01nov87,rdc   first VxWorks version
  53. */
  54. #ifndef lint
  55. /* static char sccsid[] = "@(#)xdr_rec.c 1.1 86/02/03 Copyr 1984 Sun Micro"; */
  56. #endif
  57. /*
  58.  * xdr_rec.c, Implements TCP/IP based XDR streams with a "record marking"
  59.  * layer above tcp (for rpc's use).
  60.  *
  61.  * These routines interface XDRSTREAMS to a tcp/ip connection.
  62.  * There is a record marking layer between the xdr stream
  63.  * and the tcp transport level.  A record is composed on one or more
  64.  * record fragments.  A record fragment is a thirty-two bit header followed
  65.  * by n bytes of data, where n is contained in the header.  The header
  66.  * is represented as a htonl(u_long).  Thegh order bit encodes
  67.  * whether or not the fragment is the last fragment of the record
  68.  * (1 => fragment is last, 0 => more fragments to follow.
  69.  * The other 31 bits encode the byte length of the fragment.
  70.  */
  71. #include "rpc/rpctypes.h"
  72. #include "rpc/xdr.h"
  73. #include "netinet/in.h"
  74. #include "vxWorks.h"
  75. #include "memLib.h"
  76. #include "stdio.h"
  77. #include "stdlib.h"
  78. #include "ioLib.h"
  79. LOCAL u_int fix_buf_size();
  80. LOCAL bool_t xdrrec_getlong();
  81. LOCAL bool_t xdrrec_putlong();
  82. LOCAL bool_t xdrrec_getbytes();
  83. LOCAL bool_t xdrrec_putbytes();
  84. LOCAL u_int xdrrec_getpos();
  85. LOCAL bool_t xdrrec_setpos();
  86. LOCAL long * xdrrec_inline();
  87. LOCAL void xdrrec_destroy();
  88. LOCAL bool_t  flush_out();
  89. LOCAL bool_t  set_input_fragment();
  90. LOCAL bool_t  get_input_bytes();
  91. LOCAL bool_t  skip_input_bytes();
  92. static struct  xdr_ops xdrrec_ops = {
  93. xdrrec_getlong,
  94. xdrrec_putlong,
  95. xdrrec_getbytes,
  96. xdrrec_putbytes,
  97. xdrrec_putbytes, /* substitution for x_putwords */
  98. xdrrec_putbytes, /* substitution for x_putlongs */
  99. xdrrec_getpos,
  100. xdrrec_setpos,
  101. xdrrec_inline,
  102. xdrrec_destroy
  103. };
  104. /*
  105.  * A record is composed of one or more record fragments.
  106.  * A record fragment is a two-byte header followed by zero to
  107.  * 2**32-1 bytes.  The header is treated as a long unsigned and is
  108.  * encode/decoded to the network via htonl/ntohl.  The low order 31 bits
  109.  * are a byte count of the fragment.  The highest order bit is a boolean:
  110.  * 1 => this fragment is the last fragment of the record,
  111.  * 0 => this fragment is followed by more fragment(s).
  112.  *
  113.  * The fragment/record machinery is not general;  it is constructed to
  114.  * meet the needs of xdr and rpc based on tcp.
  115.  */
  116. #define LAST_FRAG ((u_long)(1 << 31))
  117. typedef struct rec_strm {
  118. caddr_t tcp_handle;
  119. caddr_t the_buffer; /* 4.0 */
  120. /*
  121.  * out-goung bits
  122.  */
  123. int (*writeit)();
  124. caddr_t out_base; /* output buffer (points to frag header) */
  125. caddr_t out_finger; /* next output position */
  126. caddr_t out_boundry; /* data cannot up to this address */
  127. u_long *frag_header; /* beginning of curren fragment */
  128. bool_t frag_sent; /* true if buffer sent in middle of record */
  129. /*
  130.  * in-coming bits
  131.  */
  132. int (*readit)();
  133. u_long in_size; /* fixed size of the input buffer */
  134. caddr_t in_base;
  135. caddr_t in_finger; /* location of next byte to be had */
  136. caddr_t in_boundry; /* can read up to this location */
  137. long fbtbc; /* fragment bytes to be consumed */
  138. bool_t last_frag;
  139. u_int sendsize;
  140. u_int recvsize;
  141. } RECSTREAM;
  142. /*
  143.  * Create an xdr handle for xdrrec
  144.  * xdrrec_create fills in xdrs.  Sendsize and recvsize are
  145.  * send and recv buffer sizes (0 => use default).
  146.  * tcp_handle is an opaque handle that is passed as the first parameter to
  147.  * the procedures readit and writeit.  Readit and writeit are read and
  148.  * write respectively.   They are like the system
  149.  * calls expect that they take an opaque handle rather than an fd.
  150.  */
  151. void
  152. xdrrec_create(xdrs, sendsize, recvsize, tcp_handle, readit, writeit)
  153. register XDR *xdrs;
  154. u_int sendsize;
  155. u_int recvsize;
  156. caddr_t tcp_handle;
  157. int (*readit)();  /* like read, but pass it a tcp_handle, not sock */
  158. int (*writeit)();  /* like write, but pass it a tcp_handle, not sock */
  159. {
  160. register RECSTREAM *rstrm =
  161.     (RECSTREAM *)mem_alloc(sizeof(RECSTREAM));
  162. if (rstrm == NULL) {
  163. printErr ("xdrrec_create: out of memoryn");
  164. /*
  165.  *  This is bad.  Should rework xdrrec_create to
  166.  *  return a handle, and in this case return NULL
  167.  */
  168. return;
  169. }
  170. /*
  171.  * adjust sizes and allocate buffer quad byte aligned
  172.  */
  173. rstrm->sendsize = sendsize = fix_buf_size (sendsize); /* 4.0 */
  174. rstrm->recvsize = recvsize = fix_buf_size (recvsize); /* 4.0 */
  175. rstrm->the_buffer = (char *) mem_alloc (sendsize +  /* 4.0 */
  176. recvsize +  /* 4.0 */
  177. BYTES_PER_XDR_UNIT); /* 4.0 */
  178. if (rstrm->the_buffer == NULL) /* 4.0 */
  179.     { /* 4.0 */
  180.     printErr ("xdrrec_create: out of memoryn"); /* 4.0 */
  181.     return; /* 4.0 */
  182.     } /* 4.0 */
  183. for (rstrm->out_base = rstrm->the_buffer; /* 4.0 */
  184.      (u_int) rstrm->out_base % BYTES_PER_XDR_UNIT != 0; /* 4.0 */
  185.      rstrm->out_base++); /* 4.0 */
  186. rstrm->in_base = rstrm->out_base + sendsize; /* 4.0 */
  187. /*
  188.  * now the rest...
  189.  */
  190. xdrs->x_ops = &xdrrec_ops;
  191. xdrs->x_private = (caddr_t)rstrm;
  192. rstrm->tcp_handle = tcp_handle;
  193. rstrm->readit = readit;
  194. rstrm->writeit = writeit;
  195. rstrm->out_finger = rstrm->out_boundry = rstrm->out_base; /* 4.0 */
  196. rstrm->frag_header = (u_long *)rstrm->out_base;
  197. rstrm->out_finger += sizeof (u_long);
  198. rstrm->out_boundry += sendsize; /* 4.0 */
  199. rstrm->frag_sent = FALSE;
  200. rstrm->in_size = recvsize;
  201. rstrm->in_boundry = rstrm->in_base; /* 4.0 */
  202. rstrm->in_finger = (rstrm->in_boundry += recvsize);
  203. rstrm->fbtbc = 0;
  204. rstrm->last_frag = TRUE;
  205. }
  206. /*
  207.  * The reoutines defined below are the xdr ops which will go into the
  208.  * xdr handle filled in by xdrrec_create.
  209.  */
  210. LOCAL bool_t /* 4.0 */
  211. xdrrec_getlong(xdrs, lp)
  212. XDR *xdrs;
  213. long *lp;
  214. {
  215. register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
  216. register long *buflp = (long *)(rstrm->in_finger);
  217. long mylong;
  218. /* first try the inline, fast case */
  219. if ((rstrm->fbtbc >= sizeof(long)) &&
  220.     (((int)rstrm->in_boundry - (int)buflp) >= sizeof(long))) {
  221. *lp = ntohl((u_long) *buflp);
  222. rstrm->fbtbc -= sizeof(long);
  223. rstrm->in_finger += sizeof(long);
  224. } else {
  225. if (! xdrrec_getbytes(xdrs, (caddr_t)&mylong, sizeof(long)))
  226. return (FALSE);
  227. *lp = ntohl((u_long) mylong);
  228. }
  229. return (TRUE);
  230. }
  231. LOCAL bool_t /* 4.0 */
  232. xdrrec_putlong(xdrs, lp)
  233. XDR *xdrs;
  234. long *lp;
  235. {
  236. register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
  237. register long *dest_lp = ((long *)(rstrm->out_finger));
  238. if ((rstrm->out_finger += sizeof(long)) > rstrm->out_boundry) {
  239. /*
  240.  * this case should almost never happen so the code is
  241.  * inefficient
  242.  */
  243. rstrm->out_finger -= sizeof(long);
  244. rstrm->frag_sent = TRUE;
  245. if (! flush_out(rstrm, FALSE))
  246. return (FALSE);
  247. dest_lp = ((long *)(rstrm->out_finger));
  248. rstrm->out_finger += sizeof(long);
  249. }
  250. *dest_lp = htonl((u_long) *lp);
  251. return (TRUE);
  252. }
  253. LOCAL bool_t  /* must manage buffers, fragments, and records */ /* 4.0 */
  254. xdrrec_getbytes(xdrs, addr, len)
  255. XDR *xdrs;
  256. register caddr_t addr;
  257. register u_int len;
  258. {
  259. register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
  260. register int current;
  261. while (len > 0) {
  262. current = rstrm->fbtbc;
  263. if (current == 0) {
  264. if (rstrm->last_frag)
  265. return (FALSE);
  266. if (! set_input_fragment(rstrm))
  267. return (FALSE);
  268. continue;
  269. }
  270. current = (len < current) ? len : current;
  271. if (! get_input_bytes(rstrm, addr, current))
  272. return (FALSE);
  273. addr += current;
  274. rstrm->fbtbc -= current;
  275. len -= current;
  276. }
  277. return (TRUE);
  278. }
  279. LOCAL bool_t /* 4.0 */
  280. xdrrec_putbytes(xdrs, addr, len)
  281. XDR *xdrs;
  282. register caddr_t addr;
  283. register u_int len;
  284. {
  285. register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
  286. register int current;
  287. while (len > 0) {
  288. current = (u_int)rstrm->out_boundry - (u_int)rstrm->out_finger;
  289. current = (len < current) ? len : current;
  290. bcopy(addr, rstrm->out_finger, current);
  291. rstrm->out_finger += current;
  292. addr += current;
  293. len -= current;
  294. if (rstrm->out_finger == rstrm->out_boundry) {
  295. rstrm->frag_sent = TRUE;
  296. if (! flush_out(rstrm, FALSE))
  297. return (FALSE);
  298. }
  299. }
  300. return (TRUE);
  301. }
  302. LOCAL u_int /* 4.0 */
  303. xdrrec_getpos(xdrs)
  304. register XDR *xdrs;
  305. {
  306. register RECSTREAM *rstrm = (RECSTREAM *)xdrs->x_private;
  307. register u_int pos;
  308. pos = lseek((int)rstrm->tcp_handle, (long) 0, 1);
  309. if ((int)pos != -1)
  310. switch (xdrs->x_op) {
  311. case XDR_ENCODE:
  312. pos += rstrm->out_finger - rstrm->out_base;
  313. break;
  314. case XDR_DECODE:
  315. pos -= rstrm->in_boundry - rstrm->in_finger;
  316. break;
  317. default:
  318. pos = (u_int) -1;
  319. break;
  320. }
  321. return ((u_int) pos); /* 4.0 */
  322. }
  323. LOCAL bool_t /* 4.0 */
  324. xdrrec_setpos(xdrs, pos)
  325. register XDR *xdrs;
  326. u_int pos;
  327. {
  328. register RECSTREAM *rstrm = (RECSTREAM *)xdrs->x_private;
  329. u_int currpos = xdrrec_getpos(xdrs);
  330. int delta = currpos - pos;
  331. caddr_t newpos;
  332. if ((int)currpos != -1)
  333. switch (xdrs->x_op) {
  334. case XDR_ENCODE:
  335. newpos = rstrm->out_finger - delta;
  336. if ((newpos > (caddr_t)(rstrm->frag_header)) &&
  337.     (newpos < rstrm->out_boundry)) {
  338. rstrm->out_finger = newpos;
  339. return (TRUE);
  340. }
  341. break;
  342. case XDR_DECODE:
  343. newpos = rstrm->in_finger - delta;
  344. if ((delta < (int)(rstrm->fbtbc)) &&
  345.     (newpos <= rstrm->in_boundry) &&
  346.     (newpos >= rstrm->in_base)) {
  347. rstrm->in_finger = newpos;
  348. rstrm->fbtbc -= delta;
  349. return (TRUE);
  350. }
  351. break;
  352. default: /* XDR_FREE */
  353. }
  354. return (FALSE);
  355. }
  356. LOCAL long * /* 4.0 */
  357. xdrrec_inline(xdrs, len)
  358. register XDR *xdrs;
  359. int len;
  360. {
  361. register RECSTREAM *rstrm = (RECSTREAM *)xdrs->x_private;
  362. long * buf = NULL;
  363. switch (xdrs->x_op) {
  364. case XDR_ENCODE:
  365. if ((rstrm->out_finger + len) <= rstrm->out_boundry) {
  366. buf = (long *) rstrm->out_finger;
  367. rstrm->out_finger += len;
  368. }
  369. break;
  370. case XDR_DECODE:
  371. if ((len <= rstrm->fbtbc) &&
  372.     ((rstrm->in_finger + len) <= rstrm->in_boundry)) {
  373. buf = (long *) rstrm->in_finger;
  374. rstrm->fbtbc -= len;
  375. rstrm->in_finger += len;
  376. }
  377. break;
  378. default: /* XDR_FREE */
  379.                 break;
  380. }
  381. return (buf);
  382. }
  383. LOCAL void /* 4.0 */
  384. xdrrec_destroy(xdrs)
  385. register XDR *xdrs;
  386. {
  387. register RECSTREAM *rstrm = (RECSTREAM *)xdrs->x_private;
  388. mem_free (rstrm->the_buffer, /* 4.0 */
  389.   rstrm->sendsize + rstrm->recvsize + BYTES_PER_XDR_UNIT);
  390. mem_free((caddr_t)rstrm, sizeof(RECSTREAM));
  391. }
  392. /*
  393.  * Exported routines to manage xdr records
  394.  */
  395. /*
  396.  * Before reading (deserializing from the stream, one should always call
  397.  * this procedure to guarantee proper record alignment.
  398.  */
  399. bool_t
  400. xdrrec_skiprecord(xdrs)
  401. XDR *xdrs;
  402. {
  403. register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
  404. while (rstrm->fbtbc > 0 || (! rstrm->last_frag)) {
  405. if (! skip_input_bytes(rstrm, (int) rstrm->fbtbc))
  406. return (FALSE);
  407. rstrm->fbtbc = 0;
  408. if ((! rstrm->last_frag) && (! set_input_fragment(rstrm)))
  409. return (FALSE);
  410. }
  411. rstrm->last_frag = FALSE;
  412. return (TRUE);
  413. }
  414. /*
  415.  * Look ahead fuction.
  416.  * Returns TRUE iff there is no more input in the buffer
  417.  * after consuming the rest of the current record.
  418.  */
  419. bool_t
  420. xdrrec_eof(xdrs)
  421. XDR *xdrs;
  422. {
  423. register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
  424. while (rstrm->fbtbc > 0 || (! rstrm->last_frag)) {
  425. if (! skip_input_bytes(rstrm, (int) rstrm->fbtbc))
  426. return (TRUE);
  427. rstrm->fbtbc = 0;
  428. if ((! rstrm->last_frag) && (! set_input_fragment(rstrm)))
  429. return (TRUE);
  430. }
  431. if (rstrm->in_finger == rstrm->in_boundry)
  432. return (TRUE);
  433. return (FALSE);
  434. }
  435. /*
  436.  * The client must tell the package when an end-of-record has occurred.
  437.  * The second paraemters tells whether the record should be flushed to the
  438.  * (output) tcp stream.  (This let's the package support batched or
  439.  * pipelined procedure calls.)  TRUE => immmediate flush to tcp connection.
  440.  */
  441. bool_t
  442. xdrrec_endofrecord(xdrs, sendnow)
  443. XDR *xdrs;
  444. bool_t sendnow;
  445. {
  446. register RECSTREAM *rstrm = (RECSTREAM *)(xdrs->x_private);
  447. register u_long len;  /* fragment length */
  448. if (sendnow || rstrm->frag_sent ||
  449.     ((u_long)rstrm->out_finger + sizeof(u_long) >=
  450.     (u_long)rstrm->out_boundry)) {
  451. rstrm->frag_sent = FALSE;
  452. return (flush_out(rstrm, TRUE));
  453. }
  454. len = (u_long)(rstrm->out_finger) - (u_long)(rstrm->frag_header) -
  455.    sizeof(u_long);
  456. *(rstrm->frag_header) = htonl(len | LAST_FRAG);
  457. rstrm->frag_header = (u_long *)rstrm->out_finger;
  458. rstrm->out_finger += sizeof(u_long);
  459. return (TRUE);
  460. }
  461. /*
  462.  * Internal useful routines
  463.  */
  464. LOCAL bool_t /* 4.0 */
  465. flush_out(rstrm, eor)
  466. register RECSTREAM *rstrm;
  467. bool_t eor;
  468. {
  469. register u_long eormask = (eor == TRUE) ? LAST_FRAG : 0;
  470. register u_long len = (u_long)(rstrm->out_finger) -
  471.     (u_long)(rstrm->frag_header) - sizeof(u_long);
  472. *(rstrm->frag_header) = htonl(len | eormask);
  473. len = (u_long)(rstrm->out_finger) - (u_long)(rstrm->out_base);
  474. if ((*(rstrm->writeit))(rstrm->tcp_handle, rstrm->out_base, (int)len)
  475.     != (int)len)
  476. return (FALSE);
  477. rstrm->frag_header = (u_long *)rstrm->out_base;
  478. rstrm->out_finger = (caddr_t)rstrm->out_base + sizeof(u_long);
  479. return (TRUE);
  480. }
  481. LOCAL bool_t  /* knows nothing about records!  Only about input buffers */
  482. fill_input_buf(rstrm)
  483. register RECSTREAM *rstrm;
  484. {
  485. register caddr_t where; /* 4.0 */
  486. register int len = rstrm->in_size;
  487. u_int i; /* 4.0 */
  488. where = rstrm->in_base; /* 4.0 */
  489. i = (u_int) rstrm->in_boundry % BYTES_PER_XDR_UNIT; /* 4.0 */
  490. where += i; /* 4.0 */
  491. len = rstrm->in_size - i; /* 4.0 */
  492. if ((len = (*(rstrm->readit))(rstrm->tcp_handle, where, len)) == -1)
  493. return (FALSE);
  494. rstrm->in_finger = where;
  495. where += len;
  496. rstrm->in_boundry = where;
  497. return (TRUE);
  498. }
  499. LOCAL bool_t  /* knows nothing about records!  Only about input buffers */
  500. get_input_bytes(rstrm, addr, len)
  501. register RECSTREAM *rstrm;
  502. register caddr_t addr;
  503. register int len;
  504. {
  505. register int current;
  506. while (len > 0) {
  507. current = (int)rstrm->in_boundry - (int)rstrm->in_finger;
  508. if (current == 0) {
  509. if (! fill_input_buf(rstrm))
  510. return (FALSE);
  511. continue;
  512. }
  513. current = (len < current) ? len : current;
  514. bcopy(rstrm->in_finger, addr, current);
  515. rstrm->in_finger += current;
  516. addr += current;
  517. len -= current;
  518. }
  519. return (TRUE);
  520. }
  521. LOCAL bool_t  /* next two bytes of the input stream are treated as a header */
  522. set_input_fragment(rstrm)
  523. register RECSTREAM *rstrm;
  524. {
  525. u_long header;
  526. if (! get_input_bytes(rstrm, (caddr_t)&header, sizeof(header)))
  527. return (FALSE);
  528. header = ntohl(header);
  529. rstrm->last_frag = ((header & LAST_FRAG) == 0) ? FALSE : TRUE;
  530. rstrm->fbtbc = header & (~LAST_FRAG);
  531. return (TRUE);
  532. }
  533. LOCAL bool_t  /* consumes input bytes; knows nothing about records! */
  534. skip_input_bytes(rstrm, cnt)
  535. register RECSTREAM *rstrm;
  536. int cnt;
  537. {
  538. register int current;
  539. while (cnt > 0) {
  540. current = (int)rstrm->in_boundry - (int)rstrm->in_finger;
  541. if (current == 0) {
  542. if (! fill_input_buf(rstrm))
  543. return (FALSE);
  544. continue;
  545. }
  546. current = (cnt < current) ? cnt : current;
  547. rstrm->in_finger += current;
  548. cnt -= current;
  549. }
  550. return (TRUE);
  551. }
  552. LOCAL u_int /* 4.0 */
  553. fix_buf_size(s)
  554. register u_int s;
  555. {
  556. if (s < 100)
  557. s = 4000;
  558. return (RNDUP(s));
  559. }