Manual page for localedef(1)
localedef - define locale environment
localedef [-c] [-f charmap]
[-i sourcefile] localename
utility converts source definitions for locale categories into a format
usable by the functions and utilities whose operational behaviour is
determined by the setting of the locale environment variables; see
The utility reads source definitions for one or more locale categories
belonging to the same locale from the file named in the
option (if specified) or from standard input.
Each category source definition is identified by the corresponding
environment variable name and terminated by an
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 following options are supported:
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.
This option must be specified if symbolic names (other than
collating symbols defined in a
keyword) are used.
option is not present, the default
character mapping will be used.
- -i sourcefile
The path name of a file containing the source definitions.
If this option is not present, source definitions will be read from
The following operand is supported:
Identifies the locale.
If the name contains one or more slash characters,
will be interpreted as a path name
where the created locale definitions will be stored.
This capability may be restricted to users with appropriate privileges.
(As a consequence of specifying one
categories can be processed in one execution, only categories belonging
to the same locale can be processed.)
For each locale category specified in
will create the following files:
Category File Description
LC_CTYPE localename.chrtbl binary data containing charac
ter classification information
localename.chrtbl.c C language source file, to be
used by programmers as needed
localename.charmap character mapping file
LC_COLLATE localename.collate collation information used by
runtime collation library rou
localename.collate.hash hashed collation information
LC_MESSAGES localename.message.msg binary message catalogue file
used by nl_langinfo()
localename.message source message catalogue file
LC_NUMERIC localename.numeric binary numeric information for
LC_TIME localename.time text file containing informa
tion used by strftime() and
LC_MONETARY localename.monetary binary monetary information
used by strftime() and
The files created by
should be renamed as follows:
for definitions of the following environment variables that affect
the execution of
The following exit values are returned:
No errors occurred and the locales were successfully created.
Warnings occurred and the locales were successfully created.
The locale specification exceeded implementation limits
or the coded character set or sets used were not supported
by the implementation, and no locale was created.
The capability to create new locales is not supported by
Warnings or errors occurred and no output was created.
If an error is detected, no permanent output will be created.
If warnings occur, permanent output will be created if the
option was specified.
The following conditions will cause warning messages
to be issued:
- If a symbolic name not found in the
file is used for the descriptions of the
categories (for other categories, this will be an error conditions).
- If optional keywords not supported by the implementation
are present in the source.
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97