<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY NOT "">
<!ENTITY Notes "">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
]>
<refentry id="apache-1m">
<!--@(#)apache.1m 1.7 00/08/10 SMI-->
<!-- GENERIC CmdSynopsis TEMPLATE -->
<refmeta><refentrytitle>apache</refentrytitle><manvolnum>1M</manvolnum>
<refmiscinfo class="date">10 Aug 2000</refmiscinfo>
<refmiscinfo class="sectdesc">&man1m;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved.</refmiscinfo>
<indexterm><primary sortas=""></primary></indexterm><indexterm><primary sortas=""></primary></indexterm></refmeta>
<refnamediv><refname>apache</refname><refpurpose>Apache hypertext transfer protocol server overview</refpurpose></refnamediv>
<refsect1><title>&desc-tt;</title>
<para> <command>apache</command> consists of a main server daemon, loadable server modules, some additional support utilities, configuration files, and documentation. </para>
</refsect1>
<refsect1><title>&file-tt;</title>
<para>The <command>apache</command> <literal>HTTPD</literal> server is integrated with Solaris. </para>
<para>The following files specify the installation locations for <command>apache</command>: </para>
<variablelist termlength="medium"><varlistentry><term><filename>/etc/apache</filename> </term><listitem><para>Contains server configuration files. </para>
<para>A newly-installed server must be manually configured before use. Typically this involves copying <filename>httpd.conf-example</filename> to the <filename>httpd.conf</filename> file and making local configuration adjustments.</para>
</listitem></varlistentry>
<varlistentry><term><filename>/usr/apache/bin</filename> </term><listitem><para>Contains the <literal>httpd</literal> executable as well as other utility programs.</para>
</listitem></varlistentry>
<varlistentry><term><filename>/usr/apache/htdocs</filename> </term><listitem><para>Contains the Apache manual in <acronym>HTML</acronym> format. This documentation is accessible by way of a link on the server test page that gets installed upon fresh installation.</para>
</listitem></varlistentry>
<varlistentry><term><filename>/usr/apache/include</filename> </term><listitem><para>Contains the Apache header files, which are needed for building various optional server extensions with <citerefentry><refentrytitle>apxs</refentrytitle><manvolnum>8</manvolnum></citerefentry></para>
</listitem></varlistentry>
<varlistentry><term>/usr/apache/jserv</term><listitem><para>Contains documention for the <literal>mod_jserv</literal> java servlet module. Documention can be read with a web browser using the url: <screen>

file:/usr/apache/jserv/docs/index.html

</screen></para>
</listitem></varlistentry>
<varlistentry><term><filename>/usr/apache/libexec</filename> </term><listitem><para>Contains loadable modules (<literal>DSO</literal>s) supplied with the server. Any modules which are added using <citerefentry><refentrytitle>apxs</refentrytitle><manvolnum>8</manvolnum></citerefentry>are also copied into
this directory.</para>
</listitem></varlistentry>
<varlistentry><term><filename>/usr/apache/man</filename> </term><listitem><para>Contains man pages for the server, utility programs, and <literal>mod_perl</literal>. </para>
<para>Add this directory to your <filename>MANPATH</filename> to read the Apache man pages. See <literal>&note-tt;</literal>.</para>
</listitem></varlistentry>
<varlistentry><term><filename>/usr/apache/perl5</filename> </term><listitem><para>Contains the modules and library files used by the <literal>mod_perl</literal> extension to Apache. </para>
</listitem></varlistentry>
<varlistentry><term><filename>/var/apache/cgi-bin</filename> </term><listitem><para>Default location for the <acronym>CGI</acronym> scripts. </para>
<para>This can be changed by altering the <filename>httpd.conf</filename> file and restarting the server. </para>
</listitem></varlistentry>
<varlistentry><term><filename>/var/apache/htdocs</filename> </term><listitem><para>Default document root. </para>
<para>This can be changed by altering the <filename>httpd.conf</filename> file and restarting the server.</para>
</listitem></varlistentry>
<varlistentry><term><filename>/var/apache/icons</filename></term><listitem><para>Icons used by the server.</para>
<para>This normally shouldn't need to be changed.</para>
</listitem></varlistentry>
<varlistentry><term><filename>/var/apache/logs</filename></term><listitem><para>Contains server log files. </para>
<para>The formats, names, and locations of the files in this directory can be altered by various configuration directives in the <filename>httpd.conf</filename> file. </para>
</listitem></varlistentry>
<varlistentry><term><filename>/var/apache/proxy</filename></term><listitem><para>Directory used to cache pages if the caching feature of <literal>mod_proxy</literal> is enabled in the <filename>httpd.conf</filename> file. </para>
<para>The location of the cache can also be changed by changing the proxy configuration in the <filename>httpd.conf</filename> file. </para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&attr-tt;</title>
<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink> for descriptions of the following attributes:</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1"><colspec colwidth="1*"><colspec colwidth="1*">
<thead>
<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center" valign="middle">ATTRIBUTE VALUE</entry></row>
</thead>
<tbody>
<row><entry rowsep="0">Availability</entry><entry rowsep="0">SUNWapchr</entry></row>
<row><entry rowsep="0"></entry><entry rowsep="0">SUNWapchu</entry></row>
<row><entry></entry><entry>SUNWapchd</entry></row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1><title>&also-tt;</title>
<para><olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
<para><ulink url="http://www.apache.org">http://www.apache.org</ulink></para>
</refsect1>
<refsect1><title>&note-tt;</title>
<para>In addition to the documentation and man pages included with Solaris, more information is available at <ulink url="http://www.apache.org">http://www.apache.org</ulink></para>
<para>The Apache man pages are provided with the programming modules. To view the manual pages for the Apache modules with the man command, add <filename>/usr/apache/man</filename> to the <literal>MANPATH</literal> environment  variable. See <olink targetdocent="REFMAN1" localinfo="man-1"><citerefentry>
<refentrytitle>man</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink> for  more information. Running <olink targetdocent="REFMAN1M" localinfo="catman-1M"><citerefentry><refentrytitle>catman</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink> on the Apache manual pages is not supported. 
</para>
</refsect1>
</refentry>
