Linux用户手册 第1部分
更新日期： 2020-04-11

名称

localedef-编译语言环境定义文件

语法

localedef [选项]输出路径
localedef-添加到归档[选项]编译路径
localedef-从存档中删除[选项] localename ...
localedef --list-archive [选项]
localedef-帮助
localedef-用法
localedef --version

说明

localedef程序读取指示的charmap和输入文件，将它们编译为二进制形式，供C库中的语言环境功能(setlocale(3)，localeconv(3)等)快速使用，并将输出放置在outputpath中。

outputpath参数解释如下：

*

如果outputpath包含斜杠字符('/')，则将其解释为要存储输出定义的目录的名称。在这种情况下，每个语言环境类别(LC_TIME，LC_NUMERIC等)都有单独的输出文件。

*

如果使用--no-archive选项，则outputpath是/ usr / lib / locale中子目录的名称，该子目录中放置了按类别编译的文件。

*

否则，outputpath是语言环境的名称，并且已编译的语言环境数据将添加到归档文件/ usr / lib / locale / locale-archive中。语言环境档案是一个内存映射文件，其中包含系统提供的所有语言环境；未设置环境变量LOCPATH时，所有本地化程序都将使用它。

在任何情况下，如果尚未创建尝试写入区域设置文件的目录，localedef都会中止。

如果未给出charmapfile，则默认使用值ANSI_X3.4-1968(对于ASCII)。如果未提供输入文件，或者以破折号(-)给出，则localedef从标准输入中读取。

选项

Operation-selection options

一些选项指示localedef进行除编译区域设置定义之外的其他操作。一次只能使用这些选项之一。

--add-to-archive

将已编译的路径目录添加到区域设置存档文件。这些目录应该已经由localedef的先前运行使用--no-archive创建。

--delete-from-archive

从语言环境存档文件中删除命名的语言环境。

--list-archive

列出语言环境存档文件中包含的语言环境。

Other options

以下某些选项仅对某些操作才有意义；通常，不言而喻。注意，-f和-c与您期望的相反。也就是说，-f与--force不同。

-fcharmapfile, --charmap=charmapfile

指定定义输入文件使用的字符集的文件。如果charmapfile包含斜杠字符('/')，则将其解释为字符映射的名称。否则，将在当前目录和字符映射的默认目录中搜索文件。如果设置了环境变量I18NPATH，则还会在当前目录之后搜索$ I18NPATH / charmaps /和$ I18NPATH /。字符映射表的默认目录由localedef --help打印。

-iinputfile, --inputfile=inputfile

指定要编译的语言环境定义文件。在语言环境定义文件的当前目录和默认目录中搜索该文件。如果设置了环境变量I18NPATH，则还会在当前目录之后搜索$ I18NPATH / locales /和$ I18NPATH。语言环境定义文件的默认目录由localedef --help打印。

-ureperttheitroadefile, --reperttheitroade-map=reperttheitroadefile

从reperttheitroadefile读取从符号名称到Unicode代码点的映射。如果曲目库文件包含斜杠字符('/')，则将其解释为曲目库映射的路径名。否则，在库目录的当前目录和默认目录中搜索文件。如果设置了环境变量I18NPATH，则还会在当前目录之后搜索$ I18NPATH / reperttheitroademaps /和$ I18NPATH。曲目表的默认目录由localedef --help打印。

-Aaliasfile, --alias-file=aliasfile

使用aliasfile查找语言环境名称的别名。没有默认的别名文件。

-c, --force

即使生成有关输入文件的警告，也要写入输出文件。

-v, --verbose

生成有关通常被忽略的错误的额外警告。

--big-endian

生成big-endian输出。

--little-endian

生成小端输出。

--no-archive

不要使用语言环境存档文件，而是在与语言环境存档文件相同的目录中将outputpath创建为子目录，并在其中为语言环境类别创建单独的输出文件。这有助于防止系统区域设置存档更新覆盖使用localedef创建的自定义区域设置。

--no-hard-links

不要在已安装的语言环境之间创建硬链接。

--no-warnings=warnings

要禁用的警告列表，以逗号分隔。支持的警告为ascii和intcurrsym。

--posix

严格遵守POSIX。暗示-详细。该选项当前没有其他作用。如果设置了环境变量POSIXLY_CORRECT，则假定为POSIX一致性。

--prefix=pathname

将前缀设置为完整的存档路径名。默认情况下，前缀为空。将前缀设置为foo，归档文件将放在foo / usr / lib / locale / locale-archive中。

--quiet

禁止所有通知和警告，并仅报告致命错误。

--replace

在语言环境归档文件中替换语言环境。如果没有此选项，则如果区域设置已在存档文件中，则会发生错误。

--warnings=warnings

要启用的警告的逗号分隔列表。支持的警告为ascii和intcurrsym。

-?, --help

打印使用情况摘要并退出。同时显示localedef使用的默认路径。

--usage

打印简短的使用情况摘要并退出。

-V, --version

打印本地版本的版本号，许可证和免责声明。

退出状态

localedef可以返回以下退出值之一：

0

命令成功完成。

1

发生警告或错误，写入了输出文件。

4

遇到错误，未创建任何输出。

环境

POSIXLY_CORRECT

如果设置了此环境变量，则假定为--posix标志。

I18NPATH

用冒号分隔的文件搜索目录列表。

文件

/usr/share/i18n/charmaps

通常的默认字符映射路径。

/usr/share/i18n/locales

语言环境定义文件的通常默认路径。

/usr/share/i18n/reperttheitroademaps

通常的默认库目录路径。

/usr/lib/locale/locale-archive

通常的默认语言环境存档位置。

/usr/lib/locale

编译的单个区域设置数据文件的通常默认路径。

outputpath/LC_ADDRESS

一个输出文件，其中包含有关地址格式和与地理相关的项目的信息。

outputpath/LC_COLLATE

一个输出文件，其中包含有关比较字符串的规则的信息。

outputpath/LC_CTYPE

包含有关字符类信息的输出文件。

outputpath/LC_IDENTIFICATION

包含有关语言环境的元数据的输出文件。

outputpath/LC_MEASUREMENT

一个输出文件，其中包含有关区域设置度量的信息(公制还是美国习惯)。

outputpath/LC_MESSAGES/SYS_LC_MESSAGES

包含有关语言消息的信息的输出文件应该被打印出来，肯定或否定的答案是什么样的。

outputpath/LC_MONETARY

一个输出文件，其中包含有关货币值格式的信息。

outputpath/LC_NAME

一个输出文件，其中包含有关人员称呼的信息。

outputpath/LC_NUMERIC

一个输出文件，其中包含有关非货币数值格式的信息。

outputpath/LC_PAPER

一个输出文件，其中包含有关与标准纸张尺寸有关的设置的信息。

outputpath/LC_TELEPHONE

一个输出文件，其中包含有关电话服务要使用的格式的信息。

outputpath/LC_TIME

一个输出文件，其中包含有关数据和时间值格式的信息。

遵循规范

POSIX.1-2008。

示例

使用UTF-8字符集编译芬兰语的语言环境文件，并将其添加到默认语言环境档案中，名称为fi_FI.UTF-8：

localedef -f UTF-8 -i fi_FI fi_FI.UTF-8

下一个示例执行相同的操作，但是将文件生成到fi_FI.UTF-8目录中，然后在环境变量LOCPATH设置为当前目录时，程序可以使用这些文件(请注意，最后一个参数必须包含斜杠)：

localedef -f UTF-8 -i fi_FI ./fi_FI.UTF-8

另外参见

区域设置(1)，charmap(5)，区域设置(5)，曲目表(5)，区域设置(7)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。