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).
|
|
|
|
.\"
|
ldd.1, localedef.1, add_key.2, chroot.2, clone.2, fork.2, futex.2, get_mempolicy.2, get_robust_list.2, getitimer.2, getpriority.2, ioctl.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, kcmp.2, kill.2, lookup_dcookie.2, mmap.2, mount.2, open.2, pciconfig_read.2, perf_event_open.2, prctl.2, process_vm_readv.2, ptrace.2, quotactl.2, recv.2, setfsgid.2, setfsuid.2, sysinfo.2, umask.2, umount.2, unshare.2, utimensat.2, wait.2, assert.3, fmax.3, fmin.3, getauxval.3, inet_pton.3, malloc_hook.3, memmem.3, mkdtemp.3, mktemp.3, printf.3, strcasecmp.3, strcat.3, strtoul.3, strxfrm.3, console_codes.4, console_ioctl.4, lirc.4, tty.4, vcs.4, charmap.5, elf.5, locale.5, proc.5, repertoiremap.5, utmp.5, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, cp1251.7, cp1252.7, credentials.7, feature_test_macros.7, iso_8859-1.7, iso_8859-15.7, iso_8859-5.7, koi8-r.7, koi8-u.7, man-pages.7, mount_namespaces.7, namespaces.7, netlink.7, pid_namespaces.7, unix.7, user_namespaces.7, utf-8.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-07-17 16:07:58 +00:00
|
|
|
.TH LOCALEDEF 1 2016-07-17 "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
|
2015-01-31 01:49:48 +00:00
|
|
|
directory where the output definitions 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
|
2015-06-09 14:19:01 +00:00
|
|
|
.RI ( LC_TIME ,
|
2014-05-27 08:05:05 +00:00
|
|
|
.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
|
2016-11-11 08:41:35 +00:00
|
|
|
Some of the following options are sensible only 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
|
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.
|
2016-02-19 12:04:47 +00:00
|
|
|
This is helpful to prevent system locale archive updates from overwriting
|
2016-02-18 22:38:47 +00:00
|
|
|
custom locales created with
|
|
|
|
.BR localedef .
|
2014-05-26 17:01:45 +00:00
|
|
|
.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
|
iconv.1, localedef.1, access.2, execveat.2, fanotify_init.2, futex.2, ioctl_fat.2, mount.2, ftw.3, sd.4, tty_ioctl.4, fanotify.7, futex.7, posixoptions.7, iconvconfig.8: srcfix: Remove useless quotes from .SS and .SH sections
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-08 02:03:52 +00:00
|
|
|
.SH SEE ALSO
|
2014-05-26 17:01:45 +00:00
|
|
|
.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)
|