idnconv

- 国际化域名 (Internationalized Domain Name, IDN) 编码转换实用程序

用法概要

idnconv 
     [-i in-code | --in in-code | -f in-code | --from in-code] 
     [-o out-code | --out out-code | -t out-code | --to out-code] 
     [-a | --asciicheck | --ascii-check] 
     [-A | --noasciicheck | --no-ascii-check] 
     [-b | --bidicheck | --bidi-check] 
     [-B | --nobidicheck | --no-bidi-check] 
     [-l | --lengthcheck | --length-check] 
     [-L | --nolengthcheck | --no-length-check] 
     [-n | --nameprep] [-N | --nonameprep | --no-nameprep] 
     [-u | --unassigncheck | --unassign-check] 
     [-U | --nounassigncheck | --no-unassign-check] 
     [-h | --help] [-v | --version] [file]...

描述

idnconv 转换给定的文本的代码集或编码（如果适用）。您可以使用不同的选项来更改转换。idnconv 从文件或标准输入中进行读取，然后将结果写入到标准输出中。

当提供多个 IDN 名称或标签作为输入时，可以使用 POSIX 语言环境的空格字符或 RFC 3490 中定义的标签分隔符分隔这些名称或标签。

idnconv 的主要用途是将国际化域名从一种代码集或编码转换为另一种代码集或编码。例如，可以使用该实用程序将采用 UTF-8 代码集的 IDN 名称转换为采用 ASCII 兼容编码 (ASCII Compatible Encoding, ACE) 进行编码的 7 位 ASCII IDN 名称。对于任何其他意图的代码集转换，请改用 iconv(1)。

选项

支持下列选项：

-a | --asciicheck | --ascii-check

在 IDN 转换过程中，执行 ASCII 字符范围检查。

其作用与设置 RFC 3490 中介绍的 UseSTD3ASCIIRules 标志相同。有关 ASCII 字符范围检查的更多信息，请参阅 idn_decodename(3EXT) 和 RFC 3490。这是缺省值。

-A | --noasciicheck | --no-ascii-check

在 IDN 转换过程中，不执行 ASCII 字符范围检查。

其作用与取消设置 RFC 3490 中介绍的 UseSTD3ASCIIRules 标志相同。有关 ASCII 字符范围检查的更多信息，请参阅 idn_decodename(3EXT) 和 RFC 3490。

-b | --bidicheck | --bidi-check

在 IDN 转换过程中，执行 RFC 3491 和 RFC 3454 中指定的双向字符串检查。

这是缺省值。

-B | --nobidicheck | --no-bidi-check

在 IDN 转换过程中，不执行 RFC 3491 和 RFC 3454 中指定的双向字符串检查。

-h | --help

输出有关它支持的实用程序和选项的信息。

所有其他选项和操作数（如果有）将被忽略。

-i in-code| --in in-code| -f in-code | --from in-code

使用 in-code 参数标识输入代码集。所有可转换为 UTF-8 的 iconv 代码转换名称都可以用作 in-code 的值。如果未提供代码集，则会采用当前语言环境的代码集作为输入的代码集。该实用程序还检查实际输入中的所有个体名称，如果该名称以 ACE 编码，则会采用 ACE 作为该名称的 in-code。

-l | --lengthcheck | --length-check

在 IDN 转换过程中，执行标签长度检查。

请参见 idn_decodename(3EXT) 和 RFC 3490。这将确保每个标签的长度在范围 1 到 63 内。这是缺省值。

-L | --nolengthcheck | --no-length-check

在 IDN 转换过程中，不执行标签长度检查。

请参见 idn_decodename(3EXT) 和 RFC 3490。

-n | --nameprep

在 IDN 转换过程中，执行在 RFC 3490、RFC 3491 和 RFC 3454 中指定的 Nameprep 步骤。这是缺省值。

-N | --nonameprep | --no-nameprep

在 IDN 转换过程中，不执行 Nameprep 步骤。有关 Nameprep 的更多详细信息，请参阅 idn_decodename(3EXT)、RFC 3490、RFC 3491 和 RFC 3454。

-o out-code | --out out-code | --t out-code | --to out-code

使用 out-code 参数标识输出代码集。

所有可转换为 UTF-8 的 iconv 代码转换名称都可以用作 out-code 的值。如果未提供输出代码集，则会采用当前语言环境的代码集作为输出的代码集；如果 in-code 为 ACE，则实用程序会尝试将实际输入的名称转换为采用输出代码集的非 ACE IDN 名称。

-u | --unassigncheck | --unassign-check

在 IDN 转换过程期间，执行未分配字符检查。

其作用与取消设置 RFC 3490 中介绍的 AllowUnassigned 标志相同。在转换 IDN 名称以用于存储或将名称赋予服务器计算机时，该选项非常有用。有关未分配字符检查的更多详细信息，请参阅 RFC 3490、RFC 3491 和 RFC 3454。这是缺省值。

-U | --nounassigncheck | --no-unassign-check

在 IDN 转换过程中，不执行未分配字符检查。

其作用与设置 RFC 3490 中介绍的 AllowUnassigned 标志相同。在转换 IDN 名称以用于查询时，该选项非常有用。有关未分配字符检查的更多详细信息，请参阅 RFC 3490、RFC 3491 和 RFC 3454。

-v | --version

输出有关实用程序的名称、版本和合法状态的信息。所有其他选项和操作数（如果有）将被忽略。

操作数

支持下列操作数：

file

要转换的输入文件的路径名称。如果省略了该文件，则将使用标准输入。

示例

示例 1 转换 IDN 名称

以下示例用于转换 IDN 名称。

它从标准输入中读取采用当前语言环境的代码集的名称。然后，进行转换并将转换后的结果写入到 results.txt 文件中。如果提供给该实用程序的名称以 ACE 编码，则结果是采用当前语言环境的代码集的非 ACE IDN 名称。如果提供给该实用程序的名称是非 ACE IDN 名称，则结果是以 ACE 编码的 IDN 名称。

example% idnconv > results.txt

示例 2 转换以 ACE 编码的 IDN 名称

以下示例将以 ACE 编码的 IDN 名称转换为以 UTF-8 编码的 IDN 名称。

它从标准输入中读取以 ACE 编码的 xn--1lq90i。然后，将转换后的结果写入到文件 Beijing-UTF-8.txt 中。该文件包含采用 UTF-8 代码集的两个汉字“北京”。

example% idnconv -t UTF-8 > Beijing-UTF-8.txt
xn--1lq90i
CTRLd

示例 3 转换采用 KOI8-R Cyrillic 单字节代码集的名称

以下示例将采用 KOI8-R Cyrillic 单字节代码集的名称转换为以 ACE 编码的名称。

它从采用 KOI8-R 代码集的文件 inputfile.txt 中读取输入，然后将转换后的结果写入到标准输出中。结果是以 ACE 编码的。

example% idnconv --in KOI8-R --out ACE inputfile.txt 
xn--80adxhks
xn--90aqflb3d1a
xn--80aesccdb4a2a8c
example% 

示例 4 转换名称以用于存储

以下示例转换名称以用于存储。

它从采用 ISO8859-1 代码集的文件 inputfile.txt 中读取输入。然后，进行转换并将结果写入到以 ACE 编码的 outputfile.txt 中。它还生成适合用作服务器名称的 ACE 名称。

example% idnconv --from ISO8859-1 --to ACE --unassign-check\
     inputfile.txt > outputfile.txt 

示例 5 转换名称以用于查询

以下示例转换名称以用于查询。

它从采用当前语言环境的代码集的标准输入进行读取。然后，进行转换并将结果写入到以 ACE 编码的 outputfile.txt 中。

example% idnconv -U -t ACE > outputfile.txt

环境变量

有关影响 idnconv 执行的环境变量 LANG、LC_ALL、LC_CTYPE、LC_MESSAGES 和 NLSPATH 的描述，请参见 environ(5)。

退出状态

将返回以下退出值：

0

成功完成。

1

不受支持的 in-code 或 out-code 值。

2

ASCII 字符范围检查失败。

3

双向字符串检查失败。

4

标签长度检查失败。

5

Nameprep 步骤报告了错误。

6

发现了未分配字符。

7

提供了非法的或未知的选项。

8

找不到输入文件。

9

内存不足。

10

在内部 iconv 代码转换期间发生转换错误。

11

在内部 iconv 代码转换期间发生了不相同的代码转换。

>11

发生了未指明的错误。

属性

有关下列属性的描述，请参见 attributes(5)：

另请参见

iconv(1)、iconv(3C)、iconv_close(3C)、iconv_open(3C)、idn_decodename(3EXT)、idn_decodename(3EXT)、idn_decodename(3EXT)、attributes(5)、environ(5)、iconv(5)

RFC 3490 Internationalizing Domain Names in Applications (IDNA)

RFC 3491 Nameprep: A Stringprep Profile for Internationalized Domain Names (IDN)

RFC 3492 Punycode: A Bootstring encoding of Unicode for Internationalized Domain Names in Applications (IDNA)

RFC 3454 Preparation of Internationalized Strings ("stringprep")

RFC 952 DoD Internet Host Table Specification

RFC 921 Domain Name System Implementation Schedule - Revised

STD 3, RFC 1122 Requirements for Internet Hosts -- Communication Layers

STD 3, RFC 1123 Requirements for Internet Hosts -- Applications and Support

Unicode Standard Annex #15: Unicode Normalization Forms, Version 3.2.0.http://www.unicode.org

International Language Environments Guide

附注

有关应用程序中的 IDN 的一般信息，请参阅 RFC 3490 和 International Language Environments Guide。

对于存储目的和查询目的，在决定系统的名称时，两者之间存在一些差别。有关术语和差别的更多详细信息，请参阅 RFC 3454。