LOCALEDEF - Linux手册页

时间:2019-08-20 17:58:33  来源:igfitidea点击:

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/