external/bsd/bind/dist/contrib/idn/README.idnkit

   1
   2                           BIND 9 IDN support
   3
   4                Japan Network Information Center (JPNIC)
   5
   6
   7 * Compilation & installation
   8
   9 0. Prerequisite
  10
  11 You have to build and install idnkit before building bind9.
  12
  13 1. Running configure script
  14
  15 Run `configure' in the top directory.  See `README' for the
  16 configuration options.
  17
  18 The following four options to `configure' are relevant to IDN.  You
  19 should 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
  72 Please consult `README' for other configuration options.
  73
  74 Note that if you want to specify some extra header file directories,
  75 you should use the environment variable STD_CINCLUDES instead of
  76 CFLAGS, as described in README.
  77
  78 2. Compilation and installation
  79
  80 After running "configure", just do
  81
  82         make
  83         make install
  84
  85 for compiling and installing.
  86
  87
  88 * Contact information
  89
  90 Please see http://www.nic.ad.jp/en/idn/ for the latest news
  91 about idnkit.
  92
  93 Bug reports and comments on this kit should be sent to
  94 mdnkit-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