This is an old revision of the document!
citserver
Citadel Core
SYNOPSIS
citserver [-lLogFacility] [-d] [-f] [-D] [-tTraceFile] [-x Debug Component list] [-hHomeDir]
DESCRIPTION
Citadel (the binary name is citserver) is the core of the Citadel Suite. It provides Data-storage and Connection-oriented protocols like IMAP/POP/SMTP. Citserver will usualy be spawned via /etc/init.d or inittab. Unless using the -h option you shouldn't run several instances at once.
OPTIONS
| Switch | Result |
|---|---|
| -l | Log facility. Usually “mail” |
| -d | daemonize (detach from controlling terminal) |
| -D | print the directories the server would access to stderr on startup |
| -x debug compontent list | a compa separated list of facilities to add verbose logging for |
| -h[HomeDir] | Data directory for this Citadel installation. If the directory name begins with a forward slash, it is an absolute path; otherwise it is relative to the default. Watch the output of -D to observe the effects. |
DEFAULTS
Default port bindings opened by citserver:
| Port | Description |
|---|---|
| 25 | SMTP |
| 110 | POP3 |
| 143 | IMAP |
| 465 | SMTPS |
| 504 | Citadel protocol |
| 587 | MSA |
| 993 | IMAPS |
| 995 | POP3S |
| 2020 | ManageSieve |
Unix Domain Sockets opened by citserver:
| Socket name | Purpose |
|---|---|
| citadel.socket | Citadel |
| lmtp.socket | LMTP |
| lmtp-unfiltered.socket | LMPT bypassing the Spamassassin facilities |
ENVIRONMENT
These are the environment variables you can set in /etc/default/citadel or /etc/init.d/citadel to control the behaviour of citadel.
CITADEL_LOGDEBUG same as -x; all facilities specified will be enabled. see the ouptut of sendcommand LOGP for the actual names of the facilities your citadel server supports
CITSERVER_n_session_max How many simultaneous outbound smtp sessions are allowed? Defaults to 500 ; set to 0 to disable sending in total.
CITSERVER_smtp_delay a timer that is set between spawning two smtp sending tasks
CITSERVER_smtp_n_delay_count number of spawns to do in a row without applying the delay
SUPPRESS_DBVERSION_CHECK set to 1 to not be picky about the berkeley db version linked; Please note that downgrading berkeley DB versions is NOT possible; You should not set this until you're realy shure about what you're doing.
FILES
| /usr/share/citadel-server | Citadels Messages and help files |
| /var/lib/citadel | Citadel data files |
| /var/run/citadel | volatile files like the Unix Domain Sockets |
| /etc/citadel | Citadel configuration files |
| /usr/local/citadel | when compiled in non-LHFS mode, all of the above. |
| /etc/init.d/citadel | init script for CitServer; add reboot-safe parameters here. |
| /etc/default/citadel | Optoins to /etc/init.d/citadel in LHFS installations; \\add commandline options here. |
HISTORY
1987 - Now the Uncensored Communications Group