localedef(1)localedef(1)NAMElocaledef - define locale environment
SYNOPSISlocaledef [-c][-f charmap][-i sourcefile] name
DESCRIPTION
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
LC_MONETARY respectively.
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.
LC_CTYPE
Defines character classification and case conversion.
LC_COLLATE
Defines collation rules.
LC_MONETARY
Defines the format and symbols used in formatting of monetary
information.
LC_NUMERIC
Defines the decimal delimiter, grouping and grouping symbol for
non-monetary numeric editing.
LC_TIME
Defines the format and content of date and time information.
LC_MESSAGES
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.
-f charmap
Specify the pathname of a file containing a mapping of character
symbols and collating element symbols to actual character encodings.
Page 1
localedef(1)localedef(1)
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.
-i inputfile
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.
EXAMPLESlocaledef-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.
SEE ALSOchrtbl(3M), wchrtbl(3M), colltbl(3M), montbl(3M), iconv(1)FILES
/usr/lib/locale/
system supported locales
/usr/lib/locale/charmap/POSIX/
POSIX character mapping file
NOTE
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).
Page 2
