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
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
|
<?xml version='1.0' encoding='EUC-KR' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
<!-- English Revision: 105989:329591 (outdated) -->
<!--
Copyright 2004-2006 The Apache Software Foundation or its licensors,
as applicable.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<manualpage metafile="configure.xml.meta">
<parentdocument href="./">Programs</parentdocument>
<title>configure - 소스 트리를 구성한다</title>
<summary>
<p><code>configure</code> 스크립트는 특정 플래폼에서 아파치
웹서버를 컴파일하고 설치하기위해 소스 트리를 구성한다. 여러
옵션을 사용하여 원하는 요구조건에 맞게 서버를 컴파일할 수
있다.</p>
<p>소스 배포본의 최상위 디렉토리에 있는 이 스크립트는 유닉스와
유닉스류 시스템에서만 사용한다. 다른 플래폼을 사용한다면
<a href="../platform/">플래폼</a> 문서를 참고하라.</p>
</summary>
<seealso><a href="../install.html">컴파일과 설치</a></seealso>
<section id="synopsis"><title>개요</title>
<p><code>configure</code> 스크립트는 배포본의 최상위
디렉토리에서 실행해야 한다.</p>
<p><code><strong>./configure</strong> [<var>OPTION</var>]...
[<var>VAR</var>=<var>VALUE</var>]...</code></p>
<p>환경변수를 (예를 들어, <code>CC</code>, <code>CFLAGS</code>,
...) 지정하려면, <code><var>VAR</var>=<var>VALUE</var></code>와
같이 지시한다. <a href="#env">아래에서</a> 유용한 환경변수들을
설명한다.</p>
</section>
<section id="options"><title>옵션</title>
<ul>
<li><a href="#configurationoptions">구성 옵션</a></li>
<li><a href="#installationdirectories">설치 디렉토리</a></li>
<li><a href="#systemtypes">시스템 종류</a></li>
<li><a href="#optionalfeatures">기능 선택</a></li>
<li><a href="#supportopt">지원 프로그램을 위한 옵션</a></li>
</ul>
<section id="configurationoptions"><title>구성 옵션</title>
<p>이 옵션들은 <code>configure</code> 자체 행동에 영향을
준다.</p>
<dl>
<dt><code>-C</code></dt>
<dt><code>--config-cache</code></dt>
<dd><code>--cache-file=config.cache</code>와 같다.</dd>
<dt><code>--cache-file=<var>FILE</var></code></dt>
<dd>검사 결과를 <var>FILE</var> 파일에 캐싱한다.
기본값은 검사 결과를 기록하지 않는다.</dd>
<dt><code>-h</code></dt>
<dt><code>--help [short|recursive]</code></dt>
<dd>도움말을 출력하고 종료한다. <code>short</code> 아규먼트는
이 패키지 특유의 옵션만을 출력한다. <code>recursive</code>
아규먼트는 포함된 모든 패키지에 대한 짧은 도움말을
보여준다.</dd>
<dt><code>-n</code></dt>
<dt><code>--no-create</code></dt>
<dd><code>configure</code> 스크립트를 정상적으로 실행하지만,
출력파일을 만들지 않는다. 이 옵션은 컴파일을 위한 makefile을
만들기 이전에 검사 결과를 확인해볼때 유용하다.</dd>
<dt><code>-q</code></dt>
<dt><code>--quiet</code></dt>
<dd>실행중에 <code>checking ...</code> 문구를 출력하지
않는다.</dd>
<dt><code>--srcdir=<var>DIR</var></code></dt>
<dd><var>DIR</var> 디렉토리를 소스파일 디렉토리로 지정한다.
기본값은 configure가 있는 디렉토리 혹은 상위디렉토리
<code>..</code>이다.</dd>
<dt><code>--silent</code></dt>
<dd><code>--quiet</code>와 같다.</dd>
<dt>-V</dt>
<dt>--version</dt>
<dd>저작권 정보를 출력하고 종료한다.</dd>
</dl>
</section>
<section id="installationdirectories"><title>설치 디렉토리</title>
<p>이 옵션들은 설치 디렉토리를 지정한다. 설치 위치는
선택한 구조(layout)에 따라 다르다.</p>
<dl>
<dt><code>--prefix=<var>PREFIX</var></code></dt>
<dd>아키텍쳐에 독립적인 파일을 <var>PREFIX</var>에 설치한다.
기본값은 <code>/usr/local/apache2</code>이다.</dd>
<dt><code>--exec-prefix=<var>EPREFIX</var></code></dt>
<dd>아키텍쳐에 의존적인 파일을 <var>EPREFIX</var>에 설치한다.
기본값은 <var>PREFIX</var> 디렉토리이다.</dd>
</dl>
<p>기본적으로 <code>make install</code>은
<code>/usr/local/apache2/bin</code>,
<code>/usr/local/apache2/lib</code>와 같은 위치에 모든
파일을 설치한다. <code>--prefix=$HOME</code>과 같이
<code>--prefix</code> 옵션을 사용하여
<code>/usr/local/apache2</code> 이외의 설치 상위디렉토리를
지정할 수 있다.</p>
<section id="layout"><title>디렉토리 구조 지정</title>
<dl>
<dt><code>--enable-layout=<var>LAYOUT</var></code></dt>
<dd>설치 위치를 <var>LAYOUT</var> 구조에 따르도록
소스코드와 컴파일 스크립트를 구성한다. 구조를 사용하면
파일 종류에 따라 설치 위치를 따로 지정할 수 있다.
<code>config.layout</code> 파일에 여러 설정 예가 있고,
이를 참고하여 직접 설정을 만들 수도 있다. 파일에서
각 구조는 <code><Layout
FOO>...</Layout></code>로 구분되며, 이
부분은 <code>FOO</code>라는 이름의 구조를 나타낸다.
구조의 기본값은 <code>Apache</code>이다.</dd>
</dl>
</section>
<section id="directoryfinetuning"><title>설치 디렉토리의
자세한 조정</title>
<p>설치 디렉토리를 더 수정한다면 아래 옵션을 사용한다.
각 디렉토리의 기본값은 <code>autoconf</code>가 지정하며,
선택한 구조에 따라 다름을 주의하라.</p>
<dl>
<!-- only apr-config and apu-config are installed at bindir.
everything else is stored at sbindir. ==> clarify/change this -->
<dt><code>--bindir=<var>DIR</var></code></dt>
<dd>사용자 실행파일을 <var>DIR</var>에 설치한다. 사용자
실행파일에는 사이트 관리자에게 유용한
<code>htpasswd</code>와 <code>dbmmanage</code> 같은
지원 프로그램도 포함된다. <var>DIR</var>의 기본값은
<code><var>EPREFIX</var>/bin</code>이다.</dd>
<dt><code>--datadir=<var>DIR</var></code></dt>
<dd>아키텍쳐 독립적인 읽기전용 자료를 <var>DIR</var>에
설치한다. <code>datadir</code>의 기본값은
<code><var>PREFIX</var>/share</code>이다.
<code>autoconf</code>에 이 옵션이 있지만 현재 사용하지
않는다.</dd>
<dt><code>--includedir=<var>DIR</var></code></dt>
<dd>C 헤더파일을 <var>DIR</var>에 설치한다.
<code>includedir</code>의 기본값은
<code><var>EPREFIX</var>/include</code>이다.</dd>
<dt><code>--infodir=<var>DIR</var></code></dt>
<dd>info 문서를 <var>DIR</var>에 설치한다.
<code>infodir</code>의 기본값은
<code><var>PREFIX</var>/info</code>이다. 현재 이 옵션은
사용하지 않는다.</dd>
<dt><code>--libdir=<var>DIR</var></code></dt>
<dd>오브젝트코드 라이브러리를 <var>DIR</var>에 설치한다.
<code>libdir</code>의 기본값은
<code><var>EPREFIX</var>/lib</code>이다.</dd>
<dt><code>--libexecdir=<var>DIR</var></code></dt>
<dd>프로그램 실행파일을 (즉, 공유모듈) <var>DIR</var>에
설치한다. <code>libexecdir</code>의 기본값은
<code><var>EPREFIX</var>/libexec</code>이다.</dd>
<dt><code>--localstatedir=<var>DIR</var></code></dt>
<dd>변경되는 머쉰별 정보를 <var>DIR</var>에 설치한다.
<code>localstatedir</code>의 기본값은
<code><var>PREFIX</var>/var</code>이다.
<code>autoconf</code>에 이 옵션이 있지만 현재 사용하지
않는다.</dd>
<dt><code>--mandir=<var>DIR</var></code></dt>
<dd>man 문서를 <var>DIR</var>에 설치한다.
<code>mandir</code>의 기본값은
<code><var>EPREFIX</var>/man</code>이다.</dd>
<dt><code>--oldincludedir=<var>DIR</var></code></dt>
<dd>gcc가 아닌 컴파일러를 위한 C 헤더파일을 <var>DIR</var>에
설치한다. <code>oldincludedir</code>의 기본값은
<code>/usr/include</code>이다. <code>autoconf</code>에
이 옵션이 있지만 현재 사용하지 않는다.</dd>
<dt><code>--sbindir=<var>DIR</var></code></dt>
<dd>시스템 관리자용 실행파일을 <var>DIR</var>에 설치한다.
시스템 관리자용 실행파일이란 아파치 웹서버를 실행하는데
필요한 <code>httpd</code>, <code>apachectl</code>,
<code>suexec</code> 등 서버 프로그램을 말한다.
<code>sbindir</code>의 기본값은
<code><var>EPREFIX</var>/sbin</code>이다.</dd>
<dt><code>--sharedstatedir=<var>DIR</var></code></dt>
<dd>변경되는 아키텍쳐 독립적인 자료를 <var>DIR</var>에
설치한다. <code>sharedstatedir</code>의 기본값은
<code><var>PREFIX</var>/com</code>이다.
<code>autoconf</code>에 이 옵션이 있지만 현재 사용하지
않는다.</dd>
<dt><code>--sysconfdir=<var>DIR</var></code></dt>
<dd>서버 설정파일 <code>httpd.conf</code>,
<code>mime.types</code>와 같은 읽기전용 머쉰별 자료를
<var>DIR</var>에 설치한다. <code>sysconfdir</code>의
기본값은 <code><var>PREFIX</var>/etc</code>이다.</dd>
</dl>
</section>
</section>
<section id="systemtypes"><title>시스템 종류</title>
<p>다른 시스템에서 실행할 아파치 웹서버를
교차컴파일하기(cross-compile)하기 위한 옵션들이다. 서버를
컴파일한 시스템에서 서버를 실행하는 일반적인 경우, 이
옵션을 사용하지 않는다.</p>
<dl>
<dt><code>--build=<var>BUILD</var></code></dt>
<dd>도구를 컴파일하는 시스템의 종류를 지정한다. 기본값은
<code>config.guess</code> 스크립트의 결과이다.</dd>
<dt><code>--host=<var>HOST</var></code></dt>
<dd>서버를 실행할 시스템의 종류를 지정한다. <var>HOST</var>의
기본값은 <var>BUILD</var>이다.</dd>
<dt><code>--target=<var>TARGET</var></code></dt>
<dd><var>TARGET</var> 시스템 종류를 위한 컴파일러를 만들때
사용한다. 기본값은 <var>HOST</var>이다.
<code>autoconf</code>에 이 옵션이 있지만 아파치 웹서버와는
관련이 없다.</dd>
</dl>
</section>
<section id="optionalfeatures"><title>기능 선택</title>
<p>이 옵션은 웹서버의 세부 기능을 조절한다.</p>
<section id="generaloptfeat"><title>일반적인 문법</title>
<p>일반적으로 다음 문법을 사용하여 기능을 포함하고 뺀다:</p>
<dl>
<dt><code>--disable-<var>FEATURE</var></code></dt>
<dd><var>FEATURE</var> 기능을 뺀다.
<code>--enable-<var>FEATURE</var>=no</code>와 같다.</dd>
<dt><code>--enable-<var>FEATURE</var>[=<var>ARG</var>]</code></dt>
<dd><var>FEATURE</var> 기능을 포함한다. <var>ARG</var>의
기본값은 <code>yes</code>이다.</dd>
<dt><code>--enable-<var>MODULE</var>=shared</code></dt>
<dd>해당 모듈을 DSO 모듈로 컴파일한다.</dd>
<dt><code>--enable-<var>MODULE</var>=static</code></dt>
<dd>포함하는 모듈은 기본적으로 정적으로 링크된다. 이
옵션은 명시적으로 정적 링크를 강제한다.</dd>
</dl>
<note><title>주의</title>
<code>configure</code>는 <var>foo</var>가 없는 경우
<code>--enable-<var>foo</var></code>를 사용해도 이 사실을
알려주지 않으므로 주의해서 입력해야 한다.
</note>
</section>
<!-- to do: add better enable-module descriptions and recommendations -->
<section id="enabledmodules"><title>기본적으로 포함하는 모듈</title>
<p>어떤 모듈은 기본적으로 컴파일되기때문에 사용하지 않는다면
명시적으로 빼줘야 한다. 다음 옵션은 특정 모듈을 컴파일
과정에서 제외한다.</p>
<dl>
<dt><code>--disable-actions</code></dt>
<dd><module>mod_actions</module>가 제공하는 요청에 대한
행동 기능을 사용하지 않는다.</dd>
<dt><code>--disable-alias</code></dt>
<dd><module>mod_alias</module>가 제공하는 요청을
파일시스템의 다른 부분으로 대응하는 기능을 사용하지
않는다.</dd>
<dt><code>--disable-asis</code></dt>
<dd><module>mod_asis</module>가 제공하는 as-is 파일형을
지원하지 않는다.</dd>
<dt><code>--disable-auth</code></dt>
<dd><module>mod_auth</module>가 제공하는 사용자별 접근제어
기능을 사용하지 않는다. 이 모듈은 사용자명과 암호를
일반 문자파일에 저장하는 HTTP Basic Authentication에서
사용한다.</dd>
<dt><code>--disable-autoindex</code></dt>
<dd><module>mod_autoindex</module>가 제공하는 디렉토리
목록 기능을 사용하지 않는다.</dd>
<dt><code>--disable-access</code></dt>
<dd><module>mod_access</module>가 제공하는 호스트별
접근제어 기능을 사용하지 않는다.</dd>
<dt><code>--disable-cgi</code></dt>
<dd>비쓰레드 MPM을 사용하는 경우 CGI 스크립트를 지원하는
<module>mod_cgi</module>를 기본적으로 포함한다. 이
옵션을 사용하면 CGI를 지원하지 않는다.</dd>
<dt><code>--disable-cgid</code></dt>
<dd>쓰레드 MPM인 <module>worker</module>나
<module>perchild</module>를 사용하는 경우 기본적으로
<module>mod_cgid</module>가 CGI 스크립트를 지원한다.
이 옵션을 사용하면 CGI를 지원하지 않는다.</dd>
<dt><code>--disable-charset-lite</code></dt>
<dd><module>mod_charset_lite</module>가 제공하는 문자집합
변환 기능을 사용하지 않는다. 이 모듈은 EBCDIC 시스템에서만
기본적으로 포함한다.</dd>
<dt><code>--disable-dir</code></dt>
<dd><module>mod_dir</module>이 제공하는 디렉토리 요청
처리 기능을 사용하지 않는다.</dd>
<dt><code>--disable-env</code></dt>
<dd><module>mod_env</module>가 제공하는 환경변수 설정/해제
기능을 사용하지 않는다.</dd>
<!-- configure mentions enable-http, but disable-http would make much
more sense -->
<dt><code>--disable-http</code></dt>
<dd>HTTP 프로토콜을 처리하지 않는다. <code>http</code>
모듈은 서버가 웹서버로 동작하는데 기본적인 모듈이다.
대신 다른 프로토콜 모듈을 사용할 경우에만 이 모듈이
유용하다. <strong>자신이 무엇을 하는지 확실히 알지
못한다면 이 옵션을 빼지 마라</strong>
<br/>
주의: 이 모듈은 항상 정적으로 링크된다.</dd>
<dt><code>--disable-imagemap</code></dt>
<dd><module>mod_imagemap</module>이 제공하는 서버기반 imagemap
기능을 사용하지 않는다.</dd>
<dt><code>--disable-include</code></dt>
<dd><module>mod_include</module>가 제공하는 Server Side
Includes 기능을 사용하지 않는다.</dd>
<dt><code>--disable-log-config</code></dt>
<dd><module>mod_log_config</module>가 제공하는 로그
설정을 사용하지 않는다. 이 모듈이 없으면 서버의 요청을
로그에 기록할 수 없다.</dd>
<dt><code>--disable-mime</code></dt>
<dd><module>mod_mime</module>은 요청한 파일명의 확장자에
따라 파일의 행동과 내용(mime-type, 언어, 문자집합,
인코딩)을 결정한다. (이 모듈을 제거하여) 파일 확장자를
MIME과 연관하지 않는 것을 일반적으로 추천하지 않는다.</dd>
<dt><code>--disable-negotiation</code></dt>
<dd><module>mod_negotiation</module>이 제공하는 내용협상
기능을 사용하지 않는다.</dd>
<dt><code>--disable-setenvif</code></dt>
<dd><module>mod_setenvif</module>가 제공하는 헤더에
따라 환경변수를 설정하는 기능을 사용하지 않는다.</dd>
<dt><code>--disable-status</code></dt>
<dd><module>mod_status</module>가 제공하는 프로세스/쓰레드
감시 기능을 사용하지 않는다.</dd>
<dt><code>--disable-userdir</code></dt>
<dd><module>mod_userdir</module>이 제공하는 요청을 사용자별
디렉토리에 대응하는 기능을 사용하지 않는다.</dd>
</dl>
</section>
<section id="disabledmodules"><title>기본적으로 포함하지 않는 모듈</title>
<p>기본적으로 컴파일되는 모듈도 있지만, 모듈을 사용하려면
직접 혹은 <code>most</code>나 <code>all</code> 키워드를
사용하여 명시적으로 포함해야 하는 모듈이 있다. 그래서
아래 옵션들을 사용한다.</p>
<dl>
<dt><code>--enable-auth-anon</code></dt>
<dd><module>mod_auth_anon</module>이 제공하는 익명사용자
접근 기능을 사용한다.</dd>
<dt><code>--enable-auth-dbm</code></dt>
<dd><module>mod_auth_dbm</module>은 사용자명과 암호를
DBM형식의 데이터베이스 파일에 저장하는 HTTP Basic
Authentication에서 사용한다. 모듈을 사용하려면 이
옵션을 사용한다.</dd>
<dt><code>--enable-auth-digest</code></dt>
<dd><module>mod_auth_digest</module>가 제공하는 RFC2617
Digest authentication을 사용한다. 이 모듈은 정보를
일반 문자파일에 저장한다.</dd>
<dt><code>--enable-authnz-ldap</code></dt>
<dd><module>mod_authnz_ldap</module>이 제공하는 LDAP기반
인증 기능을 사용한다.</dd>
<dt><code>--enable-cache</code></dt>
<dd><module>mod_cache</module>가 제공하는 동적으로 생성하는
파일의 캐싱 기능을 사용한다. 매우 부하가 많거나 프록시
서버를 캐싱하는 서버에게 이 실험적인 모듈이 유용할
수 있다. 최소한 한가지 저장관리모듈(storage management
module)을 (예를 들어, <module>mod_disk_cache</module>나
<module>mod_mem_cache</module>) 같이 사용해야 한다.</dd>
<dt><code>--enable-cern-meta</code></dt>
<dd><module>mod_cern_meta</module>가 제공하는 CERN 메타파일
지원 기능을 사용한다.</dd>
<dt><code>--enable-charset-lite</code></dt>
<dd><module>mod_charset_lite</module>가 제공하는 문자집합
변환 기능을 사용한다. 이 모듈은 EBCDIC 시스템에서만
기본적으로 포함된다. 다른 시스템에서는 직접 포함시켜줘야
한다.</dd>
<dt><code>--enable-dav</code></dt>
<dd><module>mod_dav</module>가 제공하는 WebDAV 프로토콜
처리 기능을 사용한다. 독립된 <module>mod_dav_fs</module>
모듈이 파일시스템 자원을 지원한다. 이 모듈은
<code>--enable-dav</code>를 사용하면 자동으로 포함한다.<br/>
주의: <module>mod_dav</module>는 <code>http</code>
프로토콜 모듈과 같이 사용해야 한다.</dd>
<dt><code>--enable-dav-fs</code></dt>
<dd><module>mod_dav_fs</module>가 제공하는 DAV의 파일시스템
자원 지원 기능을 사용한다. 이 모듈은
<module>mod_dav</module> 모듈을 위한 제공자이기 때문에
<code>--enable-dav</code>도 사용해야 한다.</dd>
<dt><code>--enable-deflate</code></dt>
<dd><module>mod_deflate</module>가 제공하는 압축전송
인코딩 기능을 사용한다.</dd>
<dt><code>--enable-disk-cache</code></dt>
<dd><module>mod_disk_cache</module>가 제공하는 디스크
캐싱 기능을 사용한다.</dd>
<dt><code>--enable-expires</code></dt>
<dd><module>mod_expires</module>가 제공하는 Expires
헤더 조절 기능을 사용한다.</dd>
<dt><code>--enable-ext-filter</code></dt>
<dd><module>mod_ext_filter</module>가 제공하는 외부
필터 지원 기능을 사용한다.</dd>
<dt><code>--enable-file-cache</code></dt>
<dd><module>mod_file_cache</module>가 제공하는 파일
캐싱 기능을 사용한다.</dd>
<dt><code>--enable-headers</code></dt>
<dd><module>mod_headers</module>가 제공하는 HTTP 헤더
조절 기능을 사용한다.</dd>
<dt><code>--enable-info</code></dt>
<dd><module>mod_info</module>가 제공하는 서버정보 기능을
사용한다.</dd>
<dt><code>--enable-ldap</code></dt>
<dd><module>mod_ldap</module>이 제공하는 LDAP 캐싱과
연결풀 기능을 사용한다.</dd>
<dt><code>--enable-logio</code></dt>
<dd><module>mod_logio</module>가 제공하는 로그에 헤더와
입출력 바이트수를 기록하는 기능을 사용한다.</dd>
<dt><code>--enable-mem-cache</code></dt>
<dd><module>mod_mem_cache</module>가 제공하는 메모리
캐싱 기능을 사용한다.</dd>
<dt><code>--enable-mime-magic</code></dt>
<dd><module>mod_mime_magic</module>이 제공하는 MIME
type 자동 인식 기능을 사용한다.</dd>
<dt><code>--enable-isapi</code></dt>
<dd><module>mod_isapi</module>가 제공하는 isapi 확장을
지원한다.</dd>
<dt><code>--enable-proxy</code></dt>
<dd><module>mod_proxy</module>가 제공하는 프록시/게이트웨이
기능을 사용한다. <code>CONNECT</code>, <code>FTP</code>,
<code>HTTP</code>에 대한 프록시 기능을 각각
<module>mod_proxy_connect</module>,
<module>mod_proxy_ftp</module>,
<module>mod_proxy_http</module>
모듈이 제공한다. <code>--enable-proxy</code>를 사용하면
이 세 모듈을 자동으로 포함한다.</dd>
<dt><code>--enable-proxy-connect</code></dt>
<dd><module>mod_proxy_connect</module>가 제공하는
<code>CONNECT</code> 요청에 대한 프록시 지원 기능을
사용한다. 이 모듈은 <module>mod_proxy</module> 모듈의
확장이므로, <code>--enable-proxy</code>도 같이 사용해야
한다.</dd>
<dt><code>--enable-proxy-ftp</code></dt>
<dd><module>mod_proxy_ftp</module>가 제공하는
<code>FTP</code> 요청에 대한 프록시 지원 기능을 사용한다.
이 모듈은 <module>mod_proxy</module> 모듈의 확장이므로,
<code>--enable-proxy</code>도 같이 사용해야 한다.</dd>
<dt><code>--enable-proxy-http</code></dt>
<dd><module>mod_proxy_http</module>가 제공하는
<code>HTTP</code> 요청에 대한 프록시 지원 기능을 사용한다.
이 모듈은 <module>mod_proxy</module> 모듈의 확장이므로,
<code>--enable-proxy</code>도 같이 사용해야 한다.</dd>
<dt><code>--enable-rewrite</code></dt>
<dd><module>mod_rewrite</module>가 제공하는 규칙기반
URL 조작 기능을 사용한다.</dd>
<dt><code>--enable-so</code></dt>
<dd><module>mod_so</module>가 제공하는 DSO 기능을 사용한다.
<code>--enable-mods-shared</code> 옵션을 사용하면
자동으로 이 모듈을 포함한다.</dd>
<dt><code>--enable-speling</code></dt>
<dd><module>mod_spelling</module>이 제공하는 URL에서
일반적인 맞춤법 실수를 고치는 기능을 사용한다.</dd>
<dt><code>--enable-ssl</code></dt>
<dd><module>mod_ssl</module>이 제공하는 SSL/TLS 기능을
사용한다.</dd>
<dt><code>--enable-unique-id</code></dt>
<dd><module>mod_unique_id</module>가 제공하는 요청마다
유일한 식별자를 만드는 기능을 사용한다.</dd>
<dt><code>--enable-usertrack</code></dt>
<dd><module>mod_usertrack</module>이 제공하는 사용자세션
추적 기능을 사용한다.</dd>
<dt><code>--enable-vhost-alias</code></dt>
<dd><module>mod_vhost_alias</module>가 제공하는 대량
가상호스트 기능을 사용한다.</dd>
</dl>
</section>
<section id="developermodules"><title>개발자를 위한 모듈</title>
<p>다음 모듈은 테스트용으로 개발자에게만 유용하며, 기본적으로
포함하지 않는다. 이 모듈을 사용하려면 다음 옵션을 사용한다.
이 모듈이 필요한지 확실치않다면 사용하지 마라.</p>
<dl>
<!-- module doc needed -->
<dt><code>--enable-bucketeer</code></dt>
<dd><code>mod_bucketeer</code>가 제공하는 버킷(bucket)
조작 필터를 사용한다.</dd>
<!-- module doc needed -->
<dt><code>--enable-case-filter</code></dt>
<dd><code>mod_case_filter</code>의 대문자변환 출력필터
견본을 사용한다.</dd>
<!-- module doc needed -->
<dt><code>--enable-case-filter-in</code></dt>
<dd><code>mod_case_filter_in</code>의 대문자변환 입력필터
견본을 사용한다.</dd>
<dt><code>--enable-echo</code></dt>
<dd><module>mod_echo</module>가 제공하는 ECHO 서버를
사용한다.</dd>
<dt><code>--enable-example</code></dt>
<dd>견본 예제모듈인 <module>mod_example</module>을
사용한다.</dd>
<!-- module doc needed -->
<dt><code>--enable-optional-fn-export</code></dt>
<dd><code>mod_optional_fn_export</code>가 제공하는 선택적인
함수 엑스포트(exporter)의 예를 사용한다.</dd>
<!-- module doc needed -->
<dt><code>--enable-optional-fn-import</code></dt>
<dd><code>mod_optional_fn_import</code>가 제공하는 선택적인
함수 임포트(importer)의 예를 사용한다.</dd>
<!-- module doc needed -->
<dt><code>--enable-optional-hook-export</code></dt>
<dd><code>mod_optional_hook_export</code>가 제공하는
선택적인 훅(hook) 엑스포트의 예를 사용한다.</dd>
<!-- module doc needed -->
<dt><code>--enable-optional-hook-import</code></dt>
<dd><code>mod_optional_hook_import</code>가 제공하는
선택적인 훅 임포트의 예를 사용한다.</dd>
</dl>
</section>
<section id="modules"><title>MPM과 제삼자가 만든 모듈</title>
<p>다음 옵션을 사용하여 필요한 다중처리모듈과 제삼자가
만든 모듈을 추가한다:</p>
<dl>
<dt><code>--with-module=<var>module-type</var>:<var>module-file</var>
</code></dt>
<dd><p>제삼자가 만든 모듈을 정적으로 링크할 모듈 목록에
추가한다. 아파치 웹서버 소스 트리의
<code>modules/<var>module-type</var></code>에서 모듈의
소스파일 <code><var>module-file</var></code>을 찾기때문에
그곳에 소스파일이 있어야 한다. 그곳에 파일이 없다면
<code>configure</code>는 <var>module-file</var>이
절대파일경로라고 가정하고 소스파일을
<var>module-type</var> 하위디렉토리에 복사하려고
시도한다.</p>
<p>이 옵션은 소스파일이 한개인 작은 외부 모듈을 추가하는데
유용하다. 더 복잡한 모듈은 개발사가 제공한 문서를
참고해야 한다.</p>
<note><title>주의</title>
정적으로 링크된 모듈이 아닌 DSO 모듈을 원한다면
<a href="apxs.html">apxs</a>를 사용하라.</note>
</dd>
<dt><code>--with-mpm=MPM</code></dt>
<dd>서버의 동작방식을 선택한다. 정확히 한가지 <a
href="../mpm.html">다중처리모듈</a>만을 선택해야 한다.
선택하지 않으면 사용하는 운영체제의 <a
href="../mpm.html#defaults">기본 MPM</a>을 사용한다.
사용할 수 있는 MPM에는 <module>beos</module>,
<module>leader</module>, <module>mpmt_os2</module>,
<module>perchild</module>, <module>prefork</module>,
<module>threadpool</module>, <module>worker</module>가
있다.</dd>
</dl>
</section>
<section id="otheroptfeat"><title>기타 옵션</title>
<dl>
<dt><code>--enable-maintainer-mode</code></dt>
<dd>디버깅 모드와 컴파일시 경고를 작동한다.</dd>
<dt><code>--enable-mods-shared=<var>MODULE-LIST</var></code></dt>
<dd>
<p>동적공유모듈로 컴파일할 모듈 목록을 지정한다. 즉,
이 모듈들은 <directive
module="mod_so">LoadModule</directive> 지시어를
사용하여 동적으로 읽어들여야 한다.</p>
<p><var>MODULE-LIST</var>는 공백으로 구분한 모듈명들을
따옴표로 묶은 목록이다. 모듈명에서 앞에
<code>mod_</code>는 뺀다. 예를 들어:</p>
<example>
--enable-mods-shared='headers rewrite dav'
</example>
<p>또, 특별한 키워드 <code>all</code>과 <code>most</code>를
사용할 수 있다. 예를 들어,</p>
<example>
--enable-mods-shared=most
</example>
<p>는 대부분의 모듈을 DSO 모듈로 컴파일한다.
<!-- See <a href="../install/enabledmodules.html">Overview of
enabled modules</a> for further information. --></p>
</dd>
<dt><code>--enable-modules=<var>MODULE-LIST</var></code></dt>
<dd><code>--enable-mods-shared</code>와 비슷하지만,
이 옵션은 열거한 모듈들을 정적으로 링크한다. 즉, 이
모듈들은 <code>httpd</code> 실행하면 언제나 사용할
수 있다. <directive
module="mod_so">LoadModule</directive>로 읽어들일
필요가 없다.</dd>
<dt><code>--enable-v4-mapped</code></dt>
<dd>IPv6 소켓이 IPv4 연결을 처리할 수 있도록 한다.</dd>
<dt><code>--with-port=<var>PORT</var></code></dt>
<dd><code>httpd</code>가 기다릴 포트를 지정한다. 이
포트번호는 설정파일 <code>httpd.conf</code>를 만들때
쓰인다. 기본값은 80이다.</dd>
<dt><code>--with-program-name</code></dt>
<dd>다른 실행파일명을 지정한다. 기본값은
<code>httpd</code>이다.</dd>
</dl>
</section>
</section>
<section id="packages"><title>추가 패키지 선택</title>
<p>다음 옵션은 추가 패키지를 선택한다.</p>
<section id="generalpackages"><title>일반적인 문법</title>
<p>일반적으로 다음과 같은 문법을 사용하여 추가 패키지를
다룬다:</p>
<dl>
<dt><code>--with-<var>PACKAGE</var>[=<var>ARG</var>]</code></dt>
<dd>패키지 <var>PACKAGE</var>를 사용한다.
<var>ARG</var>의 기본값은 <code>yes</code>이다.</dd>
<dt><code>--without-<var>PACKAGE</var></code></dt>
<dd>패키지 <var>PACKAGE</var>를 사용하지 않는다.
<code>--with-<var>PACKAGE</var>=no</code>와 같다.
<code>autoconf</code>에 이 옵션이 있지만 아파치 웹서버와는
관계가 없다.</dd>
</dl>
</section>
<!-- options not known are passed to packasges?
are there other important options for packages? -->
<section id="packageopt"><title>특정 패키지</title>
<dl>
<dt><code>--with-apr=<var>DIR</var>|<var>FILE</var></code></dt>
<dd><code>httpd</code> 소스 배포본에 포함된 Apache Portable
Runtime (APR)은 자동으로 웹서버와 같이 컴파일된다.
만약 이미 설치된 APR을 대신 사용하고 싶다면
<code>configure</code>에게 <code>apr-config</code>
스크립트의 경로를 알려주어야 한다. APR가 설치된 절대경로,
파일명, 디렉토리명을 사용할 수 있다. 지정한 디렉토리나
그 디렉토리의 하위디렉토리 <code>bin</code>에
<code>apr-config</code>가 있어야 한다.</dd>
<dt><code>--with-apr-util=<var>DIR</var>|<var>FILE</var></code></dt>
<dd><code>httpd</code> 소스 배포본에 포함된 Apache Portable
Runtime Utilities (APU)는 자동으로 웹서버와 같이
컴파일된다. 만약 이미 설치된 APU을 대신 사용하고 싶다면
<code>configure</code>에게 <code>apu-config</code>
스크립트의 경로를 알려주어야 한다. APU가 설치된 절대경로,
파일명, 디렉토리명을 사용할 수 있다. 지정한 디렉토리나
그 디렉토리의 하위디렉토리 <code>bin</code>에
<code>apu-config</code>가 있어야 한다.</dd>
<dt><code>--with-ssl=<var>DIR</var></code></dt>
<dd><module>mod_ssl</module>을 사용하는 경우
<code>configure</code>는 설치된 OpenSSL을 찾는다.
대신 이 옵션을 사용하여 SSL/TLS 도구의 디렉토리경로를
알려줄 수 있다.</dd>
<dt><code>--with-z=<var>DIR</var></code></dt>
<dd>(<module>mod_deflate</module>를 사용하는 경우와
같이) 구성에 필요하다면 자동으로 <code>configure</code>는
설치된 <code>zlib</code> 라이브러리를 찾는다. 대신
이 옵션을 사용하여 압축 라이브러리의 디렉토리경로를
알려줄 수 있다.</dd>
</dl>
<p><module>mod_authn_dbm</module>과
<module>mod_rewrite</module>의 DBM <directive
module="mod_rewrite">RewriteMap</directive> 같은 아파치
웹서버의 일부 기능은 정보를 빨리 찾기위해 간단한 키/값
데이터베이스를 사용한다. APU에 SDBM이 들어있어서 언제나
최소한 이 데이터베이스는 사용할 수 있다. 다른 종류의
데이터베이스를 사용하고 싶다면 아래 옵션을 사용한다:</p>
<dl>
<dt><code>--with-gdbm[=<var>path</var>]</code></dt>
<dd><var>path</var>를 지정하지 않으면,
<code>configure</code>는 일반적인 검색경로에서 설치된
GNU DBM 헤더파일과 라이브러리를 찾는다. 직접
<var>path</var>를 지정하면 <code>configure</code>는
<code><var>path</var>/lib</code>과
<code><var>path</var>/include</code>에서 필요한 파일을
찾는다. 마지막으로 <var>path</var>에 헤더파일 경로와
라이브러리 경로를 콜론을 사이에 두고 같이 적을 수
있다.</dd>
<dt><code>--with-ndbm[=<var>path</var>]</code></dt>
<dd><code>--with-gdbm</code>과 같지만 설치된 New DBM을
찾는다.</dd>
<dt><code>--with-berkeley-db[=<var>path</var>]</code></dt>
<dd><code>--with-gdbm</code>과 같지만 설치된 Berkeley
DB를 찾는다.</dd>
</dl>
<note><title>주의</title>
<p>DBM 옵션은 APU가 제공하며 APU 구성스크립트로 직접
전달된다. 그래서 <code>--with-apr-util</code>을 사용하여
이미 설치된 APU를 사용한다면 DBM 옵션은 소용이 없다.</p>
<p>웹서버는 여러 DBM 구현을 같이 사용할 수 있다. 실행시
적절한 DBM 종류를 설정할 수 있다.</p>
</note>
</section>
</section>
<section id="supportopt"><title>지원 프로그램을 위한 옵션</title>
<dl>
<dt><code>--enable-static-support</code></dt>
<dd>지원 프로그램을 정적으로 링크된 실행파일로 만든다.
즉, 필요한 라이브러리를 모두 포함하도록 실행파일을
컴파일한다. 이 옵션을 사용하지 않으면 기본값으로 지원
프로그램을 동적으로 링크한다.</dd>
<dt><code>--enable-suexec</code></dt>
<dd>웹서버가 실행하는 프로세스의 uid와 gid를 설정하는
<code><a href="suexec.html">suexec</a></code>를 사용하려면
이 옵션을 사용한다. <strong>suid 실행파일의 보안상 위험을
모두 알지 못한다면 이 옵션을 사용하지 마라.</strong>
<code>suexec</code>를 구성하는 옵션은
<a href="#suexec">아래에서</a> 설명한다.</dd>
</dl>
<p>다음 옵션을 사용하여 지원 프로그램별로 정적으로 링크된
실행파일을 만들 수 있다:</p>
<dl>
<dt><code>--enable-static-ab</code></dt>
<dd><code><a href="ab.html">ab</a></code>를 정적으로 링크된
실행파일로 컴파일한다.</dd>
<!-- missing documentation for chechgid -->
<dt><code>--enable-static-checkgid</code></dt>
<dd><code>checkgid</code>를 정적으로 링크된 실행파일로
컴파일한다.</dd>
<!-- missing documentation for htdbm -->
<dt><code>--enable-static-htdbm</code></dt>
<dd><code>htdbm</code>을 정적으로 링크된 실행파일로
컴파일한다.</dd>
<dt><code>--enable-static-htdigest</code></dt>
<dd><code><a href="htdigest.html">htdigest</a></code>를
정적으로 링크된 실행파일로 컴파일한다.</dd>
<dt><code>--enable-static-htpasswd</code></dt>
<dd><code><a href="htpasswd.html">htpasswd</a></code>를
정적으로 링크된 실행파일로 컴파일한다.</dd>
<dt><code>--enable-static-logresolve</code></dt>
<dd><code><a href="logresolve.html">logresolve</a></code>를
정적으로 링크된 실행파일로 컴파일한다.</dd>
<dt><code>--enable-static-rotatelogs</code></dt>
<dd><code><a href="rotatelogs.html">rotatelogs</a></code>를
정적으로 링크된 실행파일로 컴파일한다.</dd>
</dl>
<section id="suexec"><title>suexec 설정 옵션</title>
<p>아래 옵션은 <code><a
href="../suexec.html">suexec</a></code>를 자세히 설정한다.
더 자세한 정보는 <a href="../suexec.html#install">suEXEC
구성과 설치</a>를 참고하라.</p>
<dl>
<dt><code>--with-suexec-bin</code></dt>
<dd>suexec 실행파일의 경로를 지정한다. 기본값은
<code>--sbindir</code>이다 (<a
href="#directoryfinetuning">설치 디렉토리의 자세한
조정</a> 참고).</dd>
<dt><code>--with-suexec-caller</code></dt>
<dd><code>suexec</code>를 실행할 사용자를 지정한다.
이 사용자는 보통 <code>httpd</code>를 실행하는 사용자와
같아야 한다.</dd>
<dt><code>--with-suexec-docroot</code></dt>
<dd><code>suexec</code>는 이 옵션으로 지정한 디렉토리
아래에 있는 실행파일만을 실행할 수 있다. 기본값은
<code>--datadir/htdocs</code>다.</dd>
<dt><code>--with-suexec-gidmin</code></dt>
<dd><code>suexec</code>에서 지정가능한 최소 GID를 설정한다.
기본값은 100이다.</dd>
<dt><code>--with-suexec-logfile</code></dt>
<dd><code>suexec</code> 로그파일명을 지정한다. 로그파일명의
기본값은 <code>suexec_log</code>이고,
<code>--logfiledir</code>에 위치한다.</dd>
<dt><code>--with-suexec-safepath</code></dt>
<dd><code>suexec</code>가 시작하는 프로세스의
<code>PATH</code> 환경변수값을 지정한다. 기본값은
<code>/usr/local/bin:/usr/bin:/bin</code>이다.</dd>
<dt><code>--with-suexec-userdir</code></dt>
<dd>사용자 디렉토리에서 <code>suexec</code>가 접근할
수 있는 (실행파일이 있는) 하위디렉토리를 지정한다.
이 설정은 <code>suexec</code>와
(<module>mod_userdir</module>이 제공하는) 사용자별
디렉토리를 같이 사용할때 필요하다. 기본값은
<code>public_html</code>이다.</dd>
<dt><code>--with-suexec-uidmin</code></dt>
<dd><code>suexec</code>에서 지정가능한 최소 UID를 설정한다.
기본값은 100이다.</dd>
<dt><code>--with-suexec-umask</code></dt>
<dd><code>suexec</code>가 실행하는 프로세스의
<code>umask</code>를 지정한다. 기본값은 사용하는 시스템의
기본 설정과 같다.</dd>
</dl>
</section>
</section>
</section>
<section id="env"><title>환경변수</title>
<p><code>configure</code>의 선택을 무시하거나 관례와 다른
이름이나 위치에 있는 라이브러리와 프로그램을 찾도록 도와주는
유용한 환경변수들이 있다.</p>
<!-- are these all useful variables? -->
<dl>
<dt><code>CC</code></dt>
<dd>컴파일에 사용할 C 컴파일러 명령어를 지정한다.</dd>
<dt><code>CFLAGS</code></dt>
<dd>컴파일때 사용하길 바라는 C 컴파일러 옵션을 지정한다.</dd>
<dt><code>CPP</code></dt>
<dd>사용할 C 선처리기 명령어를 지정한다.</dd>
<dt><code>CPPFLAGS</code></dt>
<dd>C/C++ 선처리기 옵션. 예를 들어, 헤더파일이 관례와 달리
<var>includedir</var> 디렉토리에 있다면
<code>-I<var>includedir</var></code>을 사용한다.</dd>
<dt><code>LDFLAGS</code></dt>
<dd>링커 옵션. 예를 들어, 라이브러리가 관례와 달리
<var>libdir</var> 디렉토리에 있다면
<code>-L<var>libdir</var></code>을 사용한다.</dd>
</dl>
</section>
</manualpage>
|
