README.idnkit
1
2 BIND 9 IDN support
3
4 Japan Network Information Center (JPNIC)
5
6
7* Compilation & installation
8
90. Prerequisite
10
11You have to build and install idnkit before building bind9.
12
131. Running configure script
14
15Run `configure' in the top directory. See `README' for the
16configuration options.
17
18The following four options to `configure' are relevant to IDN. You
19should at least specify `--with-idn' option to enable IDN support.
20
21 --with-idn[=IDN_PREFIX]
22 To enable IDN support, you have to specify `--with-idn' option.
23 The argument IDN_PREFIX is the install prefix of idnkit. If
24 IDN_PREFIX is omitted, PREFIX (derived from `--prefix=PREFIX')
25 is assumed.
26
27 --with-libiconv[=LIBICONV_PREFIX]
28 Specify this option if idnkit you have installed links GNU
29 libiconv. The argument LIBICONV_PREFIX is install prefix of
30 GNU libiconv. If the argument is omitted, PREFIX (derived
31 from `--prefix=PREFIX') is assumed.
32
33 `--with-libiconv' is shorthand option for GNU libiconv.
34
35 --with-libiconv=/usr/local
36
37 This is equivalent to:
38
39 --with-iconv='-L/usr/local/lib -R/usr/local/lib -liconv'
40
41 `--with-libiconv' assumes that your C compiler has `-R'
42 option, and that the option adds the specified run-time path
43 to an executable binary. If `-R' option of your compiler has
44 different meaning, or your compiler lacks the option, you
45 should use `--with-iconv' option instead. Binary command
46 without run-time path information might be unexecutable.
47 In that case, you would see an error message like:
48
49 error in loading shared libraries: libiconv.so.2: cannot
50 open shared object file
51
52 If both `--with-libiconv' and `--with-iconv' options are
53 specified, `--with-iconv' is prior to `--with-libiconv'.
54
55 --with-iconv=ICONV_LIBSPEC
56 If your libc doesn't provide iconv(), you need to specify the
57 library containing iconv() with this option. `ICONV_LIBSPEC'
58 is the argument(s) to `cc' or `ld' to link the library, for
59 example, `--with-iconv="-L/usr/local/lib -liconv"'.
60 You don't need to specify the header file directory for "iconv.h"
61 to the compiler, as it isn't included directly by bind9.
62
63 --with-idnlib=IDN_LIBSPEC
64 With this option, you can explicitly specify the argument(s)
65 to `cc' or `ld' to link the idnkit's library, `libidnkit'. If
66 this option is not specified, `-L${PREFIX}/lib -lidnkit' is
67 assumed, where ${PREFIX} is the installation prefix specified
68 with `--with-idn' option above. You may need to use this
69 option to specify extra arguments, for example,
70 `--with-idnlib="-L/usr/local/lib -R/usr/local/lib -lidnkit"'.
71
72Please consult `README' for other configuration options.
73
74Note that if you want to specify some extra header file directories,
75you should use the environment variable STD_CINCLUDES instead of
76CFLAGS, as described in README.
77
782. Compilation and installation
79
80After running "configure", just do
81
82 make
83 make install
84
85for compiling and installing.
86
87
88* Contact information
89
90Please see http://www.nic.ad.jp/en/idn/ for the latest news
91about idnkit.
92
93Bug reports and comments on this kit should be sent to
94mdnkit-bugs@nic.ad.jp and idn-cmt@nic.ad.jp, respectively.
95
96; $Id: README.idnkit,v 1.1 2009/12/04 20:14:28 each Exp $
97