1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
|
<!doctype html public "-//IETF//DTD HTML 2.0//EN">
<!-- $Id: install.html,v 1.1 2001/03/05 12:58:01 tale Exp $ -->
<html>
<head>
<title>mDNkit installation guide</title>
<meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
</head>
<body>
<h1>CXg[</h1>
<h1>Install</h1>
<p>
mDNkit ̃RpCуCXg[@ɂĉ܂B
ł̓\[X̃CXg[@ɂĐ܂B
oCipbP[W̔zz\肳Ă܂A
̃CXg[@ɊւĂ͂ꂼ̃pbP[WQƂĂB
<p>This document describes mDNkit compiling and installation procedures.
Procedures for how to install from the source is described here.
Distribution of binary packages is planned; refer to the instructions that accompany each package.
<p>
{hLgł Unix p̃RpCƃCXg[@ɂ
܂BWindows p <a href="wrapper.html">mDN Wrapper</a> ̃CXg[
@ɊւĂ mDN Wrapper <a href="wrapper.html#setup">ZbgAbv</a>
B
<p>
This document describes the compiling and installing procedures for Unix. Refer to the section <a href="wrapper.html#setup">Setup</a> in mDN Wrapper for information on procedures to install in Windows <a href="wrapper.html">mDN Wrapper</a>.
<p>
\[Xzz̃CXg[菇͂悻̂悤ɂȂ܂B
<p>
Installation procedure from source distribution is implemented as follows.
<ol>
<li><a href="#preparation">O</a>
<li><a href="#preparation">Prepare</a>
<li><a href="#extract">zz\[X̓WJ</a>
<li><a href="#extract">Extract distribution source</a>
<li><a href="#configure"><tt>configure</tt> s</a>
<li><a href="#configure"><tt>Configure</tt> Execute</a>
<li><a href="#make">RpC</a>
<li><a href="#make">Compile</a>
<li><a href="#install">t@C̃CXg[</a>
<li><a href="#install">Install file</a>
</ol>
<p>
CXg[̌́A<a href="bindconfig.html">DNS T[o̐ݒ</a>
<a href="resolvconfig.html">mDNkit ]õRtBM[V</a>
A dnsproxy gpꍇɂ
<a href="proxyconfig.html">DNS Proxy Server ̃RtBM[V</a>
QƂĐݒsĂB
<p>
After installation, refer to and set up <a href="bindconfig.html">DNS server configuration</a>, <a href="resolvconfig.html">mDNkit resolver configuration</a>, and if dnsproxy is to be used <a href="proxyconfig.html">DNS Proxy Server configuration</a>.
<p>\[XzzɊ܂܂Ăpb`Kpꍇɂ́A
ꂼꎟ̎菇ɂĂB
<p>To install the patch included in source distribution, refer to the following instructions.
<ul>
<li><a href="#bind9">bind9 ppb`̓KpƃCXg[</a>
<li><a href="#bind9">Applying and installing a bind9 patch</a>
<li><a href="#bind">bind8 ppb`̓KpƃCXg[</a>
<li><a href="#bind">Applying and installing a bind8 patch</a>
<li><a href="#squid">squid ppb`̓KpƃCXg[</a>
<li><a href="#squid">Applying and installing a squid patch</a>
</ul>
<hr>
<h2><a name="preparation">O</a></h2>
<h2><a name="preparation">Preparations</a></h2>
<h3>iconv ̃CXg[</h3>
<h3>iconv installation</h3>
<p><b>mDNkit</b> EUC SJIS ȂǗlXȃ[JGR[fBOŋLqꂽ
hC̃GR[fBOϊ邽߂ɁAėp̃R[hZbgϊ
[eBeBł <em>iconv()</em> gp܂B
ŁAFreeBSD Ȃ <em>iconv()</em> Wőgݍ܂ĂȂVXeł́A
<b>mDNkit</b> ̃CXg[ɐ旧 <em>iconv()</em> CXg[
ȂȂ܂B܂A<b>mDNkit</b> <em>iconv()</em>
UTF-8 GR[fBOT|[gĂ邱Ƃv܂BVXet
<em>iconv()</em> UTF-8 T|[gĂȂꍇɂ͂͂
ÕpbP[WCXg[Kv܂B
<p><b>mDNkit</b> uses <em>iconv()</em>, a general-purpose utility, to convert domain name encoding of EUC, SJIS or other local encoding.
<em>iconv()</em> must be installed prior to <b>mDNkit</b> installation in those systems that do not have <em>iconv()</em> as a standard package, such as FreeBSD. Also, the <b>mDNkit</b> requires that <em>iconv()</em> should support UTF-8 encoding. An external package must be installed if the provided <em>iconv()</em> in the system does not support UTF-8.
<p><em>iconv()</em> ̃t[ȎƂẮAႦ <em>libiconv</em>
<p>There are free versions of <em>iconv()</em>, for example, <em>libiconv</em>.
<ul>
<li><a href="http://clisp.cons.org/~haible/packages-libiconv.html">http://clisp.cons.org/~haible/packages-libiconv.html</a>
</ul>
<p>A\[XL̃y[W肷邱Ƃł܂B
LGPL ɊÂt[\tgEFAŁA Unix n OS
Ƃœ삵܂B̃pbP[W̃CXg[@ɂẮALy[WA
邢̓\[XzzɊ܂܂ <tt>INSTALL.generic</tt> t@CB
<p>This source can be downloaded from the above page.
This is an LGPL-based free software package that runs on a variety of Unix operating systems. Refer to the above page or the <tt>INSTALL.generic</tt> file that accompanies the source distribution for information on installation procedures.
<p>
<h3>bind9 \[X̓</h3>
<h3>Obtaining the bind9 source</h3>
<p>mDNkit bind9 ɑpb`ĂAɂ
hCƂ̂ł bind9 ̃]oуT[o
쐬邱Ƃł܂B{LbgɊ܂܂pb` BIND 9.0.0
̂łB\[X͈ȉ̏ꏊ_E[h邱Ƃł܂B
<p>The mDNkit provides a bind9 patch that can be used to generate bind9 resolvers and servers that can support multilingual domain names. The patch in this kit is for BIND 9.0.0. The source can be downloaded from the following page.
<ul>
<li><a href="http://www.isc.org/products/BIND/bind9.html">
http://www.isc.org/products/BIND/bind9.html</a>
</ul>
<p>
<h3>bind8 \[X̓</h3>
<h3>Obtaining the bind8 source</h3>
<p>dnsproxy 𗘗păNCAgAvP[V
hCgpł悤ɂ邽߂ɂ́A
Os]oCu 8bit X[ɂKv܂B
܂ DNS T[ołAhC̃GR[fBOƂ
ASCII ݊GR[fBOł UTF-5 RACE ȊÓA
Ⴆ UTF-8 Ȃǂ̃GR[fBOgp邽߂ɂ́A
8bit X[ DNS T[ogpKv܂B
<p>To use dnsproxy to enable client applications to support multilingual domain names, the resolver library that resolves names must be made 8-bit through.
Also, 8-bit through DNS servers must be used to enable a DNS server to use encodings other than UTF-5, RACE or other ASCII compatible encoding (as multilingual domain name encoding), for example, UTF-8.
<p>mDNkit ɂ͂̂߂
BIND 8.2.2-P7 BIND 8.2.3-T6B 8bit X[ɂ
pb`܂܂Ă܂Bpb`Kp bind8 gpꍇɂ
炩߂ꂩ̃o[W̃\[XpӂĂB
\[X͈ȉ̏ꏊ_E[h邱Ƃł܂B
<p>The mDNkit for that reason supplies a patch that makes BIND 8.2.2-P7 and BIND 8.2.3-T6B 8-bit through. To use bind8 with a patch installed, obtain the source of the desired version.
Sources can be downloaded from the following page.
<ul>
<li><a href="http://www.isc.org/products/BIND/bind8.html">http://www.isc.org/products/BIND/bind8.html</a>
</ul>
<p>
<h3>Squid \[X̓</h3>
<h3>Obtaining Squid</h3>
<p>Web ̃LbVT[oł Squid ́Â܂܂ł͑
hC͂ƂG[ɂĂ܂Agp邱Ƃł܂B
̂<b>mDNkit</b> ɂ
<a href="http://www.squid-cache.org/Versions/v2/2.3/">Squid-2.3.STABLE3</a>
8bit X[ɂpb`܂܂Ă܂BSquid 𑽌hCŎgp
ꍇɂ͂̃\[XpӂĂB
<p>Squid, a Web cache server, cannot be used as is, because it will generate an error when entering multilingual domain names.
<b>mDNkit</b> comes with a patch that makes <a href="http://www.squid-cache.org/Versions/v2/2.3/">Squid-2.3.STABLE3</a> 8-bit through. Obtain this source if you wish to make Squid support multilingual domain names.
<p>
<hr>
<h2><a name="extract">zz\[X̓WJ</a></h2>
<h2><a name="extract">Extracting distribution source</a></h2>
<p><b>mDNkit</b> ɊւŐV͈ȉ̏ꏊ\ŁA
ŐV̔zz\[X̃_E[hł܂B
<p>The latest information regarding the <b>mDNkit</b> is available on the following site. The most recent distribution source can also be downloaded from the following page.
<ul>
<li><a href="http://www.nic.ad.jp/jp/research/idn/">http://www.nic.ad.jp/jp/research/idn/</a>
</ul>
<p>肵 <b>mDNkit</b> ̔zz\[XWJ܂B
zz\[X̃t@C <tt>mdnkit-<i>X.Y</i>.tar.gz</tt>Ƃ
̂悤ɂēWJł܂B
<p>Extracting the obtained <b>mDNkit</b> distribution source.
Distribution sources with file names such as <tt>mdnkit-<i>X.Y</i>.tar.gz</tt> are extracted as shown below.
<blockquote>
<pre>
% <kbd>gunzip mdnkit-X.Y.tar.gz</kbd>
% <kbd>tar -xf mdnkit-X.Y.tar</kbd>
</pre>
</blockquote>
<p>WJƁA<tt>mdnkit-<i>X.Y</i></tt>ƂfBNg܂̂ŁA
ɈړĂB
<p>When extracted, a <tt>mdnkit-<i>X.Y</i></tt> directory is generated. Move to this directory.
<blockquote>
<pre>
% <kbd>cd mdnkit-X.Y</kbd>
</pre>
</blockquote>
<p>ȍ~̐ł́ÃfBNg <tt>$MDNTOP</tt> ƂO
QƂ܂Bϐ <tt>$MDNTOP</tt> ݒ肵Ăƕ֗ł傤B
<p>In the following descriptions, this directory is referred to as <tt>$MDNTOP</tt>. Setting the environment variable <tt>$MDNTOP</tt> makes it easier to use.
<blockquote>
<pre>
% <kbd>setenv MDNTOP `pwd`</kbd> (csh ñVF̏ꍇ)
% <kbd>MDNTOP=`pwd`; export MDNTOP</kbd> (sh ñVF̏ꍇ)
% <kbd>setenv MDNTOP `pwd`</kbd> (for a csh system shell)
% <kbd>MDNTOP=`pwd`; export MDNTOP</kbd> (for a sh system shell)
</pre>
</blockquote>
<p>
<hr>
<h2><a name="configure"><tt>configure</tt> s</a></h2>
<h2><a name="configure">Running <tt>Configure</tt></a></h2>
<p>܂ <b>mDNkit</b> ̖{̂łA
<p>First compile the following that form the major part of the <b>mDNkit</b>.
<ul>
<li>MDN Cu (libmdn)
<li>MDN library (libmdn)
<li>DNS vLVT[o (dnsproxy)
<li>DNS proxy server (dnsproxy)
<li>][}X^t@CR[hϊc[ (mdnconv)
<li>Zone master file code conversion tool (mdnconv)
<li>runmdn R}h
<li>runmdn command
</ul>
<p>܂A<b>mDNkit</b> ̃gbvfBNg
(<tt>$MDNTOP</tt> ̎wfBNg) ɈړA
<tt>configure</tt> XNvgs܂B
<tt>configure</tt> ̓wb_t@CCu̗LȂǁAVXe
ׁARpCKɐݒ肷邽߂̃c[łB
<p>First move to the <b>mDNkit</b> top directory (the directory that <tt>$MDNTOP</tt> points to) and execute the <tt>configure</tt> script.
<tt>Configure</tt> is a tool that checks the header file and libraries to learn the features of the system to configure the optimum compiler environment.
<blockquote>
<pre>
% <kbd>cd $MDNTOP</kbd>
% <kbd>./configure</kbd>
</pre>
</blockquote>
<p>VXe <em>iconv()</em> gݍ܂ĂāARpC
ʂȃIvVgpȂȂL̂悤ɂȂɂw肹
s悢̂łAł͂ȂꍇAIvVϐ
<tt>configure</tt> ̓ς邱Ƃł܂B
<p>When <em>iconv()</em> is included with the system and no special options are used during compilation, it can be executed like above without the need to specify any arguments. In other cases, operation of <tt>configure</tt> can be changed using options and environment variables.
<p><tt>configure</tt> ɎwłIvV̒ <b>mDNkit</b>
ڊŴ͈ȉ̒ʂłB
<p>The following options that can be set by <tt>configure</tt> are directly related to <b>mDNkit</b>.
<dl>
<dt><tt>--with-iconv=<i>LIB</i></tt>
<dd>VXe <em>iconv()</em> gݍ܂ĂȂA邢
VXe <em>iconv()</em> gȂȂǂ̗RŐV
<em>iconv()</em> ̃pbP[WCXg[ꍇɁÃIvV
p <em>iconv()</em> ̃Cuw肵܂B<i>LIB</i>
Cuw肵܂BCut@CtpXŎw肷邩A
邢 C RpCɗ^IvV̌`Ŏw肵ĂB<br>
When the <em>iconv()</em> package is installed either because it is not included with the system or because you do not wish to use the existing <em>iconv()</em> in the system, use this option to configure the <em>iconv()</em> library. Use <i>LIB</i> to specify the library. Use the full path to specify the library or specify it using an option format assigned to the C compiler.
<p>Ⴆ<a href="#preparation">O</a>ɋ
<em>iconv</em> ̃pbP[WCXg[ꍇAftHgł
<tt>/usr/local/lib</tt> <tt>libiconv</tt> ɃCXg[̂ŁA<br>
For example, when the <em>iconv</em> package mentioned in <a href="#preparation">Preparations</a> is installed, it is by default installed in <tt>libiconv</tt> of <tt>/usr/local/lib</tt>, so it is a good idea to make the following entry.
<blockquote>
<pre>
--with-iconv="-L/usr/local/lib -liconv"
</pre>
</blockquote>
Ǝw肷悢ł傤B<tt>libiconv</tt> LCu̎ɂ́A
<tt>-R</tt> IvVw肵<br>
When <tt>libiconv</tt> is shared library, it may also be necessary to specify the <tt>-R</tt> option:
<blockquote>
<pre>
--with-iconv="-L/usr/local/lib -R/usr/local/lib -liconv"
</pre>
</blockquote>
<dt><tt>--with-utf8=<i>NAME</i></tt>
<dd>UTF-8 GR[fBO <em>iconv()</em> Ɏw肷ꍇA
<b>mDNkit</b> ̓ftHg <tt>UTF-8</tt> ƂGR[fBÔ
gp܂B UTF-8 GR[fBOw肷̂ <tt>UTF-8</tt> ȊO
GR[fBÔgpKvÃIvV <i>NAME</i>
ɂ̖̂w肵܂B<a href="#preparation">O</a>ɂ
<em>iconv</em> ̃pbP[Wgpꍇɂ͂̃IvV̎w
svłB<br>
When UTF-8 encoding is specified using <em>iconv()</em>, <b>mDNkit</b> uses <tt>UTF-8</tt> to encoding names by default. If other names must be used when UTF-8 encoding is specified, specify the name in <i>NAME</i> using this option. This is not required when using <em>iconv</em>package mentioned in <a href="#preparation">Preparations</a>.
<p>
<dt><a name="race-prefix"><tt>--with-race-prefix=<i>PREFIX</i></tt></a>
<dd>DNS vgRŗp鑽hC̃GR[fBO
Ƃ RACE ƂĂĂ܂B
<a href="../spec/library.html#ACE">ASCII ݊GR[fBO</a>
1łAhCɓ̃vtBbNXt邱ƂŒʏ
ASCII hCƋʂ邱Ƃ\ɂȂĂ܂B̃vtBbNX
݂<a href="../../reference/draft/draft-ietf-idn-race-02.txt">
C^[lbghtg</a>ł <tt>"bq--"</tt> łAύX
\܂BύXꂽꍇɂ͂̃IvVpĐ
vtBbNXw肵ĂB
<br>RACE is proposed as one of the encoding system to be used for multilingual domain names in DNS protocols. RACE is <a href="../spec/library.html#ACE"> an ASCII compatible encoding scheme</a> and adds a specific prefix to the domain name to distinguish it from an ordinary ASCII domain name. This prefix is <tt>"bq--"</tt> in current <a href="../../reference/draft/draft-ietf-idn-race-02.txt"> Internet Drafts</a>, but this may change in future. Use this option to enter the new prefix when a change is made.
<p>
<dt><a name="brace-suffix"><tt>--with-brace-suffix=<i>SUFFIX</i></tt></a>
<dd>RACE Ɠ DNS vgRŗp鑽hC
GR[fBOƂ BRACE ƂĂĂ܂B
ASCII ݊GR[fBO
1łARACE ƈقȂAhCɓ̃TtBbNXt邱ƂŒʏ
ASCII hCƋʂ邱Ƃ\ɂȂĂ܂B̃TtBbNX
݂<a href="../../reference/draft/draft-ietf-idn-brace-00.txt">
C^[lbghtg</a>ł <tt>"-8q9"</tt> łAύXꂽ
ꍇɂ͂̃IvVpĐTtBbNXw肵ĂB<br>
Like RACE, BRACE is being proposed as an encoding scheme for multilingual domain names to be used in DNS protocols. It is also an ASCII compatible encoding scheme, but differs from RACE in that it adds a suffix to the domain name to distinguish from normal ASCII domain names. This suffix is <tt>"-8q9"</tt> in the current <a href="../../reference/draft/draft-ietf-idn-brace-00.txt">Internet Draft</a>, but this may change in future. Use this option to enter the correct suffix when a change is made.
<p>
<dt><a name="lace-prefix"><tt>--with-lace-prefix=<i>PREFIX</i></tt></a>
<dd>
RACE BRACE Ɠ悤 ASCII ݊GR[fBÖƂLACE ƂĂĂ܂BRACE ƓlALACE ʏ ASCII hCƋʂ߂ɓʂȃvtBbNXgp܂B
݂<a href="../../reference/draft/draft-ietf-idn-lace-00.txt">C^[lbghtg</a>ł <tt>"bq--"</tt> łAꂪύXꂽꍇɂ͂̃IvVpĐvtBbNXw肵ĂB
<p>
<p>Like RACE and BRACE, LACE is another ASCII compatible encoding scheme and like, RACE, it adds a special prefix to distinguish it from ordinary ASCII domain names.
In the current <a href="../../reference/draft/draft-ietf-idn-lace-00.txt"> Internet Draft</a> the prefix is <tt>"bq--"</tt>, but this may change in the future; if it does, use this option to enter the correct prefix.
<p>
<dt><a name="enable-zld"><tt>--enable-zld</tt></a>
<dd>ZLD (Zero Level Domain) @\̃T|[glj܂B
ZLD Ƃ DNS T[oŗpꕔ̃GR[fBOɂāAʏ ASCII hCƑhCƂʂ邽߂ɗpȃhCłB
DNS vgRŎgpGR[fBOƂ ZLD KvƂGR[fBOIȂÃIvV̎w͕svłB
<p>This option adds ZLD (Zero Level Domain) function support. ZLD is a special domain name used to differentiate standard ASCII domain names from multilingual domain names in some encodings used in a DNS server. This option need not be set unless ZLD is selected as the required encoding in a DNS protocol. <p>
<p>ȂAZLD @\̃T|[g̗L dnsproxy runmdn ݒt@Cǂݍލۂ̐U镑 (ZLD ̎w邩ǂ) ɉe܂B
mDNkit <a href="../spec/library.html">Cu</a>̂́A(ݒt@Cǂݍނ߂̈ꕔ̃W[)̃IvVɂē삪ς邱Ƃ͂ȂA ZLD ̏s悤ɂȂĂ܂B
<p>The support of the ZLD function affects operation (i.e. whether or not the ZLD setting is ignored) when configuration files are read in using the dnsproxy or runmdn command. The operation of the <a href="../spec/library.html">library</a> provided by the mDNkit does not change with this option (except some modules used for reading in configuration files), but performs ZLD processing at all times.<p>
<dt><tt><a name="sbindir">--sbindir=<i>DIR</i></a></tt>
<dd>DNS vLVT[o dnsproxy CXg[fBNgw肵܂B
ftHgł <tt>/usr/local/sbin</tt> ɃCXg[܂B
<p>
Specifies the directory where dnsproxy, the DNS proxy server, is installed. <tt>/usr/local/sbin</tt> is the default directory.<p>
<dt><tt><a name="bindir">--bindir=<i>DIR</i></a></tt>
<dd>][}X^t@CR[hϊc[ mdnconv уNCAgɑhCt runmdn R}hCXg[fBNgw肵܂B
ftHgł <tt>/usr/local/bin</tt> ɃCXg[܂B
<p>
<p>
<dd>Specifies the directory where the mdnconv command, a tool for converting zone master file code, and the runmdn command that adds multilingual domain name processing capability to a client, are installed. <tt>/usr/local/bin</tt> is the default directory.<p>
<dt><tt><a name="libdir">--libdir=<i>DIR</i></a></tt>
<dd>dnsproxy mdnconv gp mDNkit ̊{CuCXg[fBNgw肵܂B
ftHgł <tt>/usr/local/lib</tt> ɃCXg[܂B
<p>
<dd>Specifies the directory where the basic mDNkit and other basic libraries employed by dnsproxy or mdnconv are installed.
<tt>/usr/local/lib</tt> is the default directory.<p>
<p>
<dt><tt><a name="includedir">--includedir=<i>DIR</i></a></tt>
<dd>mDNkit ̊{Cugp̂ɕKvȃwb_t@CCXg[fBNgw肵܂BftHgł <tt>/usr/local/include</tt> ɃCXg[܂B
<p>
<dd>Specifies the directory where the header file required for use of the basic mDNkit library is installed. <tt>/usr/local/include</tt> is the default directory.<p>
<dt><tt><a name="sysconfdir">--sysconfdir=<i>DIR</i></a></tt>
<dd>DNS vLVT[o dnsproxy ̐ݒt@CAmDNkit ̃NCAgʐݒt@CCXg[fBNgw肵܂B
ftHgł <tt>/usr/local/etc</tt> ɃCXg[܂B
<p>
<dd>Specifies the directory where dnsproxy, the DNS proxy server, configuration files and shared client configuration files for mDNkit are installed.
<tt>/usr/local/etc</tt> is the default directory.<p>
<p>
<dt><tt><a name="mandir">--mandir=<i>DIR</i></a></tt>
<dd>IC}jACXg[x[XfBNgw肵܂B
ftHgł <tt>/usr/local/man</tt> łBۂɂ͂̃fBNg̃TufBNg <tt>man1</tt> <tt>man8</tt> ɃCXg[܂B
<p>
<dd>Specifies the base directory where the online manuals are installed.
<tt>/usr/local/man</tt> is the default directory. In fact, they are installed in its <tt>man1</tt> or <tt>man8</tt> subdirectory.<p>
</dl>
<p>̑ɂ <tt>configure</tt> ɂ͂낢ȃIvVw肷邱Ƃł܂B
<p>A number of other options can be specified using <tt>configure</tt>.<p>
<blockquote>
<pre>
% <kbd>./configure --help</kbd>
</pre>
</blockquote>
<p>Ŏw\ȃIvV̈ꗗ\邱Ƃł܂B
<p>The above is used to display a list of specifiable options.<p>
<p>܂AWϐ͎̒ʂłB
<p>The related environment variables are as follows.<p>
<dl>
<dt><tt>CFLAGS</tt>
<dd>CRpCɓnIvVw肵܂BႦΊOiconv pbP[WCXg[ƂɁACN[ht@C<tt>iconv.h</tt> WȊÕfBNgAႦ<tt>/usr/local/include</tt> ɃCXg[ꂽƂ܂B̂悤ȏꍇɂ <tt>CFLAGS</tt> <tt>-I/usr/local/include</tt> ݒ肷Kv܂B̓Iɂ́Acsh ñVF̏ꍇɂ
<p>
<dd>Specifies options passed to the C compiler. Let's assume that when an external iconv package is installed, <tt>iconv.h</tt>, the include file is installed in a directory other than the standard directory, for example, <tt>/usr/local/include</tt>. This requires that <tt>-I/usr/local/include</tt> be configured in <tt>CFLAGS</tt>. The following configuration is required in a csh shell.<p>
<blockquote>
<pre>
% <kbd>setenv CFLAGS -I/usr/local/include</kbd>
</pre>
</blockquote>
<p>܂ sh ñVF̏ꍇɂ
<p>An sh shell requires the following configuration.
<blockquote>
<pre>
% <kbd>CFLAGS=-I/usr/local/include; export CFLAGS</kbd>
</pre>
</blockquote>
<p>Ƃ܂B
<p><tt>CFLAGS</tt> ͂̑ɂ C RpC̍œKIvVw肷邽߂ɂg܂B<tt>CFLAGS</tt> <tt>-O</tt> w肷œKŃRpC܂B
<p><tt>CFLAGS</tt> can be used in other situations to specify the optimum C compiler options. When <tt>-O</tt> is specified in <tt>CFLAGS</tt> compilation is optimized.
</dl>
<p><tt>configure</tt> s邱ƂɂAȂ̃VXeɍ킹Ēꂽ Makefile ̑̃t@C܂B
<p>When <tt>configure</tt> is executed, Makefile and other files are generated and adapted to your system environment.
<p>
<hr>
<h2><a name="make">RpC</a></h2>
<h2><a name="make">Compile</a></h2>
<p><a href="#configure"><tt>configure</tt> s</a>ɂāAVXeɍ Makefile Ă̂ŁARpC̓gbvfBNg(<tt>$MDNTOP</tt> ̎wfBNg) <tt>make</tt> R}hs邾łB
<p>Since <a href="#configure"><tt>configure</tt></a> generates a Makefile tailored to the system environment, all that compile needs to do is to execute the <tt>make</tt> command in the top directory (the directory pointing to <tt>$MDNTOP</tt>).
<blockquote>
<pre>
% <kbd>make</kbd>
</pre>
</blockquote>
<p>
<hr>
<h2><a name="install">t@C̃CXg[</a></h2>
<p><h2><a name="install">Installing Files</a></h2>
<p>RpCIAst@CȂǂ̃CXg[s܂B
CXg[̑OɃX[p[[UɂȂĂB
<p>When compiling is finished, install the executable files and other files. Become a superuser prior to installation.<p>
<blockquote>
<pre>
% <kbd>su</kbd>
</pre>
</blockquote>
<p>Ƃ <tt>make install</tt> sAKvȃt@CVXeɃCXg[܂B
<p>Then execute <tt>make install</tt> to install all the required files in the system.<p>
<blockquote>
<pre>
# <kbd>make install</kbd>
</pre>
</blockquote>
<p>CXg[t@C͈ȉ̒ʂłB
<p>The following files will be installed.<p>
<dl>
<dt>st@C
<p><dt>Executable files
<dd>ȉ̎st@CCXg[܂B
<p><dd>The following executable files will be installed.
<dl>
<dt><tt>dnsproxy</tt>
<dd>DNS vLVT[ołB
<dd>The DNS proxy server.<p>
<dt><tt>mdnconv</tt>
<dd>][}X^t@Cp̃R[hϊc[łB
<dd>The code conversion tool for zone master files.<p>
<dt><tt>runmdn</tt>
<dd>NCAgăRpC邱ƂȂɑhC̖O@\tR}hłB
ftHgł <tt>/usr/local/bin</tt> ɃCXg[܂B
<dd>This command adds, without the need for recompiling, the capability to resolve multilingual domain names to clients. It is installed in <tt>/usr/local/bin</tt> by default.<p>
</dl>
<p><tt>dnsproxy</tt> ́AftHgł <tt>/usr/local/sbin</tt>ɃCXg[܂B
CXg[ςɂ<tt>configure</tt> <tt><a href="#sysconfdir">--sysconfdir</a></tt>IvVgp܂B
<p><tt>dnsproxy</tt> is installed in <tt>/usr/local/sbin</tt> by default. If you wish to change the installation location, use the <tt>configure</tt> <tt><a href="#sysconfdir">--sysconfdir</a></tt> option.
<p><tt>mdnconv</tt> <tt>runmdn</tt> ́AftHgł <tt>/usr/local/bin</tt> ɃCXg[܂B
CXg[ςɂ <tt>configure</tt> <tt><a href="#bindir">--bindir</a></tt>IvVgp܂B
<p>
<p><tt>mdnconv</tt> and <tt>runmdn</tt> are installed in <tt>/usr/local/bin</tt> by default. If you wish to change the installation location, use the </tt> <tt><a href="#bindir">--bindir</a></tt> option.<p>
<dt>IC}jA<p>
<dt>On-line manuals<p>
<dd>ȉ̃IC}jACXg[܂B
<p><dd>The following on-line manuals will be installed.<p><dl>
<dt><tt>dnsproxy.</tt>
<dd>DNS vLVT[o dnsproxy ̃}jAłB
<p><dd>The dnsproxy, a DNS proxy server, manual<p>
<dt><tt>mdnconv.1</tt>
<dd>][}X^t@Cp̃R[hϊc[ mdnconv ̃}jAłB
<p><dd>The manual for mdnconv, a zone master file code conversion tool<p>
<dt><tt>runmdn.1</tt>
<dd>runmdn R}h̃}jAłB
<p><dd>The runmdn command manual<p>
<dt><tt>mdnres.conf.5</tt>
<dd>NCAgʐݒt@C mdnres.conf ̃IC}jAłB
<p><dd>The on-line manual for mdnres.conf, a shared client configuration file
</dl>
<p>ftHgł <tt>/usr/local/man/man8</tt> (<tt>dnsproxy.8</tt>)A<tt>/usr/local/man/man1</tt> (<tt>mdnconv.1</tt>A<tt>runmdn.1</tt>)A<tt>/usr/local/man/man5</tt> (<tt>mdnres.conf.5</tt>)ɂꂼCXg[܂B
<p>These manuals are by default installed in <tt>/usr/local/man/man8</tt> (<tt>dnsproxy.8</tt>), <tt>/usr/local/man/man1</tt> (<tt>mdnconv.1</tt>, <tt>runmdn.1</tt>) and <tt>/usr/local/man/man5</tt> (<tt>mdnres.conf.5</tt>), respectively.<p>
CXg[ςɂ́A<tt>configure</tt> <tt><a href="#mandir">--mandir</a></tt> IvVgp܂B
<p>
<p>To change the location of installation, use the <tt><a href="#mandir">--mandir</a></tt> option of <tt>configure</tt>.<p>
<dt>ݒt@C
<dd>ȉ̐ݒt@C邢͂̃Tvt@CCXg[܂B
<p>Configuration files
<dd>The following configuration files and sample files will be installed.<p>
<dl>
<dt><tt>dnsproxy.conf</tt>
<dd>DNS vLVT[o dnsproxy ̐ݒt@C̐ݒLqTvt@CłB
̃t@CłɃCXg[Ăꍇɂ́A㏑Ă܂Ȃ悤 <tt>dnsproxy.conf.sample</tt> ƂOŃCXg[܂B
<p>̃t@C̐ݒ@ɊւĂ <a href="proxyconfig.html">DNS Proxy Server ̃RtBM[V</a>QƂĂB
<p><dd>This sample file describes setup examples for the configuration file for dnsproxy, the DNS proxy server.
If this file has already been installed, it is installed under the name <tt>dnsproxy.conf.sample</tt> so as not to overwrite the previous file.
Refer to <a href="proxyconfig.html">DNS Proxy Server Configuration</a> for information on how to set it up.<p>
<dt><tt>mdnres.conf.sample</tt>
<dd>NCAgʐݒt@C mdnres.conf ̐ݒLqTvt@CłB
<p><dd>This sample file describes setup examples for mdnres.conf, a shared client configuration file.<p>
<p>̃t@C̐ݒ@ɊւĂ<a href="resolvconfig.html">mDNkit ]õRtBM[V</a>QƂĂB
<p><dd>Refer to the <a href="resolvconfig.html">mDNkit resolver configuration</a> for information on how to set it up.<p>
</dl>
<p>ftHgł <tt>/usr/local/etc</tt> ɃCXg[܂B
CXg[ςɂ́A<tt>configure</tt> <tt><a href="#sysconfdir">--sysconfdir</a></tt> IvVgp܂B
<p>
<p>Both files are by default installed in <tt>/usr/local/etc</tt>. To change the installation location, use the <tt><a href="#sysconfdir">--sysconfdir</a></tt> option.<p>
<dt>Cu
<dd>ȉ̃CuCXg[܂B
<p><dt>Libraries
<dd>The following libraries will be installed.<p>
<dl>
<dt><tt>libmdn</tt>
<dd>dnsproxy mdnconv ̃R}hgpĂmDNkit ̊{CułB
<p>A basic mDNkit library that employs dnsproxy, mdnconv and other commands.
<dt><tt>libmdnres</tt>
<dd>runmdn R}hɂăNCAgɓIɃN郉CułB
<p><dd>A library dynamically linked to a client using the runmdn command.
</dl>
<p>̃CuftHgł <tt>/usr/local/lib</tt> ɃCXg[܂B
CXg[ςɂ<tt>configure</tt> <tt><a href="#libdir">--libdir</a></tt>IvVgp܂B
<p>
<p>Both libraries are by default installed in <tt>/usr/local/lib</tt>. To change the installation location, use <tt>configure</tt> with the <tt><a href="#libdir">--libdir</a></tt> option.<p>
<dt>wb_t@C
<dd>libmdn ̃wb_t@CCXg[܂B
ftHgł <tt>/usr/local/include</tt> ̉ <tt>mdn</tt> ƂfBNgẢɃCXg[܂B
CXg[ςɂ́A<tt>configure</tt><tt><a href="#includedir">--includedir</a></tt> IvVgp܂B
<p><dt>Header file
<dd>Installs the libmdn header file.
This file is by fault installed in the <tt>mdn</tt> directory under <tt>/usr/local/include</tt>.
To change the installation location, use the <tt><a href="#includedir">--includedir</a></tt> option in <tt>configure</tt>.
</dl>
<p>
<hr>
<h2><a name="bind9">bind9 ppb`̓KpƃCXg[</a></h2>
<h2><a name="bind9">Applying and Installing the bind9 Patch</a></h2>
<p>WJ\[X̒<tt>$MDNTOP/patch/bind9/bind-9.0.0-patch</tt> BIND 9.0.0 ɑhC̏@\tpb`łB
pb`̓ĕ͂̃t@C̐擪ɂĂ܂AȒPɏЉƁÂ悤ɂȂ܂B
<p><tt>$MDNTOP/patch/bind9/bind-9.0.0-patch</tt> in extracted source is the patch that adds multilingual domain name processing functionality to BIND 9.0.0.
Information on how to apply the patch is appended to the beginning of the file, but the following is a brief description.<p>
<ol>
<li>BIND 9.0.0 ̃\[X̃gbvfBNg(<tt>README</tt> Ƃt@CfBNgł) Ɉړ܂B
<p>Move to the BIND 9.0.0 source top directory (the directory that contains the <tt>README</tt> file).
<blockquote>
<pre>
% <kbd>cd /somewhere/.../bind-9.0.0</kbd>
</pre>
</blockquote>
<li><tt>patch</tt> R}hgpă\[XɃpb`Ă܂B
<p>Use the <tt>patch</tt> command to apply the patch to the source.
<blockquote>
<pre>
% <kbd>patch -p0 < $MDNTOP/patch/bind9/bind-9.0.0-patch</kbd>
</pre>
</blockquote>
</ol>
<p>pb`ĂƁAgbvfBNg <tt>README.mdnkit</tt> Ƃt@C܂BRpC̑Oɂ̃t@CǂłB
<p>When the patch is applied a <tt>README.mdnkit</tt> file is created in the top directory. Read this file before compilation.<p>
<p>̂ƃRpCƃCXg[s܂B@ <tt>README.mdnkit</tt>
ɏĂ܂B̃t@CɂĂ܂A<tt>configure</tt> R}h̎s<tt>--with-mdn</tt> IvV邱ƂYȂłB
̃IvVȂƑhC̏@\͕t܂B
<p>After this perform compilation and installation. Refer to <tt>README.mdnkit</tt> for instructions. As stated in this file, be sure to add the <tt>--with-mdn</tt> option when executing the <tt>configure</tt> command. Unless this option is added, capability to process multilingual domain names will not be added.
<blockquote>
<pre>
% ./configure --with-mdn
</pre>
</blockquote>
<p>bind9 p̃pb` mDNkit ̖{ (ɃCuƃwb_t@C) łɃCXg[Ă邱ƂOƂĂ܂BāA̍ƂmDNkit {̂̃CXg[IɎsĂB
<p>The bind9 patch assumes that the major portion of the mDNkit (especially, the library and header file) is already installed. Consequently, this operation should be performed after the mDNkit has been installed.
<p>
<hr>
<h2><a name="bind">bind8 ppb`̓KpƃCXg[</a></h2>
<h2><a name="bind">Adding and Installing the bind8 patch</a></h2>
<p>WJ\[X̒<tt>$MDNTOP/patch/bind8/bind-8.2.2-P7-patch</tt> BIND 8.2.2-P7 ɑ 8rbgX[pb`A܂<tt>$MDNTOP/patch/bind8/bind-8.2.3-T6B-patch</tt> BIND 8.2.3-T6B ɑ 8rbgX[pb`łB
pb`̓ĕ͂̃t@C̐擪ɂĂ܂AȒPɏЉƁÂ悤ɂȂ܂B
<p>The <tt>$MDNTOP/patch/bind8/bind-8.2.2-P7-patch</tt> in the extracted source is the 8-bit through patch for BIND 8.2.2-P7 and the <tt>$MDNTOP/patch/bind8/bind-8.2.3-T6B-patch</tt> is the 8-bit through patch for BIND 8.2.3-T6B.
Information on how to apply the patch is appended to the beginning of the file, but the following is a brief description.
<ol>
<li>BIND 8.2.2-P7 邢 BIND 8.2.3-T6B ̃\[X̃gbvfBNg(<tt>src</tt> ƂTufBNgfBNgł) Ɉړ܂B
<p>Move to the top directory of the BIND 8.2.2-P7 or BIND 8.2.3-T6B source (the directory containing the <tt>src</tt> subdirectory).
<blockquote>
<pre>
% <kbd>cd /somewhere/.../bind-8.2.2-P7</kbd>
</pre>
</blockquote>
<li><tt>patch</tt> R}hgpă\[XɃpb`Ă܂B
<p>Use the <tt>patch</tt> command to apply the patch to the source.
<blockquote>
<pre>
% <kbd>patch -p0 < $MDNTOP/patch/bind8/bind-8.2.2-P7-patch</kbd>
</pre>
</blockquote>
</ol>
<p>pb`ĂAƂ͒ʏ BIND ̃CXg[@ɂăRpCƃCXg[sĂBCXg[@ BIND ̃\[X <tt>src/INSTALL</tt> ɏĂ܂B
<p>When the patch has been applied, perform compilation and installation according to the standard BIND installation procedure. Refer to <tt>src/INSTALL</tt> for installation instructions.
<p>bind8 p̃pb` BIND P 8rbgX[ɂ邾ŁAmDNkit ̃Cu͎gp܂B mDNkit {̂Ƃ͓ƗɃRpCуCXg[邱Ƃł܂B
<p>
<p>The bind8 patch only makes BIND 8-bit through and does not use the mDNkit library. Thus it can be compiled and installed separately from the mDNkit.
<hr>
<h2><a name="squid">squid ppb`̓KpƃCXg[</a></h2>
<h2><a name="squid">Applying and Installing the squid Patch</a></h2>
<p>WJ\[X̒ <tt>$MDNTOP/patch/squid/squid-2.3.STABLE3-patch</tt> Squid 2.3.STABLE3 ɑ 8rbgX[pb`łB
pb`̓ĕ͂̃t@C̐擪ɂĂ܂AȒPɏЉƁÂ悤ɂȂ܂B
<p>The <tt>$MDNTOP/patch/squid/squid-2.3.STABLE3-patch</tt> in the extracted source is the 8-bit through patch for Squid 2.3.STABLE3.
Information on how to apply the patch is appended to the beginning of the file, but the following is a brief description.
<ol>
<li>Squid 2.3.STABLE3 ̃\[X̃gbvfBNg (<tt>README</tt>t@CfBNgł) Ɉړ܂B
<p>Move to the top directory of Squid 2.3.STABLE3 source (the directory containing the <tt>README</tt> file).
<blockquote>
<pre>
% <kbd>cd /somewhere/.../squid-2.3.STABLE3</kbd>
</pre>
</blockquote>
<li><tt>patch</tt> R}hgpă\[XɃpb`Ă܂B
<p>Use the <tt>patch</tt> command to apply the patch to the source.
<blockquote>
<pre>
% <kbd>patch -p1 < $MDNTOP/patch/squid/squid-2.3.STABLE3-patch</kbd>
</pre>
</blockquote>
</ol>
<p>pb`ĂAƂ͒ʏ Squid ̃CXg[@ɂăRpCƃCXg[sĂBCXg[@Squid ̃\[XɊ܂܂ <tt>INSTALL</tt> t@CɏĂ܂B
<p>When the patch has been applied, perform compilation and installation according to the standard Squid install procedure. Refer to <tt>INSTALL</tt> in the Squid source for installation instructions.
<p>Squid p̃pb` bind8 p̃pb`ƓlP 8rbgX[ɂ邾ŁAmDNkit ̃Cu͎gp܂B
mDNkit {̂Ƃ͓ƗɃRpCуCXg[邱Ƃł܂B<p>Both the Squid and the bind8 patches only add 8-bit through capability and does not use any mDNkit library or other function.
Thus they can be compiled and installed independently from the mDNkit.
</body>
</html>
|
