1 =========

     2  vmm.cfg

     3 =========

     4 

     5 ---------------------------

     6 Konfigurationsdatei für vmm

     7 ---------------------------

     8 

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

    10 :Date:           2010-01-18

    11 :Version:        vmm-0.6.0

    12 :Manual group:   vmm Manual

    13 :Manual section: 5

    14 

    15 .. contents::

    16     :backlinks: top

    17     :class: htmlout

    18 

    19 SYNOPSIS

    20 ========

    21 vmm.cfg

    22 

    23 BESCHREIBUNG

    24 ============

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

    26 

    27 Die Konfigurationsdatei ist in mehrere Abschnitte unterteilt. Jeder Abschnitt

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

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

    30 

    31     [database]

    32     host = 127.0.0.1

    33 

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

    35 ignoriert.

    36 

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

    38 ignoriert.

    39 

    40 Jeder Wert ist von einem der folgenden Datentypen:

    41 

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

    43   ausgeschaltet/deaktiviert (false) ist.

    44 

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

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

    47 

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

    49   Komponente.

    50 

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

    52 

    53 * *String* eine Folge von Buchstaben und Zahlen.

    54 

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

    56 

    57 

    58 SUCHREIHENFOLGE

    59 ---------------

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

    61 in der angegebenen Reihenfolge:

    62 

    63     | */root*

    64     | */usr/local/etc*

    65     | */etc*

    66 

    67 Die zuerst gefundene Datei wird verwendet.

    68 

    69 ABSCHNITTE

    70 ==========

    71 Dieser Abschnitt beschreibt alle Abschnitte, sowie deren Optionen, der

    72 *vmm.cfg*.

    73 

    74 ACCOUNT

    75 -------

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

    77 Einstellungen fest.

    78 

    79 ``delete_directory`` : *Boolean*

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

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

    82     zu löschenden Anwenders rekursiv gelöscht.

    83 

    84 ``directory_mode`` : *Int*

    85     Zugriffsbits des Home-Verzeichnisses, sowie aller enthaltenen

    86     Verzeichnisse, in Dezimal-Schreibweise (Basis 10).

    87 

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

    89 

    90 ``disk_usage`` : *Boolean*

    91     Legt fest, ob die Festplattenbelegung des Maildirs eines Benutzers jedes

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

    93     werden soll.

    94 

    95     Bei umfangreichen Maildirs kann das langsam sein. Falls Sie Quotas

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

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

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

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

   100 

   101 ``imap`` : *Boolean*

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

   103 

   104 ``password_length`` : *Int*

   105     Legt fest, wie viele Zahlen und/oder Buchstaben für ein automatisch

   106     erzeugtes Passwort verwendet werden sollen. Alle Werte kleiner als 8

   107     werden auf 8 erhöht.

   108 

   109 ``pop3``

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

   111 

   112 ``random_password`` : *Boolean*

   113     Mit dieser Option bestimmen Sie, ob **vmm**\(1) ein zufälliges Passwort

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

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

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

   117 

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

   119     Option **password_length** konfigurieren.

   120 

   121 ``sieve`` : *Boolean*

   122     Bestimmt, ob sich neu angelegte Benutzer per ManageSieve anmelden

   123     können sollen.

   124 

   125 ``smtp`` : *Boolean*

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

   127     können sollen.

   128 

   129 Beispiel::

   130 

   131     [account]

   132     delete_directory = false

   133     directory_mode = 448

   134     disk_usage = false

   135     random_password = true

   136     password_length = 10

   137     smtp = true

   138     pop3 = true

   139     imap = true

   140     sieve = true

   141 

   142 BIN

   143 ---

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

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

   146 

   147 ``dovecotpw`` : *String*

   148     Der absolute Pfad zum dovecotpw Binary. Dieses Binary wird zur

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

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

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

   152 

   153 ``du`` : *String*

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

   155     die Festplattenbelegung eines Kontos ermittelt wird.

   156 

   157 ``postconf`` : *String*

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

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

   160     Beispiel das `virtual_alias_expansion_limit`.

   161 

   162 Beispiel::

   163 

   164     [bin]

   165     dovecotpw = /usr/sbin/dovecotpw

   166     du = /usr/bin/du

   167     postconf = /usr/sbin/postconf

   168 

   169 CONFIG

   170 ------

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

   172 Steuerungs-Abschnitt.

   173 

   174 ``done`` : *Boolean*

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

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

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

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

   179     Wert dieser Option automatisch auf *true* gesetzt.

   180 

   181     Sollte diese Option den Wert *false* zugewiesen haben, so startet

   182     **vmm**\(1) beim nächsten Aufruf im interaktiven Konfigurations-Modus.

   183 

   184 Beispiel::

   185 

   186     [config]

   187     done = true

   188 

   189 DATABASE

   190 --------

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

   192 benötigten Optionen festzulegen.

   193 

   194 ``host`` : *String*

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

   196 

   197 ``name`` : *String*

   198     Name der zu verwendenden Datenbank.

   199 

   200 ``pass`` : *String*

   201     Das Passwort des Datenbank-Benutzers.

   202 

   203 ``user`` : *String*

   204     Der Name des Datenbank-Benutzers.

   205 

   206 Beispiel::

   207 

   208     [database]

   209     host = localhost

   210     user = vmm

   211     pass = PY_SRJ}L/0p-oOk

   212     name = mailsys

   213 

   214 DOMAIN

   215 ------

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

   217 

   218 ``auto_postmaster`` : *Boolean*

   219     Setzen Sie den Wert dieser Option auf *true*, wenn **vmm**\(1)

   220     automatisch einen postmaster-Account erstellen soll, wenn Sie eine neue

   221     Domain anlegen.

   222 

   223 ``delete_directory`` : *Boolean*

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

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

   226 

   227 ``directory_mode`` : *Int*

   228     Zugriffsbits des Domain-Verzeichnisses in Dezimal-Schreibweise (Basis

   229     10).

   230 

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

   232 

   233 ``force_deletion`` : *Boolean*

   234     Legt fest, ob beim Löschen einer Domain alle vorhanden Konten und/oder

   235     Aliase, ohne Nachfrage, gelöscht werden sollen.

   236 

   237 Beispiel::

   238 

   239     [domain]

   240     auto_postmaster = true

   241     delete_directory = false

   242     directory_mode = 504

   243     force_deletion = false

   244 

   245 MAILDIR

   246 -------

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

   248 festgelegt.

   249 

   250 ``folders`` : *String*

   251     Eine durch Doppelpunkten getrennte Liste mit Verzeichnisnamen, die

   252     innerhalb des Maildirs erstellt werden sollen. Sollen innerhalb des

   253     Maildirs keine Verzeichnisse angelegt werden, ist dieser Optionen ein

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

   255 

   256     Wenn Sie Verzeichnisse mit Unterverzeichnissen anlegen wollen,

   257     verwendenden Sie einen einzelnen Punkt ('**.**') als Separator.

   258 

   259 ``name`` : *String*

   260     Standard-Name des Maildir-Verzeichnisses im Verzeichnis des jeweiligen

   261     Anwenders.

   262 

   263 Beispiel::

   264 

   265     [maildir]

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

   267     name = Maildir

   268 

   269 MISC

   270 ----

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

   272 

   273 ``base_directory`` : *String*

   274     Alle Domain-Verzeichnisse werden innerhalb dieses Basis-Verzeichnisses

   275     angelegt.

   276 

   277 ``password_scheme`` : *String*

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

   279 

   280 ``gid_mail`` : *Int*

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

   282     `mail_privileged_group` der Datei *dovecot.conf*.

   283 

   284 ``transport`` : *String*

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

   286     **transport**\(5)

   287 

   288 ``dovecot_version`` : *Int*

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

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

   291 

   292     Diese Option beeinflusst diverse Datenbankzugriffe. Da es zwischen

   293     Dovecot v1.1.x und v1.2.x einige Änderungen gab. Zum Beispiel **11**,

   294     falls **dovecot --version** den Wert 1.1.18 ausgibt.

   295 

   296 Beispiel::

   297 

   298     [misc]

   299     base_directory = /srv/mail

   300     password_scheme = CRAM-MD5

   301     gid_mail = 8

   302     transport = dovecot:

   303     dovecot_version = 11

   304 

   305 DATEIEN

   306 =======

   307 */root/vmm.cfg*

   308     | Wird verwendet, falls vorhanden.

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

   310     | Wird verwendet, sollte obige Datei nicht gefunden werden.

   311 */etc/vmm.cfg*

   312     | Wird verwendet, falls obengenannte Dateien nicht existieren.

   313 

   314 SIEHE AUCH

   315 ==========

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

   317 zu verwalten.

   318 

   319 COPYING

   320 =======

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

   322 und sind unter den Bedingungen der BSD Lizenz lizenziert.

   323