nanoctl

Langue: en

Version: November 2002 (ubuntu - 08/07/09)

Section: 8 (Commandes administrateur)

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)