locale.c revision 307697
1/*-
2 * Copyright (c) 2002, 2003 Alexey Zelkin <phantom@FreeBSD.org>
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 *    notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 *    notice, this list of conditions and the following disclaimer in the
12 *    documentation and/or other materials provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 * SUCH DAMAGE.
25 *
26 * $FreeBSD: stable/11/usr.bin/locale/locale.c 307697 2016-10-21 03:10:05Z araujo $
27 */
28
29/*
30 * XXX: implement missing era_* (LC_TIME) keywords (require libc &
31 *	nl_langinfo(3) extensions)
32 *
33 * XXX: correctly handle reserved 'charmap' keyword and '-m' option (require
34 *	localedef(1) implementation).  Currently it's handled via
35 *	nl_langinfo(CODESET).
36 */
37
38#include <sys/param.h>
39#include <sys/types.h>
40
41#include <dirent.h>
42#include <err.h>
43#include <locale.h>
44#include <langinfo.h>
45#include <stdio.h>
46#include <stdlib.h>
47#include <string.h>
48#include <stringlist.h>
49#include <unistd.h>
50#include "setlocale.h"
51
52/* Local prototypes */
53void	init_locales_list(void);
54void	list_charmaps(void);
55void	list_locales(void);
56const char *lookup_localecat(int);
57char	*kwval_lconv(int);
58int	kwval_lookup(char *, char **, int *, int *);
59void	showdetails(char *);
60void	showkeywordslist(char *substring);
61void	showlocale(void);
62void	usage(void);
63
64/* Global variables */
65static StringList *locales = NULL;
66
67int	all_locales = 0;
68int	all_charmaps = 0;
69int	prt_categories = 0;
70int	prt_keywords = 0;
71int	more_params = 0;
72
73struct _lcinfo {
74	const char	*name;
75	int		id;
76} lcinfo [] = {
77	{ "LC_CTYPE",		LC_CTYPE },
78	{ "LC_COLLATE",		LC_COLLATE },
79	{ "LC_TIME",		LC_TIME },
80	{ "LC_NUMERIC",		LC_NUMERIC },
81	{ "LC_MONETARY",	LC_MONETARY },
82	{ "LC_MESSAGES",	LC_MESSAGES }
83};
84#define	NLCINFO nitems(lcinfo)
85
86/* ids for values not referenced by nl_langinfo() */
87#define	KW_ZERO			10000
88#define	KW_GROUPING		(KW_ZERO+1)
89#define	KW_INT_CURR_SYMBOL	(KW_ZERO+2)
90#define	KW_CURRENCY_SYMBOL	(KW_ZERO+3)
91#define	KW_MON_DECIMAL_POINT	(KW_ZERO+4)
92#define	KW_MON_THOUSANDS_SEP	(KW_ZERO+5)
93#define	KW_MON_GROUPING		(KW_ZERO+6)
94#define	KW_POSITIVE_SIGN	(KW_ZERO+7)
95#define	KW_NEGATIVE_SIGN	(KW_ZERO+8)
96#define	KW_INT_FRAC_DIGITS	(KW_ZERO+9)
97#define	KW_FRAC_DIGITS		(KW_ZERO+10)
98#define	KW_P_CS_PRECEDES	(KW_ZERO+11)
99#define	KW_P_SEP_BY_SPACE	(KW_ZERO+12)
100#define	KW_N_CS_PRECEDES	(KW_ZERO+13)
101#define	KW_N_SEP_BY_SPACE	(KW_ZERO+14)
102#define	KW_P_SIGN_POSN		(KW_ZERO+15)
103#define	KW_N_SIGN_POSN		(KW_ZERO+16)
104#define	KW_INT_P_CS_PRECEDES	(KW_ZERO+17)
105#define	KW_INT_P_SEP_BY_SPACE	(KW_ZERO+18)
106#define	KW_INT_N_CS_PRECEDES	(KW_ZERO+19)
107#define	KW_INT_N_SEP_BY_SPACE	(KW_ZERO+20)
108#define	KW_INT_P_SIGN_POSN	(KW_ZERO+21)
109#define	KW_INT_N_SIGN_POSN	(KW_ZERO+22)
110
111struct _kwinfo {
112	const char	*name;
113	int		isstr;		/* true - string, false - number */
114	int		catid;		/* LC_* */
115	int		value_ref;
116	const char	*comment;
117} kwinfo [] = {
118	{ "charmap",		1, LC_CTYPE,	CODESET, "" },	/* hack */
119
120	{ "decimal_point",	1, LC_NUMERIC,	RADIXCHAR, "" },
121	{ "thousands_sep",	1, LC_NUMERIC,	THOUSEP, "" },
122	{ "grouping",		1, LC_NUMERIC,	KW_GROUPING, "" },
123	{ "radixchar",		1, LC_NUMERIC,	RADIXCHAR,
124	  "Same as decimal_point (FreeBSD only)" },		/* compat */
125	{ "thousep",		1, LC_NUMERIC,	THOUSEP,
126	  "Same as thousands_sep (FreeBSD only)" },		/* compat */
127
128	{ "int_curr_symbol",	1, LC_MONETARY,	KW_INT_CURR_SYMBOL, "" },
129	{ "currency_symbol",	1, LC_MONETARY,	KW_CURRENCY_SYMBOL, "" },
130	{ "mon_decimal_point",	1, LC_MONETARY,	KW_MON_DECIMAL_POINT, "" },
131	{ "mon_thousands_sep",	1, LC_MONETARY,	KW_MON_THOUSANDS_SEP, "" },
132	{ "mon_grouping",	1, LC_MONETARY,	KW_MON_GROUPING, "" },
133	{ "positive_sign",	1, LC_MONETARY,	KW_POSITIVE_SIGN, "" },
134	{ "negative_sign",	1, LC_MONETARY,	KW_NEGATIVE_SIGN, "" },
135
136	{ "int_frac_digits",	0, LC_MONETARY,	KW_INT_FRAC_DIGITS, "" },
137	{ "frac_digits",	0, LC_MONETARY,	KW_FRAC_DIGITS, "" },
138	{ "p_cs_precedes",	0, LC_MONETARY,	KW_P_CS_PRECEDES, "" },
139	{ "p_sep_by_space",	0, LC_MONETARY,	KW_P_SEP_BY_SPACE, "" },
140	{ "n_cs_precedes",	0, LC_MONETARY,	KW_N_CS_PRECEDES, "" },
141	{ "n_sep_by_space",	0, LC_MONETARY,	KW_N_SEP_BY_SPACE, "" },
142	{ "p_sign_posn",	0, LC_MONETARY,	KW_P_SIGN_POSN, "" },
143	{ "n_sign_posn",	0, LC_MONETARY,	KW_N_SIGN_POSN, "" },
144	{ "int_p_cs_precedes",	0, LC_MONETARY,	KW_INT_P_CS_PRECEDES, "" },
145	{ "int_p_sep_by_space",	0, LC_MONETARY,	KW_INT_P_SEP_BY_SPACE, "" },
146	{ "int_n_cs_precedes",	0, LC_MONETARY,	KW_INT_N_CS_PRECEDES, "" },
147	{ "int_n_sep_by_space",	0, LC_MONETARY,	KW_INT_N_SEP_BY_SPACE, "" },
148	{ "int_p_sign_posn",	0, LC_MONETARY,	KW_INT_P_SIGN_POSN, "" },
149	{ "int_n_sign_posn",	0, LC_MONETARY,	KW_INT_N_SIGN_POSN, "" },
150
151	{ "d_t_fmt",		1, LC_TIME,	D_T_FMT, "" },
152	{ "d_fmt",		1, LC_TIME,	D_FMT, "" },
153	{ "t_fmt",		1, LC_TIME,	T_FMT, "" },
154	{ "am_str",		1, LC_TIME,	AM_STR, "" },
155	{ "pm_str",		1, LC_TIME,	PM_STR, "" },
156	{ "t_fmt_ampm",		1, LC_TIME,	T_FMT_AMPM, "" },
157	{ "day_1",		1, LC_TIME,	DAY_1, "" },
158	{ "day_2",		1, LC_TIME,	DAY_2, "" },
159	{ "day_3",		1, LC_TIME,	DAY_3, "" },
160	{ "day_4",		1, LC_TIME,	DAY_4, "" },
161	{ "day_5",		1, LC_TIME,	DAY_5, "" },
162	{ "day_6",		1, LC_TIME,	DAY_6, "" },
163	{ "day_7",		1, LC_TIME,	DAY_7, "" },
164	{ "abday_1",		1, LC_TIME,	ABDAY_1, "" },
165	{ "abday_2",		1, LC_TIME,	ABDAY_2, "" },
166	{ "abday_3",		1, LC_TIME,	ABDAY_3, "" },
167	{ "abday_4",		1, LC_TIME,	ABDAY_4, "" },
168	{ "abday_5",		1, LC_TIME,	ABDAY_5, "" },
169	{ "abday_6",		1, LC_TIME,	ABDAY_6, "" },
170	{ "abday_7",		1, LC_TIME,	ABDAY_7, "" },
171	{ "mon_1",		1, LC_TIME,	MON_1, "" },
172	{ "mon_2",		1, LC_TIME,	MON_2, "" },
173	{ "mon_3",		1, LC_TIME,	MON_3, "" },
174	{ "mon_4",		1, LC_TIME,	MON_4, "" },
175	{ "mon_5",		1, LC_TIME,	MON_5, "" },
176	{ "mon_6",		1, LC_TIME,	MON_6, "" },
177	{ "mon_7",		1, LC_TIME,	MON_7, "" },
178	{ "mon_8",		1, LC_TIME,	MON_8, "" },
179	{ "mon_9",		1, LC_TIME,	MON_9, "" },
180	{ "mon_10",		1, LC_TIME,	MON_10, "" },
181	{ "mon_11",		1, LC_TIME,	MON_11, "" },
182	{ "mon_12",		1, LC_TIME,	MON_12, "" },
183	{ "abmon_1",		1, LC_TIME,	ABMON_1, "" },
184	{ "abmon_2",		1, LC_TIME,	ABMON_2, "" },
185	{ "abmon_3",		1, LC_TIME,	ABMON_3, "" },
186	{ "abmon_4",		1, LC_TIME,	ABMON_4, "" },
187	{ "abmon_5",		1, LC_TIME,	ABMON_5, "" },
188	{ "abmon_6",		1, LC_TIME,	ABMON_6, "" },
189	{ "abmon_7",		1, LC_TIME,	ABMON_7, "" },
190	{ "abmon_8",		1, LC_TIME,	ABMON_8, "" },
191	{ "abmon_9",		1, LC_TIME,	ABMON_9, "" },
192	{ "abmon_10",		1, LC_TIME,	ABMON_10, "" },
193	{ "abmon_11",		1, LC_TIME,	ABMON_11, "" },
194	{ "abmon_12",		1, LC_TIME,	ABMON_12, "" },
195	{ "altmon_1",		1, LC_TIME,	ALTMON_1, "(FreeBSD only)" },
196	{ "altmon_2",		1, LC_TIME,	ALTMON_2, "(FreeBSD only)" },
197	{ "altmon_3",		1, LC_TIME,	ALTMON_3, "(FreeBSD only)" },
198	{ "altmon_4",		1, LC_TIME,	ALTMON_4, "(FreeBSD only)" },
199	{ "altmon_5",		1, LC_TIME,	ALTMON_5, "(FreeBSD only)" },
200	{ "altmon_6",		1, LC_TIME,	ALTMON_6, "(FreeBSD only)" },
201	{ "altmon_7",		1, LC_TIME,	ALTMON_7, "(FreeBSD only)" },
202	{ "altmon_8",		1, LC_TIME,	ALTMON_8, "(FreeBSD only)" },
203	{ "altmon_9",		1, LC_TIME,	ALTMON_9, "(FreeBSD only)" },
204	{ "altmon_10",		1, LC_TIME,	ALTMON_10, "(FreeBSD only)" },
205	{ "altmon_11",		1, LC_TIME,	ALTMON_11, "(FreeBSD only)" },
206	{ "altmon_12",		1, LC_TIME,	ALTMON_12, "(FreeBSD only)" },
207	{ "era",		1, LC_TIME,	ERA, "(unavailable)" },
208	{ "era_d_fmt",		1, LC_TIME,	ERA_D_FMT, "(unavailable)" },
209	{ "era_d_t_fmt",	1, LC_TIME,	ERA_D_T_FMT, "(unavailable)" },
210	{ "era_t_fmt",		1, LC_TIME,	ERA_T_FMT, "(unavailable)" },
211	{ "alt_digits",		1, LC_TIME,	ALT_DIGITS, "" },
212	{ "d_md_order",		1, LC_TIME,	D_MD_ORDER,
213	  "(FreeBSD only)"				},	/* local */
214
215	{ "yesexpr",		1, LC_MESSAGES, YESEXPR, "" },
216	{ "noexpr",		1, LC_MESSAGES, NOEXPR, "" },
217	{ "yesstr",		1, LC_MESSAGES, YESSTR,
218	  "(POSIX legacy)" },					/* compat */
219	{ "nostr",		1, LC_MESSAGES, NOSTR,
220	  "(POSIX legacy)" }					/* compat */
221
222};
223#define	NKWINFO (nitems(kwinfo))
224
225const char *boguslocales[] = { "UTF-8" };
226#define	NBOGUS	(nitems(boguslocales))
227
228int
229main(int argc, char *argv[])
230{
231	int	ch;
232	int	tmp;
233
234	while ((ch = getopt(argc, argv, "ackms:")) != -1) {
235		switch (ch) {
236		case 'a':
237			all_locales = 1;
238			break;
239		case 'c':
240			prt_categories = 1;
241			break;
242		case 'k':
243			prt_keywords = 1;
244			break;
245		case 'm':
246			all_charmaps = 1;
247			break;
248		default:
249			usage();
250		}
251	}
252	argc -= optind;
253	argv += optind;
254
255	/* validate arguments */
256	if (all_locales && all_charmaps)
257		usage();
258	if ((all_locales || all_charmaps) && argc > 0)
259		usage();
260	if ((all_locales || all_charmaps) && (prt_categories || prt_keywords))
261		usage();
262
263	/* process '-a' */
264	if (all_locales) {
265		list_locales();
266		exit(0);
267	}
268
269	/* process '-m' */
270	if (all_charmaps) {
271		list_charmaps();
272		exit(0);
273	}
274
275	/* check for special case '-k list' */
276	tmp = 0;
277	if (prt_keywords && argc > 0)
278		while (tmp < argc)
279			if (strcasecmp(argv[tmp++], "list") == 0) {
280				showkeywordslist(argv[tmp]);
281				exit(0);
282			}
283
284	/* process '-c', '-k', or command line arguments. */
285	if (prt_categories || prt_keywords || argc > 0) {
286		if (argc > 0) {
287			setlocale(LC_ALL, "");
288			while (argc > 0) {
289				showdetails(*argv);
290				argv++;
291				argc--;
292			}
293		} else {
294			uint i;
295			for (i = 0; i < nitems(kwinfo); i++)
296				showdetails ((char *)kwinfo [i].name);
297		}
298		exit(0);
299	}
300
301	/* no arguments, show current locale state */
302	showlocale();
303
304	return (0);
305}
306
307void
308usage(void)
309{
310	printf("Usage: locale [ -a | -m ]\n"
311	       "       locale -k list [prefix]\n"
312	       "       locale [ -ck ] [keyword ...]\n");
313	exit(1);
314}
315
316/*
317 * Output information about all available locales
318 *
319 * XXX actually output of this function does not guarantee that locale
320 *     is really available to application, since it can be broken or
321 *     inconsistent thus setlocale() will fail.  Maybe add '-V' function to
322 *     also validate these locales?
323 */
324void
325list_locales(void)
326{
327	size_t i;
328
329	init_locales_list();
330	for (i = 0; i < locales->sl_cur; i++) {
331		printf("%s\n", locales->sl_str[i]);
332	}
333}
334
335/*
336 * qsort() helper function
337 */
338static int
339scmp(const void *s1, const void *s2)
340{
341	return strcmp(*(const char **)s1, *(const char **)s2);
342}
343
344/*
345 * Output information about all available charmaps
346 *
347 * XXX this function is doing a task in hackish way, i.e. by scaning
348 *     list of locales, spliting their codeset part and building list of
349 *     them.
350 */
351void
352list_charmaps(void)
353{
354	size_t i;
355	char *s, *cs;
356	StringList *charmaps;
357
358	/* initialize StringList */
359	charmaps = sl_init();
360	if (charmaps == NULL)
361		err(1, "could not allocate memory");
362
363	/* fetch locales list */
364	init_locales_list();
365
366	/* split codesets and build their list */
367	for (i = 0; i < locales->sl_cur; i++) {
368		s = locales->sl_str[i];
369		if ((cs = strchr(s, '.')) != NULL) {
370			cs++;
371			if (sl_find(charmaps, cs) == NULL)
372				sl_add(charmaps, cs);
373		}
374	}
375
376	/* add US-ASCII, if not yet added */
377	if (sl_find(charmaps, "US-ASCII") == NULL)
378		sl_add(charmaps, "US-ASCII");
379
380	/* sort the list */
381	qsort(charmaps->sl_str, charmaps->sl_cur, sizeof(char *), scmp);
382
383	/* print results */
384	for (i = 0; i < charmaps->sl_cur; i++) {
385		printf("%s\n", charmaps->sl_str[i]);
386	}
387}
388
389/*
390 * Retrieve sorted list of system locales (or user locales, if PATH_LOCALE
391 * environment variable is set)
392 */
393void
394init_locales_list(void)
395{
396	DIR *dirp;
397	struct dirent *dp;
398	size_t i;
399	int bogus;
400
401	/* why call this function twice ? */
402	if (locales != NULL)
403		return;
404
405	/* initialize StringList */
406	locales = sl_init();
407	if (locales == NULL)
408		err(1, "could not allocate memory");
409
410	/* get actual locales directory name */
411	if (__detect_path_locale() != 0)
412		err(1, "unable to find locales storage");
413
414	/* open locales directory */
415	dirp = opendir(_PathLocale);
416	if (dirp == NULL)
417		err(1, "could not open directory '%s'", _PathLocale);
418
419	/* scan directory and store its contents except "." and ".." */
420	while ((dp = readdir(dirp)) != NULL) {
421		if (*(dp->d_name) == '.')
422			continue;		/* exclude "." and ".." */
423		for (bogus = i = 0; i < NBOGUS; i++)
424			if (strncmp(dp->d_name, boguslocales[i],
425			    strlen(boguslocales[i])) == 0)
426				bogus = 1;
427		if (!bogus)
428			sl_add(locales, strdup(dp->d_name));
429	}
430	closedir(dirp);
431
432	/* make sure that 'POSIX' and 'C' locales are present in the list.
433	 * POSIX 1003.1-2001 requires presence of 'POSIX' name only here, but
434	 * we also list 'C' for constistency
435	 */
436	if (sl_find(locales, "POSIX") == NULL)
437		sl_add(locales, "POSIX");
438
439	if (sl_find(locales, "C") == NULL)
440		sl_add(locales, "C");
441
442	/* make output nicer, sort the list */
443	qsort(locales->sl_str, locales->sl_cur, sizeof(char *), scmp);
444}
445
446/*
447 * Show current locale status, depending on environment variables
448 */
449void
450showlocale(void)
451{
452	size_t	i;
453	const char *lang, *vval, *eval;
454
455	setlocale(LC_ALL, "");
456
457	lang = getenv("LANG");
458	if (lang == NULL) {
459		lang = "";
460	}
461	printf("LANG=%s\n", lang);
462	/* XXX: if LANG is null, then set it to "C" to get implied values? */
463
464	for (i = 0; i < NLCINFO; i++) {
465		vval = setlocale(lcinfo[i].id, NULL);
466		eval = getenv(lcinfo[i].name);
467		if (eval != NULL && !strcmp(eval, vval)
468				&& strcmp(lang, vval)) {
469			/*
470			 * Appropriate environment variable set, its value
471			 * is valid and not overridden by LC_ALL
472			 *
473			 * XXX: possible side effect: if both LANG and
474			 * overridden environment variable are set into same
475			 * value, then it'll be assumed as 'implied'
476			 */
477			printf("%s=%s\n", lcinfo[i].name, vval);
478		} else {
479			printf("%s=\"%s\"\n", lcinfo[i].name, vval);
480		}
481	}
482
483	vval = getenv("LC_ALL");
484	if (vval == NULL) {
485		vval = "";
486	}
487	printf("LC_ALL=%s\n", vval);
488}
489
490/*
491 * keyword value lookup helper (via localeconv())
492 */
493char *
494kwval_lconv(int id)
495{
496	struct lconv *lc;
497	char *rval;
498
499	rval = NULL;
500	lc = localeconv();
501	switch (id) {
502		case KW_GROUPING:
503			rval = lc->grouping;
504			break;
505		case KW_INT_CURR_SYMBOL:
506			rval = lc->int_curr_symbol;
507			break;
508		case KW_CURRENCY_SYMBOL:
509			rval = lc->currency_symbol;
510			break;
511		case KW_MON_DECIMAL_POINT:
512			rval = lc->mon_decimal_point;
513			break;
514		case KW_MON_THOUSANDS_SEP:
515			rval = lc->mon_thousands_sep;
516			break;
517		case KW_MON_GROUPING:
518			rval = lc->mon_grouping;
519			break;
520		case KW_POSITIVE_SIGN:
521			rval = lc->positive_sign;
522			break;
523		case KW_NEGATIVE_SIGN:
524			rval = lc->negative_sign;
525			break;
526		case KW_INT_FRAC_DIGITS:
527			rval = &(lc->int_frac_digits);
528			break;
529		case KW_FRAC_DIGITS:
530			rval = &(lc->frac_digits);
531			break;
532		case KW_P_CS_PRECEDES:
533			rval = &(lc->p_cs_precedes);
534			break;
535		case KW_P_SEP_BY_SPACE:
536			rval = &(lc->p_sep_by_space);
537			break;
538		case KW_N_CS_PRECEDES:
539			rval = &(lc->n_cs_precedes);
540			break;
541		case KW_N_SEP_BY_SPACE:
542			rval = &(lc->n_sep_by_space);
543			break;
544		case KW_P_SIGN_POSN:
545			rval = &(lc->p_sign_posn);
546			break;
547		case KW_N_SIGN_POSN:
548			rval = &(lc->n_sign_posn);
549			break;
550		case KW_INT_P_CS_PRECEDES:
551			rval = &(lc->int_p_cs_precedes);
552			break;
553		case KW_INT_P_SEP_BY_SPACE:
554			rval = &(lc->int_p_sep_by_space);
555			break;
556		case KW_INT_N_CS_PRECEDES:
557			rval = &(lc->int_n_cs_precedes);
558			break;
559		case KW_INT_N_SEP_BY_SPACE:
560			rval = &(lc->int_n_sep_by_space);
561			break;
562		case KW_INT_P_SIGN_POSN:
563			rval = &(lc->int_p_sign_posn);
564			break;
565		case KW_INT_N_SIGN_POSN:
566			rval = &(lc->int_n_sign_posn);
567			break;
568		default:
569			break;
570	}
571	return (rval);
572}
573
574/*
575 * keyword value and properties lookup
576 */
577int
578kwval_lookup(char *kwname, char **kwval, int *cat, int *isstr)
579{
580	int	rval;
581	size_t	i;
582
583	rval = 0;
584	for (i = 0; i < NKWINFO; i++) {
585		if (strcasecmp(kwname, kwinfo[i].name) == 0) {
586			rval = 1;
587			*cat = kwinfo[i].catid;
588			*isstr = kwinfo[i].isstr;
589			if (kwinfo[i].value_ref < KW_ZERO) {
590				*kwval = nl_langinfo(kwinfo[i].value_ref);
591			} else {
592				*kwval = kwval_lconv(kwinfo[i].value_ref);
593			}
594			break;
595		}
596	}
597
598	return (rval);
599}
600
601/*
602 * Show details about requested keyword according to '-k' and/or '-c'
603 * command line options specified.
604 */
605void
606showdetails(char *kw)
607{
608	int	isstr, cat, tmpval;
609	char	*kwval;
610
611	if (kwval_lookup(kw, &kwval, &cat, &isstr) == 0) {
612		/*
613		 * invalid keyword specified.
614		 * XXX: any actions?
615		 */
616		fprintf(stderr, "Unknown keyword: `%s'\n", kw);
617		return;
618	}
619
620	if (prt_categories) {
621		  if (prt_keywords)
622			printf("%-20s ", lookup_localecat(cat));
623		  else
624			printf("%-20s\t%s\n", kw, lookup_localecat(cat));
625	}
626
627	if (prt_keywords) {
628		if (isstr) {
629			printf("%s=\"%s\"\n", kw, kwval);
630		} else {
631			tmpval = (char) *kwval;
632			printf("%s=%d\n", kw, tmpval);
633		}
634	}
635
636	if (!prt_categories && !prt_keywords) {
637		if (isstr) {
638			printf("%s\n", kwval);
639		} else {
640			tmpval = (char) *kwval;
641			printf("%d\n", tmpval);
642		}
643	}
644}
645
646/*
647 * Convert locale category id into string
648 */
649const char *
650lookup_localecat(int cat)
651{
652	size_t	i;
653
654	for (i = 0; i < NLCINFO; i++)
655		if (lcinfo[i].id == cat) {
656			return (lcinfo[i].name);
657		}
658	return ("UNKNOWN");
659}
660
661/*
662 * Show list of keywords
663 */
664void
665showkeywordslist(char *substring)
666{
667	size_t	i;
668
669#define	FMT "%-20s %-12s %-7s %-20s\n"
670
671	if (substring == NULL)
672		printf("List of available keywords\n\n");
673	else
674		printf("List of available keywords starting with '%s'\n\n",
675		    substring);
676	printf(FMT, "Keyword", "Category", "Type", "Comment");
677	printf("-------------------- ------------ ------- --------------------\n");
678	for (i = 0; i < NKWINFO; i++) {
679		if (substring != NULL) {
680			if (strncmp(kwinfo[i].name, substring,
681			    strlen(substring)) != 0)
682				continue;
683		}
684		printf(FMT,
685			kwinfo[i].name,
686			lookup_localecat(kwinfo[i].catid),
687			(kwinfo[i].isstr == 0) ? "number" : "string",
688			kwinfo[i].comment);
689	}
690}
691