*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> localedef (1)              


localedef(1)							  localedef(1)

NAME    [Toc]    [Back]

     localedef - define	locale environment

SYNOPSIS    [Toc]    [Back]

     localedef [-c][-f charmap][-i sourcefile] name

DESCRIPTION    [Toc]    [Back]

     The localedef utility converts source definitions for locale categories
     into the locale source files usable by the	locale generators such as
     chrtbl, wchrtbl, colltbl, and montbl. It will then	execute	those
     generators	to produce the locale runtime files LC_CTYPE, LC_COLLATE, and
     LC_MONETARY respectively.

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

     The name operand identifies the target locale. 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.

	  Defines character classification and case conversion.

	  Defines collation rules.

	  Defines the format and symbols used in formatting of monetary

	  Defines the decimal delimiter, grouping and grouping symbol for
	  non-monetary numeric editing.

	  Defines the format and content of date and time information.

	  Defines the format and values	of affirmative and negative responses.

     The localedef utility supports the	XPG4 localedef source defined by XBD
     specification, Section 10.2, Utility Syntax Guidelines.

     The following options are supported:

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

     -f	charmap
	  Specify the pathname of a file containing a mapping of character
	  symbols and collating	element	symbols	to actual character encodings.

									Page 1

localedef(1)							  localedef(1)

	  The format of	the charmap is described under the XBD specification,
	  Section 4.4, Character Set Description File.	This option must be
	  specified if symbolic	names (other than collating symbols defined in
	  a collating-symbol keyword) are used.	 Default is the	POSIX
	  character mapping file, /usr/lib/locale/charmap/POSIX.

     -i	inputfile
	  The pathname of a file containing the	source definitions. If this
	  option is not	present, source	definitions will be read from standard
	  input. The format of the inputfile is	described in the XBD
	  specification, Section 5.3, Locale Definition.

     name Identifies the locale. See the XBD specification, Chapter 5, Locale
	  for a	description of the use of this name. The name will be the
	  directory name that is used for the locale files for chrtbl,
	  wchrtbl, colltbl, and	montbl.

     To	have localedef create a	permanent output, first	it has to be run by
     the superuser. Secondly, the name argument	has to be prefixed with
     /usr/lib/locale/. Also, the codeset name is specified in the charmap file
     using the <code_set_name> directive has to	be known to the	system.	To
     find out what codeset names are defined, use the iconv -l command.	See
     the iconv(1) man page.

EXAMPLES    [Toc]    [Back]

     localedef -f foo.cm -i foo.src foo

     In	the above examples, the	locale files will be created in	the foo
     directory as LC_COLLATE, LC_CTYPE,	LC_MONETARY, LC_TIME, chrtbl_foo,
     ctype.c, colltbl_foo, montbl_foo and nl_lang_foo.src.

SEE ALSO    [Toc]    [Back]

     chrtbl(3M), wchrtbl(3M), colltbl(3M), montbl(3M), iconv(1)

FILES    [Toc]    [Back]

	  system supported locales
	  POSIX	character mapping file

NOTE    [Toc]    [Back]

     In	IRIX 6.5, the content of the LC_CTYPE locale category was extended to
     comply with the XPG/4 standard.  The older	LC_CTYPE binary	format will
     not be recognized by the C	library.  Therefore, all custom-built locales
     created under an older version of IRIX must be regenerated	with the later
     versions of localedef(1) and associated chrtbl(1M)/wchrtbl(1M).

									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
localedef HP-UX generate a locale environment
localedef Tru64 Builds a locale from locale and character map source files
env IRIX set environment for command execution, print environment
printenv Tru64 Displays or sets the current environment, or displays the values of environment variables
env Tru64 Displays or sets the current environment, or displays the values of environment variables
nl_langinfo NetBSD get locale information
setlocale Linux set the current locale.
nl_langinfo OpenBSD get locale information
locale FreeBSD get locale-specific information
locale IRIX get locale-specific information
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service