1 1.44 andvar /* $NetBSD: strfile.c,v 1.44 2022/08/07 11:06:18 andvar Exp $ */ 2 1.3 cgd 3 1.1 cgd /*- 4 1.3 cgd * Copyright (c) 1989, 1993 5 1.3 cgd * The Regents of the University of California. All rights reserved. 6 1.1 cgd * 7 1.1 cgd * This code is derived from software contributed to Berkeley by 8 1.1 cgd * Ken Arnold. 9 1.1 cgd * 10 1.1 cgd * Redistribution and use in source and binary forms, with or without 11 1.1 cgd * modification, are permitted provided that the following conditions 12 1.1 cgd * are met: 13 1.1 cgd * 1. Redistributions of source code must retain the above copyright 14 1.1 cgd * notice, this list of conditions and the following disclaimer. 15 1.1 cgd * 2. Redistributions in binary form must reproduce the above copyright 16 1.1 cgd * notice, this list of conditions and the following disclaimer in the 17 1.1 cgd * documentation and/or other materials provided with the distribution. 18 1.22 agc * 3. Neither the name of the University nor the names of its contributors 19 1.1 cgd * may be used to endorse or promote products derived from this software 20 1.1 cgd * without specific prior written permission. 21 1.1 cgd * 22 1.1 cgd * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 23 1.1 cgd * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24 1.1 cgd * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25 1.1 cgd * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 26 1.1 cgd * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27 1.1 cgd * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28 1.1 cgd * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29 1.1 cgd * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30 1.1 cgd * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31 1.1 cgd * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32 1.1 cgd * SUCH DAMAGE. 33 1.1 cgd */ 34 1.1 cgd 35 1.36 uwe #if HAVE_NBTOOL_CONFIG_H 36 1.36 uwe #include "nbtool_config.h" 37 1.36 uwe #endif 38 1.36 uwe 39 1.16 simonb #ifdef __NetBSD__ 40 1.7 lukem #include <sys/cdefs.h> 41 1.1 cgd #ifndef lint 42 1.26 lukem __COPYRIGHT("@(#) Copyright (c) 1989, 1993\ 43 1.26 lukem The Regents of the University of California. All rights reserved."); 44 1.1 cgd #endif /* not lint */ 45 1.1 cgd 46 1.1 cgd #ifndef lint 47 1.3 cgd #if 0 48 1.3 cgd static char sccsid[] = "@(#)strfile.c 8.1 (Berkeley) 5/31/93"; 49 1.3 cgd #else 50 1.44 andvar __RCSID("$NetBSD: strfile.c,v 1.44 2022/08/07 11:06:18 andvar Exp $"); 51 1.3 cgd #endif 52 1.1 cgd #endif /* not lint */ 53 1.16 simonb #endif /* __NetBSD__ */ 54 1.1 cgd 55 1.30 christos #include <sys/types.h> 56 1.30 christos #include <sys/param.h> 57 1.30 christos #include <ctype.h> 58 1.40 christos #include <stdarg.h> 59 1.30 christos #include <stdio.h> 60 1.30 christos #include <stdlib.h> 61 1.30 christos #include <string.h> 62 1.30 christos #include <time.h> 63 1.30 christos #include <unistd.h> 64 1.30 christos #include <inttypes.h> 65 1.30 christos #include <err.h> 66 1.30 christos 67 1.30 christos #include "strfile.h" 68 1.30 christos 69 1.30 christos #ifndef MAXPATHLEN 70 1.30 christos #define MAXPATHLEN 1024 71 1.30 christos #endif /* MAXPATHLEN */ 72 1.1 cgd 73 1.1 cgd /* 74 1.21 wiz * This program takes a file composed of strings separated by 75 1.1 cgd * lines starting with two consecutive delimiting character (default 76 1.1 cgd * character is '%') and creates another file which consists of a table 77 1.1 cgd * describing the file (structure from "strfile.h"), a table of seek 78 1.1 cgd * pointers to the start of the strings, and the strings, each terminated 79 1.1 cgd * by a null byte. Usage: 80 1.1 cgd * 81 1.1 cgd * % strfile [-iorsx] [ -cC ] sourcefile [ datafile ] 82 1.1 cgd * 83 1.1 cgd * c - Change delimiting character from '%' to 'C' 84 1.1 cgd * s - Silent. Give no summary of data processed at the end of 85 1.1 cgd * the run. 86 1.1 cgd * o - order the strings in alphabetic order 87 1.43 rillig * i - if ordering, ignore case 88 1.1 cgd * r - randomize the order of the strings 89 1.1 cgd * x - set rotated bit 90 1.1 cgd * 91 1.1 cgd * Ken Arnold Sept. 7, 1978 -- 92 1.1 cgd * 93 1.1 cgd * Added ordering options. 94 1.1 cgd */ 95 1.1 cgd 96 1.1 cgd # define STORING_PTRS (Oflag || Rflag) 97 1.1 cgd # define CHUNKSIZE 512 98 1.1 cgd 99 1.15 jsm # define ALLOC(ptr,sz) do { \ 100 1.1 cgd if (ptr == NULL) \ 101 1.19 jsm ptr = malloc(CHUNKSIZE * sizeof *ptr); \ 102 1.1 cgd else if (((sz) + 1) % CHUNKSIZE == 0) \ 103 1.19 jsm ptr = realloc(ptr, ((sz) + CHUNKSIZE) * sizeof *ptr); \ 104 1.7 lukem if (ptr == NULL) \ 105 1.30 christos err(1, "out of space"); \ 106 1.15 jsm } while (0) 107 1.1 cgd 108 1.1 cgd typedef struct { 109 1.1 cgd char first; 110 1.1 cgd off_t pos; 111 1.1 cgd } STR; 112 1.1 cgd 113 1.29 dholland static char *Infile = NULL; /* input file name */ 114 1.29 dholland static char Outfile[MAXPATHLEN] = ""; /* output file name */ 115 1.29 dholland static char Delimch = '%'; /* delimiting character */ 116 1.1 cgd 117 1.37 uwe static int Sflag = 0; /* silent run flag */ 118 1.37 uwe static int Oflag = 0; /* ordering flag */ 119 1.37 uwe static int Iflag = 0; /* ignore case flag */ 120 1.37 uwe static int Rflag = 0; /* randomize order flag */ 121 1.37 uwe static int Xflag = 0; /* set rotated bit */ 122 1.29 dholland static long Num_pts = 0; /* number of pointers/strings */ 123 1.1 cgd 124 1.29 dholland static off_t *Seekpts; 125 1.1 cgd 126 1.29 dholland static FILE *Sort_1, *Sort_2; /* pointers for sorting */ 127 1.1 cgd 128 1.29 dholland static STRFILE Tbl; /* statistics table */ 129 1.1 cgd 130 1.29 dholland static STR *Firstch; /* first chars of each string */ 131 1.1 cgd 132 1.16 simonb 133 1.32 dholland static uint32_t h2nl(uint32_t h); 134 1.32 dholland static void getargs(int argc, char **argv); 135 1.40 christos static void usage(const char *, ...) __dead __printflike(1, 2); 136 1.32 dholland static void add_offset(FILE *fp, off_t off); 137 1.32 dholland static void do_order(void); 138 1.32 dholland static int cmp_str(const void *vp1, const void *vp2); 139 1.32 dholland static void randomize(void); 140 1.32 dholland static void fwrite_be_offt(off_t off, FILE *f); 141 1.25 dogcow 142 1.1 cgd 143 1.1 cgd /* 144 1.1 cgd * main: 145 1.1 cgd * Drive the sucker. There are two main modes -- either we store 146 1.1 cgd * the seek pointers, if the table is to be sorted or randomized, 147 1.1 cgd * or we write the pointer directly to the file, if we are to stay 148 1.1 cgd * in file order. If the former, we allocate and re-allocate in 149 1.1 cgd * CHUNKSIZE blocks; if the latter, we just write each pointer, 150 1.1 cgd * and then seek back to the beginning to write in the table. 151 1.1 cgd */ 152 1.7 lukem int 153 1.27 apb main(int ac, char **av) 154 1.1 cgd { 155 1.7 lukem char *sp, dc; 156 1.7 lukem FILE *inf, *outf; 157 1.35 dholland off_t last_off, length, pos; 158 1.35 dholland int first; 159 1.7 lukem char *nsp; 160 1.7 lukem STR *fp; 161 1.7 lukem static char string[257]; 162 1.35 dholland long i; 163 1.1 cgd 164 1.16 simonb /* sanity test */ 165 1.27 apb if (sizeof(uint32_t) != 4) 166 1.30 christos errx(1, "sizeof(uint32_t) != 4"); 167 1.16 simonb 168 1.1 cgd getargs(ac, av); /* evalute arguments */ 169 1.1 cgd dc = Delimch; 170 1.7 lukem if ((inf = fopen(Infile, "r")) == NULL) 171 1.30 christos err(1, "open `%s'", Infile); 172 1.1 cgd 173 1.7 lukem if ((outf = fopen(Outfile, "w")) == NULL) 174 1.30 christos err(1, "open `%s'", Outfile); 175 1.1 cgd if (!STORING_PTRS) 176 1.11 jsm (void) fseek(outf, sizeof Tbl, SEEK_SET); 177 1.1 cgd 178 1.1 cgd /* 179 1.1 cgd * Write the strings onto the file 180 1.1 cgd */ 181 1.1 cgd 182 1.1 cgd Tbl.str_longlen = 0; 183 1.16 simonb Tbl.str_shortlen = (unsigned int) 0x7fffffff; 184 1.1 cgd Tbl.str_delim = dc; 185 1.1 cgd Tbl.str_version = VERSION; 186 1.1 cgd first = Oflag; 187 1.1 cgd add_offset(outf, ftell(inf)); 188 1.1 cgd last_off = 0; 189 1.1 cgd do { 190 1.1 cgd sp = fgets(string, 256, inf); 191 1.7 lukem if (sp == NULL || (sp[0] == dc && sp[1] == '\n')) { 192 1.1 cgd pos = ftell(inf); 193 1.1 cgd length = pos - last_off - (sp ? strlen(sp) : 0); 194 1.1 cgd last_off = pos; 195 1.1 cgd if (!length) 196 1.1 cgd continue; 197 1.1 cgd add_offset(outf, pos); 198 1.14 jsm if ((off_t)Tbl.str_longlen < length) 199 1.1 cgd Tbl.str_longlen = length; 200 1.14 jsm if ((off_t)Tbl.str_shortlen > length) 201 1.1 cgd Tbl.str_shortlen = length; 202 1.1 cgd first = Oflag; 203 1.1 cgd } 204 1.1 cgd else if (first) { 205 1.23 rillig for (nsp = sp; !isalnum((unsigned char)*nsp); nsp++) 206 1.1 cgd continue; 207 1.1 cgd ALLOC(Firstch, Num_pts); 208 1.1 cgd fp = &Firstch[Num_pts - 1]; 209 1.23 rillig if (Iflag && isupper((unsigned char)*nsp)) 210 1.23 rillig fp->first = tolower((unsigned char)*nsp); 211 1.1 cgd else 212 1.1 cgd fp->first = *nsp; 213 1.1 cgd fp->pos = Seekpts[Num_pts - 1]; 214 1.37 uwe first = 0; 215 1.1 cgd } 216 1.1 cgd } while (sp != NULL); 217 1.1 cgd 218 1.1 cgd /* 219 1.1 cgd * write the tables in 220 1.1 cgd */ 221 1.1 cgd 222 1.1 cgd (void) fclose(inf); 223 1.1 cgd 224 1.1 cgd if (Oflag) 225 1.1 cgd do_order(); 226 1.1 cgd else if (Rflag) 227 1.1 cgd randomize(); 228 1.1 cgd 229 1.1 cgd if (Xflag) 230 1.1 cgd Tbl.str_flags |= STR_ROTATED; 231 1.1 cgd 232 1.1 cgd if (!Sflag) { 233 1.1 cgd printf("\"%s\" created\n", Outfile); 234 1.1 cgd if (Num_pts == 2) 235 1.1 cgd puts("There was 1 string"); 236 1.1 cgd else 237 1.7 lukem printf("There were %d strings\n", (int)(Num_pts - 1)); 238 1.19 jsm printf("Longest string: %lu byte%s\n", (unsigned long)Tbl.str_longlen, 239 1.1 cgd Tbl.str_longlen == 1 ? "" : "s"); 240 1.19 jsm printf("Shortest string: %lu byte%s\n", (unsigned long)Tbl.str_shortlen, 241 1.1 cgd Tbl.str_shortlen == 1 ? "" : "s"); 242 1.1 cgd } 243 1.1 cgd 244 1.11 jsm (void) fseek(outf, (off_t) 0, SEEK_SET); 245 1.20 simonb Tbl.str_version = h2nl(Tbl.str_version); 246 1.20 simonb Tbl.str_numstr = h2nl(Num_pts - 1); 247 1.20 simonb Tbl.str_longlen = h2nl(Tbl.str_longlen); 248 1.20 simonb Tbl.str_shortlen = h2nl(Tbl.str_shortlen); 249 1.20 simonb Tbl.str_flags = h2nl(Tbl.str_flags); 250 1.1 cgd (void) fwrite((char *) &Tbl, sizeof Tbl, 1, outf); 251 1.1 cgd if (STORING_PTRS) { 252 1.35 dholland for (i = 0; i < Num_pts; i++) 253 1.35 dholland fwrite_be_offt(Seekpts[i], outf); 254 1.1 cgd } 255 1.13 jsm fflush(outf); 256 1.13 jsm if (ferror(outf)) 257 1.30 christos err(1, "fwrite %s", Outfile); 258 1.1 cgd (void) fclose(outf); 259 1.1 cgd exit(0); 260 1.1 cgd } 261 1.1 cgd 262 1.1 cgd /* 263 1.1 cgd * This routine evaluates arguments from the command line 264 1.1 cgd */ 265 1.27 apb static void 266 1.27 apb getargs(int argc, char **argv) 267 1.1 cgd { 268 1.1 cgd int ch; 269 1.16 simonb extern int optind; 270 1.16 simonb extern char *optarg; 271 1.39 nia size_t len; 272 1.1 cgd 273 1.6 lukem while ((ch = getopt(argc, argv, "c:iorsx")) != -1) 274 1.1 cgd switch(ch) { 275 1.1 cgd case 'c': /* new delimiting char */ 276 1.1 cgd Delimch = *optarg; 277 1.1 cgd if (!isascii(Delimch)) { 278 1.1 cgd printf("bad delimiting character: '\\%o\n'", 279 1.1 cgd Delimch); 280 1.1 cgd } 281 1.1 cgd break; 282 1.1 cgd case 'i': /* ignore case in ordering */ 283 1.1 cgd Iflag++; 284 1.1 cgd break; 285 1.1 cgd case 'o': /* order strings */ 286 1.1 cgd Oflag++; 287 1.1 cgd break; 288 1.1 cgd case 'r': /* randomize pointers */ 289 1.1 cgd Rflag++; 290 1.1 cgd break; 291 1.1 cgd case 's': /* silent */ 292 1.1 cgd Sflag++; 293 1.1 cgd break; 294 1.1 cgd case 'x': /* set the rotated bit */ 295 1.1 cgd Xflag++; 296 1.1 cgd break; 297 1.1 cgd case '?': 298 1.1 cgd default: 299 1.40 christos usage(NULL); 300 1.1 cgd } 301 1.1 cgd argv += optind; 302 1.1 cgd 303 1.1 cgd if (*argv) { 304 1.1 cgd Infile = *argv; 305 1.39 nia if (*++argv) { 306 1.40 christos len = strlcpy(Outfile, *argv, sizeof(Outfile)); 307 1.39 nia if (len >= sizeof(Outfile)) { 308 1.40 christos usage("Too long output filename"); 309 1.39 nia } 310 1.39 nia } 311 1.1 cgd } 312 1.1 cgd if (!Infile) { 313 1.40 christos usage("No input file name"); 314 1.1 cgd } 315 1.1 cgd if (*Outfile == '\0') { 316 1.40 christos len = snprintf(Outfile, sizeof(Outfile), "%s.dat", Infile); 317 1.40 christos if (len >= sizeof(Outfile)) { 318 1.40 christos usage("Too long input filename"); 319 1.39 nia } 320 1.1 cgd } 321 1.1 cgd } 322 1.1 cgd 323 1.27 apb static void 324 1.40 christos usage(const char *fmt, ...) 325 1.1 cgd { 326 1.40 christos if (fmt) { 327 1.40 christos va_list ap; 328 1.40 christos va_start(ap, fmt); 329 1.40 christos vwarnx(fmt, ap); 330 1.40 christos va_end(ap); 331 1.40 christos } 332 1.1 cgd (void) fprintf(stderr, 333 1.30 christos "Usage: %s [-iorsx] [-c char] sourcefile [datafile]\n", 334 1.30 christos getprogname()); 335 1.16 simonb exit(1); 336 1.16 simonb } 337 1.16 simonb 338 1.1 cgd /* 339 1.1 cgd * add_offset: 340 1.1 cgd * Add an offset to the list, or write it out, as appropriate. 341 1.1 cgd */ 342 1.27 apb static void 343 1.27 apb add_offset(FILE *fp, off_t off) 344 1.1 cgd { 345 1.1 cgd 346 1.1 cgd if (!STORING_PTRS) { 347 1.16 simonb fwrite_be_offt(off, fp); 348 1.1 cgd } else { 349 1.1 cgd ALLOC(Seekpts, Num_pts + 1); 350 1.1 cgd Seekpts[Num_pts] = off; 351 1.1 cgd } 352 1.1 cgd Num_pts++; 353 1.1 cgd } 354 1.1 cgd 355 1.1 cgd /* 356 1.1 cgd * do_order: 357 1.1 cgd * Order the strings alphabetically (possibly ignoring case). 358 1.1 cgd */ 359 1.27 apb static void 360 1.27 apb do_order(void) 361 1.1 cgd { 362 1.7 lukem int i; 363 1.7 lukem off_t *lp; 364 1.7 lukem STR *fp; 365 1.1 cgd 366 1.1 cgd Sort_1 = fopen(Infile, "r"); 367 1.1 cgd Sort_2 = fopen(Infile, "r"); 368 1.1 cgd qsort((char *) Firstch, (int) Tbl.str_numstr, sizeof *Firstch, cmp_str); 369 1.1 cgd i = Tbl.str_numstr; 370 1.1 cgd lp = Seekpts; 371 1.1 cgd fp = Firstch; 372 1.1 cgd while (i--) 373 1.1 cgd *lp++ = fp++->pos; 374 1.1 cgd (void) fclose(Sort_1); 375 1.1 cgd (void) fclose(Sort_2); 376 1.1 cgd Tbl.str_flags |= STR_ORDERED; 377 1.1 cgd } 378 1.1 cgd 379 1.27 apb static int 380 1.27 apb cmp_str(const void *vp1, const void *vp2) 381 1.1 cgd { 382 1.10 jsm const STR *p1, *p2; 383 1.7 lukem int c1, c2; 384 1.7 lukem int n1, n2; 385 1.7 lukem 386 1.10 jsm p1 = (const STR *)vp1; 387 1.10 jsm p2 = (const STR *)vp2; 388 1.1 cgd 389 1.1 cgd # define SET_N(nf,ch) (nf = (ch == '\n')) 390 1.1 cgd # define IS_END(ch,nf) (ch == Delimch && nf) 391 1.1 cgd 392 1.1 cgd c1 = p1->first; 393 1.1 cgd c2 = p2->first; 394 1.1 cgd if (c1 != c2) 395 1.1 cgd return c1 - c2; 396 1.1 cgd 397 1.11 jsm (void) fseek(Sort_1, p1->pos, SEEK_SET); 398 1.11 jsm (void) fseek(Sort_2, p2->pos, SEEK_SET); 399 1.1 cgd 400 1.37 uwe n1 = 0; 401 1.37 uwe n2 = 0; 402 1.1 cgd while (!isalnum(c1 = getc(Sort_1)) && c1 != '\0') 403 1.1 cgd SET_N(n1, c1); 404 1.1 cgd while (!isalnum(c2 = getc(Sort_2)) && c2 != '\0') 405 1.1 cgd SET_N(n2, c2); 406 1.1 cgd 407 1.1 cgd while (!IS_END(c1, n1) && !IS_END(c2, n2)) { 408 1.1 cgd if (Iflag) { 409 1.1 cgd if (isupper(c1)) 410 1.1 cgd c1 = tolower(c1); 411 1.1 cgd if (isupper(c2)) 412 1.1 cgd c2 = tolower(c2); 413 1.1 cgd } 414 1.1 cgd if (c1 != c2) 415 1.1 cgd return c1 - c2; 416 1.1 cgd SET_N(n1, c1); 417 1.1 cgd SET_N(n2, c2); 418 1.1 cgd c1 = getc(Sort_1); 419 1.1 cgd c2 = getc(Sort_2); 420 1.1 cgd } 421 1.1 cgd if (IS_END(c1, n1)) 422 1.1 cgd c1 = 0; 423 1.1 cgd if (IS_END(c2, n2)) 424 1.1 cgd c2 = 0; 425 1.1 cgd return c1 - c2; 426 1.1 cgd } 427 1.1 cgd 428 1.1 cgd /* 429 1.1 cgd * randomize: 430 1.1 cgd * Randomize the order of the string table. We must be careful 431 1.1 cgd * not to randomize across delimiter boundaries. All 432 1.1 cgd * randomization is done within each block. 433 1.1 cgd */ 434 1.27 apb static void 435 1.27 apb randomize(void) 436 1.1 cgd { 437 1.7 lukem int cnt, i; 438 1.7 lukem off_t tmp; 439 1.7 lukem off_t *sp; 440 1.1 cgd 441 1.42 nia srandom((int)(time(NULL) + getpid())); 442 1.42 nia 443 1.1 cgd Tbl.str_flags |= STR_RANDOM; 444 1.1 cgd cnt = Tbl.str_numstr; 445 1.1 cgd 446 1.1 cgd /* 447 1.1 cgd * move things around randomly 448 1.1 cgd */ 449 1.1 cgd 450 1.1 cgd for (sp = Seekpts; cnt > 0; cnt--, sp++) { 451 1.42 nia i = random() % cnt; 452 1.1 cgd tmp = sp[0]; 453 1.1 cgd sp[0] = sp[i]; 454 1.1 cgd sp[i] = tmp; 455 1.1 cgd } 456 1.16 simonb } 457 1.16 simonb 458 1.16 simonb /* 459 1.16 simonb * fwrite_be_offt: 460 1.44 andvar * Write out the off parameter as a 64 bit big endian number 461 1.16 simonb */ 462 1.16 simonb 463 1.27 apb static void 464 1.27 apb fwrite_be_offt(off_t off, FILE *f) 465 1.16 simonb { 466 1.16 simonb int i; 467 1.16 simonb unsigned char c[8]; 468 1.16 simonb 469 1.16 simonb for (i = 7; i >= 0; i--) { 470 1.16 simonb c[i] = off & 0xff; 471 1.16 simonb off >>= 8; 472 1.16 simonb } 473 1.16 simonb fwrite(c, sizeof(c), 1, f); 474 1.1 cgd } 475 1.32 dholland 476 1.32 dholland static uint32_t 477 1.32 dholland h2nl(uint32_t h) 478 1.32 dholland { 479 1.32 dholland unsigned char c[4]; 480 1.32 dholland uint32_t rv; 481 1.32 dholland 482 1.32 dholland c[0] = (h >> 24) & 0xff; 483 1.32 dholland c[1] = (h >> 16) & 0xff; 484 1.32 dholland c[2] = (h >> 8) & 0xff; 485 1.32 dholland c[3] = (h >> 0) & 0xff; 486 1.32 dholland memcpy(&rv, c, sizeof rv); 487 1.32 dholland 488 1.32 dholland return (rv); 489 1.32 dholland } 490