VMM/cli/main: Adjusted to new argparse functionality.
.TH"VMM.CFG""5""2012-08-12""vmm 0.6""vmm".SHNAMEvmm.cfg \- Konfigurationsdatei für vmm.\" -----------------------------------------------------------------------.SHÜBERSICHTvmm.cfg.\" -----------------------------------------------------------------------.SHBESCHREIBUNG.BRvmm(1)liest seine Konfigurationsparameter aus der Datei.IRvmm.cfg..PPDie Konfigurationsdatei ist in mehrere Sektionen unterteilt.Jede Sektion wird mit dem in eckigen Klammern.RB'["' und '"]'eingefassten Namen der Sektion eingeleitet, gefolgt von.RI'Option" = "Wert'Einträgen..PPLeerräume um das Gleichheitszeichen '=' und am Ende eines Wertes werdenignoriert.Leerzeilen und Zeilen, die mit einer '#' oder einem ';' anfangen, werdenignoriert..PPJeder Wert ist von einem der folgenden Datentypen:.PP.TP8.IBooleanum festzulegen, ob etwas eingeschaltet/aktiviert (true) oderausgeschaltet/deaktiviert (false) ist..brMögliche Werte für.Itruesind:.BR1," yes"," true"" und "on..brMögliche Werte für.Ifalsesind:.BR0," no"," false"" und "off..TP.IInteine Integer\-Zahl, geschrieben ohne eine gebrochene oder dezimaleKomponente..brBeispielsweise.BR1," 50"" oder "321sind Integer\-Zahlen..TP.IStringeine Folge von Buchstaben und Zahlen..brZum Beispiel:.RB'Wort"', '""Hallo Welt""' oder '"/usr/bin/strings'.PPDie meisten Optionen haben einen Vorgabewert.Dieser ist nach dem Namen der Option in Klammern angegebenen.Um den Vorgabewert einer Option zu verwenden, wird die entsprechende Zeileentweder mit.BR#" oder ";auskommentiert oder die Zeile wird einfach aus der.Ivmm.cfgentfernt..PPEine minimale.Ivmm.cfgkönnte so aussehen:.PP.nf[database]user = ichpass = xxxxxxxx[misc]dovecot_version = 1.2.16.fi.\" -----------------------------------------------------------------------.SHSUCHREIHENFOLGEStandardmäßig sucht.BRvmm(1)die.Ivmm.cfgin folgenden Verzeichnissen, in der angegebenen Reihenfolge:.RS.PD0.TP.I/root.TP.I/usr/local/etc.TP.I/etc.PD.RE.PPDie zuerst gefundene Datei wird verwendet..\" -----------------------------------------------------------------------.SHSEKTIONACCOUNTDie Optionen der Sektion.Baccountlegen Konto\-spezifische Einstellungen fest..SSaccount.delete_directory.BRdelete_directory" (Vorgabe: false) :".IBoolean.PPBestimmt das Verhalten von.BRvmm(1)beim Löschen eines Kontos (userdelete).Wenn der Wert dieser Option.Itrueist, wird das Home\-Verzeichnis des zu löschenden Anwenders rekursivgelöscht..\" ------------------------------------.SSaccount.directory_mode.BRdirectory_mode" (Vorgabe: 448) :".IInt.PPZugriffsbits des Home\-Verzeichnisses, sowie aller enthaltenenVerzeichnisse, in Dezimal\-Schreibweise (Basis 10)..brBeispiel: 'drwx\-\-\-\-\-\-' \(-> oktal 0700 \(-> dezimal 448.\" ------------------------------------.SSaccount.disk_usage.BRdisk_usage" (Vorgabe: false) :".IBoolean.PPLegt fest, ob die Festplattenbelegung des Maildirs eines Benutzers jedesMal mit.BRdu(1)ermittelt und mit den Konto\-Informationen ausgegeben werden soll..PPBei umfangreichen Maildirs kann das langsam sein.Falls Sie Quotas aktiviert haben, wird der.BRvmm\-Unterbefehluserinfo ebenfalls die aktuelle Quota\-Nutzung des Kontos mit ausgegeben.Sie können auch eines der optionalen Argumente.BRdu" oder "fullan userinfo übergeben, um sich die aktuelle Festplattenbelegung anzeigen zulassen..\" ------------------------------------.SSaccount.password_length.BRpassword_length" (Vorgabe: 8) :".IInt.PPDiese Option legt die Anzahl der Zeichen für automatisch erzeugtePasswörter fest.Alle Werte kleiner als 8 werden auf 8 erhöht..\" ------------------------------------.SSaccount.random_password.BRrandom_password" (Vorgabe: false) :".IBoolean.PPMit dieser Option wird bestimmt, ob.BRvmm(1)ein zufälliges Passwort generieren soll, wenn kein Passwort an denUnterbefehl useradd übergeben wurde.Ist der Wert dieser Option.IRfalse,wird.BvmmSie auffordern, ein Passwort für den neuen Account einzugeben..PPSie können die Länge für automatisch generierte Passwörter mit der Option.Iaccount.password_lengthkonfigurieren..\" -----------------------------------------------------------------------.SHSEKTIONBINIn der.BRbin\-Sektionwerden die Pfade zu den von.BRvmm(1)benötigten Binaries angegeben..SSbin.dovecotpw.BRdovecotpw" (Vorgabe: /usr/sbin/dovecotpw) :".IString.PPDer absolute Pfad zum dovecotpw Binary.Geben Sie den absoluten Pfad zum.BRdoveadm(1)Binary an, falls Sie Dovecot v2.0 verwenden..PPDieses Binary wird zur Hash\-Erzeugung verwendet, wenn.Imisc.password_schemeeinen der nachfolgenden Werte hat: 'CRAM\-MD5', 'HMAC\-MD5', 'LANMAN',\(aqOTP', 'RPA' oder 'SKEY'.Dieses Binary wird auch benötigt, wenn Ihre Python\-Installation einen derfolgenden Hash\-Algorithmen nicht unterstützt:.IP\(bu4md4: (hashlib + OpenSSL oder PyCrypto) verwendet für die Passwort\-Schemen:\(aqPLAIN\-MD4' und 'NTLM'.IP\(busha256: (hashlib oder PyCrypto \(>= 2.1.0alpha1) verwendet für diePasswort\-Schemen: 'SHA256' und 'SSHA256'.IP\(busha512: (hashlib) verwendet für die Passwort\-Schemen: 'SHA512' und\(aqSSHA512'.PPDas.BRdoveadm(1)Binary wird auch gebraucht, um die INBOX und zusätzliche Mailboxen.RI(mailbox.folders)für einen neuen Account zu erstellen, wenn die Option.Imailbox.formatden Wert.BRmdbox" oder "sdboxhat..\" ------------------------------------.SSbin.du.BRdu" (Vorgabe: /usr/bin/du) :".IString.PPDer absolute Pfad zu.BRdu(1).Dieses Binary wird verwendet, wenn die Festplattenbelegung eines Kontosermittelt wird..\" ------------------------------------.SSbin.postconf.BRpostconf" (Vorgabe: /usr/sbin/postconf) :".IString.PPDer absolute Pfad zu Postfix'.BRpostconf(1).Dieses Binary wird verwendet, wenn.BRvmm(1)diverse Postfix\-Einstellungen prüft, zum Beispiel das.IRvirtual_alias_expansion_limit..\" -----------------------------------------------------------------------.SHSEKTIONDATABASEDie.BRdatabase\-Sektionwird verwendet, um die für den Datenbankzugriff erforderlichen Optionenfestzulegen..SSdatabase.host.BRhost" (Vorgabe: localhost) :".IString.PPDer Hostname oder die IP\-Adresse des Datenbankservers..\" ------------------------------------.SSdatabase.module.BRmodule" (Vorgabe: psycopg2) :".IString.PPDas für den Datenbankzugriff zu verwendende Python PostgreSQL AdapterModul.Unterstützte Module sind.BRpsycopg2" und "pyPgSQL..\" ------------------------------------.SSdatabase.name.BRname" (Vorgabe: mailsys) :".IString.PPDer Name der zu verwendenden Datenbank..\" ------------------------------------.SSdatabase.pass.BRpass" (Vorgabe: "None") :".IString.PPDas Passwort des Datenbank\-Benutzers..\" ------------------------------------.SSdatabase.port.BRport" (Vorgabe: 5432) :".IInt.PPDer TCP\-Port, auf dem der Datenbankserver Verbindungen annimmt..\" ------------------------------------.SSdatabase.sslmode.BRsslmode" (Vorgabe: prefer) :".IString.PPBestimmt, ob und mit welcher Priorität eine SSL\-Verbindung mit demDatenbankserver ausgehandelt wird.Mögliche Werte sind:.BRdisabled", "allow", "prefer", "require", "verify\-ca" und ".BRverify\-full.Die Modi.BRverify\-ca" und "verify\-fullstehen seit PostgreSQL 8.4 zur Verfügung..PPDiese Option wird ignoriert, wenn das.Idatabase.module.BpyPgSQLverwendet wird..\" ------------------------------------.SSdatabase.user.BRuser" (Vorgabe: "None") :".IString.PPDer Name des Datenbank\-Benutzers..\" -----------------------------------------------------------------------.SHSEKTIONDOMAINIn der.BRdomain\-Sektionwerden Domain\-spezifische Einstellungen hinterlegt..PPDas Quota\-Limit (quota_bytes und quota_messages), Service\-Einstellungen(imap, pop3, sieve und smtp) und der Transport werden angewendet, wenneine Domain angelegt wird.Um die Einstellungen einer vorhandenen Domain zu ändern, verwenden Sieeinen der folgenden.BRvmm(1)Unterbefehle:.PP.TP.Bdomainquotaum das Quota\-Limit einer Domain zu ändern.TP.Bdomainservicesum einer Domain einen abweichenden Satz von nutzbaren Services zuzuweisen.TP.Bdomaintransportum einen neuen Vorgabe\-Transport für eine Domain festzulegen.PPWenn ein Account angelegt wird, erbt er alle Einstellungen von der Domain,zu der er hinzugefügt wird.Abweichende Einstellungen für einen vorhandenen Account nehmen Sie miteinem der Unterbefehle.BRuserquota", "userservices" und "usertransportvor..\" ------------------------------------.SSdomain.auto_postmaster.BRauto_postmaster" (Vorgabe: true) :".IBoolean.PPIst der Wert dieser Option.IRtrue,wird.BRvmm(1)beim Anlegen einer Domain (domainadd) automatisch einen postmaster\-Accounterstellen..\" ------------------------------------.SSdomain.delete_directory.BRdelete_directory" (Vorgabe: false) :".IBoolean.PPLegt fest, ob beim Löschen einer Domain (domaindelete) das Verzeichnis derzu löschenden Domain, inklusive aller Anwender\-Verzeichnisse, rekursivgelöscht werden soll..\" ------------------------------------.SSdomain.directory_mode.BRdirectory_mode" (Vorgabe: 504) :".IInt.PPZugriffsbits des Domain\-Verzeichnisses in Dezimal\-Schreibweise(Basis 10)..brBeispiel: 'drwxrwx\-\-\-' \(-> oktal 0770 \(-> dezimal 504.\" ------------------------------------.SSdomain.force_deletion.BRforce_deletion" (Vorgabe: false) :".IBoolean.PPErzwingt das Löschen aller zugeordneten Konten und Aliase beim Löscheneiner Domain (domaindelete)..\" ------------------------------------.SSdomain.imap.BRimap" (Vorgabe: true) :".IBoolean.PPLegt fest, ob sich neu angelegte Benutzer per IMAP anmelden können sollen..\" ------------------------------------.SSdomain.pop3.BRpop3" (Vorgabe: true) :".IBoolean.PPLegt fest, ob sich neu angelegte Benutzer per POP3 anmelden können sollen..\" ------------------------------------.SSdomain.quota_bytes.BRquota_bytes" (Vorgabe: 0) :".IString.PPQuota Limit in Bytes.0 bedeutet unbegrenzt.Dieses Limit wird beim Anlegen von Domains angewendet..PPDer Wert dieser Option kann als Integer\-Wert, zum Beispiel.B20480geschrieben werden.Es ist auch möglich dem Wert eines der folgendenSuffixe anzuhängen:.BRb" (Bytes), "k" (Kilobytes), "M" (Megabytes) oder "G(Gigabytes)..br1024 entspricht 1024b oder 1k..\" ------------------------------------.SSdomain.quota_messages.BRquota_messages" (Vorgabe: 0) :".IInt.PPQuota Limit als Anzahl von Nachrichten.0 bedeutet unbegrenzt.Dieses Limit wird beim Anlegen neuer Domains angewendet..\" ------------------------------------.SSdomain.sieve.BRsieve" (Vorgabe: true) :".IBoolean.PPLegt fest, ob sich neu angelegte Benutzer per SIEVE (ManageSieve) anmeldenkönnen sollen..\" ------------------------------------.SSdomain.smtp.BRsmtp" (Vorgabe: true) :".IBoolean.PPLegt fest, ob sich neu angelegte Benutzer per SMTP (SMTP AUTH) anmeldenkönnen sollen..\" ------------------------------------.SSdomain.transport.BRtransport" (Vorgabe: dovecot:) :".IString.PPDer Standard\-Transport aller neuen Domains.Siehe auch:.BRtransport(5)..\" -----------------------------------------------------------------------.SHSEKTIONMAILBOXIn der.BRmailbox\-Sektionwerden die für die Erstellung von Mailboxen erforderlichen Optionenfestgelegt.Die INBOX wird in jedem Fall erstellt..SSmailbox.folders.BRfolders" (Vorgabe: Drafts:Sent:Templates:Trash) :".IString.PPEine durch Doppelpunkte getrennte Liste mit Namen der zu erstellendenMailboxen.Sollen keine zusätzlichen Mailboxen angelegt werden, ist dieser Option eineinzelner Doppelpunkt.RB(':')als Wert zuzuweisen..PPSollen Verzeichnisse mit Unterverzeichnissen angelegt werden, ist eineinzelner Punkt.RB('.')als Separator zu verwenden..PPSollen Mailboxen mit internationalisierten Namen erstellt werden (zumBeispiel: 'Wysłane' oder 'Gelöschte Objekte'), ist der Name UTF\-8 kodiertanzugeben..BRvmm(1)wird die internationalisierten Mailboxnamen in eine modifizierten Variantedes UTF\-7\-Zeichensatzes (siehe auch: RFC 3501, Sektion 5.1.3)konvertieren..\" ------------------------------------.SSmailbox.format.BRformat" (Vorgabe: maildir) :".IString.PPDas zu verwendende Mailbox\-Format für die Mailboxen der Benutzer.Abhängig von der verwendeten Dovecot\-Version.RI(misc.dovecot_version),unterstützt.BRvmm(1)bis zu drei Formate:.TP8.BmaildirDovecot \(>= v1.0.0.TP.BmdboxDovecot \(>= v2.0.beta5.TP.BsdboxDovecot \(>= v2.0.rc3.\" ------------------------------------.SSmailbox.root.BRroot" (Vorgabe: Maildir) :".IString.PPName des Mailbox\-Wurzelverzeichnisses im Home\-Verzeichnis des jeweiligenBenutzers.Übliche Namen, je nach verwendetem.IRmailbox.format,sind.BRMaildir", "mdbox" or "sdbox..\" ------------------------------------.SSmailbox.subscribe.BRsubscribe" (Vorgabe: true) :".IBoolean.PPWenn dieser Option der Wert.Btruezugewiesen wurde, werden die, gemäß.IRmailbox.folders,erstellen Mailboxen in der subscriptions\-Datei des Benutzers gelistet.Sollen die erstellen Mailboxen nicht nicht in der subscriptions\-Dateigelistet werden, weisen Sie dieser Option den Wert.Bfalsezu..\" -----------------------------------------------------------------------.SHSEKTIONMISCIn der.BRmisc\-Sektionwerden Einstellungen für verschiedene Bereiche festgelegt..SSmisc.base_directory.BRbase_directory" (Vorgabe: /srv/mail) :".IString.PPAlle Domain\-Verzeichnisse werden innerhalb dieses Basis\-Verzeichnissesangelegt..\" ------------------------------------.SSmisc.crypt_blowfish_rounds.BRcrypt_blowfish_rounds" (Vorgabe: 5) :".IInt.PPAnzahl der Verschlüsselungsdurchgänge für das.Ipassword_scheme.BRBLF\-CRYPT..PPDer Wert muss im Bereich von.BR4" \- "31liegen..\" ------------------------------------.SSmisc.crypt_sha256_rounds.BRcrypt_sha256_rounds" (Vorgabe: 5000) :".IInt.PPAnzahl der Verschlüsselungdurchgänge für das.Ipassword_scheme.BRSHA256\-CRYPT..PPDer Wert muss im Bereich von.BR1000" \- "999999999liegen..\" ------------------------------------.SSmisc.crypt_sha512_rounds.BRcrypt_sha512_rounds" (Vorgabe: 5000) :".IInt.PPAnzahl der Verschlüsselungdurchgänge für das.Ipassword_scheme.BRSHA512\-CRYPT..PPDer Wert muss im Bereich von.BR1000" \- "999999999liegen..\" ------------------------------------.SSmisc.dovecot_version.BRdovecot_version" (Vorgabe: "None") :".IString.PPDie aktuell eingesetzte Dovecot\-Version.(siehe:.BR"dovecot \-\-version").Wenn das Kommando.Bdovecot\-\-versionzum Beispiel.I2.0.beta4(8818db00d347)ausgibt, ist dieser Option der Wert.B2.0.beta4zuzuweisen..\" ------------------------------------.SSmisc.password_scheme.BRpassword_scheme" (Vorgabe: CRAM\-MD5) :".IString.PPDas zu verwendende Passwort\-Schema.Um eine Liste aller verwendbaren Passwort\-Schemen zu erhalten, führen Siedas Kommando.Bvmmlpaus..PPSeit Dovecot \(>= v1.1.alpha1 ist es möglich, dem.Ipassword_schemeein Encoding\-Suffix anzufügen.Unterstützte Encoding\-Suffixe:.BR.b64", ".base64" und ".hex.Beispiel: PLAIN.BASE64.\" -----------------------------------------------------------------------.SHBEISPIELEine Beispiel\-Konfiguration.Alle Optionen, die nicht in der Konfigurationsdatei gelistet sind, habenihren Vorgabewert..PP.nf[account]password_length = 10random_password = true[bin]dovecotpw = /usr/bin/doveadm[database]host = dbsrv8.example.netpass = PY_SRJ}L/0p\-oOkport = 5433sslmode = requireuser = vmm[domain]quota_bytes = 500Mquota_messages = 10000transport = lmtp:unix:private/dovecot\-lmtp[mailbox]folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix[misc]crypt_sha512_rounds = 10000dovecot_version = 2.0.beta4password_scheme = SHA512\-CRYPT.hex.fi.\" -----------------------------------------------------------------------.SHSIEHEAUCH.BRpostconf(1),.BRvmm(1),.BRtransport(5).\" -----------------------------------------------------------------------.SHINTERNETRESSOURCEN.TPHomepagehttp://vmm.localdomain.org/.TPProjekt\-Seitehttp://sf.net/projects/vmm/.TPBugtrackerhttps://bitbucket.org/pvo/vmm/issues.\" -----------------------------------------------------------------------.SHCOPYINGvmm und die dazugehörigen Manualseiten wurden von Pascal Volk <user+vmm ATlocalhost.localdomain.org> geschrieben und sind unter den Bedingungen derBSD Lizenz lizenziert.