2014-05-26 17:01:45 +00:00
|
|
|
.\" Copyright (C) 2001 Richard Braakman
|
|
|
|
.\" Copyright (C) 2004 Alastair McKinstry
|
|
|
|
.\" Copyright (C) 2005 Lars Wirzenius
|
|
|
|
.\" Copyright (C) 2014 Marko Myllynen
|
2014-05-27 08:05:30 +00:00
|
|
|
.\"
|
2014-05-26 17:01:45 +00:00
|
|
|
.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
|
|
|
|
.\" This is free documentation; you can redistribute it and/or
|
|
|
|
.\" modify it under the terms of the GNU General Public License as
|
|
|
|
.\" published by the Free Software Foundation; either version 2 of
|
|
|
|
.\" the License, or (at your option) any later version.
|
2014-05-27 08:05:30 +00:00
|
|
|
.\"
|
2014-05-26 17:01:45 +00:00
|
|
|
.\" The GNU General Public License's references to "object code"
|
|
|
|
.\" and "executables" are to be interpreted as the output of any
|
|
|
|
.\" document formatting or typesetting system, including
|
|
|
|
.\" intermediate and printed output.
|
|
|
|
.\"
|
|
|
|
.\" This manual is distributed in the hope that it will be useful,
|
|
|
|
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
.\" GNU General Public License for more details.
|
|
|
|
.\"
|
|
|
|
.\" You should have received a copy of the GNU General Public
|
|
|
|
.\" License along with this manual; if not, see
|
|
|
|
.\" <http://www.gnu.org/licenses/>.
|
|
|
|
.\" %%%LICENSE_END
|
|
|
|
.\"
|
|
|
|
.\" This manual page was initially written by Richard Braakman
|
|
|
|
.\" on behalf of the Debian GNU/Linux Project and anyone else
|
2014-05-27 08:05:30 +00:00
|
|
|
.\" who wants it. It was amended by Alastair McKinstry to
|
2014-05-26 17:01:45 +00:00
|
|
|
.\" explain new ISO 14652 elements, and amended further by
|
|
|
|
.\" Lars Wirzenius to document new functionality (as of GNU
|
|
|
|
.\" C library 2.3.5).
|
|
|
|
.\"
|
localedef.1, adjtimex.2, clock_nanosleep.2, epoll_ctl.2, ioctl.2, madvise.2, open.2, posix_fadvise.2, prctl.2, restart_syscall.2, sched_setaffinity.2, select.2, semop.2, setsid.2, sgetmask.2, sigaction.2, sigreturn.2, splice.2, syscall.2, syscalls.2, tee.2, tkill.2, abort.3, cmsg.3, exp10.3, ftw.3, getopt.3, ilogb.3, memcmp.3, mq_open.3, pow.3, pthread_setschedparam.3, sigvec.3, sysconf.3, termios.3, tgamma.3, wordexp.3, locale.5, proc.5, resolv.conf.5, cp1251.7, credentials.7, fanotify.7, inotify.7, locale.7, man-pages.7, signal.7, unix.7, ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-12-31 06:01:38 +00:00
|
|
|
.TH LOCALEDEF 1 2014-12-31 "Linux" "Linux User Manual"
|
2014-05-26 17:01:45 +00:00
|
|
|
.SH NAME
|
|
|
|
localedef \- compile locale definition files
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.ad l
|
|
|
|
.nh
|
|
|
|
.B localedef
|
|
|
|
.RI [ options ]
|
|
|
|
.I outputpath
|
|
|
|
.br
|
|
|
|
.B "localedef \-\-list\-archive"
|
|
|
|
.RI [ options ]
|
|
|
|
.br
|
|
|
|
.B "localedef \-\-delete\-from\-archive"
|
|
|
|
.RI [ options ]
|
|
|
|
.IR localename " ..."
|
|
|
|
.br
|
|
|
|
.B "localedef \-\-add\-to\-archive"
|
|
|
|
.RI [ options ]
|
|
|
|
.IR compiledpath
|
|
|
|
.br
|
|
|
|
.B "localedef \-\-version"
|
|
|
|
.br
|
|
|
|
.B "localedef \-\-help"
|
|
|
|
.br
|
|
|
|
.B "localedef \-\-usage"
|
|
|
|
.ad b
|
|
|
|
.hy
|
|
|
|
.SH DESCRIPTION
|
|
|
|
The
|
|
|
|
.B localedef
|
|
|
|
program reads the indicated
|
|
|
|
.I charmap
|
|
|
|
and
|
|
|
|
.I input
|
|
|
|
files, compiles them to a binary form quickly usable by the
|
2014-05-27 07:39:55 +00:00
|
|
|
locale functions in the C library
|
|
|
|
.RB ( setlocale (3),
|
|
|
|
.BR localeconv (3),
|
2014-05-27 08:05:30 +00:00
|
|
|
etc.), and places the output in
|
2014-05-26 17:01:45 +00:00
|
|
|
.IR outputpath .
|
2014-05-27 08:05:05 +00:00
|
|
|
|
|
|
|
The
|
|
|
|
.I outputpath
|
|
|
|
argument is interpreted as follows:
|
|
|
|
.IP * 3
|
2014-05-26 17:01:45 +00:00
|
|
|
If
|
|
|
|
.I outputpath
|
2014-05-27 08:05:05 +00:00
|
|
|
contains a slash character ('/'), it is interpreted as the name of the
|
|
|
|
directory where the output defintions are to be stored.
|
2014-05-26 17:01:45 +00:00
|
|
|
In this case, there is a separate output file for each locale category
|
2014-05-27 08:05:05 +00:00
|
|
|
.RI ( LC_CTIME ,
|
|
|
|
.IR LC_NUMERIC ,
|
|
|
|
and so on).
|
|
|
|
.IP *
|
2014-05-27 08:05:30 +00:00
|
|
|
If the
|
2014-05-26 17:01:45 +00:00
|
|
|
.B \-\-no\-archive
|
|
|
|
option is used,
|
|
|
|
.I outputpath
|
|
|
|
is the name of a subdirectory in
|
2014-05-27 08:05:05 +00:00
|
|
|
.I /usr/lib/locale
|
2014-05-26 17:01:45 +00:00
|
|
|
where per-category compiled files are placed.
|
2014-05-27 08:05:05 +00:00
|
|
|
.IP *
|
2014-05-27 08:05:30 +00:00
|
|
|
Otherwise,
|
2014-05-26 17:01:45 +00:00
|
|
|
.I outputpath
|
|
|
|
is the name of a locale and the compiled locale data is added to the
|
2014-05-27 08:05:30 +00:00
|
|
|
archive file
|
2014-05-26 17:01:45 +00:00
|
|
|
.IR /usr/lib/locale/locale-archive .
|
2014-05-27 08:05:05 +00:00
|
|
|
A locale archive is a memory-mapped file which contains all the
|
|
|
|
system-provided locales;
|
|
|
|
it is used by all localized programs when the environment variable
|
2014-05-26 17:01:45 +00:00
|
|
|
.B LOCPATH
|
|
|
|
is not set.
|
|
|
|
.PP
|
|
|
|
In any case,
|
|
|
|
.B localedef
|
|
|
|
aborts if the directory in which it tries to write locale files has
|
|
|
|
not already been created.
|
|
|
|
.PP
|
|
|
|
If no
|
|
|
|
.I charmapfile
|
|
|
|
is given, the value
|
|
|
|
.I ANSI_X3.4-1968
|
|
|
|
(for ASCII) is used by default.
|
|
|
|
If no
|
|
|
|
.I inputfile
|
|
|
|
is given, or if it is given as a dash
|
2014-05-27 08:05:05 +00:00
|
|
|
(\-),
|
2014-05-26 17:01:45 +00:00
|
|
|
.B localedef
|
|
|
|
reads from standard input.
|
|
|
|
.SH OPTIONS
|
2014-05-27 08:05:05 +00:00
|
|
|
.SS Operation-selection options
|
2014-05-27 08:05:30 +00:00
|
|
|
A few options direct
|
2014-05-26 17:01:45 +00:00
|
|
|
.B localedef
|
2014-05-27 08:05:05 +00:00
|
|
|
to do something other than compile locale definitions.
|
|
|
|
Only one of these options should be used at a time.
|
2014-05-26 17:01:45 +00:00
|
|
|
.TP
|
|
|
|
.B \-\-delete\-from\-archive
|
|
|
|
Delete the named locales from the locale archive file.
|
|
|
|
.TP
|
|
|
|
.B \-\-list\-archive
|
|
|
|
List the locales contained in the locale archive file.
|
|
|
|
.TP
|
|
|
|
.B \-\-add\-to\-archive
|
2014-05-27 08:05:30 +00:00
|
|
|
Add the
|
2014-05-26 17:01:45 +00:00
|
|
|
.I compiledpath
|
|
|
|
directories to the locale archive file.
|
2014-05-27 08:05:30 +00:00
|
|
|
The directories should have been created by previous runs of
|
2014-05-26 17:01:45 +00:00
|
|
|
.BR localedef ,
|
2014-05-27 08:05:30 +00:00
|
|
|
using
|
2014-05-26 17:01:45 +00:00
|
|
|
.BR \-\-no\-archive .
|
2014-05-27 08:05:05 +00:00
|
|
|
.SS Other options
|
2014-05-27 08:05:30 +00:00
|
|
|
Some of the following options are only sensible for certain operations;
|
2014-05-26 17:01:45 +00:00
|
|
|
generally, it should be self-evident which ones.
|
|
|
|
.TP
|
|
|
|
.BI \-f " charmapfile" ", \-\-charmap=" charmapfile
|
2014-06-04 05:58:53 +00:00
|
|
|
Specify the file that defines the character set
|
|
|
|
that is used by the input file.
|
2014-05-26 17:01:45 +00:00
|
|
|
If
|
|
|
|
.I charmapfile
|
|
|
|
contains a slash character ('/'),
|
2014-05-27 08:05:05 +00:00
|
|
|
it is interpreted as the name of the character map.
|
2014-05-27 08:05:30 +00:00
|
|
|
Otherwise, the file is sought in the current directory
|
2014-05-26 17:01:45 +00:00
|
|
|
and the default directory for character maps.
|
|
|
|
If the environment variable
|
|
|
|
.B I18NPATH
|
2014-05-27 08:05:30 +00:00
|
|
|
is set,
|
2014-05-27 08:05:05 +00:00
|
|
|
.I $I18NPATH/charmaps/
|
2014-05-26 17:01:45 +00:00
|
|
|
and
|
2014-05-27 08:05:05 +00:00
|
|
|
.I $I18NPATH/
|
2014-05-26 17:01:45 +00:00
|
|
|
are also searched after the current directory.
|
|
|
|
The default directory for character maps is printed by
|
|
|
|
.BR "localedef \-\-help" .
|
|
|
|
.TP
|
|
|
|
.BI \-i " inputfile" ", \-\-inputfile=" inputfile
|
|
|
|
Specify the locale definition file to compile.
|
2014-05-27 08:05:05 +00:00
|
|
|
The file is sought in the current directory
|
2014-05-26 17:01:45 +00:00
|
|
|
and the default directory for locale definition files.
|
|
|
|
If the environment variable
|
|
|
|
.B I18NPATH
|
2014-05-27 08:05:30 +00:00
|
|
|
is set,
|
2014-05-27 08:05:05 +00:00
|
|
|
.I $I18NPATH/locales/
|
2014-05-26 17:01:45 +00:00
|
|
|
and
|
2014-05-27 08:05:05 +00:00
|
|
|
.I $I18NPATH
|
2014-05-26 17:01:45 +00:00
|
|
|
are also searched after the current directory.
|
|
|
|
The default directory for locale definition files is printed by
|
|
|
|
.BR "localedef \-\-help" .
|
|
|
|
.TP
|
|
|
|
.BI \-u " repertoirefile" ", \-\-repertoire-map=" repertoirefile
|
2014-06-04 05:58:53 +00:00
|
|
|
Read mappings from symbolic names to Unicode code points from
|
2014-05-26 17:01:45 +00:00
|
|
|
.IR repertoirefile .
|
|
|
|
If
|
|
|
|
.I repertoirefile
|
|
|
|
contains a slash character ('/'),
|
2014-05-27 08:05:05 +00:00
|
|
|
it is interpreted as the pathname of the repertoire map.
|
|
|
|
Otherwise, the file is sought in the current directory
|
2014-05-26 17:01:45 +00:00
|
|
|
and the default directory for repertoire maps.
|
|
|
|
If the environment variable
|
|
|
|
.B I18NPATH
|
2014-05-27 08:05:30 +00:00
|
|
|
is set,
|
2014-05-27 08:05:05 +00:00
|
|
|
.I $I18NPATH/repertoiremaps/
|
2014-05-26 17:01:45 +00:00
|
|
|
and
|
2014-05-27 08:05:05 +00:00
|
|
|
.I $I18NPATH
|
2014-05-26 17:01:45 +00:00
|
|
|
are also searched after the current directory.
|
|
|
|
The default directory for repertoire maps is printed by
|
|
|
|
.BR "localedef \-\-help" .
|
|
|
|
.TP
|
|
|
|
.BI \-A " aliasfile" ", \-\-alias\-file=" aliasfile
|
2014-05-27 08:05:30 +00:00
|
|
|
Use
|
2014-05-26 17:01:45 +00:00
|
|
|
.I aliasfile
|
|
|
|
to look up aliases for locale names.
|
|
|
|
There is no default aliases file.
|
|
|
|
.TP
|
|
|
|
.BI \-\-prefix= pathname
|
2014-05-27 08:05:05 +00:00
|
|
|
Set the prefix to be prepended to the full archive pathname.
|
2014-05-26 17:01:45 +00:00
|
|
|
By default, the prefix is empty.
|
2014-05-27 08:05:30 +00:00
|
|
|
Setting the prefix to
|
2014-05-26 17:01:45 +00:00
|
|
|
.IR foo ,
|
|
|
|
the archive would be placed in
|
|
|
|
.IR foo/usr/lib/locale/locale-archive .
|
|
|
|
.TP
|
2014-06-23 20:18:37 +00:00
|
|
|
.BR \-c ", " \-\-force
|
2014-05-26 17:01:45 +00:00
|
|
|
Write the output files even if warnings were generated about the input
|
|
|
|
file.
|
|
|
|
.TP
|
|
|
|
.B \-\-old\-style
|
|
|
|
Create old-style hash tables instead of 3-level access tables.
|
|
|
|
.TP
|
2014-06-23 20:18:37 +00:00
|
|
|
.BR \-v ", " \-\-verbose
|
2014-05-26 17:01:45 +00:00
|
|
|
Generate extra warnings about errors that are normally ignored.
|
|
|
|
.TP
|
|
|
|
.B \-\-quiet
|
|
|
|
Suppress all notifications and warnings, and report only fatal errors.
|
|
|
|
.TP
|
|
|
|
.B \-\-posix
|
|
|
|
Conform strictly to POSIX. Implies
|
|
|
|
.BR \-\-verbose .
|
|
|
|
This option currently has no other effect.
|
|
|
|
POSIX conformance is assumed if the environment variable
|
|
|
|
.B POSIXLY_CORRECT
|
|
|
|
is set.
|
|
|
|
.TP
|
|
|
|
.B \-\-replace
|
|
|
|
Replace a locale in the locale archive file.
|
|
|
|
Without this option, if the locale is in the archive file already,
|
|
|
|
an error occurs.
|
|
|
|
.TP
|
|
|
|
.B \-\-no\-archive
|
2014-05-27 08:05:30 +00:00
|
|
|
Do not use the locale archive file, instead create
|
2014-05-26 17:01:45 +00:00
|
|
|
.I outputpath
|
|
|
|
as a subdirectory in the same directory as the locale archive file,
|
|
|
|
and create separate output files for locale categories in it.
|
|
|
|
.TP
|
2014-06-23 20:18:37 +00:00
|
|
|
.BR \-? ", " \-\-help
|
2014-05-26 17:01:45 +00:00
|
|
|
Print a usage summary and exit.
|
|
|
|
Also prints the default paths used by
|
|
|
|
.BR localedef .
|
|
|
|
.TP
|
|
|
|
.B "\-\-usage"
|
|
|
|
Print a short usage summary and exit.
|
|
|
|
.TP
|
2014-06-23 20:18:37 +00:00
|
|
|
.BR \-V ", " \-\-version
|
2014-05-26 17:01:45 +00:00
|
|
|
Print the version number, license, and disclaimer of warranty for
|
|
|
|
.BR localedef .
|
|
|
|
.SH EXIT STATUS
|
|
|
|
One of the following exit values can be returned by
|
|
|
|
.BR localedef :
|
|
|
|
.RS 3
|
|
|
|
.TP 10
|
|
|
|
.B 0
|
|
|
|
Command completed successfully.
|
|
|
|
.TP
|
|
|
|
.B 1
|
|
|
|
Warnings or errors occurred, output files were written.
|
|
|
|
.TP
|
|
|
|
.B 4
|
|
|
|
Errors encountered, no output created.
|
|
|
|
.RE
|
|
|
|
.SH ENVIRONMENT
|
|
|
|
.TP
|
|
|
|
.B POSIXLY_CORRECT
|
|
|
|
The
|
|
|
|
.B \-\-posix
|
|
|
|
flag is assumed if this environment variable is set.
|
|
|
|
.TP
|
|
|
|
.B I18NPATH
|
|
|
|
A colon-separated list of search directories for files.
|
|
|
|
.SH FILES
|
|
|
|
.TP
|
|
|
|
.I /usr/share/i18n/charmaps
|
|
|
|
Usual default character map path.
|
|
|
|
.TP
|
|
|
|
.I /usr/share/i18n/locales
|
|
|
|
Usual default path for locale definition files.
|
|
|
|
.TP
|
|
|
|
.I /usr/share/i18n/repertoiremaps
|
|
|
|
Usual default repertoire map path.
|
|
|
|
.TP
|
|
|
|
.I /usr/lib/locale/locale-archive
|
|
|
|
Usual default locale archive location.
|
2014-12-31 06:46:42 +00:00
|
|
|
.TP
|
|
|
|
.I /usr/lib/locale
|
2014-10-20 05:21:53 +00:00
|
|
|
Usual default path for compiled individual locale data files.
|
2014-05-26 17:01:45 +00:00
|
|
|
.TP
|
|
|
|
.I outputpath/LC_ADDRESS
|
2014-06-10 17:39:20 +00:00
|
|
|
An output file that contains information about formatting of
|
2014-05-26 17:01:45 +00:00
|
|
|
addresses and geography-related items.
|
|
|
|
.TP
|
|
|
|
.I outputpath/LC_COLLATE
|
2014-05-27 08:05:30 +00:00
|
|
|
An output file that contains information about the rules for comparing
|
2014-05-26 17:01:45 +00:00
|
|
|
strings.
|
|
|
|
.TP
|
|
|
|
.I outputpath/LC_CTYPE
|
|
|
|
An output file that contains information about character classes.
|
|
|
|
.TP
|
|
|
|
.I outputpath/LC_IDENTIFICATION
|
|
|
|
An output file that contains metadata about the locale.
|
|
|
|
.TP
|
|
|
|
.I outputpath/LC_MEASUREMENT
|
2014-05-27 08:05:30 +00:00
|
|
|
An output file that contains information about locale measurements
|
2014-05-26 17:01:45 +00:00
|
|
|
(metric versus US customary).
|
|
|
|
.TP
|
|
|
|
.I outputpath/LC_MESSAGES/SYS_LC_MESSAGES
|
2014-05-27 08:05:30 +00:00
|
|
|
An output file that contains information about the language messages
|
|
|
|
should be printed in, and what an affirmative or negative answer looks
|
2014-05-26 17:01:45 +00:00
|
|
|
like.
|
|
|
|
.TP
|
|
|
|
.I outputpath/LC_MONETARY
|
2014-05-27 08:05:30 +00:00
|
|
|
An output file that contains information about formatting of monetary
|
2014-05-26 17:01:45 +00:00
|
|
|
values.
|
|
|
|
.TP
|
|
|
|
.I outputpath/LC_NAME
|
|
|
|
An output file that contains information about salutations for persons.
|
|
|
|
.TP
|
|
|
|
.I outputpath/LC_NUMERIC
|
2014-05-27 08:05:30 +00:00
|
|
|
An output file that contains information about formatting of nonmonetary
|
2014-05-26 17:01:45 +00:00
|
|
|
numeric values.
|
|
|
|
.TP
|
|
|
|
.I outputpath/LC_PAPER
|
2014-05-27 08:05:30 +00:00
|
|
|
An output file that contains information about settings related to
|
2014-05-26 17:01:45 +00:00
|
|
|
standard paper size.
|
|
|
|
.TP
|
|
|
|
.I outputpath/LC_TELEPHONE
|
2014-05-27 08:05:30 +00:00
|
|
|
An output file that contains information about formats to be used with
|
2014-05-26 17:01:45 +00:00
|
|
|
telephone services.
|
|
|
|
.TP
|
|
|
|
.I outputpath/LC_TIME
|
2014-05-27 08:05:30 +00:00
|
|
|
An output file that contains information about formatting of data and
|
2014-05-26 17:01:45 +00:00
|
|
|
time values.
|
|
|
|
.SH CONFORMING TO
|
|
|
|
POSIX.1-2008.
|
|
|
|
.SH EXAMPLE
|
|
|
|
Compile the locale files for Finnish in the UTF\-8 character set
|
2014-05-27 08:05:30 +00:00
|
|
|
and add it to the default locale archive with the name
|
2014-05-26 17:01:45 +00:00
|
|
|
.BR fi_FI.UTF\-8 :
|
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
localedef \-f UTF\-8 \-i fi_FI fi_FI.UTF\-8
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
The next example does the same thing, but generates files into the
|
2014-05-27 08:05:05 +00:00
|
|
|
.I fi_FI.UTF\-8
|
2014-05-26 17:01:45 +00:00
|
|
|
directory which can then be used by programs when the environment
|
|
|
|
variable
|
|
|
|
.B LOCPATH
|
2014-05-27 08:05:30 +00:00
|
|
|
is set to the current directory (note that the last argument must
|
2014-05-26 17:01:45 +00:00
|
|
|
contain a slash):
|
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
localedef \-f UTF\-8 \-i fi_FI ./fi_FI.UTF\-8
|
|
|
|
.RE
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR locale (1),
|
2014-06-04 05:58:53 +00:00
|
|
|
.BR charmap (5),
|
2014-05-26 17:01:45 +00:00
|
|
|
.BR locale (5),
|
2014-06-04 05:58:53 +00:00
|
|
|
.BR repertoiremap (5),
|
2014-05-26 17:01:45 +00:00
|
|
|
.BR locale (7)
|