|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
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 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 informa-
tion.
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 responses.
SunOS 5.10 Last change: 11 Oct 2004 1
User Commands localedef(1)
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 sym-
bols 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 defin-
itions 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.
SunOS 5.10 Last change: 11 Oct 2004 2
User Commands localedef(1)
-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 character
symbols and collating element sym-
bols whose encoding values are
defined in terms of the ISO/IEC
10646-1: 2000 standard position con-
stant values. See NOTES.
-W cc,arg Passes arg options to the C com-
piler. Each argument must be
separated 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:
SunOS 5.10 Last change: 11 Oct 2004 3
User Commands localedef(1)
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 conse-
quence of specifying one localename,
although several categories can be processed
in one execution, only categories 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 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
If the -m option is not specified, localedef generates a
32-bit locale object named:
localename.so.version_number
SunOS 5.10 Last change: 11 Oct 2004 4
User Commands localedef(1)
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 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 success-
fully 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 sup-
ported by the implementation.
SunOS 5.10 Last change: 11 Oct 2004 5
User Commands localedef(1)
>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 attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
| Interface Stability | Standard |
|_____________________________|_____________________________|
SunOS 5.10 Last change: 11 Oct 2004 6
User Commands localedef(1)
SEE ALSO
locale(1), iconv_open(3C), nl_langinfo(3C), strftime(3C),
attributes(5), charmap(5), environ(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 implementa-
tion 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
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 correspond-
ing 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.
SunOS 5.10 Last change: 11 Oct 2004 7
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:25:02 GMT 2007
|
Your favourite pages:
No pages logged yet.
Trying to save cookie... Top 10 most popular pages:
sqlite3 man page (5334 hits)
(openSUSE 10.2)
svn man page (5208 hits)
(FreeBSD 6.2)
adv_cap_autoneg man page (4870 hits)
(Solaris 10 11_06)
CPAN man page (4607 hits)
(Suse Linux 10.1)
ssh man page (4342 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (2874 hits)
(Solaris 10 11_06)
netcat man page (2717 hits)
(Suse Linux 10.1)
pprosetup man page (2487 hits)
(Solaris 10 11_06)
startproc man page (2471 hits)
(Suse Linux 10.1)
signal man page (2406 hits)
(Suse Linux 10.1)
|
Man Pages 
