nlsinfo(1)

NAME

nlsinfo − display native language support information

SYNOPSIS

nlsinfo [-acfhilmnstC] [-d n] [-e n] [-o n] [-r n1 n2] [-L language]

Remarks:

nlsinfo is provided for historical reasons only. Use locale instead (see locale(1)).

DESCRIPTION

nlsinfo displays a list of installed Native Language Support (NLS) international environment languages, and displays information contained within the runtime locale associated with these languages (see setlocale(3C)). Commands and routines modified for NLS operation (see EXTERNAL INFLUENCES section in applicable manual entries) use the information contained within locales to process and display data according to the local language and customs of a user (see hpnls(5)). Unless overridden by the -L option, the runtime locale is determined by the locale category environment variables (those that begin with LC_) and the LANG environment variable.

By default, non-printable characters are displayed as 2-digit hexadecimal numbers unless they are included within strings, in which case the hexadecimal numbers are preceded by \x.

Options

The following options are recognized:

-l Display the list of installed international environment languages.

-a Display the LC_ALL locale category which contains all parts of the selected locale. Equivalent to specifying options -csntmh.

-c Display the LC_CTYPE locale category that contains character classification and conversion information (see ctype(3C), conv(3C), and nl_tools_16(3C)).

-s Display the LC_COLLATE locale category that contains collating (sorting) information (see strcoll(3C) and strxfrm(3C)).

-n Display the LC_NUMERIC locale category which contains information regarding the radix character and thousands separator.

-t Display the LC_TIME locale category which contains such information as the format of the date and time and the names of the days of the week (see strftime(3C)).

-m Display the LC_MONETARY locale category which contains information for the formatting of monetary quantities.

-h Display all other local custom information not included in the LC_NUMERIC, LC_TIME, and LC_MONETARY locale categories.

-i Display a list of abbreviated "from" and "to" code set names used by iconv the code set conversion utility (see iconv(1)). Each "from" and "to" code set name pair represents a conversion supported by iconv.

-C Display all the characters defined in the selected NLS environment’s code set. The list of characters may be quite long for some Asian NLS environments.

If none of the options l, a, c, s, n, t, m, h, i, or C is specified, -l is used as a default.

-f Place a form feed character before all category display headings.

-o n Display non-printable characters as numbers using the base specified by n. If n is o, display non-printable characters as 3-digit octal numbers. If n is x, display non-printable characters as 2-digit hex numbers. If non-printable characters are included within strings, the octal or hex numbers are preceded by a backslash (\).

-e n Display all characters (including printable characters) as hexadecimal or octal numbers. If n is o, display characters as 3-digit octal numbers. If n is x, display characters as 2-digit hex numbers. If characters are included within strings, the octal or hex numbers are preceded by a backslash (\).

-d n Display n lines between headings. By default 16 lines are displayed between headings.

-r n1 n2 Display information only about element number n1 through element number n2 of the requested table(s), rather than all elements of each table. The parameters n1 and n2 can be hexadecimal (preceded by 0x), octal (preceded by 0), or decimal numbers. These parameters can also be characters, in which case each character is mapped to its value in the code set of the user’s current locale (not the locale, if any, specified via the -L option). Characters that are digits should be quoted with the backslash character (\) to prevent them from being interpreted as numbers.

-L language Display information about the locale associated with language instead of the locale specified by the setlocale category and LANG environment variables. The parameter language should be one of the language names from the output of nlsinfo -l (ell) (the valid language names are also given in lang(5)).

EXTERNAL INFLUENCES

Environment Variables

The LC_CTYPE environment variable determines how option argument characters are mapped to a value in the code set.

The LANG environment variable determines the language in which messages and headings are displayed.

International Code Set Support

Single- and multi-byte-character code sets are supported with the exception of multi-byte-character file names.

WARNINGS

The format and content of the display of a particular table may change if the underlying NLS implementation is changed to support new features. Applications should not use the information displayed by nlsinfo as the basis for their operation, but rather should use the interface routines provided in LIBC (see conv(3C), ctype(3C), langinfo(3C), nl_tools_16(3C), setlocale(3C), string(3C) and buildlang(1M)).

AUTHOR

nlsinfo was developed by HP.

FILES

/usr/lib/nls/config
/usr/lib/nls/$LANG/locale.def

Museum

Related Articles