BIND 9 IDN support

	       Japan Network Information Center (JPNIC)

* Compilation & installation

0. Prerequisite

You have to build and install idnkit before building bind9.

1. Running configure script

Run `configure' in the top directory.  See `README' for the

configuration options.

The following four options to `configure' are relevant to IDN.  You

should at least specify `--with-idn' option to enable IDN support.

    --with-idn[=IDN_PREFIX]

	To enable IDN support, you have to specify `--with-idn' option.

	The argument IDN_PREFIX is the install prefix of idnkit.  If

	IDN_PREFIX is omitted, PREFIX (derived from `--prefix=PREFIX')

	is assumed.

    --with-libiconv[=LIBICONV_PREFIX]

	Specify this option if idnkit you have installed links GNU

	libiconv.  The argument LIBICONV_PREFIX is install prefix of

	GNU libiconv.  If the argument is omitted, PREFIX (derived

	from `--prefix=PREFIX') is assumed.

	`--with-libiconv' is shorthand option for GNU libiconv.

	    --with-libiconv=/usr/local

	This is equivalent to:

	    --with-iconv='-L/usr/local/lib -R/usr/local/lib -liconv'

	`--with-libiconv' assumes that your C compiler has `-R'

	option, and that the option adds the specified run-time path

	to an executable binary.  If `-R' option of your compiler has

	different meaning, or your compiler lacks the option, you

	should use `--with-iconv' option instead.  Binary command

	without run-time path information might be unexecutable.

	In that case, you would see an error message like:

	    error in loading shared libraries: libiconv.so.2: cannot

	    open shared object file

	If both `--with-libiconv' and `--with-iconv' options are

	specified, `--with-iconv' is prior to `--with-libiconv'.

    --with-iconv=ICONV_LIBSPEC

	If your libc doesn't provide iconv(), you need to specify the

	library containing iconv() with this option.  `ICONV_LIBSPEC'

	is the argument(s) to `cc' or `ld' to link the library, for

	example, `--with-iconv="-L/usr/local/lib -liconv"'.

	You don't need to specify the header file directory for "iconv.h"

	to the compiler, as it isn't included directly by bind9.

    --with-idnlib=IDN_LIBSPEC

	With this option, you can explicitly specify the argument(s)

	to `cc' or `ld' to link the idnkit's library, `libidnkit'.  If

	this option is not specified, `-L${PREFIX}/lib -lidnkit' is

	assumed, where ${PREFIX} is the installation prefix specified

	with `--with-idn' option above.  You may need to use this

	option to specify extra arguments, for example,

	`--with-idnlib="-L/usr/local/lib -R/usr/local/lib -lidnkit"'.

Please consult `README' for other configuration options.

Note that if you want to specify some extra header file directories,

you should use the environment variable STD_CINCLUDES instead of

CFLAGS, as described in README.

2. Compilation and installation

After running "configure", just do

	make

	make install

for compiling and installing.

* Contact information

Please see http://www.nic.ad.jp/en/idn/ for the latest news

about idnkit.

Bug reports and comments on this kit should be sent to

mdnkit-bugs@nic.ad.jp and idn-cmt@nic.ad.jp, respectively.

; $Id: README.idnkit,v 1.1 2009/12/04 20:14:28 each Exp $