xref: /netbsd/usr.bin/db/db.c (revision 6550d01e)
1 /*	$NetBSD: db.c,v 1.24 2009/01/28 05:48:49 lukem Exp $	*/
2 
3 /*-
4  * Copyright (c) 2002-2009 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to The NetBSD Foundation
8  * by Luke Mewburn of Wasabi Systems.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  * POSSIBILITY OF SUCH DAMAGE.
30  */
31 
32 #if HAVE_NBTOOL_CONFIG_H
33 #include "nbtool_config.h"
34 #endif
35 
36 #include <sys/cdefs.h>
37 #ifndef lint
38 #ifdef __RCSID
39 __RCSID("$NetBSD: db.c,v 1.24 2009/01/28 05:48:49 lukem Exp $");
40 #endif /* __RCSID */
41 #endif /* not lint */
42 
43 #include <ctype.h>
44 #include <db.h>
45 #include <err.h>
46 #include <fcntl.h>
47 #include <limits.h>
48 #include <stdio.h>
49 #include <stdlib.h>
50 #include <string.h>
51 #include <unistd.h>
52 #include <vis.h>
53 
54 
55 typedef enum {
56 	F_WRITE		= 1<<0,
57 	F_DELETE	= 1<<1,
58 	F_SHOW_KEY	= 1<<2,
59 	F_SHOW_VALUE	= 1<<3,
60 	F_QUIET		= 1<<10,
61 	F_IGNORECASE	= 1<<11,
62 	F_ENDIAN_BIG	= 1<<12,
63 	F_ENDIAN_LITTLE	= 1<<13,
64 	F_NO_NUL	= 1<<14,
65 	F_CREATENEW	= 1<<20,
66 	F_DUPLICATES	= 1<<21,
67 	F_REPLACE	= 1<<22,
68 	F_ENCODE_KEY	= 1<<23,
69 	F_ENCODE_VAL	= 1<<24,
70 	F_DECODE_KEY	= 1<<25,
71 	F_DECODE_VAL	= 1<<26,
72 } flags_t;
73 
74 int	main(int, char *[]);
75 void	db_print(DBT *, DBT *);
76 int	db_dump(void);
77 int	db_del(char *);
78 int	db_get(char *);
79 int	db_seq(char *);
80 int	db_put(char *, char *);
81 int	parseline(FILE *, const char *, char **, char **);
82 int	encode_data(size_t, char *, char **);
83 int	decode_data(char *, char **);
84 void	parse_encode_decode_arg(const char *, int);
85 int	parse_encode_option(char **);
86 void	usage(void);
87 
88 flags_t	 	 flags = 0;
89 DB		*db;
90 const char	*outputsep = "\t";
91 int		 visflags = 0;
92 const char	*extra_echars = NULL;
93 
94 int
95 main(int argc, char *argv[])
96 {
97 	struct {
98 		char		*file;
99 		char		*type;
100 		DBTYPE	 	dbtype;
101 		void		*info;
102 		int	 	dbflags;
103 		mode_t	 	mode;
104 		unsigned int	pagesize;
105 	} oi;
106 	BTREEINFO	btreeinfo;
107 	HASHINFO	hashinfo;
108 	FILE		*infp;
109 	const char	*infile, *fieldsep;
110 	char		*p, *key, *val;
111 	int		ch, rv;
112 	long		lval;
113 
114 	setprogname(argv[0]);
115 
116 	infile = NULL;
117 	fieldsep = " ";
118 	infp = NULL;
119 	memset(&oi, 0, sizeof(oi));
120 	oi.mode = 0644;
121 	oi.pagesize = 4096;
122 
123 				/* parse arguments */
124 	while ( (ch = getopt(argc, argv,
125 			     "CDdE:F:f:iKm:NO:P:qRS:T:U:VwX:")) != -1) {
126 		switch (ch) {
127 
128 		case 'C':
129 			flags |= F_CREATENEW;
130 			break;
131 
132 		case 'D':
133 			flags |= F_DUPLICATES;
134 			break;
135 
136 		case 'd':
137 			flags |= F_DELETE;
138 			break;
139 
140 		case 'E':
141 			if (! optarg[0] || optarg[1])
142 				goto badendian;
143 			switch (toupper((int)optarg[0])) {
144 			case 'B':
145 				flags |= F_ENDIAN_BIG;
146 				break;
147 			case 'L':
148 				flags |= F_ENDIAN_LITTLE;
149 				break;
150 			case 'H':
151 				flags &= ~(F_ENDIAN_BIG | F_ENDIAN_LITTLE);
152 				break;
153 			default:
154  badendian:
155 				errx(1, "Bad endian `%s'", optarg);
156 			}
157 			break;
158 
159 		case 'F':
160 			if (! optarg[0])
161 				errx(1, "Invalid field separator `%s'",
162 				    optarg);
163 			fieldsep = optarg;
164 			break;
165 
166 		case 'f':
167 			infile = optarg;
168 			break;
169 
170 		case 'i':
171 			flags |= F_IGNORECASE;
172 			break;
173 
174 		case 'K':
175 			flags |= F_SHOW_KEY;
176 			break;
177 
178 		case 'm':
179 			lval = strtol(optarg, &p, 8);
180 			if (p == optarg || *p != '\0')
181 				errx(1, "Invalid octal number `%s'", optarg);
182 			if (lval < 0 || lval > 07777)
183 				errx(1, "Invalid mode `%s'", optarg);
184 			oi.mode = (mode_t)lval;
185 			break;
186 
187 		case 'N':
188 			flags |= F_NO_NUL;
189 			break;
190 
191 		case 'O':
192 			outputsep = optarg;
193 			break;
194 
195 		case 'P':
196 			lval = strtol(optarg, &p, 10);
197 			if (p == optarg || *p != '\0')
198 				errx(1, "Invalid pagesize `%s'", optarg);
199 			if (lval < 0 || (unsigned int)lval >= UINT_MAX)
200 				errx(1, "Pagesize `%s' out of range", optarg);
201 			oi.pagesize = (unsigned int)lval;
202 			break;
203 
204 		case 'q':
205 			flags |= F_QUIET;
206 			break;
207 
208 		case 'R':
209 			flags |= F_REPLACE;
210 			break;
211 
212 		case 'S':
213 			parse_encode_decode_arg(optarg, 1 /* encode */);
214 			if (! (flags & (F_ENCODE_KEY | F_ENCODE_VAL)))
215 				errx(1, "Invalid encoding argument `%s'",
216 				    optarg);
217 			break;
218 
219 		case 'T':
220 			visflags = parse_encode_option(&optarg);
221 			if (! visflags)
222 				errx(1, "Invalid encoding/decoding option `%s'",
223 				    optarg);
224 			break;
225 
226 		case 'U':
227 			parse_encode_decode_arg(optarg, 0 /* decode */);
228 			if (! (flags & (F_DECODE_KEY | F_DECODE_VAL)))
229 				errx(1, "Invalid decoding argument `%s'",
230 				    optarg);
231 			break;
232 
233 		case 'V':
234 			flags |= F_SHOW_VALUE;
235 			break;
236 
237 		case 'w':
238 			flags |= F_WRITE;
239 			break;
240 
241 		case 'X':
242 			extra_echars = optarg;
243 			break;
244 
245 		default:
246 			usage();
247 
248 		}
249 	}
250 	argc -= optind;
251 	argv += optind;
252 
253 				/* validate arguments */
254 	if (argc < 2)
255 		usage();
256 	oi.type = argv[0];
257 	oi.file = argv[1];
258 	argc -= 2;
259 	argv += 2;
260 
261 	if (flags & F_WRITE) {
262 		if (flags & (F_SHOW_KEY | F_SHOW_VALUE | F_DELETE))
263 			usage();
264 		if ((!infile && argc < 2) || (argc % 2))
265 			usage();
266 		if (0 != (visflags & ~(VIS_HTTPSTYLE)))
267 			errx(1, "Unsupported decoding option provided to -T");
268 		oi.dbflags = O_RDWR | O_CREAT | O_EXLOCK;
269 		if (flags & F_CREATENEW)
270 			oi.dbflags |= O_TRUNC;
271 	} else if (flags & F_DELETE) {
272 		if (flags & (F_SHOW_KEY | F_SHOW_VALUE | F_WRITE))
273 			usage();
274 		if (!infile && argc < 1)
275 			usage();
276 		if (0 != (visflags & ~(VIS_HTTPSTYLE)))
277 			errx(1, "Unsupported decoding option provided to -T");
278 		oi.dbflags = O_RDWR | O_CREAT | O_EXLOCK;
279 	} else {
280 		if (! (flags & (F_SHOW_KEY | F_SHOW_VALUE)))
281 			flags |= (F_SHOW_KEY | F_SHOW_VALUE);
282 		oi.dbflags = O_RDONLY | O_SHLOCK;
283 	}
284 
285 				/* validate oi.type */
286 	if (strcmp(oi.type, "btree") == 0) {
287 		memset(&btreeinfo, 0, sizeof(btreeinfo));
288 		if (flags & F_ENDIAN_BIG)
289 			btreeinfo.lorder = 4321;
290 		else if (flags & F_ENDIAN_LITTLE)
291 			btreeinfo.lorder = 1234;
292 		if (flags & F_DUPLICATES)
293 			btreeinfo.flags = R_DUP;
294 		btreeinfo.psize = oi.pagesize;
295 		btreeinfo.cachesize = 1024 * 1024;
296 		oi.info = &btreeinfo;
297 		oi.dbtype = DB_BTREE;
298 	} else if (strcmp(oi.type, "hash") == 0) {
299 		memset(&hashinfo, 0, sizeof(hashinfo));
300 		if (flags & F_ENDIAN_BIG)
301 			hashinfo.lorder = 4321;
302 		else if (flags & F_ENDIAN_LITTLE)
303 			hashinfo.lorder = 1234;
304 		hashinfo.bsize = oi.pagesize;
305 		hashinfo.cachesize = 1024 * 1024;
306 		oi.info = &hashinfo;
307 		oi.dbtype = DB_HASH;
308 	} else {
309 		warnx("Unknown database type `%s'", oi.type);
310 		usage();
311 	}
312 
313 	if (infile) {
314 		if (strcmp(infile, "-") == 0)
315 			infp = stdin;
316 		else if ((infp = fopen(infile, "r")) == NULL)
317 			err(1, "Opening input file `%s'", infile);
318 	}
319 
320 				/* open database */
321 	db = dbopen(oi.file, oi.dbflags, oi.mode, oi.dbtype, oi.info);
322 	if (db == NULL)
323 		err(1, "Opening database `%s'", oi.file);
324 
325 
326 				/* manipulate database */
327 	rv = 0;
328 	if (flags & F_WRITE) {			/* write entries */
329 		for (ch = 0; ch < argc; ch += 2)
330 			if ((rv = db_put(argv[ch], argv[ch+1])))
331 				goto cleanup;
332 		if (infp) {
333 			while (parseline(infp, fieldsep, &key, &val)) {
334 				if ((rv = db_put(key, val)))
335 					goto cleanup;
336 			}
337 			if (ferror(infp)) {
338 				warnx("Reading `%s'", infile);
339 				goto cleanup;
340 			}
341 		}
342 	} else if (!infp && argc == 0) {	/* read all */
343 		db_dump();
344 	} else {				/* read/delete specific */
345 		int	(*dbop)(char *);
346 
347 		if (flags & F_DELETE)
348 			dbop = db_del;
349 		else if (DB_BTREE == oi.dbtype)
350 			dbop = db_seq;
351 		else if (DB_HASH == oi.dbtype)
352 			dbop = db_get;
353 		else
354 			errx(5, "internal error: unsupported dbtype %d",
355 			    oi.dbtype);
356 		for (ch = 0; ch < argc; ch++) {
357 			if ((rv = dbop(argv[ch])))
358 				goto cleanup;
359 		}
360 		if (infp) {
361 			while (parseline(infp, fieldsep, &key, NULL)) {
362 				if ((rv = dbop(key)))
363 					goto cleanup;
364 			}
365 			if (ferror(infp)) {
366 				warnx("Reading `%s'", infile);
367 				goto cleanup;
368 			}
369 		}
370 	}
371 
372 				/* close database */
373  cleanup:
374 	if (db->close(db) == -1)
375 		err(1, "Closing database `%s'", oi.file);
376 	if (infp)
377 		fclose(infp);
378 	return (rv);
379 }
380 
381 void
382 db_print(DBT *key, DBT *val)
383 {
384 	int	len;
385 	char	*data;
386 
387 #define	MINUSNUL(x)	((x) > 0  ?  (x) - (flags & F_NO_NUL ? 0 : 1)  :  0)
388 
389 	if (flags & F_SHOW_KEY) {
390 		if (flags & F_ENCODE_KEY) {
391 			len = encode_data(MINUSNUL(key->size),
392 			    (char *)key->data, &data);
393 		} else {
394 			len = (int)MINUSNUL(key->size);
395 			data = (char *)key->data;
396 		}
397 		printf("%.*s", len, data);
398 	}
399 	if ((flags & F_SHOW_KEY) && (flags & F_SHOW_VALUE))
400 		printf("%s", outputsep);
401 	if (flags & F_SHOW_VALUE) {
402 		if (flags & F_ENCODE_VAL) {
403 			len = encode_data(MINUSNUL(val->size),
404 			    (char *)val->data, &data);
405 		} else {
406 			len = (int)MINUSNUL(val->size);
407 			data = (char *)val->data;
408 		}
409 		printf("%.*s", len, data);
410 	}
411 	printf("\n");
412 }
413 
414 int
415 db_dump(void)
416 {
417 	DBT	key, val;
418 	int	rv;
419 
420 	while ((rv = db->seq(db, &key, &val, R_NEXT)) == 0)
421 		db_print(&key, &val);
422 	if (rv == -1)
423 		warn("Error dumping database");
424 	return (rv == 1 ? 0 : 1);
425 }
426 
427 static void
428 db_makekey(DBT *key, char *keystr, int downcase, int decode)
429 {
430 	char	*p, *ks;
431 	int	klen;
432 
433 	memset(key, 0, sizeof(*key));
434 	if (decode) {
435 		if ((klen = decode_data(keystr, &ks)) == -1)
436 			errx(1, "Invalid escape sequence in `%s'", keystr);
437 	} else {
438 		klen = strlen(keystr);
439 		ks = keystr;
440 	}
441 	key->data = ks;
442 	key->size = klen + (flags & F_NO_NUL ? 0 : 1);
443 	if (downcase && (flags & F_IGNORECASE)) {
444 		for (p = ks; *p; p++)
445 			if (isupper((int)*p))
446 				*p = tolower((int)*p);
447 	}
448 }
449 
450 int
451 db_del(char *keystr)
452 {
453 	DBT	key;
454 	int	r;
455 
456 	db_makekey(&key, keystr, 1, (flags & F_DECODE_KEY ? 1 : 0));
457 	r = db->del(db, &key, 0);
458 	switch (r) {
459 	case -1:
460 		if (! (flags & F_QUIET))
461 			warn("Error deleting key `%s'", keystr);
462 		r = 1;
463 		break;
464 	case 0:
465 		if (! (flags & F_QUIET))
466 			printf("Deleted key `%s'\n", keystr);
467 		break;
468 	case 1:
469 		if (! (flags & F_QUIET))
470 			warnx("Unknown key `%s'", keystr);
471 		break;
472 	default:
473 		errx(5, "%s: unexpected result %d from db", __func__, r);
474 	}
475 	if (flags & F_DECODE_KEY)
476 		free(key.data);
477 	return (r);
478 }
479 
480 int
481 db_get(char *keystr)
482 {
483 	DBT	key, val;
484 	int	r;
485 
486 	db_makekey(&key, keystr, 1, (flags & F_DECODE_KEY ? 1 : 0));
487 
488 	r = db->get(db, &key, &val, 0);
489 	switch (r) {
490 	case -1:
491 		warn("Error reading key `%s'", keystr);
492 		r = 1;
493 		break;
494 	case 0:
495 		db_print(&key, &val);
496 		break;
497 	case 1:
498 		if (! (flags & F_QUIET)) {
499 			warnx("Unknown key `%s'", keystr);
500 		}
501 		break;
502 	default:
503 		errx(5, "%s: unexpected result %d from db", __func__, r);
504 	}
505 	if (flags & F_DECODE_KEY)
506 		free(key.data);
507 	return (r);
508 }
509 
510 int
511 db_seq(char *keystr)
512 {
513 	DBT	key, val, want;
514 	int	r, found;
515 	u_int	seqflags;
516 
517 	db_makekey(&key, keystr, 1, (flags & F_DECODE_KEY ? 1 : 0));
518 		/* remember key in want, since db->seq() changes key */
519 	want.data = key.data;
520 	want.size = key.size;
521 
522 	found = 0;
523 	seqflags = R_CURSOR;
524 	while ((r = db->seq(db, &key, &val, seqflags)) == 0) {
525 		if (key.size != want.size ||
526 		    0 != strcmp((char *)key.data, (char *)want.data)) {
527 			r = 1;
528 			break;
529 		}
530 		seqflags = R_NEXT;
531 		found++;
532 		db_print(&key, &val);
533 		if (! (flags & F_DUPLICATES))
534 			break;
535 	}
536 
537 	switch (r) {
538 	case -1:
539 		warn("Error reading key `%s'", keystr);
540 		r = 1;
541 		break;
542 	case 0:
543 		break;
544 	case 1:
545 		if (found) {
546 			r = 0;
547 			break;
548 		}
549 		if (! (flags & F_QUIET)) {
550 			warnx("Unknown key `%s'", keystr);
551 		}
552 		break;
553 	default:
554 		errx(5, "%s: unexpected result %d from db", __func__, r);
555 	}
556 	if (flags & F_DECODE_KEY)
557 		free(want.data);
558 	return (r);
559 }
560 
561 int
562 db_put(char *keystr, char *valstr)
563 {
564 	DBT	key, val;
565 	int	r = 0;
566 
567 	db_makekey(&key, keystr, 1, (flags & F_DECODE_KEY ? 1 : 0));
568 	db_makekey(&val, valstr, 0, (flags & F_DECODE_VAL ? 1 : 0));
569 	r = db->put(db, &key, &val, (flags & F_REPLACE) ? 0 : R_NOOVERWRITE);
570 	switch (r) {
571 	case -1:
572 		warn("Error writing key `%s'", keystr);
573 		r = 1;
574 		break;
575 	case 0:
576 		if (! (flags & F_QUIET))
577 			printf("Added key `%s'\n", keystr);
578 		break;
579 	case 1:
580 		if (! (flags & F_QUIET))
581 			warnx("Key `%s' already exists", keystr);
582 		break;
583 	default:
584 		errx(5, "Unexpected result %d in %s", r, __func__);
585 	}
586 	if (flags & F_DECODE_KEY)
587 		free(key.data);
588 	if (flags & F_DECODE_VAL)
589 		free(val.data);
590 	return (r);
591 }
592 
593 int
594 parseline(FILE *fp, const char *sep, char **kp, char **vp)
595 {
596 	size_t	len;
597 	char	*key, *val;
598 
599 	key = fgetln(fp, &len);
600 	if (key == NULL)		/* end of file, or error */
601 		return (0);
602 
603 	if (key[len-1] == '\n')		/* check for \n at EOL */
604 		key[--len] = '\0';
605 	else
606 		return (0);
607 
608 	*kp = key;
609 	if (vp == NULL)			/* don't split if don't want value */
610 		return (1);
611 	if ((val = strstr(key, sep)) == NULL)
612 		val = key + len;
613 	else {
614 		*val = '\0';
615 		val += strlen(sep);
616 	}
617 	*vp = val;
618 	return (1);
619 }
620 
621 int
622 encode_data(size_t len, char *data, char **edata)
623 {
624 	static char	*buf = NULL;
625 	char		*nbuf;
626 	static size_t	buflen = 0;
627 	size_t		elen;
628 
629 	elen = 1 + (len * 4);
630 	if (elen > buflen) {
631 		if ((nbuf = realloc(buf, elen)) == NULL)
632 			err(1, "Cannot allocate encoding buffer");
633 		buf = nbuf;
634 		buflen = elen;
635 	}
636 	*edata = buf;
637 	if (extra_echars) {
638 		return (strsvisx(buf, data, len, visflags, extra_echars));
639 	} else {
640 		return (strvisx(buf, data, len, visflags));
641 	}
642 }
643 
644 int
645 decode_data(char *data, char **ddata)
646 {
647 	char	*buf;
648 
649 	if ((buf = malloc(strlen(data) + 1)) == NULL)
650 		err(1, "Cannot allocate decoding buffer");
651 	*ddata = buf;
652 	return (strunvisx(buf, data, (visflags & VIS_HTTPSTYLE)));
653 }
654 
655 void
656 parse_encode_decode_arg(const char *arg, int encode)
657 {
658 	if (! arg[0] || arg[1])
659 		return;
660 	if (arg[0] == 'k' || arg[0] == 'b') {
661 		if (encode)
662 			flags |= F_ENCODE_KEY;
663 		else
664 			flags |= F_DECODE_KEY;
665 	}
666 	if (arg[0] == 'v' || arg[0] == 'b') {
667 		if (encode)
668 			flags |= F_ENCODE_VAL;
669 		else
670 			flags |= F_DECODE_VAL;
671 	}
672 	return;
673 }
674 
675 int
676 parse_encode_option(char **arg)
677 {
678 	int	r = 0;
679 	int	encmask = ~(VIS_CSTYLE | VIS_HTTPSTYLE | VIS_OCTAL);
680 
681 	for(; **arg; (*arg)++) {
682 		switch (**arg) {
683 			case 'b':
684 				r |= VIS_NOSLASH;
685 				break;
686 			case 'c':
687 				r &= encmask;
688 				r |= VIS_CSTYLE;
689 				break;
690 			case 'h':
691 				r &= encmask;
692 				r |= VIS_HTTPSTYLE;
693 				break;
694 			case 'o':
695 				r &= encmask;
696 				r |= VIS_OCTAL;
697 				break;
698 			case 's':
699 				r |= VIS_SAFE;
700 				break;
701 			case 't':
702 				r |= VIS_TAB;
703 				break;
704 			case 'w':
705 				r |= VIS_WHITE;
706 				break;
707 			default:
708 				return (0);
709 				break;
710 		}
711 	}
712 	return (r);
713 }
714 
715 void
716 usage(void)
717 {
718 	const char *p = getprogname();
719 
720 	fprintf(stderr,
721 "usage: %s    [-DKiNqV] [-E endian] [-f infile] [-O outsep] [-S visitem]\n"
722 "             [-T visspec] [-U unvisitem] [-X extravis] type dbfile [key [...]]\n"
723 "       %s -d [-iNq] [-E endian] [-f infile] [-T visspec] [-U unvisitem]\n"
724 "             type dbfile [key [...]]\n"
725 "       %s -w [-CDiNqR] [-E endian] [-F isep] [-f infile] [-m mode]\n"
726 "             [-P pagesize] [-T visspec] [-U unvisitem]\n"
727 "             type dbfile [key value [...]]\n"
728 	    ,p ,p ,p );
729 	fprintf(stderr,
730 "Supported modes:\n"
731 "                read keys  [default]\n"
732 "   -d           delete keys\n"
733 "   -w           write (add) keys/values\n"
734 "Supported options:\n"
735 "   -C           create empty (truncated) database\n"
736 "   -D           allow duplicates\n"
737 "   -E endian    database endian: `B'ig, `L'ittle, `H'ost  [default: H]\n"
738 "   -F isep      input field separator string  [default: a space]\n"
739 "   -f infile    file of keys (read|delete) or keys/vals (write)\n"
740 "   -i           ignore case of key by converting to lower case\n"
741 "   -K           print key\n"
742 "   -m mode      mode of created database  [default: 0644]\n"
743 "   -N           don't NUL terminate key\n"
744 "   -O outsep    output field separator string  [default: a tab]\n"
745 "   -P pagesize  database page size  [default: 4096]\n"
746 "   -q           quiet operation (missing keys aren't errors)\n"
747 "   -R           replace existing keys\n"
748 "   -S visitem   items to strvis(3) encode: 'k'ey, 'v'alue, 'b'oth\n"
749 "   -T visspec   options to control -S and -U; like vis(1) options\n"
750 "   -U unvisitem items to strunvis(3) decode: 'k'ey, 'v'alue, 'b'oth\n"
751 "   -V           print value\n"
752 "   -X extravis  extra characters to encode with -S\n"
753 	    );
754 	exit(1);
755 }
756