File citserver.8 of Package citadel

." Text automatically generated by txt2man
.TH citserver 8 "Mai 14, 2011" "Citadel Server" "7.86-0"
.SH NAME
\fBcitserver \fP- Citadel server
.SH SYNOPSIS
.nf
.fam C
\fBcitserver\fP [\fB-lFacility\fP] [\fB-d\fP] [\fB-D\fP] [\fB-s\fP] [\fB-tFile\fP] [\fB-xLevel\fP] [\fB-hDir\fP]
.fam T
.fi
.SH DESCRIPTION
Citadel (the binary name is \fBcitserver\fP) is the core of the
Citadel Suite. It provides Data-storage and Connection-oriented
protocols like IMAP/POP/SMTP. Citserver will be spawned 
via /etc/init.d/citadel or inittab. Unless using the \fB-h\fP option you
shouldn't run several instances at once.
.SH OPTIONS
.TP
.B
\fB-l\fP
Log facility. Usually "mail"
.TP
.B
\fB-d\fP
daemonize (detach from controlling terminal)
.TP
.B
\fB-D\fP
print the directories the server would access to stderr on startup
.TP
.B
\fB-t\fP [File]
Send log messages to a file instead of syslog
.TP
.B
\fB-x\fP [Level]
Verbosity level of logging (0 to 9)
.TP
.B
\fB-h\fP [Dir]
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 \fB-D\fP to observe the effects.
.SH DEFAULTS
Default port bindings opened by \fBcitserver\fP:
.PP
-- port and description
.TP
.B
25
SMTP
.TP
.B
110
POP3
.TP
.B
143
IMAP
.TP
.B
465
SMTPS
.TP
.B
504
Citadel protocol
.TP
.B
587
MSA
.TP
.B
993
IMAPS
.TP
.B
995
POP3S
.TP
.B
2020
ManageSieve
.PP
Unix Domain Sockets opened by \fBcitserver\fP:
.PP
-- socket and purpose
.TP
.B
citadel.socket
Citadel
.TP
.B
lmtp.socket
LMTP
.TP
.B
lmtp-unfiltered.socket
LMPT bypassing the Spamassassin facilities
.SH FILES
.TP
.B
/usr/share/citadel
Citadels Messages and help files
.TP
.B
/srv/citadel
Citadel data files
.TP
.B
/var/run/citadel
volatile files like the Unix Domain Sockets
.TP
.B
/etc/citadel
Citadel configuration files
.TP
.B
/etc/init.d/citadel
init script for \fBcitserver\fP;
.TP
.B
/etc/sysconfig/citadel
Optoins to /etc/init.d/citadel in LHFS
installations; add commandline options here.
.SH EXAMPLE
Daemonize, log to mail facility and log level 3 by syslog:
.PP
$ \fBcitserver\fP \fB-d\fP \fB-x3\fP \fB-lmail\fP \fB-t\fP/dev/null
.SH LICENSE
\fBcitserver\fP is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
.PP
\fBcitserver\fP is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.
.PP
You should have received a copy of the GNU General Public License
along with this program. If not, see http://www.gnu.org/licenses/.
.SH AUTHOR
The Citadel Team
.PP
This manual page was written by Stefan Jakobs <projects@localside.net>