man/man5/vmm.cfg.5
author Pascal Volk <neverseen@users.sourceforge.net>
Thu, 03 Nov 2011 05:32:47 +0000
branchv0.6.x
changeset 446 18b75e6a39d5
parent 416 f32b323fd347
child 460 e57dd007d69a
permissions -rw-r--r--
VMM/cli/subcommands: Small indent fix.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 412
diff changeset
     1
.TH "VMM.CFG" "5" "2011-02-24" "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.imap
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 imap " (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
   140
.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
   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 whether a newly created user can log in via IMAP.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   143
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   144
.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
   145
.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
   146
.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
   147
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   148
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
   149
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
   150
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
   151
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   152
.SS account.pop3
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   153
.BR pop3 " (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
   154
.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
   155
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   156
Determines whether a newly created user can log in via POP3.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   157
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   158
.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
   159
.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
   160
.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
   161
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   162
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
   163
.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
   164
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
   165
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
   166
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
   167
.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
   168
.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
   169
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
   170
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   171
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
   172
.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
   173
option.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   174
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   175
.SS account.sieve
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 sieve " (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
   177
.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
   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
Determines whether a newly created user can log in via ManageSieve.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   180
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   181
.SS account.smtp
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   182
.BR smtp " (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
   183
.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
   184
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   185
Determines whether a newly created user can log in via SMTP (SMTP AUTH).
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   186
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   187
.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
   188
The
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   189
.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
   190
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
   191
.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
   192
.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
   193
.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
   194
.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
   195
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   196
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
   197
.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
   198
binary.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   199
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
   200
.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
   201
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
   202
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   203
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
   204
.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
   205
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
   206
`SKEY'.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   207
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
   208
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
   209
.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
   210
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
   211
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
   212
.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
   213
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
   214
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
   215
.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
   216
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
   217
`SSHA512'
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   218
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   219
The
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   220
.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
   221
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
   222
.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
   223
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
   224
.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
   225
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
   226
.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
   227
.\" ------------------------------------
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 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
   229
.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
   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
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   232
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
   233
.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
   234
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
   235
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   236
.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
   237
.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
   238
.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
   239
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   240
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
   241
.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
   242
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
   243
.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
   244
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
   245
.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
   246
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   247
.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
   248
The
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   249
.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
   250
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
   251
database.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   252
.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
   253
.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
   254
.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
   255
.PP
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   256
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
   257
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   258
.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
   259
.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
   260
.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
   261
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   262
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
   263
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
   264
.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
   265
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   266
.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
   267
.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
   268
.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
   269
.PP
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   270
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
   271
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   272
.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
   273
.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
   274
.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
   275
.PP
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   276
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
   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.port
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 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
   280
.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
   281
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   282
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
   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
.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
   285
.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
   286
.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
   287
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   288
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
   289
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
   290
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
   291
.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
   292
.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
   293
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
   294
.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
   295
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
   296
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   297
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
   298
.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
   299
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
   300
.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
   301
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   302
.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
   303
.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
   304
.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
   305
.PP
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   306
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
   307
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   308
.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
   309
The
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   310
.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
   311
section specifies some domain 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
   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).
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   342
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   343
.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
   344
The
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   345
.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
   346
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
   347
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
   348
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
   349
.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
   350
.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
   351
.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
   352
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   353
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
   354
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
   355
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
   356
.RB (` : ').
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   357
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   358
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
   359
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
   360
.RB (` . ').
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   361
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   362
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
   363
`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
   364
.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
   365
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
   366
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
   367
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   368
.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
   369
.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
   370
.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
   371
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   372
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
   373
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
   374
.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
   375
.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
   376
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
   377
.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
   378
.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
   379
Dovecot \(>= v1.0.0
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   380
.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
   381
.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
   382
Dovecot \(>= v2.0.beta5
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   383
.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
   384
.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
   385
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
   386
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   387
.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
   388
.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
   389
.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
   390
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   391
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
   392
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
   393
.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
   394
are
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   395
.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
   396
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   397
.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
   398
.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
   399
.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
   400
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   401
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
   402
.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
   403
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
   404
.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
   405
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
   406
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
   407
.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
   408
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   409
.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
   410
The
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   411
.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
   412
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
   413
.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
   414
.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
   415
.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
   416
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   417
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
   418
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   419
.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
   420
.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
   421
.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
   422
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   423
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
   424
.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
   425
.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
   426
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   427
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
   428
.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
   429
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   430
.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
   431
.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
   432
.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
   433
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   434
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
   435
.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
   436
.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
   437
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   438
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
   439
.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
   440
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   441
.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
   442
.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
   443
.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
   444
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   445
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
   446
.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
   447
.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
   448
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   449
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
   450
.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
   451
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   452
.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
   453
.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
   454
.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
   455
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   456
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
   457
(see:
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 "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
   459
.br
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   460
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
   461
.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
   462
prints
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   463
.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
   464
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
   465
.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
   466
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   467
.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
   468
.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
   469
.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
   470
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   471
Password scheme to use.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   472
To get a list of all available password schemes execute 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
   473
.B dovecotpw \-l
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   474
(Dovecot v1.x) or
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   475
.B doveadm pw \-l
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   476
(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
   477
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   478
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
   479
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
   480
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
   481
.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
   482
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
   483
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   484
.SS misc.quota_bytes
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   485
.BR quota_bytes " (default: 0) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   486
.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
   487
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   488
Quota limit in bytes.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   489
0 means unlimited.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   490
This limit will be applied to all newly created domains.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   491
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   492
The option's value can be written as an integer value, e.g.:
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   493
.BR 20480 .
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   494
It's also possible to append one of the following prefixes to the limit:
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 b " (bytes), " k " (kilobytes), " M " (megabytes) or " G
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   496
(gigabytes).
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   497
.br
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   498
1024 is the same as 1024b or 1k.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   499
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   500
.SS misc.quota_messages
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   501
.BR quota_messages " (default: 0) :"
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 Int
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   503
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   504
Quota limit in number of messages.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   505
0 means unlimited.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   506
This limit 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
   507
applied to all newly created domains.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   508
.\" ------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   509
.SS misc.transport
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   510
.BR transport " (default: dovecot:) :"
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   511
.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
   512
.PP
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   513
Default transport for domains and accounts.
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   514
For details see
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 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
   516
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   517
.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
   518
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
   519
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
   520
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
   521
.PP
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   522
.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
   523
[account]
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   524
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
   525
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
   526
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   527
[bin]
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   528
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
   529
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   530
[database]
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   531
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
   532
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
   533
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
   534
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
   535
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
   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
[mailbox]
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   538
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
   539
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   540
[misc]
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   541
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
   542
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
   543
password_scheme = SHA512\-CRYPT.hex
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   544
quota_bytes = 500M
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   545
quota_messages = 10000
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   546
transport = lmtp:unix:private/dovecot\-lmtp
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   547
.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
   548
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   549
.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
   550
.BR doveadm\-pw (1),
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   551
.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
   552
.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
   553
.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
   554
.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
   555
.\" -----------------------------------------------------------------------
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   556
.SH INTERNET RESOURCES
86
e43e4e7e9ec0 * 'VirtualMailManager/ext/Postconf.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 68
diff changeset
   557
.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
   558
Wiki
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   559
http://vmm.localdomain.org/
24
48ea255e8a85 * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   560
.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
   561
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
   562
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
   563
.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
   564
Bug tracker
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   565
http://sf.net/tracker/?group_id=213727&atid=1026862
65687300ba19 man/man5: Reworked/updated vmm.cfg.5. Removed vmm.cfg.5.rst.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 170
diff changeset
   566
.\" -----------------------------------------------------------------------
169
a72908248153 man: updated man/{de/,}man5/vmm.cfg.5, using reStructuredText now
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   567
.SH COPYING
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 412
diff changeset
   568
vmm and its manual pages were written by Pascal Volk <neverseen AT
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 412
diff changeset
   569
users.sourceforge.net> and are licensed under the terms of the BSD License.