|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| conf/ | H | 27-Dec-2013 | - | 784 | 695 |
| data/ | H | 03-May-2022 | - | 12,885 | 12,817 |
| include/ | H | 27-Dec-2013 | - | 10,936 | 2,337 |
| lib/ | H | 27-Dec-2013 | - | 43,186 | 30,137 |
| man/ | H | 27-Dec-2013 | - | 5,772 | 2,412 |
| map/ | H | 27-Dec-2013 | - | 692 | 615 |
| patch/ | H | 27-Dec-2013 | - | 31 | 25 |
| test/ | H | 27-Dec-2013 | - | 173,780 | 114,868 |
| tools/ | H | 27-Dec-2013 | - | 5,507 | 3,379 |
| util/ | H | 27-Dec-2013 | - | 11,178 | 3,442 |
| ChangeLog | H A D | 27-Dec-2013 | 13.5 KiB | 306 | 273 |
| ChangeLog-1.x | H A D | 03-Dec-2013 | 29.7 KiB | 861 | 664 |
| INSTALL | H A D | 03-Dec-2013 | 8.5 KiB | 293 | 195 |
| Makefile.am | H A D | 03-Dec-2013 | 272 | 23 | 20 |
| Makefile.in | H A D | 27-Dec-2013 | 23.2 KiB | 769 | 678 |
| NEWS | H A D | 27-Dec-2013 | 9.5 KiB | 282 | 192 |
| README | H A D | 24-Dec-2013 | 6.1 KiB | 166 | 126 |
| README.ja | H A D | 09-Dec-2013 | 7.1 KiB | 165 | 123 |
| UPDATE-TABLES | H A D | 27-Dec-2013 | 3.6 KiB | 108 | 75 |
| aclocal.m4 | H A D | 27-Dec-2013 | 335.4 KiB | 9,532 | 8,589 |
| compile | H A D | 03-Dec-2013 | 7.1 KiB | 343 | 253 |
| config.guess | H A D | 03-Dec-2013 | 43.8 KiB | 1,531 | 1,321 |
| config.sub | H A D | 03-Dec-2013 | 34.7 KiB | 1,783 | 1,640 |
| configure | H A D | 03-May-2022 | 415.3 KiB | 14,195 | 11,854 |
| configure.ac | H A D | 19-Dec-2013 | 19.5 KiB | 563 | 538 |
| depcomp | H A D | 03-Dec-2013 | 20.4 KiB | 708 | 460 |
| install-sh | H A D | 03-Dec-2013 | 13.7 KiB | 528 | 351 |
| ltconfig | H A D | 03-Dec-2013 | 95.4 KiB | 3,115 | 2,405 |
| ltmain.sh | H A D | 03-Dec-2013 | 276.8 KiB | 9,656 | 7,304 |
| missing | H A D | 03-Dec-2013 | 9.9 KiB | 331 | 243 |
| mkinstalldirs | H A D | 03-Dec-2013 | 3.5 KiB | 163 | 112 |
README
1
2 idnkit
3 -- internationalized domain name toolkit --
4 version 2
5 Japan Registry Services Co., Ltd.(JPRS)
6
7
8Table of contents of this file:
9
10 1. Overview
11 2. Components
12 3. Directory structure of this distribution
13 4. Supported systems
14 5. Contact information
15
16See the file INSTALL for compilation and installation instructions.
17See the file NEWS for a list of major changes in the current release.
18See the file UPDATE-TABLES, if you would like to update code point
19tables derived from Unicode Character Database (UCD) or IDNA parameters.
20
21
221. Overview
23
24idnkit, which was originally known as mDNkit, is a toolkit for handling
25internationalized domain names (IDN).
26
27idnkit version 1 (1.0, 1.1, ...) supports IDNA2003 which consists of
28the following RFCs:
29
30 + RFC3454: Preparation of Internationalized Strings ("stringprep")
31 + RFC3490: Internationalizing Domain Names in Applications (IDNA)
32 + RFC3491: Nameprep: A Stringprep Profile for Internationalized Domain
33 Names (IDN)
34 + RFC3492: Punycode: A Bootstring encoding of Unicode
35 for Internationalized Domain Names in Applications (IDNA)
36
37idnkit version 2 (2.0, 2.1, ...), supports IDNA2008 which consists of RFCs
38listed below:
39
40 + RFC3492: Punycode: A Bootstring encoding of Unicode
41 for Internationalized Domain Names in Applications (IDNA)
42 + RFC5890: Internationalized Domain Names for Applications (IDNA):
43 Definitions and Document Framework
44 + RFC5891: Internationalized Domain Names for Applications (IDNA):
45 Background, Explanation, and Rationale
46 + RFC5892: The Unicode code points and IDNA
47 + RFC5893: Right-to-left scripts for IDNA
48 + RFC5894: Internationalized Domain Names in Applications (IDNA):
49 Protocol
50 + RFC5895: Mapping Characters in IDNA2008
51 + RFC6452: The Unicode Code Points and Internationalized Domain Names
52 for Applications (IDNA) - Unicode 6.0
53
54Please note that idnkit version 2 doesn't support IDNA2003 any longer.
55
56
572. Compnenets
58
59idnkit provides the following components.
60
61 + library for handling internationalized domain names
62 (libidnkit, libidnkitlite)
63 Those libraries implement encoding/decoding conversions of
64 internationalized domain name. They provide easy-to-use APIs
65 for handling internationalized domain name in your applications.
66
67 Both libraries provide almost the same API. The difference
68 between them is that libidnkit internally uses iconv() function
69 to provide encoding conversion from UTF-8 to the local encoding
70 (such as iso-8859-1, usually determined by the current locale),
71 and vise versa. 'idncheck', 'idncmp' and 'idnconv2' commands
72 in this toolkit use libidnkit.
73
74 libidnkitlite is lightweight version of libidnkit. Since it
75 always assumes the local encoding is UTF-8, it never uses
76 iconv().
77
78 The libraries also provides some functions convenient for
79 applications to operate internationalized domain name.
80 See the online manual libidnkit(3) for more details.
81
82 + 'idnconv2' command
83 This command can convert internationalized domain name written
84 in local encoding (e.g. EUC-JP) to Punycode or the opposite
85 direction.
86
87 It can also convert named.conf and zone master files for BIND.
88
89 For users who want install idnkit version 1 and 2 on the same
90 system, the command in idnkit version 2 has been renamed from
91 'idnconv' to 'idnconv2'.
92
93 + 'idncmp' command
94 This command takes two domain names as its command line arguments,
95 and checks whether the domain names are equivalent or not in view
96 of IDNA2008. The result is written to standard error.
97
98 + 'idncheck' command
99 This command takes a domain names as its command line argument,
100 and checks whether it is a valid domain name. The result is
101 written to standard error.
102
103 + patch to idnkit version 1.0
104 A patch file to fix bugs in idnkit version 1.0.
105
1063. Directory structure of this distribution
107
108The following is a directory structure of this distribution with some
109important files and their brief description.
110
111 +README this file
112 +README.ja .. in Japanese
113 +INSTALL compilation and installation instructions.
114 +INSTALL.ja .. in Japanese
115 +LICENSE.txt license
116 +UPDATE-TABLES how to update code point tables
117 +NEWS what's new in this version
118 +ChangeLog list of changes
119 +configure the 'configure' script
120 +conf/ sample configuration files
121 +data/ data files used to generate code point tables
122 +man/ online manuals
123 +map/ sample map files
124 +include/
125 | +idn/ header files for libidnkit and libindkitlite
126 | +auto/ header files generated by utilities
127 +lib/ source for libidnkit and libidnkitlite
128 | +auto/ source files generated by utilities
129 +patch/ patch for idnkit version 1.0
130 +test/ test suite
131 +tools/
132 | +idncheck/ source for idncheck command
133 | +idncmp/ source for idncmp command
134 | +idnconv/ source for idnconv2 command
135 +util/ scripts to generate code point tables
136
137
1384. Supported systems
139
140We've tested on the following systems:
141
142 --------------------------------------------------------------------
143 OS iconv library configure options
144 ====================================================================
145 CentOS release 5.4 standard library (none)
146 for Intel x86 (glibc)
147 --------------------------------------------------------------------
148 Cygwin 1.7.5 GNU libiconv (none)
149 (Windows XP Professional SP3)
150 for Intel x86 1.13
151 --------------------------------------------------------------------
152 Solaris 10 standard library (none)
153 for Sparc (libc)
154 --------------------------------------------------------------------
155
156
1575. Contact information
158
159The latest version and information about idnkit can be found at:
160
161 http://jprs.co.jp/idn/
162
163Send bug reports and comments to
164
165 idnkit-info@jprs.co.jp
166
README.ja
1
2 idnkit
3 -- $B9q:]2=%I%a%$%sL>%D!<%k%-%C%H(B --
4 $B%P!<%8%g%s(B2
5$B!!!!!!!!!!(B $B3t<02q<RF|K\%l%8%9%H%j%5!<%S%9(B (JPRS)
6
7
8$B$3$N%U%!%$%k$NL\<!(B:
9
10 1. $B35MW(B
11 2. $BK\%-%C%H$NFbMF(B
12 3. $B%G%#%l%/%H%j9=@.(B
13 4. $BK\%-%C%H$,BP1~$7$F$$$k%7%9%F%`(B
14 5. $BK\%-%C%H$K4X$9$k:G?7>pJs!"Ld$$9g$o$;$K$D$$$F(B
15
16$B%3%s%Q%$%k$*$h$S%$%s%9%H!<%kJ}K!$K$D$$$F$O!"(BINSTALL.ja$B$H$$$&%U%!%$%k$r(B
17$B$4Mw2<$5$$!#$3$N%P!<%8%g%s$G$N<g$JJQ99E@$K$D$$$F$O!"(B($B1QJ8$G$9$,(B) NEWS
18$B$H$$$&%U%!%$%k$r$4Mw2<$5$$!#(BUnicode$B$NJ8;z%G!<%?%Y!<%9(B (UCD) $B$d(BIDNA$B%Q%i(B
19$B%a%?$+$iF3=P$5$l$?%3!<%I%]%$%s%HI=$N99?7J}K!$K$D$$$F$O!"(B($B$3$l$b1QJ8$G$9(B
20$B$,(B) UPDATE-TABLES$B$H$$$&%U%!%$%k$r$4Mw2<$5$$!#(B
21
22
231. $B35MW(B
24
25idnkit ($B5l>N(B mDNkit) $B$H$O9q:]2=%I%a%$%sL>$r07$&$?$a$N%D!<%k%-%C%H$G$9!#(B
26
27idnkit$B%P!<%8%g%s(B1 ($B%P!<%8%g%s(B1.0) $B$O(BIDNA2003$B$KBP1~$7$F$$$^$9!#(BIDNA2003
28$B$O<!$N(BRFC$B$+$i9=@.$5$l$F$$$^$9!#(B
29
30 + RFC3454: Preparation of Internationalized Strings ("stringprep")
31 + RFC3490: Internationalizing Domain Names in Applications (IDNA)
32 + RFC3491: Nameprep: A Stringprep Profile for Internationalized Domain
33 Names (IDN)
34 + RFC3492: Punycode: A Bootstring encoding of Unicode
35 for Internationalized Domain Names in Applications (IDNA)
36
37idnkit$B%P!<%8%g%s(B2 (2.0, 2.1, ...) $B$O(BIDNA2008$B$KBP1~$7$F$$$^$9!#(BIDNA2008$B$O(B
38$B<!$N(BRFC$B$+$i9=@.$5$l$F$$$^$9!#(B
39
40 + RFC3492: Punycode: A Bootstring encoding of Unicode
41 for Internationalized Domain Names in Applications (IDNA)
42 + RFC5890: Internationalized Domain Names for Applications (IDNA):
43 Definitions anda Document Framework
44 + RFC5891: Internationalized Domain Names for Applications (IDNA):
45 Background, Explanation, and Rationale
46 + RFC5892: The Unicode code points and IDNA
47 + RFC5893: Right-to-left scripts for IDNA
48 + RFC5894: Internationalized Domain Names in Applications (IDNA):
49 Protocol
50 + RFC5895: Mapping Characters in IDNA2008
51 + RFC6452: The Unicode Code Points and Internationalized Domain Names
52 for Applications (IDNA) - Unicode 6.0
53
54idnkit$B%P!<%8%g%s(B2$B$O(BIDNA2003$B$X$NBP1~$r;_$a$F$$$^$9$N$G!"$4Cm0U2<$5$$!#(B
55
56
572. $BK\%-%C%H$NFbMF(B
58
59$B$3$NG[I[%-%C%H$K$O<!$N$h$&$J$b$N$,4^$^$l$^$9!#(B
60
61$B!&9q:]2=%I%a%$%sL>$r=hM}$9$k$?$a$N%i%$%V%i%j(B (libidnkit, libidnkitlite)
62$B!!!!$3$l$i$N%i%$%V%i%j$G$O!"9q:]2=%I%a%$%sL>$N%(%s%3!<%I(B/$B%G%3!<%I5!G=$r(B
63$B!!!!<BAu$7$F$$$^$9!#%"%W%j%1!<%7%g%s$,9q:]2=%I%a%$%sL>$r4JC1$K07$($k$?$a(B
64$B!!!!$N(BAPI$B$rDs6!$7$^$9!#(B
65
66$B!!!!$I$A$i$N%i%$%V%i%j$b!"$[$H$s$IF1$8(BAPI$B$rDs6!$7$^$9!#N><T$NAj0cE@$O!"(B
67$B!!!!(Blibidnkit$B$G$O(Biconv()$B4X?t$rMQ$$$F(BUTF-8$B$H%m!<%+%k%(%s%3!<%G%#%s%0(B
68$B!!!!(B(iso-8859-1$B$J$I!"DL>o$O(Blocale$B$+$i7hDj$5$l$^$9(B) $B$H$N4V$NJQ495!G=$r(B
69$B!!!!Ds6!$7$F$$$kE@$G$9!#K\%D!<%k%-%C%HIUB0$N(Bidncheck, idncmp$B$*$h$S(B
70$B!!!!(Bidnconv2 $B%3%^%s%I$O(Blibidnkit$B$r;HMQ$7$F$$$^$9!#(B
71
72$B!!!!(Blibidnkitlite$B$O(Blibidnkit$B$N7ZNLHG$G$9!#%m!<%+%k%(%s%3!<%G%#%s%0$O>o$K(B
73$B!!!!(BUTF-8$B$G$"$k$H2>Dj$7$F$$$k$?$a!"(Biconv()$B$O;HMQ$7$^$;$s!#(B
74
75$B!!!!$^$?%i%$%V%i%j$K$O!"%"%W%j%1!<%7%g%s$,9q:]2=%I%a%$%sL>$r07$&:]$KJXMx(B
76$B!!!!$J$h$&$K!"$$$/$D$+$N5!G=$rDs6!$7$F$$$^$9!#>\$7$/$O%*%s%i%$%s%^%K%e%"%k(B
77$B!!!!(Blibidnkit(3)$B$r;2>H$7$F2<$5$$!#(B
78
79$B!&(Bidnconv2$B%3%^%s%I(B
80$B!!!!%m!<%+%k%(%s%3!<%G%#%s%0(B ($B$?$H$($P(BEUC-JP) $B$G=q$+$l$?9q:]2=%I%a%$%s(B
81$B!!!!L>$+$i(B Punycode$B$X$NJQ49$d!"$=$N5UJQ49$r9T$($k%3%^%s%I$G$9!#(B
82
83$B!!!!(BBIND$BMQ$N(Bnamed.conf$B$d%>!<%s%^%9%?%U%!%$%k$rJQ49$9$k$3$H$b2DG=$G$9!#(B
84
85$B!!!!(Bidnkit$B%P!<%8%g%s(B1$B$H(B2$B$rF10l$N%7%9%F%`>e$K%$%s%9%H!<%k$7$?$$MxMQ<T$N(B
86 $B$?$a$K!"(Bidnkit$B%P!<%8%g%s(B2$B$G$O%3%^%s%IL>$,(B 'idnconv' $B$+$i(B 'idnconv2'
87 $B$KJQ$o$j$^$7$?!#(B
88
89$B!&(Bidncmp$B%3%^%s%I(B
90$B!!!!$3$N%3%^%s%I$O!"%3%^%s%I9T0z?t$H$7$F%I%a%$%sL>$r(B2$B$D<u$1<h$j!"$=$N(B
91$B!!!!%I%a%$%sL>F1;N$,(BIDNA2008$B$N2<$G0lCW$9$k$b$N$+$I$&$+$rD4$Y$^$9!#7k2L(B
92$B!!!!$OI8=`%(%i!<=PNO$K=PNO$5$l$^$9!#(B
93
94$B!&(Bidncheck$B%3%^%s%I(B
95$B!!!!$3$N%3%^%s%I$O!"%3%^%s%I9T0z?t$H$7$F%I%a%$%sL>$r(B1$B$D<u$1<h$j!"$=$N(B
96$B!!!!%I%a%$%sL>$,9q:]2=%I%a%$%sL>$H$7$F(B ($B$b$7$/$OEAE}E*$J(BASCII$B%I%a%$%s(B
97$B!!!!L>$H$7$F(B) $B@5$7$$$+$I$&$+%A%'%C%/$7$^$9!#7k2L$OI8=`%(%i!<=PNO$K=PNO(B
98$B!!!!$5$l$^$9!#(B
99
100$B!&(Bidnkit$B%P!<%8%g%s(B1.0$B$X$N%Q%C%A(B
101$B!!!!(Bidnkit$B%P!<%8%g%s(B1.0$B$NIT6q9g$r=$@5$9$k%Q%C%A$G$9!#(B
102
103
1043. $B%G%#%l%/%H%j9=@.(B
105
106$BG[I[%-%C%H$N%G%#%l%/%H%j9=@.$H!"<gMW$J%U%!%$%k$r<($7$^$9!#(B
107
108 +README $B1Q8lHG$N(BREADME
109 +README.ja $B$3$N%U%!%$%k(B
110 +INSTALL $B1Q8lHG$N(BINSTALL
111 +INSTALL.ja $B%3%s%Q%$%k$H%$%s%9%H!<%kJ}K!(B
112 +LICENSE.txt $B;HMQ5vBz(B
113 +UPDATE-TABLES $B%3!<%I%]%$%s%HI=$N99?7J}K!(B
114 +NEWS $B<g$JJQ99(B
115 +ChangeLog $BJQ99>\:Y(B
116 +configure configure$B%9%/%j%W%H(B
117 +conf/ $B@_Dj%U%!%$%k$N%5%s%W%k(B
118 +data/ $B%3!<%I%]%$%s%HI=$N@8@.85%G!<%?(B
119 +man/ $B%*%s%i%$%s%^%K%e%"%k(B
120 +map/ $B%^%C%W%U%!%$%k$N%5%s%W%k(B
121 +include/
122 | +idn/ libidnkit, libidnkitlite$B$N%X%C%@%U%!%$%k(B
123 | +auto/ $B<+F0@8@.$5$l$?%X%C%@%U%!%$%k(B
124 +lib/ libidnkit, libidnkitlite$B$N%=!<%9(B
125 | +auto/ $B<+F0@8@.$5$l$?%=!<%9(B
126 +patch/ idnkit $B%P!<%8%g%s(B1.0$B8~$1$N%Q%C%A%U%!%$%k(B
127 +test/ $B%F%9%H0l<0(B
128 +tools/
129 | +idncheck/ idncheck$B%3%^%s%I$N%=!<%9(B
130 | +idncmp/ idncmp$B%3%^%s%I$N%=!<%9(B
131 | +idnconv/ idnconv$B%3%^%s%I$N%=!<%9(B
132 +util/ $B%3!<%I%]%$%s%HI=$r@8@.$9$k%9%/%j%W%H(B
133
134
1354. $BK\%-%C%H$,BP1~$7$F$$$k%7%9%F%`(B
136
137$B<!$N%7%9%F%`$G$NF0:n3NG'$r9T$C$F$$$^$9!#(B
138
139 ----------------------------------------------------------------------
140 OS iconv$B%i%$%V%i%j(B configure$B$N%*%W%7%g%s(B
141 ======================================================================
142 CentOS release 5.4 $BI8=`%i%$%V%i%j(B ($B$J$7(B)
143 for Intel x86 (glibc)
144 ----------------------------------------------------------------------
145 Cygwin 1.7.5 GNU libiconv ($B$J$7(B)
146 (Windows XP Professional SP3)
147 for Intel x86 1.13
148 ----------------------------------------------------------------------
149 Solaris 10 options ($B$J$7(B)
150 for Sparc (libc)
151 ----------------------------------------------------------------------
152
153
1545. $BK\%-%C%H$K4X$9$k:G?7>pJs!"Ld$$9g$o$;$K$D$$$F(B
155
156$B:G?7%P!<%8%g%s$*$h$S(Bidnkit$B$N>pJs$K$D$$$F$O!"(B
157
158 http://jprs.co.jp/idn/
159
160$B$r;2>H$7$F$/$@$5$$!#IT6q9g$NJs9p$*$h$S$40U8+$O!"(B
161
162 idnkit-info@jprs.co.jp
163
164$B$X$*4j$$$7$^$9!#(B
165