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
|
<?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 -->
<!--
Copyright 2004 The Apache Software Foundation
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="apxs.xml.meta">
<parentdocument href="./">Programs</parentdocument>
<title>apxs - APache eXtenSion 도구</title>
<summary>
<p><code>apxs</code>는 아파치 하이퍼텍스트 전송 프로토콜
(HTTP) 서버의 확장모듈을 컴파일하고 설치하는 도구이다. 이
도구는 여러 소스와 오브젝트<var>파일</var>을 가지고,
<module>mod_so</module>의 <directive
module="mod_so">LoadModule</directive> 지시어로 실행중에
아파치 서버로 읽어들일 수 있는 동적공유객체(DSO)를 만든다.</p>
<p>그래서 이런 확장방식을 사용하려면 플래폼이 DSO 기능을
지원하고 아파치 <code>httpd</code> 실행파일을
<module>mod_so</module> 모듈과 같이 컴파일해야 한다.
<code>apxs</code> 도구는 이 조건이 만족하지않으면 실행하지
않는다. 직접 명령어를 실행하여 조건이 만족하는지 알아볼
수 있다</p>
<example>
$ httpd -l
</example>
<p>목록에 <module>mod_so</module> 모듈이 나와야 한다. 조건을
만족하면 <code>apxs</code> 도구로 DSO 모듈을 설치하여
아파치서버의 기능을 쉽게 확장할 수 있다:</p>
<example>
$ apxs -i -a -c mod_foo.c<br />
gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo.c<br />
ld -Bshareable -o mod_foo.so mod_foo.o<br />
cp mod_foo.so /path/to/apache/modules/mod_foo.so<br />
chmod 755 /path/to/apache/modules/mod_foo.so<br />
[activating module `foo' in /path/to/apache/etc/httpd.conf]<br />
$ apachectl restart<br />
/path/to/apache/sbin/apachectl restart: httpd not running, trying to start<br />
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module<br />
/path/to/apache/sbin/apachectl restart: httpd started<br />
$ _
</example>
<p>아규먼트 <var>files</var>에는 C 소스파일 (.c) 이나
오브젝트파일 (.o), 라이브러리모음 (.a)을 사용할 수 있다.
<code>apxs</code> 도구는 확장자를 보고 자동으로 C 소스파일은
컴파일하고, 오브젝트와 모음파일은 링크에만 사용한다. 그러나
컴파일한 오브젝트를 사용하려면 동적으로 읽어들일 수 있는
공유객체로 사용하기위해 반드시 오브젝트를 위치독립코드(PIC,
position independent code)로 컴파일해야 한다. GCC의 경우
<code>-fpic</code>을 사용하면 된다. 다른 C 컴파일러는 설명서를
참고하거나 <code>apxs</code>가 오브젝트파일을 컴파일할때
사용하는 옵션을 참고하라.</p>
<p>아파치의 DSO 지원에 대한 더 자세한 내용은
<module>mod_so</module> 문서를 참고하거나
<code>src/modules/standard/mod_so.c</code> 소스파일을 읽어봐라.</p>
</summary>
<seealso><a href="apachectl.html">apachectl</a></seealso>
<seealso><a href="httpd.html">httpd</a></seealso>
<section id="synopsis"><title>개요</title>
<p><code><strong>apxs</strong> -<strong>g</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
-<strong>n</strong> <var>modname</var></code></p>
<p><code><strong>apxs</strong> -<strong>q</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
<var>query</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>c</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
[ -<strong>o</strong> <var>dsofile</var> ]
[ -<strong>I</strong> <var>incdir</var> ]
[ -<strong>D</strong> <var>name</var>=<var>value</var> ]
[ -<strong>L</strong> <var>libdir</var> ]
[ -<strong>l</strong> <var>libname</var> ]
[ -<strong>Wc,</strong><var>compiler-flags</var> ]
[ -<strong>Wl,</strong><var>linker-flags</var> ]
<var>files</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>i</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
[ -<strong>n</strong> <var>modname</var> ]
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]
<var>dso-file</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>e</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
[ -<strong>n</strong> <var>modname</var> ]
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]
<var>dso-file</var> ...</code></p>
</section>
<section id="options"><title>옵션</title>
<section id="options.common"><title>공통 옵션</title>
<dl>
<dt><code>-n <var>modname</var></code></dt>
<dd><code>-i</code> (install)과 <code>-g</code> (template
generation) 옵션을 사용할때 직접 모듈명을 지정한다. 이
옵션을 사용하여 모듈명을 직접 지정한다. <code>-g</code>
옵션을 사용한다면 이 옵션을 반드시 사용해야하고,
<code>-i</code> 옵션을 사용한다면 <code>apxs</code> 도구는
소스나 (마지막 시도로) 파일명을 가지고 이름을 추측한다.</dd>
</dl>
</section>
<section id="options.query"><title>질의 옵션</title>
<dl>
<dt><code>-q</code></dt>
<dd><code>apxs</code>의 설정값을 알아낸다. <var>query</var>에는
다음을 사용할 수 있다: <code>CC</code>, <code>CFLAGS</code>,
<code>CFLAGS_SHLIB</code>, <code>INCLUDEDIR</code>,
<code>LD_SHLIB</code>, <code>LDFLAGS_SHLIB</code>,
<code>LIBEXECDIR</code>, <code>LIBS_SHLIB</code>,
<code>SBINDIR</code>, <code>SYSCONFDIR</code>, <code>TARGET</code>.
<p>설정을 직접 알아낼때 사용한다.</p>
<example>
INC=-I`apxs -q INCLUDEDIR`
</example>
<p>예를 들어, 아파치 C 헤더파일을 직접 접근한다면
Makefile에서 위와 같이 사용한다.</p></dd>
</dl>
</section>
<section id="options.conf"><title>설정 옵션</title>
<dl>
<dt><code>-S <var>name</var>=<var>value</var></code></dt>
<dd>이 옵션은 위에서 설명한 apxs 설정을 변경한다.</dd>
</dl>
</section>
<section id="options.template"><title>견본(template) 생성 옵션</title>
<dl>
<dt><code>-g</code></dt>
<dd>하위디렉토리 <var>name</var>을 만들고 (<code>-n</code>
옵션 참고) 그곳에 파일 두개를 만든다: 한 파일은
<code>mod_<var>name</var>.c</code>라는 견본 모듈소스파일로,
자신의 모듈을 만들때 견본으로 사용하거나 apxs 기능을
시험해볼때 사용한다. 다른 파일은 이 모듈을 쉽게 컴파일하고
설치하기위한 <code>Makefile</code>이다.</dd>
</dl>
</section>
<section id="options.dso"><title>DSO 컴파일 옵션</title>
<dl>
<dt><code>-c</code></dt>
<dd>컴파일을 지시한다. 먼저 <var>files</var>에서 C
소스파일들(.c)을 오브젝트파일(.o)로 컴파일하고,
<var>files</var>의 나머지 오브젝트파일들(.o과 .a)과
링크하여 동적공유객체 <var>dsofile</var>을 만든다.
<code>-o</code> 옵션을 사용하지않으면 <var>files</var>의
첫번째 파일명에서 이름을 추측하여 보통
<code>mod_<var>name</var>.so</code>를 사용한다.</dd>
<dt><code>-o <var>dsofile</var></code></dt>
<dd>생성할 동적공유객체 파일명을 직접 지정한다. 이름을
지정하지않고 <var>files</var> 목록에서 이름을 추측하지
못하면 마지막으로 <code>mod_unknown.so</code>를 이름으로
사용한다.</dd>
<dt><code>-D <var>name</var>=<var>value</var></code></dt>
<dd>이 옵션을 컴파일 명령어로 직접 전달한다.
컴파일때 자신의 define을 추가한다.</dd>
<dt><code>-I <var>incdir</var></code></dt>
<dd>이 옵션을 컴파일 명령어로 직접 전달한다.
컴파일때 include를 찾을 디렉토리를 추가한다.</dd>
<dt><code>-L <var>libdir</var></code></dt>
<dd>이 옵션을 링커 명령어로 직접 전달한다.
컴파일때 라이브러리를 찾을 디렉토리를 추가한다.</dd>
<dt><code>-l <var>libname</var></code></dt>
<dd>이 옵션을 링커 명령어로 직접 전달한다.
컴파일때 사용할 라이브러리를 추가한다.</dd>
<dt><code>-Wc,<var>compiler-flags</var></code></dt>
<dd>이 옵션은 추가 옵션 <var>compiler-flags</var>를
<code>libtool --mode=compile</code> 명령어로 전달한다.
컴파일러 특유의 옵션을 추가할때 사용한다.</dd>
<dt><code>-Wl,<var>linker-flags</var></code></dt>
<dd>이 옵션은 추가 옵션 <var>linker-flags</var>를
<code>libtool --mode=link</code> 명령어로 전달한다. 링커
특유의 옵션을 추가할때 사용한다.</dd>
</dl>
</section>
<section id="options.dsoinstall">
<title>DSO 설치과 설정 옵션</title>
<dl>
<dt><code>-i</code></dt>
<dd>설치를 지시한다. 여러 동적공유객체를 서버의
<var>modules</var> 디렉토리에 설치한다.</dd>
<dt><code>-a</code></dt>
<dd>아파치 <code>httpd.conf</code> 설정파일에 적절한
<directive module="mod_so">LoadModule</directive> 줄을
추가하거나 이미 있다면 활성화하여 모듈을 사용하도록
만든다.</dd>
<dt><code>-A</code></dt>
<dd><code>-a</code>와 비슷하지만, <directive
module="mod_so">LoadModule</directive> 지시어 앞에
우물정자(<code>#</code>)를 붙인다. <em>즉</em>, 현재는
사용하지않지만 나중에 사용할 수 있도록 모듈을 준비한다.</dd>
<dt><code>-e</code></dt>
<dd>편집을 지시한다. <code>-a</code> 혹은 <code>-A</code>
옵션과 같이 사용할 수 있으며, <code>-i</code> 명령과
비슷하지만 모듈을 설치하지않고 아파치
<code>httpd.conf</code> 설정파일만 편집한다.</dd>
</dl>
</section>
</section>
<section id="examples"><title>예제</title>
<p>아파치서버의 기능을 확장하는 <code>mod_foo.c</code>라는
아파치 모듈이 있다고 가정하자. 먼저 다음 명령어를 사용하여
C 소스를 아파치 서버가 읽어들일 공유객체로 컴파일한다:</p>
<example>
$ apxs -c mod_foo.c<br />
/path/to/libtool --mode=compile gcc ... -c mod_foo.c<br />
/path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo<br />
$ _
</example>
<p>그리고 이 공유객체를 읽어들이는 <directive
module="mod_so">LoadModule</directive> 지시어를 아파치
설정에 추가한다. <code>apxs</code>는 자동으로 공유객체를
"modules" 디렉토리에 설치하고 <code>httpd.conf</code> 파일을
알맞게 수정하여 간단히 작업을 마친다. 다음 같이 실행한다:</p>
<example>
$ apxs -i -a mod_foo.la<br />
/path/to/instdso.sh mod_foo.la /path/to/apache/modules<br />
/path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules
...
chmod 755 /path/to/apache/modules/mod_foo.so<br />
[/path/to/apache/conf/httpd.conf에서 `foo' 모듈을 활성화한다]<br />
$ _
</example>
<p>그러면 다음과 같은 줄을</p>
<example>
LoadModule foo_module modules/mod_foo.so
</example>
<p>설정파일에 없다면 추가한다. 이 설정을 기본적으로 사용하지
않는다면 <code>-A</code> 옵션을 사용한다. <em>즉</em></p>
<example>
$ apxs -i -A mod_foo.c
</example>
<p>apxs를 쉽게 사용하려고 다음과 같이 아파치 모듈 견본과
Makefile을 만들 수 있다:</p>
<example>
$ apxs -g -n foo<br />
Creating [DIR] foo<br />
Creating [FILE] foo/Makefile<br />
Creating [FILE] foo/modules.mk<br />
Creating [FILE] foo/mod_foo.c<br />
Creating [FILE] foo/.deps<br />
$ _
</example>
<p>그런후 바로 견본 모듈을 공유객체로 컴파일하여 아파치
서버가 읽도록한다:</p>
<example>
$ cd foo<br />
$ make all reload<br />
apxs -c mod_foo.c<br />
/path/to/libtool --mode=compile gcc ... -c mod_foo.c<br />
/path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo<br />
apxs -i -a -n "foo" mod_foo.la<br />
/path/to/instdso.sh mod_foo.la /path/to/apache/modules<br />
/path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules
...
chmod 755 /path/to/apache/modules/mod_foo.so<br />
[/path/to/apache/conf/httpd.conf에서 `foo' 모듈을 활성화한다]<br />
apachectl restart<br />
/path/to/apache/sbin/apachectl restart: httpd not running, trying to start<br />
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module<br />
/path/to/apache/sbin/apachectl restart: httpd started<br />
$ _
</example>
</section>
</manualpage>
|
