"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">[

]>

 Copyright 2018 Red Hat, Inc.

 Licensed to the Apache Software Foundation (ASF) under one or more

 contributor license agreements. See the NOTICE file distributed with

 this work for additional information regarding copyright ownership.

 The ASF licenses this file to You 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.

-->

<refentry>

  <refentryinfo>

    <title>apachectl</title>

    <productname>httpd</productname>

    <corpauthor>Apache Software Foundation</corpauthor>

    <editor><contrib>Fedora man page</contrib><surname>Dana</surname><firstname>Frank</firstname><email>ferdnyc@gmail.com</email></editor>

  </refentryinfo>

  <refmeta>

    <refentrytitle>apachectl</refentrytitle>

    <manvolnum>8</manvolnum>

  </refmeta>

  <refnamediv>

    <refname>apachectl</refname>

    <refpurpose>Server control interface for httpd</refpurpose>

  </refnamediv>

  <refsynopsisdiv id='synopsis'>

    <cmdsynopsis>

      <command>apachectl</command>

      <arg choice='opt'><replaceable>command</replaceable> </arg>

      <sbr/>

    </cmdsynopsis>

  </refsynopsisdiv>

  <refsect1 id='description'>

    <title>DESCRIPTION</title>

    <para><command>apachectl</command> is a front end to the Apache HyperText

    Transfer Protocol (HTTP) server. It is designed to help the

    administrator control the functioning of the Apache

    <command>httpd</command> daemon.</para>

    <para>The <command>apachectl</command> script takes one-word arguments like

    <option>start</option>,

    <option>restart</option>, and

    <option>stop</option>, and translates them

    into appropriate signals to <command>httpd</command>.</para>

    <para>The <command>apachectl</command> script returns a 0 exit value on

    success, and >0 if an error occurs.</para>

  </refsect1>

  <refsect1 id='options'>

    <title>OPTIONS</title>

    <variablelist remap='TP'>

      <varlistentry>

        <term><option>start</option></term>

        <listitem>

          <para>Start the Apache <command>httpd</command> daemon. Gives an error if it

          is already running. This is equivalent to <command>systemctl start httpd.service</command>.</para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>stop</option></term>

        <listitem>

          <para>Stops the Apache <command>httpd</command> daemon. This is equivalent to

          <command>systemctl stop httpd.service</command>.</para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>restart</option></term>

        <listitem>

          <para>Restarts the Apache <command>httpd</command> daemon. If the daemon is

          not running, it is started. This is equivalent

          to <command>systemctl restart httpd.service</command>.</para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>status</option></term>

        <listitem>

          <para>Displays a brief status report. This is equivalent to <command>systemctl status httpd.service.</command></para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>graceful</option></term>

        <listitem>

          <para>Gracefully restarts the Apache <command>httpd</command> daemon. If the

          daemon is not running, it is started. This differs from a normal

          restart in that currently open connections are not aborted. A side

          effect is that old log files will not be closed immediately. This

          means that if used in a log rotation script, a substantial delay may

          be necessary to ensure that the old log files are closed before

          processing them. This is equivalent to

          <command>systemctl kill --signal=SIGUSR1 --kill-who=main httpd.service</command>.</para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>graceful-stop</option></term>

        <listitem>

          <para>Gracefully stops the Apache <command>httpd</command> daemon.

          This differs from a normal stop in that currently open connections are not

          aborted. A side effect is that old log files will not be closed immediately.

          This is equivalent to

          <command>systemctl kill --signal=SIGWINCH --kill-who=main httpd.service</command>.</para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>configtest</option></term>

        <listitem>

          <para>Run a configuration file syntax test. It parses the configuration

          files and either reports <literal>Syntax Ok</literal>

          or detailed information about the particular syntax error. This is

          equivalent to <command>httpd -t</command>.</para>

        </listitem>

      </varlistentry>

    </variablelist>

    <para>The following options were available in earlier versions but have been removed.</para>

    <variablelist remap='TP'>

      <varlistentry>

        <term><option>fullstatus</option></term>

        <listitem>

          <para>Displays a full status report from <literal>mod_status</literal>.

          For this to work, you need to have <literal>mod_status</literal> enabled

          on your server and a text-based browser such as <command>lynx</command>

          available on your system. The URL used to access the status report

          can be set by editing the <literal>STATUSURL</literal> variable in the

          script.</para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>startssl</option></term>

        <listitem>

          <para>To start <command>httpd</command> with SSL support, you should edit

          your configuration file to include the relevant directives and then

          use the normal <command>apachectl start</command>.</para>

        </listitem>

      </varlistentry>

    </variablelist>

  </refsect1>

  <refsect1 id='bugs'>

    <title>BUGS</title>

    <para>Please report bugs by filing an issue against the "httpd" component of the "Fedora"

    project, in <ulink url='https://bugzilla.redhat.com/'>RedHat Bugzilla</ulink>.</para>

  </refsect1>

</refentry>