From 80d5dafe92c224fe43033b29d07331c923b2a3b7 Mon Sep 17 00:00:00 2001 From: Joshua Slive Date: Wed, 13 Nov 2002 20:54:35 +0000 Subject: [PATCH] Deprecate the direct use of httpd and recommend instead the use of apachectl. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@97505 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/invoking.html.en | 45 ++++++++++++++++++++------------- docs/manual/invoking.xml | 49 +++++++++++++++++++++++------------- 2 files changed, 60 insertions(+), 34 deletions(-) diff --git a/docs/manual/invoking.html.en b/docs/manual/invoking.html.en index 1579dc05e6..a7a14dae64 100644 --- a/docs/manual/invoking.html.en +++ b/docs/manual/invoking.html.en @@ -14,7 +14,7 @@ is run as a daemon that executes continuously in the background to handle requests. This document describes how to invoke httpd.

-
top

How Apache Starts

+

See also

top

How Apache Starts

If the Listen specified in the configuration file is default of 80 (or any other @@ -28,21 +28,28 @@ run as a less privileged user. This is controlled by the selected Multi-Processing Module.

+

The recommended method of invoking the httpd + executable is to use the apachectl control script. This + script sets certain environment variables that are necessary for + httpd to function correctly under some operating + systems, and then invokes the httpd binary. + apachectl will pass through any command line + arguments, so any httpd options may also be used with + apachectl. You may also directly edit the + apachectl script by changing the HTTPD + variable near the top to specify the correct location of the + httpd binary and any command-line arguments that you + wish to be always present.

+

The first thing that httpd does when it is invoked is to locate and read the configuration file httpd.conf. The location of this file is set at compile-time, but it is possible to specify its location at run time using the -f command-line option as in

-

/usr/local/apache/bin/httpd -f +

/usr/local/apache2/bin/apachectl -f /usr/local/apache/conf/httpd.conf

-

As an alternative to invoking the httpd binary - directly, a shell script called apachectl is provided which - can be used to control the daemon process with simple commands - such as apachectl start and apachectl - stop.

-

If all goes well during startup, the server will detach from the terminal and the command prompt will return almost immediately. This indicates that the server is up and running. @@ -73,15 +80,19 @@

top

Starting at Boot-Time

If you want your server to continue running after a system - reboot, you should add a call to httpd or - apachectl to your system startup files (typically - rc.local or a file in an rc.N - directory). This will start Apache as root. Before doing this - ensure that your server is properly configured for security and - access restrictions. The apachectl script is - designed so that it can often be linked directly as an init - script, but be sure to check the exact requirements of your - system.

+ reboot, you should add a call to apachectl to your + system startup files (typically rc.local or a file in + an rc.N directory). This will start Apache as + root. Before doing this ensure that your server is properly + configured for security and access restrictions.

+ +

The apachectl script is designed to act like a + standard SysV init script; it can take the arguments + start, restart, and stop + and translate them into the appropriate signals to + httpd. So you can often simply link + apachectl into the appropriate init directory. But be + sure to check the exact requirements of your system.

top

Additional Information

Additional information about the command-line options of httpd and apachectl as well as other diff --git a/docs/manual/invoking.xml b/docs/manual/invoking.xml index a50adcafe6..7a044eed39 100644 --- a/docs/manual/invoking.xml +++ b/docs/manual/invoking.xml @@ -18,6 +18,10 @@ to invoke httpd.

+Stopping Apache +httpd +apachectl +
How Apache Starts

If the Listen @@ -32,6 +36,20 @@ run as a less privileged user. This is controlled by the selected Multi-Processing Module.

+

The recommended method of invoking the httpd + executable is to use the apachectl control script. This + script sets certain environment variables that are necessary for + httpd to function correctly under some operating + systems, and then invokes the httpd binary. + apachectl will pass through any command line + arguments, so any httpd options may also be used with + apachectl. You may also directly edit the + apachectl script by changing the HTTPD + variable near the top to specify the correct location of the + httpd binary and any command-line arguments that you + wish to be always present.

+

The first thing that httpd does when it is invoked is to locate and read the configuration file @@ -39,16 +57,9 @@ compile-time, but it is possible to specify its location at run time using the -f command-line option as in

-/usr/local/apache/bin/httpd -f +/usr/local/apache2/bin/apachectl -f /usr/local/apache/conf/httpd.conf -

As an alternative to invoking the httpd binary - directly, a shell script called apachectl is provided which - can be used to control the daemon process with simple commands - such as apachectl start and apachectl - stop.

-

If all goes well during startup, the server will detach from the terminal and the command prompt will return almost immediately. This indicates that the server is up and running. @@ -84,15 +95,19 @@

Starting at Boot-Time

If you want your server to continue running after a system - reboot, you should add a call to httpd or - apachectl to your system startup files (typically - rc.local or a file in an rc.N - directory). This will start Apache as root. Before doing this - ensure that your server is properly configured for security and - access restrictions. The apachectl script is - designed so that it can often be linked directly as an init - script, but be sure to check the exact requirements of your - system.

+ reboot, you should add a call to apachectl to your + system startup files (typically rc.local or a file in + an rc.N directory). This will start Apache as + root. Before doing this ensure that your server is properly + configured for security and access restrictions.

+ +

The apachectl script is designed to act like a + standard SysV init script; it can take the arguments + start, restart, and stop + and translate them into the appropriate signals to + httpd. So you can often simply link + apachectl into the appropriate init directory. But be + sure to check the exact requirements of your system.

Additional Information -- 2.40.0