FreeBSD Manual 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] lo- calename 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(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 en- vironment variable name and terminated by an END category-name state- ment. 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 in- formation. 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 re- sponses. OPTIONS The following options are supported: -c Creates permanent output even if warning messages have been is- sued. -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 charac- ter symbols and collating element symbols to actual character en- codings. 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 map- ping 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. -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. Spec- ify 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 sep- arated from the preceding by only a comma. (A comma can be part of an argument by escaping it by an immediately preceding back- slash character; the backslash is removed from the resulting ar- gument.) 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 definitions will be stored. This capability may be restricted to users with appropriate privileges. (As a consequence of specifying one localename, although several cate- gories can be processed in one execution, only categories belong- ing to the same locale can be processed.) OUTPUT localedef creates a temporary C source file that represents the lo- cale'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 gener- ating 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 sys- tem running localedef supports the 64-bit environment, localedef addi- tionally calls the C compiler for generating 64-bit objects and gener- ates 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 lo- cale 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 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 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 im- plementation. >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. ATTRIBUTES See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | 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 implementation are present in the source. SunOS 5.9 8 Dec 1998 localedef(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | OUTPUT | ENVIRONMENT VARIABLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO | WARNINGS
Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=localedef&sektion=1&manpath=SunOS+5.9>