Section: User Manuals (8)Updated: November 2002Local indexUp
NAME
nanoctl - Starts and Stops Nanoweb
SYNOPSIS
nanoctlcommand
[...]
DESCRIPTION
nanoweb.php
is a utility which allows you to start and stop the Nanoweb HyperText
Transfer Protocol (HTTP) server. Among this it allows you to show the
current state of the running server.
If Nanoweb is running you'll find the full documentation under
http://localhost/manual/
OPTIONS
The
command
argument can be one out of the following:
start
Brings up the Nanoweb Server.
stop
Stops the Nanoweb daemon.
restart
This command reinitializes Nanoweb, or with other words stops it first and
starts it again.
reload
Makes Nanoweb reread the main server configuration files (by sending the HUP
signal to the running nanoweb.php).
status
Shows a summary of the current server state.
status who
Status page which lists all active server processes (usually there is more
than one "subserver").
status detailed
Full status information.
status vstats
Shows the status of all defined virtual hosts.
status detailed-vstats
More detailed version of the above one.
NOTES
You really don't need to use
nanoctl
to start and stop the Nanoweb server daemon. You could do all this with the
standard UNIX
kill(1)
command. However nanoctl is of course much more easy and flexible to use.
It is for example designed to easily allow to run the Nanoweb daemon on
system bootup by simply creating a
ln(1)
symlink to nanoctl in the
/etc/rc2.d/
directory for example.
BUGS
nanoctl
used to give too few error messages in the past, but this seems fixed
currently.
A common mistake is to run
nanoweb.php(8)
from commandline, which doesn't create the PID-file automatically and trying
to stop nanoweb.php with nanoctl, which usually won't work that way.
FILES
/var/run/nanoweb.pid
This file holds the process id
(PID)
of the running nanoweb.php daemon to make it easier for
nanoctl
to stop it.