Injun Man Page

NAME

injun - Injun Application Server

SYNOPSYS

injun	[ -ruandD ]
	[ -p tcp/ip port ] [ -o outstanding requests ]
	[ -t threads ] [ -q thread queue length ]
	[ -l log level ] [ -f log facility ] [ -x log destination ]
	[ -s library module -s ... ]

injun -v

DESCRIPTION

injun is the Injun Application Server daemon. It is usually started once and left to run as it can be configured, administered and shutdown from a world wide web browser. There are no configuration files or support directories or files necessary. Once started the daemon waits for connection requests (by default) from browsers on port 8765.

OPTIONS

-v	Causes the version number to be printed on stdout, after which the programs exits.
-a	Allows the display and use of the load, unload, debug and exit options by users.
-n	Runs injun in the foreground allowing for easier debugging and control under shell scripts.
-r	This option tells injun to try and resolve ip addresses into domain names. The domain name of the requestor is then added to the page details which are passed to the page handler as arguments. Using this argument slows down injun as each ip address must be resolved before the web page is handled.
-u	This option is used in conjunction with the -r option and causes injun to use a primitive caching mechanism for the address to name resolution.
-d	This option causes the default socket on port 8765 not to be created. This is used when the administration module is not loaded and the modules being loaded create their own ports.
-D	Do not load the administration module. This option is used when no administration is (necessary) or needed. This can be used to start up injun with a preconfigured module and nothing else.
-?	Causes the Usage string to be printed out, after which the program exits.
-p	Allows the default port number that injun will wait for connections on to be specified. The -p flag has the form: -p port where port should be greater than 1023 when injun is started by a non privileged user.
-o	This sets up the outstanding requests parameter that is used in the listen(3N) command. This is sometimes called the backlog parameter. This defines the maximum length the queue of pending connections may grow to. The -o flag has the form: -o number where number should be a positive integer.
-t	This configures the number of threads that is used in the main processing loop to handle requests and timeouts. The -t flag has the form: -t threads where threads should be a positive integer.
-q	This configures the size of the request queue for the injun application server (rather than the -o flag which configures the OS backlog queue.) The -t flag has the form: -q queue size where queue size should be a positive integer.
-l	Specifies the logging level. This must be in the range 0 to 2 where 0 will cause only error messages to be logged, 1 will log informational messages while 2 will log copious amounts of spurious output. The -l flag has the form: -l level where level must be the integer 0, 1 or 2.
-f	Specifies the syslog logging facility. This must be in the range 0 to 7 where 0 will cause messages to be sent to the syslog(1) facility LOCAL0, 1 will log to LOCAL1, etc, etc. The default is 7 which causes messages to be logged to LOCAL7. The -f flag has the form: -f facility where facility must be an integer in the range 0 to 7. Note: This flag is ignored if the -x flag is set.
-x	Specifies the destination of the logging output. This must be in the range 0 to 3 where 0 will cause the output to be directed to stdout, 1 will cause the output to be directed to the syslog daemon, 2 will send the output to stderr and 3 will cause the output to be logged to a local file injun-*.log (where * is the operating system, release number and system architecture.) This can be useful if syslog is not (or can not be) configured. The -x flag has the form: -x destination where destination must be an integer in the range 0 to 3.
-s	Specifies an application module to load immediatly after starting. The -i flag has the form: -s library:args:init:dele where library specifies the name of a dynamic shared library containing the application module to load (Note: the directory containing this library should be in the LD_LIBRARY_PATH environment variable.) args specifies the arguments to be passed to the initialisation routine (init) and deletion routine (dele) init specifies the name of the initialisation routine. dele specifies the name of the deletion routine.

EXIT STATUS

0	the daemon was launched
255	failure to parse command line args or fork

SEE ALSO

syslogd(1M), syslog.conf(4), listen(3N), fork(2), tail(1)

WARNINGS

The return codes from startup are superficial. As the program forks early in its life to avoid over complicated initialisation, plenty of things can go wrong in the startup after becoming a daemon (and returning a good return code.)

To check on the startup status of the daemon, simply tail the syslog configured for injun messages or log to a file with the -x0 option and then tail the output.

NOTES

To configure the syslog to log messages to file /var/log/injunlog for facility LOCAL7 add the following line to the syslog configuration file /etc/syslogd.conf

local7.debug	/var/log/injunlog
        

NOTE: the whitespaces are TABS !

Copyright © 2000 Tortuga Technologies Pty Ltd. All rights reserved.

last updated 18-February-2000