Next: , Previous: , Up: Existing servers   [Contents][Index]


3.4.3 Control Protocol Server

If the GNU Serveez package is configured with the control protocol enabled, running ‘serveez --help’ will show the option -P and the following documentation applies. Otherwise, feel free to skip to the next section.

3.4.3.1 General description

Serveez implements something like a telnet protocol for administrative purposes. You just need to start a telnet session like:

$ telnet www.lkcc.org 42420

After pressing RET you will be asked for a password which you might setup passing Serveez the -P argument. See Using Serveez. The next section describes the interactive commands available.

3.4.3.2 Using the Control Protocol

help

This command will give you a very short help screen of all available commands.

quit

This command closes the connection to Serveez.

restart ident

Restarts the internal ident coserver. This is useful if you just want to start a new one if the old one died or is otherwise unusable.

restart dns

Restarts the internal dns lookup server.

restart reverse dns

Restarts the internal reverse dns lookup server.

killall

This might be useful if Serveez seems to be unstable but you do not want to restart it. With ‘killall’ you disconnect all client network connections except the control protocol connections.

kill id NUM

Disconnects a specific connection identified by its ID. These IDs will be stated when you type ‘stat con’ (see below).

stat

General statistics about Serveez. This will show you some useful information about the computer Serveez is running on and about the state of Serveez in general.

stat coserver

Statistics about all running coserver instances.

stat SERVER

This command is for selecting certain server instances to be listed. SERVER is one of server names you specified in the configuration file.

stat id NUM

Show statistics about a specific connection. This will give you all available information about every connection you specified. See Writing servers, for more information about how to provide these information.

stat con

Connection statistics. This will give a list of all socket structures within Serveez. If you want more detailed information about specific connections, coservers or servers you need to request these information with ‘stat id NUM’ or ‘stat all’.

stat all

Server and coserver instance statistics. This command lists all the information about instantiated servers and coservers. See Writing servers, for more information about how to provide these information.

stat cache

HTTP cache statistics. This command produces an output something like the following where ‘File’ is the short name of the cache entry, ‘Size’ the cache size, ‘Usage’ the amount of connections currently using this entry, ‘Hits’ the amount of cache hits, ‘Recent’ the cache strategy flag (newer entries have larger numbers) and ‘Ready’ is the current state of the cache entry.

File                      Size  Usage  Hits Recent Ready
zlib-1.1.3-20000531.zip  45393      0     0      1 Yes
texinfo.tex             200531      0     0      2 Yes
shayne.txt                2534      0     1      1 Yes

Total : 248458 byte in 3 cache entries
kill cache

Reinitialize the HTTP file cache. Flushes all files from the cache.

3.4.3.3 Configuration

There is nothing to be configured yet.


Next: Foo Server, Previous: IRC Server, Up: Existing servers   [Contents][Index]