manpages.info - online man pages   

SunOS man pages : 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 ] [ -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 utili- ties whose operational behavior is determined by the setting 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 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 infor- mation. 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. -C compiler_options SunOS 5.8 Last change: 8 Dec 1998 1 User Commands localedef(1) 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 encodings. This option must be speci- fied 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 defini- tions. If this option is not present, source defini- tions will be read from standard 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. -W cc,arg Passes arg options to the C compiler. Each argument must be separated from the preceding by only a comma. (A comma can be part of an argument by escaping it by an immediately preceding backslash character; the backslash is removed from the resulting argument.) Use this option instead of the -C and -L options. SunOS 5.8 Last change: 8 Dec 1998 2 User Commands localedef(1) -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 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 processed in one execution, only categories belonging to the same locale can be pro- cessed.)

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 gen- erates 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 SunOS 5.8 Last change: 8 Dec 1998 3 User Commands localedef(1) 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 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 execution of localedef: 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 lim- its 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. SunOS 5.8 Last change: 8 Dec 1998 4 User Commands localedef(1)

FILES

/usr/lib/localedef/extensions/generic_eucbc.x Describes what a generic EUC locale uses in the sys- tem. This file is used by default. /usr/lib/localedef/extensions/single_byte.x Describes a generic single-byte file used in the sys- tem. /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.

ATTRIBUTES

See attributes(5) for descriptions of the following attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWcsu | |_____________________________|_____________________________|

SEE ALSO

locale(1), nl_langinfo(3C), strftime(3C), attributes(5), charmap(5), environ(5), extensions(5), locale(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 implementa- tion are present in the source. SunOS 5.8 Last change: 8 Dec 1998 5