contrib/bind/README.idnkit

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