.TH vmm.cfg 5 "17 Aug 2009" "Pascal Volk"
.SH NAME
vmm.cfg \- Konfigurationsdatei für vmm
.SH SYNOPSIS
vmm.cfg
.SH BESCHREIBUNG
\fBvmm\fR(1) liest Konfigurationsparameter aus der Datei \fIvmm.cfg\fP.
.br
Die Konfigurationsdatei ist in mehrere Abschnitte unterteilt. Jeder Abschnitt
wird mit dem, in eckigen Klammern '[' und ']' eingefassten, Namen des Abschnitts
eingeleitet (z. B. \fB[database]\fP), gefolgt von \'Option = Wert\' Einträgen
(Z. B. \fBhost = 127.0.0.1\fP).
.br
Leerräume um das Gleichheitszeichen '=' und am Ende eine Wertes werden
ignoriert.
.PP
Leerzeilen und Zeilen, die mit einer '#' oder einem ';' anfangen, werden
ignoriert.
.PP
Jeder Wert ist von einem der folgenden Datentypen:
.IP \(bu
.I Boolean
um zu bestimmen, ob etwas eingeschaltet/aktiviert (true) oder
ausgeschaltet/deaktiviert (false) ist.
.br
Mögliche Werte für \fBtrue\fP sind: \fB1\fP, \fByes\fP, \fBtrue\fP und \fBon\fP.
.br
Mögliche Werte für \fBfalse\fP sind: \fB0\fP, \fBno\fP, \fBfalse\fP und
\fBoff\fP.
.IP \(bu
.I Int
eine Integer-Zahl, geschrieben ohne eine gebrochene oder dezimale Komponente.
.br
Beispielsweise sind \fB1\fP, \fB50\fP oder \fB321\fP Integer-Zahlen.
.IP \(bu
.I String
eine Folge von Buchstaben und Zahlen.
.br
Zum Beispiel: '\fBWort\fP', '\fBHallo Welt\fP', oder '\fB/usr/bin/strings\fP'
.SS SUCHREIHENFOLGE
Standardmäßig sucht vmm die \fIvmm.cfg\fP in folgenden Verzeichnissen, in dieser
Reihenfolge:
.RS
.PD 0
.TP
.I
/root
.TP
.I
/usr/local/etc
.TP
.I
/etc
.PD
.RE
.PP
Die zuerst gefundene Datei wird verwendet.
.\" -----
.SH DATABASE ABSCHNITT
Der \fBdatabase\fP-Abschnitt wird verwendet, um die für den Datenbankzugriff
benötigten Optionen festzulegen.
.TP
\fBhost\fP (\fIString\fP)
Der Hostname oder die IP-Adresse des Datenbank-Servers.
.TP
\fBuser\fP (\fIString\fP)
Der Name des Datenbank-Benutzers.
.TP
\fBpass\fP (\fIString\fP)
Das Passwort des Datenbank-Benutzers
.TP
\fBname\fP (\fIString\fP)
Name der zu verwendenden Datenbank.
.TP
\fBBeispiel\fP:
[database]
.br
host = localhost
.br
user = vmm
.br
pass = T~_:L4OYyl]TU?)
.br
name = mailsys
.\" -----
.SH MAILDIR ABSCHNITT
Im \fBmaildir\fP-Abschnitt werden die für die Maildirs erforderlichen Optionen
festgelegt.
.TP
\fBname\fP (\fIString\fP)
Standard-Name des Maildir-Verzeichnisses im Verzeichnis des jeweiligen
Anwenders.
.TP
\fBfolders\fP (\fIString\fP)
Eine durch Doppelpunkten getrennte Liste mit Verzeichnisnamen, die innerhalb des
Maildirs erstellt werden sollen.
.br
Sollen innerhalb des Maildirs keine Verzeichnisse angelegt werden, ist dieser
Optionen ein einzelner Doppelpunkt (':') als Wert zuzuweisen.
.TP
\fBmode\fP (\fIInt\fP)
Zugriffsbits des Maildirs in Dezimal-Schreibweise (Basis 10).
.br
Beispiel: \'drwx------' -> oktal 0700 -> dezimal 448
.TP
\fBdiskusage\fP (\fIBoolean\fP)
Legt fest, ob die Festplattenbelegung des Maildirs jedes Mal, wenn
Konto-Informationen ausgegeben werden, ermittelt und mit ausgegeben werden
sollen.
.TP
\fBdelete\fP (\fIBoolean\fP)
Bestimmt, ob das Maildir rekursiv gelöscht werden soll, wenn ein Konto gelöscht
wird.
.TP
\fBBeispiel\fP:
[maildir]
.br
name = Maildir
.br
folders = Drafts:Sent:Templates:Trash:INBOX.News
.br
mode = 448
.br
diskusage = false
.br
delete = false
.\" -----
.SH SERVICES ABSCHNITT
Im \fBservices\fP-Abschnitt werden die Standard-Beschränkungen für alle Konten
festgelegt.
.TP
\fBsmtp\fP (\fIBoolean\fP)
Legt fest, ob sich ein Anwender standardmäßig per SMTP einloggen kann.
.TP
\fBpop3\fP (\fIBoolean\fP)
Legt fest, ob sich ein Anwender standardmäßig per POP3 einloggen kann.
.TP
\fBimap\fP (\fIBoolean\fP)
Legt fest, ob sich ein Anwender standardmäßig per IMAP einloggen kann.
.TP
\fBsieve\fP (\fIBoolean\fP)
Legt fest, ob sich ein Anwender standardmäßig per MANAGESIEVE einloggen kann.
.TP
\fBBeispiel\fP:
[services]
.br
smtp = true
.br
pop3 = true
.br
imap = false
.br
sieve = false
.\" -----
.SH DOMDIR ABSCHNITT
Im \fBdomdir\fP-Abschnitt werden die Optionen der Domain-Verzeichnisse bestimmt.
.TP
\fBbase\fP (\fIString\fP)
Alle Domain-Verzeichnisse werden unterhalb dieses Basis-Verzeichnisses angelegt.
.TP
\fBmode\fP (\fIInt\fP)
Zugriffsbits des Domain-Verzeichnisses in Dezimal-Schreibweise (Basis 10).
.br
Beispiel: 'drwxrwx---' -> oktal 0770 -> dezimal 504
.TP
\fBdelete\fP (\fIBoolean\fP)
Bestimmt, ob beim Löschen einer Domain das Verzeichnis einer Domain, inklusive
aller Anwender-Verzeichnisse, rekursiv gelöscht werden soll.
.TP
\fBBeispiel\fP:
[domdir]
.br
base = /srv/mail
.br
mode = 504
.br
delete = false
.\" -----
.SH BIN ABSCHNITT
Der \fBbin\fP-Abschnitt wird verwendet, um Pfade zu Binaries, die von \fBvmm\fP
benötigt werden, anzugeben.
.TP
\fBdovecotpw\fP (\fIString\fP)
Der absolute Pfad zum dovecotpw-Binary. Dieses wird verwendet, wenn als
Passwort-Schema eines der folgenden verwendet wird: 'SMD5', 'SSHA', 'CRAM-MD5',
\'HMAC-MD5', 'LANMAN', 'NTLM' oder 'RPA'.
.TP
\fBdu\fP (\fIString\fP)
Der absolute Pfad zu \fBdu\fR(1). Dieses Binary wird verwendet, wenn die
Festplattenbelegung eines Kontos ermittelt wird.
.TP
\fBpostconf\fP (\fIString\fP)
Der absolute Pfad zu Postfix' \fBpostconf\fR(1).
.br
Dieses Binary wird verwendet, wenn \fBvmm\fR(1) diverse Postfix-Einstellungen
prüft, zum Beispiel virtual_alias_expansion_limit.
.TP
\fBBeispiel\fP:
[bin]
.br
dovecotpw = /usr/sbin/dovecotpw
.br
du = /usr/bin/du
.br
postconf = /usr/sbin/postconf
.\" -----
.SH MISC ABSCHNITT
Im \fBmisc\fP-Abschnitt werden verschiedene Einstellungen festgelegt.
.TP
\fBpasswdscheme\fP (\fIString\fP)
Das zu verwendende Passwort-Schema (siehe auch: dovecotpw -l)
.TP
\fBgid_mail\fP (\fIInt\fP)
Die numerische Gruppen-ID der Gruppe mail, bzw. der Gruppe aus
mail_privileged_group der Datei dovecot.conf.
.TP
\fBforcedel\fP (\fIBoolean\fP)
Legt fest, ob beim Löschen einer Domain alle vorhanden Konten und/oder Aliase,
ohne Nachfrage, gelöscht werden sollen.
.TP
\fBtransport\fP (\fIString\fP)
Der Standard-Transport aller Domains und Konten.
.TP
\fBdovecotvers\fP (\fIInt\fP)
Die verketteten Major- und Minor-Teile der eingesetzten Dovecot-Version
(siehe: dovecot --version).
.br
Diese Option beeinflusst diverse Datenbankzugriffe. Da es zwischen Dovecot
v1.1.x und v1.2.x einige Änderungen gab. Zum Beispiel \fB11\fP, falls
\fBdovecot --version\fP den Wert \fB1.1\fP.18 ausgibt.
.TP
\fBBeispiel\fP:
[misc]
.br
passwdscheme = CRAM-MD5
.br
gid_mail = 8
.br
forcedel = false
.br
transport = dovecot:
.br
dovecotvers = 11
.\" -----
.SH CONFIG ABSCHNITT
Beim \fBconfig\fP-Abschnitt handelt es sich um einen internen
Steuerungs-Abschnitt.
.TP
\fBdone\fP (\fIBoolean\fP)
Diese Option hat den den Wert \fIfalse\fP, wenn vmm zum ersten Mal installiert
wurde. Wenn die Datei \fIvmm.cfg\fP von Hand editiert wird, weisen Sie dieser
Option abschließend den Wert \fItrue\fP zu.
.br
Wird die Konfiguration über das Kommando \fBvmm configure\fP angepasst, wird der
Wert dieser Option automatisch auf \fItrue\fP gesetzt.
.br
Sollte diese Option den Wert \fIfalse\fP zugewiesen haben, so startet \fBvmm\fP
beim nächsten Aufruf im interaktiven Konfigurations-Modus.
.TP
\fBBeispiel\fP:
[config]
.br
done = true
.\" -----
.SH DATEIEN
vmm.cfg
.SH SIEHE AUCH
vmm(1), Programm für die Kommandozeile, um E-Mail-Domains, -Konten und -Aliase
zu verwalten.
.SH AUTOR
\fBvmm\fP und die dazugehörigen Manualseiten wurden von Pascal Volk
<\fIp.volk@veb-it.de\fP> geschrieben und sind unter den Bedingungen der BSD
Lizenz lizenziert.