LOCALEDEF(1) BSD General Commands Manual LOCALEDEF(1)

NAME
     llooccaalleeddeeff - define locale environment

SYNOPSIS
     llooccaalleeddeeff [-cc] [-ff charmap] [-ii sourcefile] name

DESCRIPTION
     The llooccaalleeddeeff 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. The utility supports

     as private, or restricted-access locales. Implementations may restrict
     the capability to create or modify public locales to users with the
     appropriate privileges.

     Each category source definition is identified by the corresponding envi-
     ronment variable name and terminated by an END category-name statement.

           LCCTYPE     Defines character classification and case conversion.
           LCCOLLATE   Defines collation rules.
           LCMONETARY  Defines the format and symbols used in formatting of
                        monetary information.
           LCNUMERIC   Defines the decimal delimiter, grouping and grouping
                        symbol for non-monetary numeric editing.
           LCTIME      Defines the format and content of date and time infor-
                        mation.
           LCMESSAGES  Defines the format and values of affirmative and nega-
                        tive responses.

OOPPTTIIOONNSS
     The following options are supported:

     -cc       Create permanent output even if warning messages have been
              issued.

     -ff       charmap Specify the pathname of a file containing a mapping of
              character symbols and collating element symbols to actual char-
              acter encodings.

     -ii       inputfile The pathname of a file containing the source defini-
              tions. If this option is not present, source definitions will be
              read from standard input.

OOPPEERRAANNDDSS
     The following operand is supported:

     name Identifies the locale. If the name contains one or more slash char-
     acters, name will be interpreted as a pathname where the created locale
     definitions will be stored. If name does not contain any slash charac-
     ters, the locale will be public. This capability is restricted to users
     with appropriate privileges. (As a consequence of specifying one name,
     although several categories can be processed in one execution, only cate-
     gories belonging to the same locale can be processed.)

ENVIRONMENT
     The following environment variables affect the execution of localedef:

     LANG        Provide a default value for the internationalisation vari-
                 ables that are unset or null. If LANG is unset or null, the
                 corresponding value from the implementation-dependent default
                 locale will be used. If any of the internationalisation vari-
                 ables contains an invalid setting, the utility will behave as
                 if none of the variables had been defined.

     LCALL      If set to a non-empty string value, override the values of
                 all the other internationalisation variables.

     LCCOLLATE  (This variable has no affect on localedef; the POSIX locale
                 will be used for this category.)

     LCCTYPE    Determine the locale for the interpretation of sequences of
                 bytes of text data as characters (for example, single- as
                 opposed to multi-byte characters in arguments and input
                 files). This variable has no affect on the processing of
                 localedef input data; the POSIX locale is used for this pur-
                 pose, regardless of the value of this variable.

     LCMESSAGES
                 Determine the locale that should be used to affect the format
                 and contents of diagnostic messages written to standard
                 error.

     NLSPATH     Determine the location of message catalogues for the process-
                 ing of LCMESSAGES .

EEXXIITT SSTTAATTUUSS
     The following exit values are returned:

     0
       No errors occurred and the locales were successfully created.

     1
       Warnings occurred and the locales were successfully created.

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

     >2
       Warnings or errors occurred and no output was created.

Darwin                         September 9, 2004                        Darwin