👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

OpenSolaris 2009.06 - man page for localedef (opensolaris section 1)

localedef(1)				  User Commands 			     localedef(1)

NAME
       localedef - define locale environment

SYNOPSIS
       localedef [-c] [-C compiler_options] [-f charmap]
	    [-i sourcefile] [-L linker_options] [-m model]
	    [-u code_set_name] [-W cc, arg] [-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 set-
       ting of the locale environment variables; see environ(5).

       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 sup-
       ported.

       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-mone-
		      tary 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.

OPTIONS
       The following options are supported:

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

       -C compiler_options    Passes  the  compiler_options  to the C compiler (cc). If more than
			      one option is specified, then  the  options  must  be  enclosed  in
			      quotes ("").

			      This is an old option. Use the -W cc,arg option instead.

       -f charmap	      Specifies  the pathname of a file containing a mapping of character
			      symbols and collating element symbols to	actual	character  encod-
			      ings.  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 stan-
			      dard input.

       -L linker_options      Passes the linker_options to the C compiler (cc) that follows the C
			      source  filename.  If  more  than one option is specified, then the
			      options must be enclosed in quotes ("").

			      This is an old option. Use the -W cc,arg option instead.

       -m model 	      Specifies whether localedef will generate  a  64-bit  or	a  32-bit
			      locale object.

			      Specify  model as ilp32 to generate a 32-bit locale object. Specify
			      lp64 to generate a 64-bit locale object. If the -m  option  is  not
			      specified,  localedef  generates	a 32-bit locale object. And if no
			      other options than -c, -f, and -i options are specified and if  the
			      system running localedef supports the 64-bit environment, localedef
			      additionally generates a 64-bit locale object.

       -u code_set_name       Specifies the name of a codeset used as the target mapping of char-
			      acter  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.

       -W cc,arg	      Passes  arg  options to the C compiler. Each argument must be sepa-
			      rated from the preceding by only a comma. A comma can be part of an
			      argument	by  escaping  it  withan  immediately preceding backslash
			      character; the backslash is removed from the resulting argument.

			      Use this option instead of the -C and -L options.

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

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 defi-
		     nitions  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 processed in one execution, only cate-
		     gories belonging to the same locale can be processed.)

OUTPUT
       localedef creates a temporary C source file that represents the locale's  data.	localedef
       then calls the C compiler to compile this C source file into a shared object.

       If  the -m ilp32 option is specified, localedef calls the C compiler for generating 32-bit
       objects and generates a 32-bit  locale  object.	If  the  -m  lp64  option  is  specified,
       localedef calls the C compiler for generating 64-bit objects and generates a 64-bit locale
       object.

       If the -m option is not specified, localedef calls the C compiler  for  generating  32-bit
       objects	and  generates	a  32-bit  locale object. If no other options than -c, -f, and -i
       options are specified and if the system running localedef supports the 64-bit environment,
       localedef  additionally calls the C compiler for generating 64-bit objects and generates a
       64-bit locale object.

       If no option to the C compiler is explicitly specified using the -W, -C,  or  -L  options,
       localedef  calls  the  C compiler with appropriate C compiler options to generate a locale
       object or objects.

       If the -m ilp32 option is specified, localedef generates a 32-bit locale object named:

       localename.so.version_number

       If the -m lp64 option is specified, localedef generates a 64-bit locale object named:

       localename.so.version_number

       If the -m option is not specified, localedef generates a 32-bit locale object named:

       localename.so.version_number

       and, if appropriate, generates a 64-bit locale object named:

       64-bit_architecture_name/localename.so.version_number

       The shared object for the 32-bit environment must be moved to:

       /usr/lib/locale/localename/localename.so.version_number

       The shared object for the 64-bit environment on SPARC must be moved to:

       /usr/lib/locale/localename/sparcv9/localename.so.version_number

       The shared object for the 64-bit environment on AMD64 must be moved to:

       /usr/lib/locale/<localename>/amd64/<localename>.so.<version_number>

       localedef also generates a text file named localename that is used for information only.

ENVIRONMENT VARIABLES
       See environ(5) for definitions of the following environment variables that affect the exe-
       cution 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 implementation, 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 in the system. This file is used by default.

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

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

       /usr/lib/locale/localename/localename.so.version_number

	   The shared object for the 32-bit environment.

       /usr/lib/locale/localename/sparcv9/localename.so.version_number

	   The shared object for the 64-bit environment on SPARC.

       /usr/lib/locale/<localename>/amd64/<localename>.so.<version_number>

	   The shared object for the 64-bit environment on AMD64.

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       locale(1), iconv_open(3C), nl_langinfo(3C), strftime(3C), attributes(5), charmap(5), envi-
       ron(5), extensions(5), locale(5), standards(5)

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.

NOTES
       When  the -u option is used, the code_set_name option-argument is interpreted as a name of
       a codeset to which the ISO/IEC 10646-1: 2000 standard position constant	values	are  con-
       verted. 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-argu-
       ment 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.

SunOS 5.11				   11 Oct 2004				     localedef(1)


All times are GMT -4. The time now is 05:10 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password