NAME
nanoctl - Starts and Stops Nanoweb
SYNOPSIS
nanoctl command [...]
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.
SEE ALSO
nanoweb.php(5) kill(1)