Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
localedef(1M)							 localedef(1M)

NAME
       localedef - generate a locale environment

SYNOPSIS
       compiler_options] loader_options]

	      method_file] charmap_file] locale_definition] locale_name

DESCRIPTION
       sets  up	 the  language environment for the named locale.  reads	a file
       (see localedef(4) for a detailed	description) from standard input  (de-
       fault)  or  from	locale_definition file,	creates	a locale file with the
       same name as specified for the locale_name  parameter,  and  optionally
       installs	 this  locale  in  the appropriate directory.  Installation of
       public locales (those accessible	to  all	 users)	 requires  appropriate
       privileges.  Creation of	locales	(both private and public) requires ac-
       cess to the ANSI	C compiler.

   Options
       recognizes the following	options:

       Create permanent	output even if warning messages	have been generated.

       Generate	64-bit locale in addition to the 32-bit	locale.	This is	the
		      default on a 64-bit operating system (and	hence  on  IPF
		      systems)	and is included	to allow cross platform	devel-
		      opment.

       (noinstall) Create the locale file in the current directory.

       (verbose) Generate as many diagnostic messages as possible.

       Generate	additional warning messages for	duplicate definitions and  el-
       lipses
		      use in the category.

       If	      file   contains  symbolic	 names	(of  the  form	)  use
		      charmap_file.  See charmap(4) for	a description  of  the
		      format of	a charmap_file.

       Use	      locale_definition	file as	input, instead of standard in-
		      put (default).

       Use the specified
		      method_file to overwrite use of default methods in  pro-
		      cessing the

       Specify	additional compiler options to be applied in compiling the lo-
       cale.
		      See cc_bundled(1)	for a complete list  of	 options.  Use
		      with  care  on a 64-bit operating	system since the addi-
		      tional default option includes +DA2.0W on	PA  and	 +DD64
		      on IPF systems.

       Specify additional loader options to be applied in linking the locale.
		      See ld(1)	for a complete list of options.

       locale_name    This  argument  is  required, and	identifies the name of
		      the language following the naming	convention of the  en-
		      vironment	variable (see environ(5)):

			   language[_territory][.codeset]

       The  following  is a brief description of the components	that make up a
       locale.	For a complete description of the form and syntax of  a	 file,
       see  localedef(4).   For	a complete description of the form and effects
       of a charmap file, see charmap(4).

       Six categories of data in the file are recognized by setlocale(3C), and
       make up a language definition:

	      Information in this category affects behavior
				  of regular-expressions and NLS string-colla-
				  tion functions.

	      Information in this category affects behavior
				  of character classification  and  conversion
				  functions.

	      Information in this category affects behavior
				  of functions that handle monetary values.

	      Information in this category affects handling of the radix char-
	      acter
				  in formatted-input/output and	string-conver-
				  sion functions.

	      Information in this category affects behavior
				  of time-conversion functions.

	      This category contains information
				  affecting   interpretation   of  yes/no  re-
				  sponses.

       A file also consists of six categories.	The beginning of each category
       is identified by	a having the form where	category is one	of the follow-
       ing: or The end of each category	is identified by a tag	consisting  of
       the  word followed by a space and the category identifier; for example,
       Categories can appear in	any order in the file.	At least one  category
       specifications  is  required.   If a category is	not specified, sets up
       the default ``C'' locale	 for  that  category  (see  setlocale(3C)  and
       lang(5)).

       Each  category  is  composed of one or more statements.	Each statement
       begins with a keyword followed by one or	more expressions.  An  expres-
       sion  is	 a  set	of well-formed metacharacters, strings,	and constants.
       also recognizes comments	and separators.

       More than one definition	specified for each category constitutes	a hard
       error  (causes  to exit without generating a locale).  Any category can
       be specified by the keyword followed by the name	 of  a	valid  locale.
       This causes the information for the category to be identical to that in
       the named locale.  Note that the	keyword, if used for a category,  must
       be the first and	only keyword following the category tag.

       A  methods  file	 is used to create locales for user-specific character
       encoding	schemes.

   Operating System Requirements
       For cross platform development and development on  a  64-bit  operating
       system  several	requirements  must  be	observed.  Both	the 32-bit and
       64-bit method libraries must exist. In the case of  the	64-bit	shared
       library	it  must be in the directory ( or in case of PA	systems) under
       the location where the 32-bit library is	located. When  the  option  is
       specified,  or when executing on	a 64-bit operating system, the result-
       ing locale is placed in the directory in	case of	PA systems) under  the
       current working directory unless	the install option has been specified.

NOTE
       A locale	built for one system cannot be used on other systems.

       Users will not be able to generate PA locales on	IPF systems.

EXTERNAL INFLUENCES
   Environment Variables
       determines  the	locale to use when neither or the other	category vari-
       ables specify a locale.

       determines locale to be used.  It overrides any values specified	by  or
       any other variables.

       and  have no effect on the processing of	localedef, which behaves as if
       these two variables were	set to the C locale.

       determines the language in which	messages are displayed.

   International Code Set Support
       Single- and multi-byte character	code sets are supported.

RETURN VALUE
       returns the following values:

	      No errors	occurred and the locale	was successfully created.
	      Warnings occurred	and the	locale was successfully	created.
	      The locale specification exceeded	implementation limits or the
		    coded character set	used is	not supported.
	      Warnings or errors occurred, and no output was generated.

AUTHOR
       was developed by	OSF and	HP.

FILES FOR PA SYSTEMS
FILES FOR IPF SYSTEMS
       In addition to the PA files, the	following files	 are  present  on  IPF
       systems.

SEE ALSO
       locale(1), setlocale(3C), charmap(4), localedef(4), environ(5).

STANDARDS CONFORMANCE
								 localedef(1M)

NAME | SYNOPSIS | DESCRIPTION | NOTE | EXTERNAL INFLUENCES | RETURN VALUE | AUTHOR | FILES FOR PA SYSTEMS | FILES FOR IPF SYSTEMS | SEE ALSO | STANDARDS CONFORMANCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=localedef&sektion=1m&manpath=HP-UX+11.22>

home | help