setup.py.mk: update pypi url
[unleashed-userland.git] / components / web / apache24 / Solaris / apache2.1m.sunman
blobada56d2efae2b8a90ae1f39257004ca996143147
1 '\" te
2 .\" Copyright (c) 2008, 2011, Oracle and/or its affiliates. All rights reserved.
3 .TH apache2 1M "May 2011" "SunOS 5.11" "System Administration Commands"
4 .SH NAME
5 apache24 \- Apache HTTP Server Version 2.4 overview
6 .SH SYNOPSIS
7 .LP
8 .nf
9 \fBapache24\fR
10 .fi
12 .SH DESCRIPTION
13 .sp
14 .LP
15 Apache HTTP Server Version 2 (Apache 2) consists of a main  server daemon,
16 loadable server modules,  some additional  support utilities, configuration
17 files, and documentation.
18 .sp
19 .LP
20 Both 32-bit and 64-bit versions of the servers are installed. It also
21 includes two of the most popular MPMs - Prefork and Worker.
22 .SH FILES
23 .sp
24 .LP
25 The following files specify the installation locations for Apache 2:
26 .LP
27 Note : 
28 .RS +4
29 .TP
30 .ie t \(bu
31 .el o
32 The string \fB[version]\fR should be expanded
33 to \fB"MAJOR.MINOR"\fR. For example, \fB/usr/apache2/2.4/*\fR.
34 .RE
35 .RS +4
36 .TP
37 .ie t \(bu
38 .el o
39 \fB[isainfo]\fR represents the output of \fBisainfo
40 -n\fR on 64-bit platform.
41 .RE
42 .RS +4
43 .TP
44 .ie t \(bu
45 .el o
46 To find the current version of Apache 2 installed on your
47 machine, type the following command:
48 .sp
49 .in +2
50 .nf
51 $ /usr/apache2/[version]/bin/apachectl -v
52 .fi
53 .in -2
54 .sp
56 .RE
57 .RE
58 .sp
59 .ne 2
60 .mk
61 .na
62 \fB\fB/etc/apache2/[version]/\fR\fR
63 .ad
64 .sp .6
65 .RS 4n
66 Contains server configuration files. A newly-installed server
67 contains a default \fBhttpd.conf\fR file. This is the main configuration file.
68 .RE
70 .sp
71 .ne 2
72 .mk
73 .na
74 \fB\fB/etc/apache2/[version]/conf.d/\fR\fR
75 .ad
76 .sp .6
77 .RS 4n
78 Contains additional server configuration files.
79 .sp
80 By default, server will load all the \fB\&.conf\fR files
81 placed under this directory. It also has 2 additional \fB\&.load\fR configuration
82 files-\fBmodules-32.load\fR and \fBmodules-64.load\fR which
83 contain \fBLoadModule\fR directives for loading the 32 and 64-bit
84 bundled Apache 2 modules respectively.
85 .RE
87 .sp
88 .ne 2
89 .mk
90 .na
91 \fB\fB/etc/apache2/[version]/envvars\fR\fR
92 .ad
93 .sp .6
94 .RS 4n
95 File for specifying the environment settings which the server uses at
96 startup. This is the user-editable version of the 
97 /usr/apache2/[version]/bin/envvars file. 
98 .RE
101 .ne 2
104 \fB\fB/etc/apache2/[version]/magic\fR\fR
106 .sp .6
107 .RS 4n
108 Magic data for \fBmod_mime_magic\fR Apache module as documented in the 
110 \fB/usr/apache2/2.4/manual/mod/mod_mime_magic.html\fR file.
113 Editing this file is not recommended.
118 .ne 2
121 \fB\fB/etc/apache2/[version]/mime.types\fR\fR
123 .sp .6
124 .RS 4n
125 Default MIME types file. This file sets the default list of
126 mappings from filename extensions to content types, changing this file is
127 not recommended. Use the \fBAddType\fR directive instead.
131 .ne 2
134 \fB\fB/etc/apache2/[version]/original/\fR\fR
136 .sp .6
137 .RS 4n
138 Contents under this directory are delivered as-is from the
139 apache distribution and these files are not meant to be read by the server.
143 .ne 2
146 \fB\fB/etc/apache2/[version]/sample-conf.d/\fR\fR
148 .sp .6
149 .RS 4n
150 Contains sample \fB\&.conf\fR files. These are
151 not included in the main configuration file. To use the sample file, copy
152 the file to \fBconf.d\fR directory and modify as per the need.
156 .ne 2
159 \fB\fB/usr/apache2/[version]/bin/\fR\fR
161 .sp .6
162 .RS 4n
163 Contains the 32-bit httpd (Prefork MPM) and httpd.worker (Worker
164 MPM) executable as well as other utility programs.
168 .ne 2
171 \fB\fB/usr/apache2/[version]/bin/[isainfo]/\fR\fR
173 .sp .6
174 .RS 4n
175 Contains the 64-bit httpd (Prefork MPM) and httpd.worker (Worker
176 MPM) executables as well as other utility programs.
180 .ne 2
183 \fB\fB/usr/apache2/[version]/bin/envvars\fR\fR
184 \fB\fB/usr/apache2/[version]/bin/[isainfo]/envvars\fR\fR
186 .sp .6
187 .RS 4n
188 Contains the default environment settings that the server uses at startup.
190 Editing this file is not recommended. 
192 Instead, user should use /etc/apache2/[version]/envvars file.
196 .ne 2
199 \fB\fB/usr/apache2/[version]/manual/\fR\fR
201 .sp .6
202 .RS 4n
203 Contains the Apache 2 manual in HTML format.
207 .ne 2
210 \fB\fB/usr/apache2/[version]/include/\fR\fR
212 .sp .6
213 .RS 4n
214 Contains the Apache 2 header files, which are needed for building
215 various optional server extensions with \fBapxs(8)\fR.
219 .ne 2
222 \fB\fB/usr/apache2/[version]/libexec/\fR\fR
224 .sp .6
225 .RS 4n
226 Contains 32-bit loadable modules (DSOs) supplied with the
227 server.
231 .ne 2
234 \fB\fB/usr/apache2/[version]/libexec/[isainfo]/\fR\fR
236 .sp .6
237 .RS 4n
238 Contains 64-bit loadable modules (DSOs) supplied with the
239 server.
243 .ne 2
246 \fB\fB/usr/apache2/[version]/man/\fR\fR
248 .sp .6
249 .RS 4n
250 Contains man pages for the server, utility programs, and \fBmod_perl\fR.
252 Add this directory to your MANPATH to read the Apache 2 man pages. See
253 Notes.
257 .ne 2
260 \fB\fB/usr/apache2/[version]/lib/\fR\fR
262 .sp .6
263 .RS 4n
264 Contains the 32-bit Apache 2 core libraries.
268 .ne 2
271 \fB\fB/usr/apache2/[version]/lib/[isainfo]/\fR\fR
273 .sp .6
274 .RS 4n
275 Contains the 64-bit Apache 2 core libraries.
279 .ne 2
282 \fB\fB/usr/apache2/[version]/lib/perl/\fR\fR
284 .sp .6
285 .RS 4n
286 Contains the 32-bit modules and library files used by the \fBmod_perl\fR extension to Apache 2.
290 .ne 2
293 \fB\fB/var/apache2/[version]/cgi-bin/\fR\fR
295 .sp .6
296 .RS 4n
297 Default location for the CGI scripts.
299 This can be changed by altering the \fBhttpd.conf\fR file
300 and restarting the server.
304 .ne 2
307 \fB\fB/var/apache2/[version]/htdocs/\fR\fR
309 .sp .6
310 .RS 4n
311 Default document root.
313 This can be changed by altering the \fBhttpd.conf\fR file
314 and restarting the server.
318 .ne 2
321 \fB\fB/var/apache2/[version]/icons/\fR\fR
323 .sp .6
324 .RS 4n
325 Icons used by the server.
327 This should not be changed.
331 .ne 2
334 \fB\fB/var/apache2/[version]/libexec/\fR\fR
336 .sp .6
337 .RS 4n
338 Place holder for 32-bit user Apache 2 modules.
340 Any 32-bit modules which are added using \fBapxs(8)\fR are
341 copied into this directory.
345 .ne 2
348 \fB\fB/var/apache2/[version]/libexec/[isainfo]/\fR\fR
350 .sp .6
351 .RS 4n
352 Place holder for 64-bit user Apache 2 modules.
354 Any 64-bit modules which are added using \fBapxs(8)\fR are
355 copied into this directory.
359 .ne 2
362 \fB\fB/var/apache2/[version]/logs/\fR\fR
364 .sp .6
365 .RS 4n
366 Contains server log files.
368 The formats, names, and locations of the files in this directory can
369 be altered by various configuration directives in the \fBhttpd.conf\fR file.
373 .ne 2
376 \fB\fB/var/apache2/[version]/proxy/\fR\fR
378 .sp .6
379 .RS 4n
380 Directory used to cache pages if  the caching feature of \fBmod_proxy\fR is enabled in the \fBhttpd.conf\fR file.
382 The location of the cache can also be changed by changing the proxy
383 configuration in the \fBhttpd.conf\fR file.
386 .SH SEE ALSO
389 \fBattributes(5)\fR, \fBhttpd(8)\fR, apachectl(8)
392 http://www.apache.org
393 .SH NOTES
396 In addition to the documentation and man pages included with Solaris,
397 more information is available at http://www.apache.org\&.
400 The Apache 2 man pages are provided with the programming modules. To
401 view the manual pages for the Apache 2 modules with the man command, add \fB/usr/apache2/[version]/man\fR to the MANPATH environment variable.
402 See \fBman(1)\fR for more information. Running \fBcatman(1M)\fR on
403 the Apache 2 manual pages is not supported.