localedef - define locale environment
localedef [-c][-f charmap][-i sourcefile] name
The localedef utility converts source definitions for locale categories
into the locale source files usable by the locale generators such as
chrtbl, wchrtbl, colltbl, and montbl. It will then execute those
generators to produce the locale runtime files LC_CTYPE, LC_COLLATE, and
The localedef utility reads source definitions for one or more locale
categories belonging to the same locale from the file named in the i
option (if specified) or from standard input.
The name operand identifies the target locale. Each category source
definition is identified by the corresponding environment variable name
and terminated by an END category-name statement. The following
categories are supported.
Defines character classification and case conversion.
Defines collation rules.
Defines the format and symbols used in formatting of monetary
Defines the decimal delimiter, grouping and grouping symbol for
non-monetary numeric editing.
Defines the format and content of date and time information.
Defines the format and values of affirmative and negative responses.
The localedef utility supports the XPG4 localedef source defined by XBD
specification, Section 10.2, Utility Syntax Guidelines.
The following options are supported:
-c Create permanent output even if warning messages have been issued.
Specify the pathname of a file containing a mapping of character
symbols and collating element symbols to actual character encodings.
The format of the charmap is described under the XBD specification,
Section 4.4, Character Set Description File. This option must be
specified if symbolic names (other than collating symbols defined in
a collating-symbol keyword) are used. Default is the POSIX
character mapping file, /usr/lib/locale/charmap/POSIX.
The pathname of a file containing the source definitions. If this
option is not present, source definitions will be read from standard
input. The format of the inputfile is described in the XBD
specification, Section 5.3, Locale Definition.
name Identifies the locale. See the XBD specification, Chapter 5, Locale
for a description of the use of this name. The name will be the
directory name that is used for the locale files for chrtbl,
wchrtbl, colltbl, and montbl.
To have localedef create a permanent output, first it has to be run by
the superuser. Secondly, the name argument has to be prefixed with
/usr/lib/locale/. Also, the codeset name is specified in the charmap file
using the <code_set_name> directive has to be known to the system. To
find out what codeset names are defined, use the iconv -l command. See
the iconv(1) man page.
localedef -f foo.cm -i foo.src foo
In the above examples, the locale files will be created in the foo
directory as LC_COLLATE, LC_CTYPE, LC_MONETARY, LC_TIME, chrtbl_foo,
ctype.c, colltbl_foo, montbl_foo and nl_lang_foo.src.
chrtbl(3M), wchrtbl(3M), colltbl(3M), montbl(3M), iconv(1)
system supported locales
POSIX character mapping file
In IRIX 6.5, the content of the LC_CTYPE locale category was extended to
comply with the XPG/4 standard. The older LC_CTYPE binary format will
not be recognized by the C library. Therefore, all custom-built locales
created under an older version of IRIX must be regenerated with the later
versions of localedef(1) and associated chrtbl(1M)/wchrtbl(1M).
PPPPaaaaggggeeee 2222 [ Back ]