README.ja revision 04bdb234571448ed6194e1d4048e6512f2446f1c
mDNkit
-- ¿����ɥᥤ��̾ɾ�����å� --
������� 1.2
(��) ���ܥͥåȥ������ե��᡼����󥻥󥿡� (JPNIC)
* ����
mDNkit �Ȥ� DNS ��¿����ɥᥤ��̾�򰷤��������Ƥ���Ƥ���Ƽ����
��ɾ�����뤿��Υ��åȤǤ���¿����ɥᥤ��̾�򰷤�����ˤϡ����Τ褦��
��ǽ���׵ᤵ��ޤ���
�����ץꥱ������󤬻��Ѥ��륨�󥳡��ǥ��� (�?���륨�󥳡��ǥ���)
�� DNS �ץ�ȥ����Υ��󥳡��ǥ��󥰤Ȥδ֤Ρ��ɥᥤ��̾�Υ��󥳡�
�ǥ����Ѵ���
���ɥᥤ��̾����������
mDNkit �Ǥϡ������ε�ǽ���ɲä��뤿��γƼ����ˡ���󶡤��Ƥ��ޤ���
�������ۥ��åȤˤϼ��Τ褦�ʤ�Τ��ޤޤ�ޤ���
��DNS�ץ?�������� (dnsproxy)
�ɥᥤ��̾�Ѵ���ǽ���� DNS �Υץ?�������ФǤ������饤����Ȥ���
�������� DNS ��å�������Υɥᥤ��̾�򥯥饤����ȤΥ?���륨�󥳡�
�ǥ��󥰤��� DNS �����Фλ��Ѥ��� DNS �ץ�ȥ����Υ��󥳡��ǥ���
�ؤ��Ѵ����� DNS �����Ф��������ޤ����ޤ� DNS �����Ф����֤��줿DNS
��å�������Υɥᥤ��̾�򥯥饤����ȤΥ?���륨�󥳡��ǥ��󥰤���
���ƥ��饤����Ȥ��֤��ޤ����ܤ����ϡ���ҤΡ�1. dnsproxy ��Ȥ��פ�
��������������
��UNIX ���ץꥱ�������� MDN ��ǽ��ưŪ���ɲä��륳�ޥ�� (runmdn)
UNIX ���̾�Υ��ץꥱ��������¿����ɥᥤ��̾���갷������ˡ���
�̤ʥ饤�֥���ưŪ�˥�󥯤��뤿��Υ��ޥ�ɤǤ����ܤ����ϡ���Ҥ�
��2. runmdn ��Ȥ��פ��������������
��bind-9 �� MDN ��ǽ���ɲä���ѥå�
bind-9 �� MDN �ε�ǽ���ɲä���ѥå��Ǥ���bind-9 �Ǥϡ����饤�����
¦�Υ饤�֥�� (liblwres) �ȡ�������̾������ѥǡ���� (lwresd) ����
���롢�饤�ȥ������ȥ꥾��ФȤ�������������̾��������ˡ���Ȥ���
���ޤ������Υѥå��ϡ������� MDN �ε�ǽ���ɲä��ޤ����ܤ����ϡ���
�ҤΡ�3. bind9 �˥ѥå������ƤƻȤ��פ��������������
��Windows ���ץꥱ��������Ѥ� mDN ��åѡ�
WINSOCK ��̾����赡ǽ���Ф����åѡ� DLL �Ǥ���Windows ��Ǥϡ�̾
�������׵�ϡ�WINSOCK DLL ���̤��ƹԤ��ޤ��������ǡ������¿����
�ɥᥤ���Ѥ� WINSOCK DLL ���֤������뤳�Ȥǡ������ Windows ���ץꥱ��
�����Ǥ� mDN ��ǽ����ѤǤ���褦�ˤ��ޤ����ܤ����ϡ���Ҥ�
��4. mDN ��åѡ���Ȥ��פ��������������
��named.conf ����ӥ�����ޥ����ե������ѥ����ɥ��åȥ���С��� (mdnconv)
named.conf ����ӥ�����ޥ����ե�������оݤȤ��������ɥ��å� (����
�����ǥ���)�Ѵ��ѥġ���Ǥ���SJIS �ʤɤΥ?���륨�󥳡��ǥ��󥰤�
�񤫤줿�����Υե������¿���첽 DNS �ǻ��Ѥ��륨�󥳡��ǥ���
(�㤨��UTF-8) �ؤ��Ѵ����ޤ���
��¿����ɥᥤ��̾�����뤿��Υ饤�֥�� (libmdn, libmdnres)
dnsproxy �� mdnconv �����Ѥ��Ƥ���饤�֥��Ǥ������󥳡��ǥ�����
������������ZLD (zero-level domain) �ν�����ε�ǽ���󶡤��ޤ���
��bind-8 �� 8 �ӥåȥ��롼������ѥå�
named ��꥾��Фǥ?���륨�󥳡��ǥ��󥰤� UTF-8 ���󥳡��ǥ���
�Υɥᥤ��̾����Ѳ�ǽ�ˤ��뤿��Υѥå��Ǥ���8�ӥåȥ��롼�ʤΤǤ�
�Ȥ�ɤɤ�ʥ����ɤǤ��̤äƤ��ޤ��ޤ���
��squid �� 8 �ӥåȥ��롼������ѥå�
URL ��Υۥ���̾�˴ؤ��������������å��򳰤�����Υѥå��Ǥ������Υѥ�
�������Ƥʤ��� Squid ��¿����ɥᥤ��̾��ޤ� URL �򥨥顼�Ȥ��ƤϤ�
���Ƥ��ޤ��ޤ���
�������ۥ��åȤϡ��ʾ�Τ�Τ��Ѥ��ơ�¿����ɥᥤ��̾�򰷤������ʣ��
����ˡ���󶡤��Ƥ��ޤ���
** 1. dnsproxy ��Ȥ�
�?���륨�� ���󥳡��ǥ��� DNS �ץ�ȥ�����
�����ɥ��� ���Ѵ�������� ���󥳡��ǥ��󥰤�
+----------------+�Υɥᥤ��̾ ���� �ɥᥤ��̾
|���饤����� | +--------------+ +------+
|���ץꥱ�������|------------>| dnsproxy |------------>| DNS |
|�� 8�ӥåȥ��롼|<------------| |<------------|������|
|�������꥾��� | +--------------+ +------+
+----------------+
** 2. runmdn ��Ȥ�
���󥳡��ǥ����Ѵ� DNS �ץ�ȥ�����
����������� ���󥳡��ǥ��󥰤�
+----------------+------------------+ �ɥᥤ��̾
|���饤����� |ưŪ�˥�󥯤��줿| +------+
|���ץꥱ�������| �饤�֥�� |---------------->| DNS |
|���̾�Υ꥾���| (libmdnres) |<----------------|������|
+----------------+------------------+ +------+
** 3. bind9 �˥ѥå������ƤƻȤ�
UTF-8 �Υ� ���󥳡��ǥ� DNS �ץ�ȥ�����
�ᥤ��̾ ���Ѵ����� ���󥳡��ǥ��󥰤�
+----------------+ �������� �ɥᥤ��̾
|���饤����� | +----------------+ +------+
|���ץꥱ�������|---------->| �饤�ȥ������� |------------>| DNS |
|�� bind9�Υ饤��|-----------| �꥾��� |<------------|������|
|�������ȥ꥾���| | �ǡ���� | +------+
+----------------+ +----------------+
** 4. mDN ��åѡ���Ȥ�
�?���륨 ����������� DNS �ץ�ȥ�����
�󥳡��ǥ� ���󥳡��ǥ� ���󥳡��ǥ��󥰤�
+----------------+ �󥰤Υɥ� ���Ѵ� �ɥᥤ��̾
|����� Windows | ����̾ +---------+------------+ +------+
|�ͥåȥ�� |---------->| mDN | ���ꥸ�ʥ� |---------->| DNS |
|���ץꥱ�������|<----------| ��åѡ�| winsock |<----------|������|
+----------------+ +---------+------------+ +------+
* �ǥ��쥯�ȥ깽��
���ۥ��åȤΥǥ��쥯�ȥ깽���ȡ����פʥե�����򼨤��ޤ���
README �Ѹ��Ǥ� README
README.ja ���Υե�����
DISTFILES ���ۤ����ե��������
NEWS ����ѹ�
ChangeLog �ѹ��ܺ�
configure configure ������ץ�
Makefile.in �ȥåץ�٥�� Makefile �Υƥ�ץ졼��
include/ ���󥯥롼�ɥե�����ǥ��쥯�ȥ�
config.h.in config.h �Υƥ�ץ졼��
mdn/ mdn �饤�֥���ѥ��󥯥롼�ɥե�����
dnsproxy/ DNS �ץ?�������Х�����
lib/ mdn �饤�֥�꥽����
wsock/ mDN ��åѡ�������
tools/ ���եġ���
mdnconv/ �����ɥ��åȥ���С���������
runmdn/ runmdn ���ޥ�ɥ�����
patch/ �Ƽ�ѥå��ե�����
bind8/ bind8 �ѥѥå�
bind9/ bind9 �ѥѥå�
squid/ squid �ѥѥå�
util/ �桼�ƥ���ƥ�
* ����ѥ��뤪��ӥ��󥹥ȡ���
0. ������
�⤷���ʤ��λ��Ѥ��Ƥ��륷���ƥ�Υ饤�֥��� iconv() ���ʤ���硢��
�뤤�Ϥ��äƤ� UTF-8 �򰷤����Ȥ��Ǥ��ʤ����ˤϤ��餫���� iconv() ��
���󥹥ȡ��뤷�Ƥ����Ƥ���������iconv() �μ����ϡ��㤨�� LGPL �Τ�Τ�
http://clisp.cons.org/~haible/packages-libiconv.html
���������ǽ�Ǥ���
1. configure ������ץȤμ¹�
�ȥåץǥ��쥯�ȥ�ˤ��� configure ������ץȤ�¹Ԥ��Ƥ���������
% ./configure
configure ������ץȤˤϤ����Ĥ��Υ��ץ�������ꤹ�뤳�Ȥ��Ǥ��ޤ���
mdn ��ľ�ܴط������Τϼ����̤�Ǥ���
--with-iconv=LIB
libc �� iconv �����äƤ��ʤ���� (�嵭�Υѥå����������줿
���ʤ�) �ˡ�iconv �Υ饤�֥�����ꤷ�ޤ����㤨��
--with-iconv="-L/usr/local/lib -liconv"
�Τ褦�˻��ꤷ�ޤ����⤷ iconv ����ͭ�饤�֥��ˤʤäƤ���
���ˤϡ�-R ���ץ�������ꤷ��
--with-iconv="-L/usr/local/lib -R/usr/local/lib -liconv"
�Ȥ���ɬ�פ����뤫�⤷��ޤ���
--with-iconv-sofile=PATH
mDNkit �˴ޤޤ�Ƥ��� runmdn ���ޥ�ɤϡ�iconv() �� libc �ΰ�
���Ȥ����󶡤���ʤ��Ȥ��ˡ�iconv() ��ޤඦͭ�饤�֥��ؤΥ�
��̾���Τ�ɬ�פ�����ޤ���mDNkit �ϡ�--with-iconv ���ץ�����
���Ҥ��˥ѥ�̾�򸡺����ޤ���������˼��Ԥ����Ȥ��ˡ��ʲ��Τ�
���˶�ͭ�饤�֥�����ꤹ�뤳�Ȥ��Ǥ��ޤ���
--with-iconv-sofile=/usr/local/lib/libiconvv.so.2.0
--with-utf8=NAME
iconv �� utf-8 ���󥳡��ǥ��󥰤���ꤹ���硢�ܥ饤�֥���
�ǥե���ȤǤ� "UTF-8" �Ȥ���̾������ꤷ�ޤ����⤷���ʤ���
�����ƥ�� iconv �� "UTF-8" �Ȥ���̾��������դ��ʤ����ˤϡ�
����̾������ꤷ�ޤ����㤨�� "UTF-8" �ǤϤʤ� "utf8" ��
���ˤϼ��Τ褦�˻��ꤷ�ޤ���
--with-utf8=utf8
--with-race-prefix=PREFIX
--with-brace-suffix=SUFFIX
--with-lace-prefix=PREFIX
RACE (Row-based ASCII-Compatible Encoding)��BRACE (Bi-mode
Row-based ASCII-Compatible Encoding) ����� LACE (Length-based
ASCII Compatible Encoding) �Ϥ������ DNS �ץ�ȥ���
��ǻ��Ѥ����¿����ɥᥤ��̾�˴ؤ�����Ƥ���Ƥ��륨�󥳡��ǥ�
����Ǥ����̾�� ASCII �ɥᥤ��̾�Ȥ����ˤ�äƥ��󥳡�
�ɤ��줿�ɥᥤ��̾����̤��뤿��ˡ��������Ƭ�� (BRACE �ξ��
�ˤ�����) ���Ѥ����ޤ���
mDNkit �Ǥϸ��ߤΥ��󥿡��ͥåȥɥ�եȤ��������Ƥ�����Ƭ��
���뤤���������Ѥ���褦�ˤʤäƤ��ޤ���������Υɥ�եȤ�
�Ѥ�뤫�⤷��ޤ��󡣤����ǡ������Υ��ץ������Ѥ��ƻ����
����褦�ˤʤäƤ��ޤ���
--enable-zld
ZLD (zero level domain) �ϡ��ǥե���ȤǤϻ��ѤǤ��ޤ��󡣤���
��ǽ����Ѥ������Ȥ��ˡ����Υ��ץ�������ꤷ�ޤ���
--sbindir=DIR
DNS �ץ?�������Ф򥤥󥹥ȡ��뤹��ǥ��쥯�ȥ����ꤷ�ޤ���
�ǥե���ȤǤ� /usr/local/sbin �Ǥ���
--bindir=DIR
�����ɥ��åȥ���С��� mdnconv �򥤥󥹥ȡ��뤹��ǥ��쥯�ȥ��
���ꤷ�ޤ����ǥե���ȤǤ� /usr/local/bin �Ǥ���
--sysconfdir=DIR
DNS �ץ?�������Ф�����ե�����򥤥󥹥ȡ��뤹��ǥ��쥯�ȥ��
���ꤷ�ޤ����ǥե���ȤǤ� /usr/local/etc �Ǥ���
--mandir=DIR
����饤��ޥ˥奢��Υ��󥹥ȡ���ǥ��쥯�ȥ����ꤷ�ޤ���
�ǥե���ȤǤ� /usr/local/man �Ǥ���
--with-iconv ���ץ����Ǥϥ饤�֥���������ꤷ�ޤ����⤷���󥯥롼
�ɥե����� iconv.h ���ǥե���ȤΥ��󥯥롼�ɥե�����Υѥ��˥��󥹥ȡ�
�뤵��Ƥ��ʤ���硢���뤤��¾�� C ����ѥ���ؤΥ��ץ�������ꤷ��
�����ˤϴĶ��ѿ� CFLAGS ����Ѥ��Ƥ����������㤨��
% CFLAGS=-I/usr/local/include ./configure ...
(sh �ϤΥ�����ξ��)
% setenv CFLAGS -I/usr/local/include; ./configure ...
(csh �ϤΥ�����ξ��)
�Ȥ��ޤ���
configure �ˤ�¾�ˤ�¿���Υ��ץ���󤬤���ޤ������Ĥ�ϰ���Ū�ʥ��ץ���
��ʤΤ������Ͼʤ��ޤ���
% ./configure --help
��¹Ԥ���ȥ��ץ����ΰ�����ɽ������ޤ���
2. ����ѥ���
configure ��¹Ԥ���� Makefile �ʤɤ���������ޤ��Τǡ�³���� make��
�¹Ԥ��ƥ���ѥ��뤷�ޤ���
% make
3. ���󥹥ȡ���
�����ѥ桼���ˤʤäƥ��󥹥ȡ��뤷�ޤ���
% su
# make install
4. Configuration and usage
���󥹥ȡ��뤵���ġ��� (dnsproxy��mdnconv��runmdn) �λȤ���������
ˡ�˴ؤ��Ƥϥ���饤��ޥ˥奢���������������mdnconv �� runmdn �ˤ�
���Ƥϡ�mDNkit �Υ꥾�������ե����� mdnres.conf �Υޥ˥奢��⻲�Ȥ�
�Ƥ���������
% man dnsproxy
% man mdnconv
% man runmdn
% man mdnres.conf
* �ѥå���������
�������ۥ��åȤˤϡ�bind-8.2.2-P7��bind-8.2.3-T6B��bind-9.0.0�������
squid-2.3-STABLE3 ���Ф���ѥå����ޤޤ�Ƥ��ޤ����ѥå���������ϡ��ѥ�
���ե��������Ƭ�˽񤫤�Ƥ��ޤ��ΤǤ�����򻲾Ȥ��Ƥ���������
Solaris �Ǥϡ������ƥ���°�� patch ���ޥ�ɤ������ư��ʤ����Ȥ���
��ޤ������Τ褦�ʾ��ˤϡ�GNU �С������� patch
(http://www.gnu.org/software/patch/) �򥤥󥹥ȡ��뤷�ơ��������Ѥ�
�Ƥ���������
* �ܥ��åȤ˴ؤ���ǿ������䤤��碌�ˤĤ���
�ܥ��åȤ˴ؤ���ǿ�����ˤĤ��Ƥϡ�
http://www.nic.ad.jp/jp/research/idn/ �򻲾Ȥ��Ƥ�������
�ܥ��åȤ˴ؤ���Х���ݡ��Ȥ���ӥ����Ȥϡ����줾��
mdnkit-bugs@nic.ad.jp ����� idn-cmt@nic.ad.jp �ؤ��ꤤ���ޤ���
; $Id: README.ja,v 1.18 2000/11/21 07:54:13 ishisone Exp $