localedef(1)                                                      localedef(1)


NAME
     localedef - define locale environment

SYNOPSIS
     localedef [-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.


          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.

EXAMPLES
     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.


SEE ALSO
     chrtbl(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