man/man5/vmm.cfg.5
author Pascal Volk <user@localhost.localdomain.org>
Thu, 23 Aug 2012 21:27:33 +0000
changeset 593 3dc1764c23d2
parent 588 dcde0010cdf8
child 694 b1bfd4d1d9c0
child 732 fae6a42add07
permissions -rw-r--r--
VMM/cli/subcommands: Added 'missing' newline below domain notes. This patch contains also a small code cleanup and PEP8-fix.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
588
dcde0010cdf8 man/{de/}man5: s/Wiki/Homepage/g
Pascal Volk <user@localhost.localdomain.org>
parents: 554
diff changeset
     1
.TH "VMM.CFG" "5" "2012-08-12" "vmm 0.6" "vmm"
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     2
.SH NAME
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     3
vmm.cfg \- configuration file for vmm
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
     4
.\" -----------------------------------------------------------------------
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     5
.SH SYNOPSIS
94
0d303d15549e * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 86
diff changeset
     6
vmm.cfg
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
     7
.\" -----------------------------------------------------------------------
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     8
.SH DESCRIPTION
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
     9
.BR vmm (1)
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    10
reads its configuration data from
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    11
.IR vmm.cfg .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    12
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    13
The configuration file is split into multiple sections.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    14
A section starts with the section name, enclosed in square brackets
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    15
.RB ` [ "' and `" ] ',
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    16
followed by
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    17
.RI ` option " = " value '
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    18
pairs.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    19
.br
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    20
Whitespace around the `=' and at the end of a value is ignored.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    21
Empty lines and lines starting with `#' or `;' will be ignored.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    22
.PP
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    23
Each value uses one of the following data types:
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    24
.TP 8
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    25
.I Boolean
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    26
to indicate if something is enabled/activated (true) or
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    27
disabled/deactivated (false).
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    28
.br
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    29
Accepted values for
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    30
.I true
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    31
are:
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    32
.BR 1 , " yes" , " true" " and " on .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    33
.br
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    34
Accepted values for
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    35
.I false
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    36
are:
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    37
.BR 0 , " no" , " false" " and " off .
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    38
.TP
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    39
.I Int
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    40
an integer number, written without a fractional or decimal component.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    41
.br
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    42
For example
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    43
.BR 1 , " 50" " or " 321
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    44
are integers.
94
0d303d15549e * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 86
diff changeset
    45
.TP
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    46
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    47
a sequence of characters and/or numbers.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    48
.br
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    49
For example
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    50
.RB ` word "', `" "hello world" "' or `" /usr/bin/strings '
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    51
are strings.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    52
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    53
Most options have a default value, shown in parentheses after the option's
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    54
name.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    55
In order to use a option's default setting, comment out the line, either
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    56
with a
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    57
.BR # " or " ;
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    58
or simply remove the setting from
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    59
.IR vmm.cfg .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    60
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    61
A minimal
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    62
.I vmm.cfg
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    63
would be:
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    64
.PP
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    65
.nf
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    66
[database]
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    67
user = me
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    68
pass = xxxxxxxx
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    69
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    70
[misc]
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    71
dovecot_version = 1.2.16
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    72
.fi
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    73
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    74
.SH SEARCH ORDER
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    75
By default
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    76
.BR vmm (1)
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    77
looks for the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    78
.I vmm.cfg
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    79
file in the following directories in the order listed:
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    80
.RS
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    81
.PD 0
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    82
.TP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    83
.I
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    84
/root
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    85
.TP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    86
.I
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    87
/usr/local/etc
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    88
.TP
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    89
.I
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    90
/etc
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    91
.PD
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    92
.RE
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    93
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    94
The first configuration file found will be used.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    95
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    96
.SH SECTION ACCOUNT
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    97
The options in the section
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    98
.B account
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
    99
are used to specify user account related settings.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   100
.SS account.delete_directory
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   101
.BR delete_directory " (default: false) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   102
.I Boolean
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   103
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   104
Determines the behavior of
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   105
.BR vmm (1)
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   106
when an account is deleted (userdelete).
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   107
If this option is set to
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   108
.I true
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   109
the user's home directory will be deleted recursively.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   110
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   111
.SS account.directory_mode
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   112
.BR directory_mode " (default: 448) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   113
.I Int
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   114
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   115
Access mode for a user's home directory and all directories inside.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   116
The value has to be specified in decimal (base 10) notation.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   117
.br
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   118
For example: `drwx\-\-\-\-\-\-' \(-> octal 0700 \(-> decimal 448
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   119
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   120
.SS account.disk_usage
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   121
.BR disk_usage " (default: false) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   122
.I Boolean
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   123
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   124
Determines whether the disk usage of a user's mail directory always should
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   125
be summarized, using
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   126
.BR du (1),
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   127
and displayed with the account information (userinfo).
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   128
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   129
This could be slow on large Maildirs.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   130
When you have enabled quotas,
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   131
.BR vmm 's
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   132
userinfo subcommand will also display the current quota usage of the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   133
account.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   134
You may also use userinfo's optional details\-argument
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   135
.BR du " or " full ,
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   136
in order to display the current disk usage of an account's mail directory.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   137
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   138
.SS account.password_length
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   139
.BR password_length " (default: 8) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   140
.I Int
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   141
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   142
Determines how many characters and/or numbers should be used for randomly
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   143
generated passwords.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   144
Any value less than 8 will be increased to 8.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   145
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   146
.SS account.random_password
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   147
.BR random_password " (default: false) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   148
.I Boolean
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   149
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   150
Determines whether
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   151
.BR vmm (1)
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   152
should generate a random password when no password was given for the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   153
useradd subcommand.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   154
If this option is set to
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   155
.I false
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   156
.B vmm
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   157
will prompt you to enter a password for the new account.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   158
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   159
You can specify the password length of generated passwords with the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   160
.I account.password_length
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   161
option.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   162
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   163
.SH SECTION BIN
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   164
The
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   165
.B bin
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   166
section is used to specify some paths to some binaries required by
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   167
.BR vmm (1).
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   168
.SS bin.dovecotpw
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   169
.BR dovecotpw " (default: /usr/sbin/dovecotpw) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   170
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   171
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   172
The absolute path to the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   173
.BR dovecotpw (1)
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   174
binary.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   175
Use the absolute path to the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   176
.BR doveadm (1)
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   177
binary, if you are using Dovecot v2.0.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   178
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   179
This binary is used to generate a password hash, if
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   180
.I misc.password_scheme
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   181
is set to one of `CRAM\-MD5', `HMAC\-MD5', `LANMAN', `OTP', `RPA' or
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   182
`SKEY'.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   183
This binary will be also required if your Python installation doesn't
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   184
support the:
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   185
.IP \(bu 4
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   186
md4 hash algorithm (hashlib + OpenSSL or PyCrypto) used for the password
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   187
schemes: `PLAIN\-MD4' and `NTLM'
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   188
.IP \(bu
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   189
sha256 hash algorithm (hashlib or PyCrypto \(>= 2.1.0alpha1) used for the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   190
password schemes: `SHA256' and `SSHA256'
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   191
.IP \(bu
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   192
sha512 hash algorithm (hashlib) used for the password schemes: `SHA512' and
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   193
`SSHA512'
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   194
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   195
The
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   196
.BR doveadm (1)
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   197
binary is also used to create a user's INBOX and additional mailboxes
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   198
.RI ( mailbox.folders ),
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   199
when the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   200
.I mailbox.format
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   201
is set to
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   202
.BR mdbox " or " sdbox .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   203
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   204
.SS bin.du
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   205
.BR du " (default: /usr/bin/du) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   206
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   207
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   208
The absolute path to
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   209
.BR du (1).
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   210
This binary is used to summarize the disk usage of a user's mail directory.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   211
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   212
.SS bin.postconf
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   213
.BR postconf " (default: /usr/sbin/postconf) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   214
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   215
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   216
The absolute path to Postfix'
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   217
.BR postconf (1).
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   218
This binary is required when
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   219
.BR vmm (1)
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   220
has to check for some Postfix settings, e.g. the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   221
.IR virtual_alias_expansion_limit .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   222
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   223
.SH SECTION DATABASE
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   224
The
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   225
.B database
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   226
section is used to specify some options required to connect to the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   227
database.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   228
.SS database.host
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   229
.BR host " (default: localhost) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   230
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   231
.PP
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   232
Hostname or IP address of the database server.
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   233
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   234
.SS database.module
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   235
.BR module " (default: psycopg2) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   236
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   237
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   238
The Python PostgreSQL database adapter module to be used.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   239
Supported modules are
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   240
.BR psycopg2 " and " pyPgSQL .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   241
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   242
.SS database.name
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   243
.BR name " (default: mailsys) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   244
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   245
.PP
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   246
Name of the database.
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   247
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   248
.SS database.pass
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   249
.BR pass " (default: " None ") :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   250
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   251
.PP
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   252
Database password.
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   253
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   254
.SS database.port
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   255
.BR port " (default: 5432) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   256
.I Int
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   257
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   258
The TCP port, on which the database server is listening for connections.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   259
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   260
.SS database.sslmode
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   261
.BR sslmode " (default: prefer) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   262
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   263
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   264
Determines whether and with what priority an SSL connection will be
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   265
negotiated with the database server.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   266
Possible values are:
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   267
.BR disabled ", " allow ", " prefer ", " require ", " verify\-ca " and "
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   268
.BR verify\-full .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   269
The modes
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   270
.BR verify\-ca " and " verify\-full
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   271
are available since PostgreSQL 8.4
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   272
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   273
This setting will be ignored when the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   274
.I database.module
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   275
is set to
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   276
.BR pyPgSQL .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   277
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   278
.SS database.user
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   279
.BR user " (default: " None ") :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   280
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   281
.PP
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   282
Name of the database user.
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   283
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   284
.SH SECTION DOMAIN
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   285
The
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   286
.B domain
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   287
section specifies some domain related settings.
460
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   288
.PP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   289
The quota limit (quota_bytes and quota_messages), service settings (imap,
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   290
pop3, sieve and smtp) and the transport setting will be applied when a
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   291
domain is created.
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   292
In order to modify those settings for an existing domain, use one of
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   293
the following
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   294
.BR vmm (1)
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   295
subcommands:
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   296
.PP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   297
.TP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   298
.B domainquota
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   299
in order to update a domain's quota limit
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   300
.TP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   301
.B domainservices
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   302
in order to assign a different service set to a domain
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   303
.TP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   304
.B domaintransport
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   305
in order to set a new default domain transport
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   306
.PP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   307
When an account is created, it inherits all the settings of the domain
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   308
to which it is added.
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   309
Different settings for an existing account can be set using the subcommands
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   310
.BR userquota ", " userservices " and " usertransport .
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   311
.\" ------------------------------------
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   312
.SS domain.auto_postmaster
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   313
.BR auto_postmaster " (default: true) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   314
.I Boolean
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   315
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   316
Determines if
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   317
.BR vmm (1)
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   318
should create also a postmaster account when a new domain is created
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   319
(domainadd).
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   320
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   321
.SS domain.delete_directory
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   322
.BR delete_directory " (default: false) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   323
.I Boolean
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   324
.PP
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   325
Specifies whether the domain directory and all user directories inside
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   326
should be deleted when a domain is deleted (domaindelete).
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   327
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   328
.SS domain.directory_mode
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   329
.BR directory_mode " (default: 504) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   330
.I Int
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   331
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   332
Access mode for the domain directory in decimal (base 10) notation.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   333
.br
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   334
For example: `drwxrwx\-\-\-' \(-> octal 0770 \(-> decimal 504
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   335
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   336
.SS domain.force_deletion
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   337
.BR force_deletion " (default: false) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   338
.I Boolean
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   339
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   340
Force the deletion of accounts and aliases when a domain is deleted
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   341
(domaindelete).
460
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   342
.\" ------------------------------------
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   343
.SS domain.imap
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   344
.BR imap " (default: true) :"
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   345
.I Boolean
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   346
.PP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   347
Determines whether newly created users can log in via IMAP.
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   348
.\" ------------------------------------
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   349
.SS domain.pop3
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   350
.BR pop3 " (default: true) :"
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   351
.I Boolean
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   352
.PP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   353
Determines whether newly created users can log in via POP3.
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   354
.\" ------------------------------------
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   355
.SS domain.quota_bytes
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   356
.BR quota_bytes " (default: 0) :"
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   357
.I String
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   358
.PP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   359
Quota limit in bytes.
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   360
0 means unlimited.
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   361
This limit will be applied to all newly created domains.
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   362
.PP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   363
The option's value can be written as an integer value, e.g.:
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   364
.BR 20480 .
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   365
It's also possible to append one of the following prefixes to the limit:
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   366
.BR b " (bytes), " k " (kilobytes), " M " (megabytes) or " G
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   367
(gigabytes).
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   368
.br
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   369
1024 is the same as 1024b or 1k.
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   370
.\" ------------------------------------
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   371
.SS domain.quota_messages
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   372
.BR quota_messages " (default: 0) :"
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   373
.I Int
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   374
.PP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   375
Quota limit in number of messages.
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   376
0 means unlimited.
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   377
This limit will be applied to all newly created domains.
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   378
.\" ------------------------------------
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   379
.SS domain.sieve
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   380
.BR sieve " (default: true) :"
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   381
.I Boolean
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   382
.PP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   383
Determines whether newly created users can log in via SIEVE (ManageSieve).
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   384
.\" ------------------------------------
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   385
.SS domain.smtp
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   386
.BR smtp " (default: true) :"
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   387
.I Boolean
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   388
.PP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   389
Determines whether newly created users can log in via SMTP (SMTP AUTH).
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   390
.\" ------------------------------------
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   391
.SS domain.transport
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   392
.BR transport " (default: dovecot:) :"
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   393
.I String
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   394
.PP
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   395
Default transport for domains and accounts.
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   396
For details see
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   397
.BR transport (5).
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   398
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   399
.SH SECTION MAILBOX
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   400
The
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   401
.B mailbox
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   402
section is used to specify some options for new created mailboxes in the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   403
users home directories.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   404
The INBOX will be created always.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   405
.SS mailbox.folders
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   406
.BR folders " (default: Drafts:Sent:Templates:Trash) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   407
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   408
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   409
A colon separated list of mailboxes that should be created.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   410
If no additionally mailboxes should be created, set the value of this
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   411
option to a single colon
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   412
.RB (` : ').
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   413
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   414
If you want to create folders containing one or more subfolders, separate
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   415
them with a single dot
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   416
.RB (` . ').
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   417
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   418
If you want to use internationalized mailbox names (e.g. `Wysłane' or
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   419
`Gelöschte Objekte'), write their names UTF\-8 encoded.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   420
.BR vmm (1)
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   421
will convert internationalized mailbox names to a modified version of the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   422
UTF\-7 encoding (see also: RFC 3501, section 5.1.3).
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   423
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   424
.SS mailbox.format
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   425
.BR format " (default: maildir) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   426
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   427
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   428
The mailbox format to be used for a user's mailbox.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   429
Depending on the used Dovecot version
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   430
.RI ( misc.dovecot_version )
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   431
.BR vmm (1)
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   432
supports up to three formats:
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   433
.TP 8
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   434
.B maildir
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   435
Dovecot \(>= v1.0.0
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   436
.TP
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   437
.B mdbox
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   438
Dovecot \(>= v2.0.beta5
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   439
.TP
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   440
.B sdbox
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   441
Dovecot \(>= v2.0.rc3
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   442
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   443
.SS mailbox.root
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   444
.BR root " (default: Maildir) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   445
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   446
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   447
Name of the mailbox root directory in a user's home directory.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   448
Commonly used names, depending on the used
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   449
.IR mailbox.format ,
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   450
are
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   451
.BR Maildir ", " mdbox " or " sdbox .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   452
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   453
.SS mailbox.subscribe
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   454
.BR subscribe " (default: true) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   455
.I Boolean
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   456
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   457
When this option is set to
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   458
.BR true ,
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   459
the mailboxes from the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   460
.I mailbox.folders
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   461
option will be listed in the user's subscriptions file.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   462
If you don't want to subscribe the created mailboxes, set this option to
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   463
.BR false .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   464
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   465
.SH SECTION MISC
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   466
The
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   467
.I misc
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   468
section is used to define miscellaneous settings.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   469
.SS misc.base_directory
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   470
.BR base_directory " (default: /srv/mail) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   471
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   472
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   473
All domain directories will be created inside this directory.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   474
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   475
.SS misc.crypt_blowfish_rounds
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   476
.BR crypt_blowfish_rounds " (default: 5) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   477
.I Int
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   478
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   479
Number of encryption rounds for the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   480
.I password_scheme
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   481
.BR BLF\-CRYPT .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   482
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   483
The value must be in range
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   484
.BR 4 " \- " 31 .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   485
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   486
.SS misc.crypt_sha256_rounds
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   487
.BR crypt_sha256_rounds " (default: 5000) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   488
.I Int
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   489
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   490
Number of encryption rounds for the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   491
.I password_scheme
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   492
.BR SHA256\-CRYPT .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   493
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   494
The value must be in range
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   495
.BR 1000 " \- " 999999999 .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   496
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   497
.SS misc.crypt_sha512_rounds
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   498
.BR crypt_sha512_rounds " (default: 5000) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   499
.I Int
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   500
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   501
Number of encryption rounds for the
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   502
.I password_scheme
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   503
.BR SHA512\-CRYPT .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   504
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   505
The value must be in range
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   506
.BR 1000 " \- " 999999999 .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   507
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   508
.SS misc.dovecot_version
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   509
.BR dovecot_version " (default: " None ") :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   510
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   511
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   512
The version number of the currently used Dovecot version.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   513
(see:
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   514
.BR "dovecot \-\-version" )
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   515
.br
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   516
When, for example, the command
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   517
.B dovecot \-\-version
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   518
prints
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   519
.IR "2.0.beta4 (8818db00d347)" ,
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   520
set the value of this option to
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   521
.BR 2.0.beta4 .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   522
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   523
.SS misc.password_scheme
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   524
.BR password_scheme " (default: CRAM\-MD5) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   525
.I String
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   526
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   527
Password scheme to use.
476
c30ce0e079b6 man5: Updated the `usable password schemes' part.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 460
diff changeset
   528
To get a list of all usable password schemes execute the command
c30ce0e079b6 man5: Updated the `usable password schemes' part.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 460
diff changeset
   529
.BR "vmm lp" .
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   530
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   531
With Dovecot \(>= v1.1.alpha1 it is also possible to append an encoding
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   532
suffix to the password_scheme.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   533
Supported encoding suffixes are:
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   534
.BR .b64 ", " .base64 " and " .hex .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   535
For example: PLAIN.BASE64
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   536
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   537
.SH EXAMPLE
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   538
An example configuration.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   539
All options that are not listed in the configuration file will have their
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   540
default values.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   541
.PP
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   542
.nf
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   543
[account]
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   544
password_length = 10
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   545
random_password = true
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   546
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   547
[bin]
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   548
dovecotpw = /usr/bin/doveadm
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   549
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   550
[database]
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   551
host = dbsrv8.example.net
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   552
pass = PY_SRJ}L/0p\-oOk
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   553
port = 5433
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   554
sslmode = require
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   555
user = vmm
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   556
460
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   557
[domain]
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   558
quota_bytes = 500M
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   559
quota_messages = 10000
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   560
transport = lmtp:unix:private/dovecot\-lmtp
e57dd007d69a man5: Moved some option descriptions to section doamin,
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   561
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   562
[mailbox]
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   563
folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   564
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   565
[misc]
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   566
crypt_sha512_rounds = 10000
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   567
dovecot_version = 2.0.beta4
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   568
password_scheme = SHA512\-CRYPT.hex
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   569
.fi
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   570
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   571
.SH SEE ALSO
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   572
.BR postconf (1),
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   573
.BR vmm (1),
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   574
.BR transport (5)
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   575
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   576
.SH INTERNET RESOURCES
86
e43e4e7e9ec0 * 'VirtualMailManager/ext/Postconf.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 68
diff changeset
   577
.TP
588
dcde0010cdf8 man/{de/}man5: s/Wiki/Homepage/g
Pascal Volk <user@localhost.localdomain.org>
parents: 554
diff changeset
   578
Homepage
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   579
http://vmm.localdomain.org/
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   580
.TP
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   581
Project site
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   582
http://sf.net/projects/vmm/
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   583
.TP
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   584
Bug tracker
477
86fa217cba11 man: Updated the URL of the bug tracker.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 476
diff changeset
   585
https://bitbucket.org/pvo/vmm/issues
412
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   586
.\" -----------------------------------------------------------------------
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   587
.SH COPYING
478
6278a7a2a476 Updated the author's e-mail address.
Pascal Volk <user@localhost.localdomain.org>
parents: 477
diff changeset
   588
vmm and its manual pages were written by Pascal Volk <user+vmm AT
6278a7a2a476 Updated the author's e-mail address.
Pascal Volk <user@localhost.localdomain.org>
parents: 477
diff changeset
   589
localhost.localdomain.org> and are licensed under the terms of the BSD
588
dcde0010cdf8 man/{de/}man5: s/Wiki/Homepage/g
Pascal Volk <user@localhost.localdomain.org>
parents: 554
diff changeset
   590
License.