man/man5/vmm.cfg.5.rst
author Pascal Volk <neverseen@users.sourceforge.net>
Sun, 04 Jul 2010 16:41:34 +0000
branchv0.6.x
changeset 295 18086c6a2521
parent 291 7ef3f117a230
child 299 d15a27eaa9d2
permissions -rw-r--r--
VMM/maillocation: Code cleanups. Fixed error introduced with changeset 084300a00ee1.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     1
=========
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     2
 vmm.cfg
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     3
=========
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     4
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     5
--------------------------
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     6
configuration file for vmm
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     7
--------------------------
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     8
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     9
:Author:         Pascal Volk <neverseen@users.sourceforge.net>
269
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
    10
:Date:           |today|
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    11
:Version:        vmm-0.6.0
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    12
:Manual group:   vmm Manual
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    13
:Manual section: 5
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    14
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    15
.. contents::
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    16
  :backlinks: top
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    17
  :class: htmlout
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    18
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    19
SYNOPSIS
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    20
========
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    21
vmm.cfg
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    22
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    23
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    24
DESCRIPTION
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    25
===========
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    26
|vmm(1)|_ reads its configuration data from *vmm.cfg*.
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    27
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    28
The configuration file is split into multiple sections. A section starts with
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    29
the section name, enclosed in square brackets '**[**' and '**]**', followed
177
ec2e1df8bb10 man/{,de/}man5: added a note about how to use default settings.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 176
diff changeset
    30
by '*option* = *value*' pairs.
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    31
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    32
Whitespace around the '=' and at the end of a value is ignored.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    33
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    34
Empty lines and lines starting with '#' or ';' will be ignored.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    35
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    36
Each value uses one of the following data types:
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    37
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    38
* *Boolean* to indicate if something is enabled/activated (true) or
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    39
  disabled/deactivated (false).
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    40
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    41
  | Accepted values for *true* are: **1**, **yes**, **true** and **on**.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    42
  | Accepted values for *false* are: **0**, **no**, **false** and **off**.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    43
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    44
* *Int* an integer number, written without a fractional or decimal component.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    45
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    46
  | For example **1**, **50** or **321** are integers.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    47
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    48
* *String* a sequence of characters and numbers.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    49
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    50
  | For example '**word**', '**hello world**' or '**/usr/bin/strings**'
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    51
177
ec2e1df8bb10 man/{,de/}man5: added a note about how to use default settings.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 176
diff changeset
    52
Most options have a default value, shown in parentheses after the option's
ec2e1df8bb10 man/{,de/}man5: added a note about how to use default settings.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 176
diff changeset
    53
name. In order to use a option's default setting, comment out the line,
ec2e1df8bb10 man/{,de/}man5: added a note about how to use default settings.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 176
diff changeset
    54
either with a **#** or **;** or simply remove the setting from *vmm.cfg*.
ec2e1df8bb10 man/{,de/}man5: added a note about how to use default settings.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 176
diff changeset
    55
ec2e1df8bb10 man/{,de/}man5: added a note about how to use default settings.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 176
diff changeset
    56
A minimal *vmm.cfg* would be::
ec2e1df8bb10 man/{,de/}man5: added a note about how to use default settings.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 176
diff changeset
    57
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    58
  [database]
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    59
  user = me
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    60
  pass = xxxxxxxx
177
ec2e1df8bb10 man/{,de/}man5: added a note about how to use default settings.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 176
diff changeset
    61
288
01cb71c1ae33 man5: added misc.dovecot_version to the minimal config example.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 286
diff changeset
    62
  [misc]
01cb71c1ae33 man5: added misc.dovecot_version to the minimal config example.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 286
diff changeset
    63
  dovecot_version = 1.2.11
01cb71c1ae33 man5: added misc.dovecot_version to the minimal config example.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 286
diff changeset
    64
177
ec2e1df8bb10 man/{,de/}man5: added a note about how to use default settings.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 176
diff changeset
    65
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    66
SEARCH ORDER
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    67
-------------
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    68
By default |vmm(1)|_ looks for *vmm.cfg* in the following directories in the
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    69
order listed:
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    70
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    71
  | */root*
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    72
  | */usr/local/etc*
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    73
  | */etc*
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    74
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    75
The first configuration file found will be used.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    76
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    77
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    78
SECTIONS
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    79
========
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    80
This section describes all sections and their options of the *vmm.cfg*.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    81
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    82
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    83
ACCOUNT
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    84
-------
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    85
The options in the section **account** are used to specify user account
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    86
related settings.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    87
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    88
.. _account.delete_directory:
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    89
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    90
``delete_directory (default: false)`` : *Boolean*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    91
  Determines the behavior of |vmm(1)|_ when an account is deleted
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    92
  (|userdelete|_). If this option is set to *true* the user's home directory
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    93
  will be deleted  recursively.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    94
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    95
.. _account.directory_mode:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    96
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    97
``directory_mode (default: 448)`` : *Int*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    98
  Access mode for a user's home directory and all directories inside. The
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
    99
  value has to be specified in decimal (base 10) notation.
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   100
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   101
  | For example: 'drwx------' -> octal 0700 -> decimal 448
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   102
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   103
.. _account.disk_usage:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   104
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   105
``disk_usage (default: false)`` : *Boolean*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   106
  Determines whether the disk usage of a user's Maildir always should be
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   107
  summarized, using **du**\(1), and displayed with account information.
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   108
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   109
  This could be slow on large Maildirs. When you have enabled quotas,
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   110
  **vmm**'s |userinfo|_ subcomammand will also display the current quota
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   111
  usage of the account. You may also use |userinfo|_'s optional argument
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   112
  **du** or **full**, in order to display the current disk usage of an
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   113
  account's Maildir.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   114
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   115
.. _account.imap:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   116
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   117
``imap (default: true)`` : *Boolean*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   118
  Determines whether a newly created user can log in via IMAP.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   119
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   120
.. _account.password_length:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   121
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   122
``password_length (default: 8)`` : *Int*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   123
  Determines how many characters and/or numbers should be used for randomly
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   124
  generated passwords. Any value less than 8 will be increased to 8.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   125
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   126
.. _account.pop3:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   127
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   128
``pop3 (default: true)`` : *Boolean*
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   129
    Determines whether a newly created user can log in via POP3.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   130
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   131
.. _account.random_password:
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   132
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   133
``random_password (default: false)`` : *Boolean*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   134
  Determines whether **vmm** should generate a random password when no
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   135
  password was given for the |useradd|_ subcommand. If this option is set to
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   136
  *false* **vmm** will prompt you to enter a password for the new account.
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   137
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   138
  You can specify the password length of generated passwords with the
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   139
  |account.password_length|_ option.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   140
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   141
.. _account.sieve:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   142
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   143
``sieve (default: true)`` : *Boolean*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   144
  Determines whether a newly created user can log in via ManageSieve.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   145
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   146
.. _account.smtp:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   147
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   148
``smtp (default: true)`` : *Boolean*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   149
  Determines whether a newly created user can log in via SMTP (SMTP AUTH).
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   150
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   151
Example::
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   152
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   153
  [account]
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   154
  delete_directory = false
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   155
  directory_mode = 448
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   156
  disk_usage = false
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   157
  random_password = true
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   158
  password_length = 10
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   159
  smtp = true
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   160
  pop3 = true
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   161
  imap = true
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   162
  sieve = true
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   163
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   164
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   165
BIN
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   166
---
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   167
The **bin** section is used to specify some paths to some binaries required
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   168
by |vmm(1)|_.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   169
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   170
.. _bin.dovecotpw:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   171
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   172
``dovecotpw (default: /usr/sbin/dovecotpw)`` : *String*
269
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   173
  The absolute path to the dovecotpw binary. Use the absolute path to the
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   174
  doveadm binary, if you are using Dovecot v2.0. This binary is used to
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   175
  generate a password hash, if |misc.password_scheme|_ is set to one of
269
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   176
  'CRAM-MD5', 'HMAC-MD5', 'LANMAN', 'OTP', 'RPA' or 'SKEY'. This binary will
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   177
  be also required if your Python installation doesn't support the:
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   178
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   179
  * md4 hash algorithm (hashlib + OpenSSL or PyCrypto) used for the password
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   180
    schemes: 'PLAIN-MD4' and 'NTLM'
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   181
  * sha256 hash algorithm (hashlib or PyCrypto >= 2.1.0alpha1) used for the
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   182
    password schemes: 'SHA256' and 'SSHA256'
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   183
  * sha512 hash algorithm (hashlib) used for the password schemes 'SHA512'
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   184
    and 'SSHA512'
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   185
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   186
.. _bin.du:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   187
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   188
``du (default: /usr/bin/du)`` : *String*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   189
  The absolute path to **du**\(1). This binary is used to summarize the disk
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   190
  usage of a user's Maildir.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   191
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   192
.. _bin.postconf:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   193
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   194
``postconf (default: /usr/sbin/postconf)`` : *String*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   195
  The absolute path to Postfix' |postconf(1)|_. This binary is required when
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   196
  |vmm(1)|_ has to check for some Postfix settings, e.g.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   197
  |virtual_alias_expansion_limit|_.
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   198
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   199
Example::
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   200
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   201
  [bin]
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   202
  dovecotpw = /usr/sbin/dovecotpw
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   203
  du = /usr/bin/du
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   204
  postconf = /usr/sbin/postconf
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   205
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   206
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   207
DATABASE
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   208
--------
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   209
The **database** section is used to specify some options required to
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   210
connect to the database.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   211
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   212
.. _database.host:
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   213
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   214
``host (default: localhost)`` : *String*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   215
  Hostname or IP address of the database server.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   216
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   217
.. _database.name:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   218
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   219
``name (default: mailsys)`` : *String*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   220
  Name of the database.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   221
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   222
.. _database.pass:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   223
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   224
``pass (default: None)`` : *String*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   225
  Database password.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   226
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   227
.. _database.user:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   228
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   229
``user (default: None)`` : *String*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   230
  Name of the database user.
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   231
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   232
Example::
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   233
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   234
  [database]
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   235
  host = localhost
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   236
  user = vmm
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   237
  pass = PY_SRJ}L/0p-oOk
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   238
  name = mailsys
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   239
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   240
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   241
DOMAIN
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   242
------
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   243
The **domain** section specifies some domain related settings.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   244
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   245
.. _domain.auto_postmaster:
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   246
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   247
``auto_postmaster (default: true)`` : *Boolean*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   248
  Determines if |vmm(1)|_ should create also a postmaster account when a new
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   249
  domain is created (|domainadd|_).
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   250
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   251
.. _domain.delete_directory:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   252
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   253
``delete_directory (default: false)`` : *Boolean*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   254
  Specifies whether the domain directory and all user directories inside
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   255
  should be deleted when a domain is deleted (|domaindelete|_).
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   256
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   257
.. _domain.directory_mode:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   258
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   259
``directory_mode (default: 504)`` : *Int*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   260
  Access mode for the domain directory in decimal (base 10) notation.
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   261
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   262
  | For example: 'drwxrwx---' -> octal 0770 -> decimal 504
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   263
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   264
.. _domain.force_deletion:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   265
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   266
``force_deletion (default: false)`` : *Boolean*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   267
  Force deletion of accounts and aliases when a domain is deleted
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   268
  (|domaindelete|_).
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   269
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   270
Example::
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   271
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   272
  [domain]
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   273
  auto_postmaster = true
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   274
  delete_directory = false
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   275
  directory_mode = 504
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   276
  force_deletion = false
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   277
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   278
230
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   279
MAILBOX
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   280
-------
230
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   281
The **mailbox** section is used to specify some options for new created
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   282
mailboxes in the users home directories. The INBOX will be created always.
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   283
230
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   284
.. _mailbox.folders:
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   285
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   286
``folders (default: Drafts:Sent:Templates:Trash)`` : *String*
230
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   287
  A colon separated list of mailboxes that should be created. (Works currently
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   288
  only if the |mailbox.format|_ is either **maildir** or **mbox**. For other
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   289
  formats use Dovecot's autocreate plugin
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   290
  <http://wiki.dovecot.org/Plugins/Autocreate>.) If no additionally mailboxes
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   291
  should be created, set the value of this option to a single colon ('**:**').
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   292
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   293
  If you want to create folders containing one or more subfolders, separate
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   294
  them with a single dot ('**.**').
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   295
230
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   296
.. _mailbox.format:
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   297
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   298
``format (default: maildir)`` : *String*
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   299
  The mailbox format to be used for a user's mailbox. Depending on the used
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   300
  Dovecot version there are up to four supported formats:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   301
230
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   302
    ``maildir``
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   303
      since Dovecot v1.0.0
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   304
    ``mbox``
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   305
      since Dovecot v1.0.0
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   306
    ``dbox``
269
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   307
      since Dovecot v1.0.0
230
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   308
    ``mdbox``
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   309
      comes with Dovecot v2.0.0
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   310
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   311
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   312
Example::
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   313
230
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   314
  [mailbox]
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   315
  folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix
230
eefbe052a135 man: updated configuration manual pages (maildir.* -> mailbox.*).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 180
diff changeset
   316
  format = maildir
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   317
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   318
.. _imap_uft7:
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   319
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   320
.. note:: If you want to use internationalized mailbox names in the
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   321
  **folders** setting, you have to specify them in a modified version of the
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   322
  UTF-7 encoding (see :RFC:`3501`, section 5.1.3).
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   323
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   324
  Dovecot provides a useful utility for mUTF-7 <-> UTF-8 conversion:
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   325
  **imap-utf7**, it's available since Dovecot version 1.2.0.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   326
..
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   327
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   328
imap-utf7 example::
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   329
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   330
  user@host:~$ /usr/local/libexec/dovecot/imap-utf7 -r Wysłane
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   331
  Wys&AUI-ane
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   332
  user@host:~$ /usr/local/libexec/dovecot/imap-utf7 "&AVo-mietnik"
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   333
  Śmietnik
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   334
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   335
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   336
MISC
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   337
----
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   338
The **misc** section is used to define miscellaneous settings.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   339
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   340
.. _misc.base_directory:
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   341
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   342
``base_directory (default: /srv/mail)`` : *String*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   343
  All domain directories will be created inside this directory.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   344
284
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   345
.. _misc.crypt_blowfish_rounds:
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   346
291
7ef3f117a230 VMM/password: adapted Blowfish/SHA-256/SHA-512 crypt() to recent
Pascal Volk <neverseen@users.sourceforge.net>
parents: 288
diff changeset
   347
``crypt_blowfish_rounds (default: 5)`` : *Int*
7ef3f117a230 VMM/password: adapted Blowfish/SHA-256/SHA-512 crypt() to recent
Pascal Volk <neverseen@users.sourceforge.net>
parents: 288
diff changeset
   348
  Number of encryption rounds for the *password_scheme* **BLF-CRYPT**.
284
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   349
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   350
  The value must be in range **4** - **31**.
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   351
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   352
.. _misc.crypt_sha256_rounds:
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   353
291
7ef3f117a230 VMM/password: adapted Blowfish/SHA-256/SHA-512 crypt() to recent
Pascal Volk <neverseen@users.sourceforge.net>
parents: 288
diff changeset
   354
``crypt_sha256_rounds (default: 5000)`` : *Int*
7ef3f117a230 VMM/password: adapted Blowfish/SHA-256/SHA-512 crypt() to recent
Pascal Volk <neverseen@users.sourceforge.net>
parents: 288
diff changeset
   355
  Number of encryption rounds for the *password_scheme* **SHA256-CRYPT**.
284
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   356
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   357
  The value must be in range **1000** - **999999999**.
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   358
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   359
.. _misc.crypt_sha512_rounds:
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   360
291
7ef3f117a230 VMM/password: adapted Blowfish/SHA-256/SHA-512 crypt() to recent
Pascal Volk <neverseen@users.sourceforge.net>
parents: 288
diff changeset
   361
``crypt_sha512_rounds (default: 5000)`` : *Int*
7ef3f117a230 VMM/password: adapted Blowfish/SHA-256/SHA-512 crypt() to recent
Pascal Volk <neverseen@users.sourceforge.net>
parents: 288
diff changeset
   362
  Number of encryption rounds for the *password_scheme* **SHA512-CRYPT**.
284
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   363
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   364
  The value must be in range **1000** - **999999999**.
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   365
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   366
.. _misc.password_scheme:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   367
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   368
``password_scheme (default: CRAM-MD5)`` : *String*
269
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   369
  Password scheme to use. To get a list of all available password schemes
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   370
  execute the command **dovecotpw -l** (Dovecot v1.x) or **doveadm pw -l**
188ea8d6072f man/{,de/}man5/vmm.cfg.5.rst: Updated descriptions of dovecotpw
Pascal Volk <neverseen@users.sourceforge.net>
parents: 264
diff changeset
   371
  (Dovecot v2.0).
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   372
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   373
.. _misc.transport:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   374
176
cc0d79842fdf man: Added used default values to manual.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   375
``transport (default: dovecot:)`` : *String*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   376
  Default transport for domains and accounts. For details see
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   377
  |transport(5)|_.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   378
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   379
.. _misc.dovecot_version:
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   380
286
e2046d47688b VMM/Config: removed the default value of misc.dovecot_version.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 284
diff changeset
   381
``dovecot_version (default: None)`` : *String*
264
04fea4d8b900 Use the complete Dovecot version, not only the concatenated major
Pascal Volk <neverseen@users.sourceforge.net>
parents: 230
diff changeset
   382
  The version number of the currently used Dovecot version.
04fea4d8b900 Use the complete Dovecot version, not only the concatenated major
Pascal Volk <neverseen@users.sourceforge.net>
parents: 230
diff changeset
   383
  (see: **dovecot --version**).
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   384
264
04fea4d8b900 Use the complete Dovecot version, not only the concatenated major
Pascal Volk <neverseen@users.sourceforge.net>
parents: 230
diff changeset
   385
  When, for example, the command **dovecot --version** prints
04fea4d8b900 Use the complete Dovecot version, not only the concatenated major
Pascal Volk <neverseen@users.sourceforge.net>
parents: 230
diff changeset
   386
  *2.0.beta4 (8818db00d347)*, set the value of this option to **2.0.beta4**.
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   387
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   388
Example::
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   389
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   390
  [misc]
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   391
  base_directory = /srv/mail
284
ec1966828246 VMM/password: Added support Blowfish/SHA-256/SHA-512 crypt().
Pascal Volk <neverseen@users.sourceforge.net>
parents: 270
diff changeset
   392
  crypt_sha512_rounds = 10000
291
7ef3f117a230 VMM/password: adapted Blowfish/SHA-256/SHA-512 crypt() to recent
Pascal Volk <neverseen@users.sourceforge.net>
parents: 288
diff changeset
   393
  password_scheme = SHA512-CRYPT
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   394
  transport = dovecot:
264
04fea4d8b900 Use the complete Dovecot version, not only the concatenated major
Pascal Volk <neverseen@users.sourceforge.net>
parents: 230
diff changeset
   395
  dovecot_version = 2.0.beta4
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   396
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   397
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   398
FILES
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   399
=====
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   400
*/root/vmm.cfg*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   401
  | will be used when found.
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   402
*/usr/local/etc/vmm.cfg*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   403
  | will be used when the above file doesn't exist.
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   404
*/etc/vmm.cfg*
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   405
  | will be used when none of the both above mentioned files exists.
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   406
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   407
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   408
SEE ALSO
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   409
========
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   410
|vmm(1)|_
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   411
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   412
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   413
COPYING
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   414
=======
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   415
vmm and its manual pages were written by Pascal Volk and are licensed under
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   416
the terms of the BSD License.
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   417
179
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   418
.. include:: ../substitute_links.rst
3d09c657e9e5 man: updated documentation …
Pascal Volk <neverseen@users.sourceforge.net>
parents: 177
diff changeset
   419
.. include:: ../substitute_links_5.rst