WEBCIT(8)							    Citadel.org 							 WEBCIT(8)

NAME

       webcit - Citadel Servlet Engine.

SYNOPSIS

       webcit [-i ip_addr] [-p http_port] [-t tracefile] [-T Templatedebuglevel] [-c] [-f] [-d] [-s] [remotehost [remoteport] ]

DESCRIPTION

       WebCit  (the  binaries  name  is  webcit) is the Citadel Servlet engine. It can operate with Citserver on another box, but it can't operate
       without.

OPTIONS

       SwitchResult

       -hPATH Specify the home directory eg. -h/usr/local/citadel not adding a leading / will make the path  relative  to  the	compiletime  path.
	      Needed for running several webcit/citadel instances at the same host

       -d     Run as a daemon; fork watcher process.

       -DPATH Run as a daemon but create a pid file at PATH eg.  -D/var/run/webcit.pid

       -iIP_ADDR
	      Specify IP address to listen on as web server eg -i192.168.9.1; default is 0.0.0.0

       -pPORT Specify port to listen on eg. -p80; default is 2000

       -tPATH Specify trace file (where to put the log file) eg -t/var/log/webcit

       -T VAL 0  (default;  recommended for production systems) 1: Parse template on each request .TP -xVAL How much info to put in the trace file
	      (or to stdout) eg -x9

       -f     Follow X-Forwarded-For: headers.

       -c     Use a server cookie.

       -s     use SSL (turns the -p default to 443)

       remotehost
	      if the citserver lives on another box, its name / ip (remember to add your webserver IP to the citadel servers public_clients - Con-
	      figfile.); else the path to the unix-domain-socket. Defaults to the compiled in unix domain socket

       remoteport
	      If you want to connect to citserver via TCP specify its port here; usualy 504

DEFAULTS

       The  default  for  remotehost is to connect localy via Unix Domain Socket.  The default TCP port is 504. webcit will open Port 2000 serving
       HTTP requests and bind 0.0.0.0 if not other specified.

FILES

       The location of the files may vary depending on configure options. .TP /usr/share/citadel-webcit/static//  WebCits template files

       /usr/share/citadel-webcit/static.local//  Your customized
	      templates

       /usr/share/tinymce/www// the TinyMCE
	      [http://tinymce.moxiecode.com/] Javascript Editor

       /etc/init.d/webcit/
	      The initscript usually used to start this binary. Add Options here

       /etc/default/webcit/
	      Parameters to /etc/init.d/webcit/ in the LHFS ified installations dpkg-reconfigurecitadel-webcitwillmodifythisfile.

HISTORY

       1998 - Now the Uncensored Communication Group

webcit								     2008-9-4								 WEBCIT(8)