Scroll to navigation

KLONED(8) KoanLogic Srl KLONED(8)

NAME

kloned - klone daemon

SYNOPSIS

kloned [-d] [-f file] [-F] [-h] [-i] [-u]

DESCRIPTION

kloned merges a web server (or CGI to be plugged into other CGI-compliant web servers), its compressed configuration, together with the static and dynamic web contents into a single executable file.

The process of creating the kloned executable, by embedding the web content into the server process, is documented in the klone(1) manual page.

OPTIONS

Enable verbose logging for debugging purposes.
Load further configuration parameters from the external file config_file besides those found in the embedded configuration file sup://etc/kloned.conf. Parameters in conf_file override the values of those with the same name in the embedded configuration file.
If specified, this parameter causes the main kloned process to not detach from the terminal. HTTP/HTTPS requests are served iteratively: no child is forked to handle the client connection.
Display a summary of command-line options and exit.
Install kloned service and exit (only available on Windows).
Uninstall kloned service and exit (only available on Windows).
Print klone version and exit.

FILES

kloned depends on sup://etc/kloned.conf for the configuration of its instances (clones). Additional configuration can be supplied via an external file (the -f command line flag): see kloned.conf(5) for details on available configuration parameters and their respective values.

DIAGNOSTICS

KLone is a product targeted for embedded systems, especially those with limited or no disk resources; as such it tries to reduce logging activity to a minumum (at its best, zero logging).

Diagnostics issued by kloned are passed to the syslogd(8), subsystem with facility LOG_LOCAL0 and priority LOG_DEBUG and can be routed to a configurable file (see syslog.conf(5) for details).

The number and nature of diagnostics available depends on the debug level defined at compile-time. If you are having problems, compile the KLone application with NDEBUG unset, configure the syslog daemon appropriately, run your application and peruse the log files. Most messages are reasonably self-explanatory. At this stage your best bet is still to grep the source code and inspect the conditions that gave rise to the diagnostics you are seeing.

kloned is a service/daemon, as such it will bail out with an EXIT_SUCCESS exit code only if explicitly requested to terminate (i.e. SIGTERM or SIGINT), otherwise it will exit with EXIT_FAILURE.

ENVIRONMENT VARIABLES

The following environment variables affect the execution of kloned:

If set, kloned assumes it has been run as a CGI script by an external web server.

SIGNALS

To shut down a user's kloned process it is recommended that SIGKILL not be used, except as a last resort. The safe way to terminate a kloned is to send it a SIGTERM or SIGINT signal and wait for it to die on its own.

SEE ALSO

kloned.conf(5), klone(1).

BUGS

Sure there are some. If you find one, please email it to <klone-bug@koanlogic.com>.

11/03/2005 KoanLogic Srl