=========

 vmm.cfg

=========

---------------------------

Konfigurationsdatei für vmm

---------------------------

:Author:         Pascal Volk <neverseen@users.sourceforge.net>

:Date:           2010-01-18

:Version:        vmm-0.6.0

:Manual group:   vmm Manual

:Manual section: 5

.. contents::

    :backlinks: top

    :class: htmlout

SYNOPSIS

========

vmm.cfg

BESCHREIBUNG

============

**vmm**\(1) liest seine Konfigurationsparameter aus der Datei *vmm.cfg*.

Die Konfigurationsdatei ist in mehrere Abschnitte unterteilt. Jeder Abschnitt

wird mit dem, in eckigen Klammern '**[**' und '**]**' eingefassten, Namen des

Abschnitts eingeleitet, gefolgt von '*Option* = *Wert*' Einträgen::

    [database]

    host = 127.0.0.1

Leerräume um das Gleichheitszeichen '=' und am Ende eines Wertes werden

ignoriert.

Leerzeilen und Zeilen, die mit einer '#' oder einem ';' anfangen, werden

ignoriert.

Jeder Wert ist von einem der folgenden Datentypen:

* *Boolean* um zu bestimmen, ob etwas eingeschaltet/aktiviert (true) oder

  ausgeschaltet/deaktiviert (false) ist.

  | Mögliche Werte für *true* sind: **1**, **yes**, **true** und **on**.

  | Mögliche Werte für *false* sind: **0**, **no**, **false** und **off**.

* *Int* eine Integer-Zahl, geschrieben ohne eine gebrochene oder dezimale

  Komponente.

  | Beispielsweise **1**, **50** oder **321** sind Integer-Zahlen.

* *String* eine Folge von Buchstaben und Zahlen.

  | Zum Beispiel: '**Wort**', '**Hallo Welt**' oder '**/usr/bin/strings**'

SUCHREIHENFOLGE

---------------

Standardmäßig sucht **vmm**\(1) die *vmm.cfg* in folgenden Verzeichnissen,

in der angegebenen Reihenfolge:

    | */root*

    | */usr/local/etc*

    | */etc*

Die zuerst gefundene Datei wird verwendet.

ABSCHNITTE

==========

Im Folgenden werden die Abschnitte der *vmm.cfg* und deren Optionen

beschrieben.

ACCOUNT

-------

Die Optionen des Abschnitts **account** legen Konto-spezifische

Einstellungen fest.

``delete_directory`` : *Boolean*

    Bestimmt das Verhalten von **vmm**\(1) beim Löschen eines Kontos.

    Wenn der Wert dieser Option *true* ist, wird das Home-Verzeichnis des

    zu löschenden Anwenders rekursiv gelöscht.

``directory_mode`` : *Int*

    Zugriffsbits des Home-Verzeichnisses, sowie aller enthaltenen

    Verzeichnisse, in Dezimal-Schreibweise (Basis 10).

    | Beispiel: 'drwx------' -> oktal 0700 -> dezimal 448

``disk_usage`` : *Boolean*

    Legt fest, ob die Festplattenbelegung des Maildirs eines Benutzers jedes

    Mal mit **du**\(1) ermittelt und mit den Konto-Informationen ausgegeben

    werden soll.

    Bei umfangreichen Maildirs kann das langsam sein. Falls Sie Quotas

    aktiviert haben, wird der **vmm**-Unterbefehl **userinfo** ebenfalls

    die aktuelle Quota-Nutzung des Kontos mit ausgegeben. Sie können auch

    eines der optionalen Argumente **du** oder **full** an **userinfo**

    übergeben, um sich die aktuelle Festplattenbelegung anzeigen zu lassen.

``imap`` : *Boolean*

    Bestimmt, ob sich neu angelegte Benutzer per IMAP anmelden können sollen.

``password_length`` : *Int*

    Diese Option legt die Anzahl der Zeichen für automatisch erzeugte

    Passwörter fest. Alle Werte kleiner als 8 werden auf 8 erhöht.

``pop3``

    Bestimmt, ob sich neu angelegte Benutzer per POP3 anmelden können sollen.

``random_password`` : *Boolean*

    Mit dieser Option wird bestimmt , ob **vmm**\(1) ein zufälliges Passwort

    generieren soll, wenn kein Passwort an den **useradd** Unterbefehl

    übergeben wurde. Ist der Wert dieser Option *false*, wird **vmm** Sie

    auffordern, ein Passwort für den neun Account einzugeben.

    Sie können die Länge für automatisch generierte Passwörter mit der

    Option **password_length** konfigurieren.

``sieve`` : *Boolean*

    Bestimmt, ob sich neu angelegte Benutzer per ManageSieve anmelden

    können sollen.

``smtp`` : *Boolean*

    Bestimmt, ob sich neu angelegte Benutzer per SMTP (SMTP AUTH) anmelden

    können sollen.

Beispiel::

    [account]

    delete_directory = false

    directory_mode = 448

    disk_usage = false

    random_password = true

    password_length = 10

    smtp = true

    pop3 = true

    imap = true

    sieve = true

BIN

---

Im **bin**-Abschnitt werden Pfade zu Binaries angegeben, die von

**vmm**\(1) benötigt werden.

``dovecotpw`` : *String*

    Der absolute Pfad zum dovecotpw Binary. Dieses Binary wird zur

    Hash-Erzeugung verwendet, wenn **misc.password_scheme** einen der

    nachfolgenden Werte hat: 'SMD5', 'SSHA', 'CRAM-MD5', 'HMAC-MD5',

    'LANMAN', 'NTLM' oder 'RPA'.

``du`` : *String*

    Der absolute Pfad zu **du**\(1). Dieses Binary wird verwendet, wenn

    die Festplattenbelegung eines Kontos ermittelt wird.

``postconf`` : *String*

    Der absolute Pfad zu Postfix' **postconf**\(1). Dieses Binary wird

    verwendet, wenn **vmm**\(1) diverse Postfix-Einstellungen prüft, zum

    Beispiel das `virtual_alias_expansion_limit`.

Beispiel::

    [bin]

    dovecotpw = /usr/sbin/dovecotpw

    du = /usr/bin/du

    postconf = /usr/sbin/postconf

CONFIG

------

Beim **config**-Abschnitt handelt es sich um einen internen

Steuerungs-Abschnitt.

``done`` : *Boolean*

    Diese Option hat den Wert *false*, wenn **vmm**\(1) zum ersten Mal

    installiert wurde. Wenn Sie die Datei *vmm.cfg* von Hand editieren,

    weisen Sie dieser Option abschließend den Wert *true* zu. Wird die

    Konfiguration über das Kommando **vmm configure** angepasst, wird der

    Wert dieser Option automatisch auf *true* gesetzt.

    Ist der Wert dieser Option  *false*, so startet **vmm**\(1) beim

    nächsten Aufruf im interaktiven Konfigurations-Modus.

Beispiel::

    [config]

    done = true

DATABASE

--------

Der **database**-Abschnitt wird verwendet, um die für den Datenbankzugriff

benötigten Optionen festzulegen.

``host`` : *String*

    Der Hostname oder die IP-Adresse des Datenbank-Servers.

``name`` : *String*

    Der Name der zu verwendenden Datenbank.

``pass`` : *String*

    Das Passwort des Datenbank-Benutzers.

``user`` : *String*

    Der Name des Datenbank-Benutzers.

Beispiel::

    [database]

    host = localhost

    user = vmm

    pass = PY_SRJ}L/0p-oOk

    name = mailsys

DOMAIN

------

Im **domain**-Abschnitt werden Domain-spezifische Informationen konfiguriert.

``auto_postmaster`` : *Boolean*

    Ist der Wert dieser Option *true*, wird **vmm**\(1) beim Anlegen einer

    Domain automatisch einen postmaster-Account erstellen.

``delete_directory`` : *Boolean*

    Bestimmt, ob beim Löschen einer Domain das Verzeichnis einer Domain,

    inklusive aller Anwender-Verzeichnisse, rekursiv gelöscht werden soll.

``directory_mode`` : *Int*

    Zugriffsbits des Domain-Verzeichnisses in Dezimal-Schreibweise (Basis

    10).

    | Beispiel: 'drwxrwx---' -> oktal 0770 -> dezimal 504

``force_deletion`` : *Boolean*

    Erzwingt das Löschen aller zugeordneten Konten und Aliase beim Löschen

    einer Domain.

Beispiel::

    [domain]

    auto_postmaster = true

    delete_directory = false

    directory_mode = 504

    force_deletion = false

MAILDIR

-------

Im **maildir**-Abschnitt werden die für die Maildirs erforderlichen Optionen

festgelegt.

``folders`` : *String*

    Eine durch Doppelpunkten getrennte Liste mit Verzeichnisnamen, die

    innerhalb des Maildirs erstellt werden sollen. Sollen innerhalb des

    Maildirs keine Verzeichnisse angelegt werden, ist dieser Optionen ein

    einzelner Doppelpunkt ('**:**') als Wert zuzuweisen.

    Sollen Verzeichnisse mit Unterverzeichnissen angelegt werden, ist ein

    einzelner Punkt ('**.**') als Separator zu verwenden.

``name`` : *String*

    Der Standard-Name des Maildir-Verzeichnisses im Verzeichnis des

    jeweiligen Anwenders.

Beispiel::

    [maildir]

    folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix

    name = Maildir

MISC

----

Im **misc**-Abschnitt werden verschiedene Einstellungen festgelegt.

``base_directory`` : *String*

    Alle Domain-Verzeichnisse werden innerhalb dieses Basis-Verzeichnisses

    angelegt.

``password_scheme`` : *String*

    Das zu verwendende Passwort-Schema (siehe auch: **dovecotpw -l**).

``gid_mail`` : *Int*

    Die numerische Gruppen-ID der Gruppe mail, bzw. der Gruppe aus

    `mail_privileged_group` der Datei *dovecot.conf*.

``transport`` : *String*

    Der Standard-Transport aller Domains und Konten. Siehe auch:

    **transport**\(5)

``dovecot_version`` : *Int*

    Die verketteten Major- und Minor-Teile der eingesetzten Dovecot-Version

    (siehe: **dovecot --version**).

    Wenn das Kommando **dovecot --version** zum Beispiel *1.1.18* ausgibt,

    ist dieser Option der Wert **11** zuzuweisen.

Beispiel::

    [misc]

    base_directory = /srv/mail

    password_scheme = CRAM-MD5

    gid_mail = 8

    transport = dovecot:

    dovecot_version = 11

DATEIEN

=======

*/root/vmm.cfg*

    | Wird verwendet, falls vorhanden.

*/usr/local/etc/vmm.cfg*

    | Wird verwendet, sollte obige Datei nicht gefunden werden.

*/etc/vmm.cfg*

    | Wird verwendet, falls obengenannte Dateien nicht existieren.

SIEHE AUCH

==========

vmm(1), Programm für die Kommandozeile, um E-Mail-Domains, -Konten und -Aliase

zu verwalten.

COPYING

=======

vmm und die dazugehörigen Manualseiten wurden von Pascal Volk geschrieben

und sind unter den Bedingungen der BSD Lizenz lizenziert.