localedef(1) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

localedef(1)

localedef(1)                     User Commands                    localedef(1)



NAME
       localedef - define locale environment

SYNOPSIS
       localedef [-c] [-f charmap]
            [-i sourcefile] [-u code_set_name]
            [-x extensions_file] localename

DESCRIPTION
       The localedef utility converts source definitions for locale categories
       into a format usable by the functions and utilities  whose  operational
       behavior  is  determined by the setting of the locale environment vari‐
       ables; see environ(7).


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


       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 informa‐
                      tion.


       LC_MESSAGES    Defines  the  format and values of affirmative and nega‐
                      tive responses.


OPTIONS
       The following options are supported:

       -c                    Creates permanent output even if warning messages
                             have been issued.


       -f charmap            Specifies  the  pathname  of  a file containing a
                             mapping of character symbols and  collating  ele‐
                             ment  symbols to actual character encodings. This
                             option must be specified if symbolic names (other
                             than  collating  symbols  defined in a collating-
                             symbol keyword) are used. If the -f 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  standard
                             input.


       -u code_set_name      Specifies  the name of a codeset used as the tar‐
                             get mapping of character  symbols  and  collating
                             element symbols whose encoding values are defined
                             in terms of the ISO/IEC  10646-1:  2000  standard
                             position constant values. See NOTES.


       -x extensions_file    Specifies  the  name  of  an extension file where
                             various  localedef  options   are   listed.   See
                             locale(7).


OPERANDS
       The following operand is supported:

       localename    Identifies  the  locale. If the name contains one or more
                     slash characters, localename 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 localename, although several categories can  be  pro‐
                     cessed in one execution, only categories belonging to the
                     same locale can be processed.)


OUTPUT
       localedef generates a locale data file named localename at the  current
       directory for both 32-bit and 64-bit environments.


       The   locale   data  file  must  be  moved  to  /usr/lib/locale/locale‐
       name/localename to be recognized and supported as a locale.

ENVIRONMENT VARIABLES
       See environ(7) for definitions of the following  environment  variables
       that  affect  the  execution  of  localedef:  LANG, LC_ALL, LC_COLLATE,
       LC_CTYPE, LC_MESSAGES, and NLSPATH.

EXIT STATUS
       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 imple‐
             mentation, and no locale was created.


       3     The capability to create new locales  is  not  supported  by  the
             implementation.


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



       If an error is detected, no permanent output will be created.

FILES
       /usr/lib/localedef/extensions/generic_eucbc.x

           Describes  what a generic EUC locale uses as the extensions file in
           the system. This file is used by default.


       /usr/lib/localedef/extensions/single_byte.x

           Describes a generic single-byte file used as the extensions file in
           the system.


       /usr/lib/locale/localename/localename

           The locale data file for both 32-bit and 64-bit environments.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Availabilitysystem/core-os _ Interface StabilityCommit‐
       ted _ StandardSee standards(7).


SEE ALSO
       locale(1),      iconv_open(3C),      nl_langinfo(3C),     strftime(3C),
       attributes(7), charmap(7), environ(7), extensions(7), locale(7),  stan‐
       dards(7)

WARNINGS
       If  warnings  occur,  permanent output will be created if the -c option
       was specified. The following conditions will cause warning messages  to
       be issued:

           o      If a symbolic name not found in the charmap file is used for
                  the descriptions of the LC_CTYPE  or  LC_COLLATE  categories
                  (for other categories, this will be an error conditions).


           o      If optional keywords not supported by the implementation are
                  present in the source.


           o      Use of no longer supported options and option arguments such
                  as -C, -L, -m, and -W.


NOTES
       When the -u option is used, the code_set_name option-argument is inter‐
       preted as a name of a codeset to which the ISO/IEC 10646-1: 2000  stan‐
       dard  position constant values are converted. Both the ISO/IEC 10646-1:
       2000 standard position constant  values  and  other  formats  (decimal,
       hexadecimal,  or octal) are valid as encoding values within the charmap
       file. The  codeset  can  be  any  codeset  that  is  supported  by  the
       iconv_open(3C) function on the system.


       When   conflicts   occur   between   the   charmap   specification   of
       code_set_name, mb_cur_max, or mb_cur_min and  the  corresponding  value
       for  the  codeset  represented by the -u option-argument code_set_name,
       the localedef utility fails as an error.


       When conflicts occur between the charmap encoding values specified  for
       symbolic  names  of  characters  of  the portable character set and the
       character encoding values  defined  by  the  US-ASCII,  the  result  is
       unspecified.


       If  a non-printable character in the charmap has a width specified that
       is not -1, localedef generates a warning.


       The options such as -C, -L, -m, and -W with their option arguments will
       still  be accepted, but they are not used and not supported. Use of any
       of these will display a warning message specifying  that  they  are  no
       longer needed.



Oracle Solaris 11.4               20 Jun 2016                     localedef(1)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3