man/man1/vmm.1
author Pascal Volk <neverseen@users.sourceforge.net>
Thu, 03 Nov 2011 05:32:47 +0000
branchv0.6.x
changeset 446 18b75e6a39d5
parent 432 ad7cfbfbc68d
child 473 9b9cccebccf0
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: 411
diff changeset
     1
.TH "VMM" "1" "2011-02-24" "vmm 0.6" "vmm"
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     2
.SH NAME
26
668951708f2f * 'vmm.cfg.5'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 25
diff changeset
     3
vmm \- command line tool to manage email domains/accounts/aliases
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
     4
.\" -----------------------------------------------------------------------
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     5
.SH SYNOPSIS
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     6
.B vmm
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
     7
.IR subcommand " [" "argument ..." ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
     8
.\" -----------------------------------------------------------------------
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
     9
.SH DESCRIPTION
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    10
.B vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    11
(a virtual mail manager) is the easy to use command line tool for
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    12
administrators and postmasters to manage (alias) domains, accounts, aliases
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    13
and relocated users.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    14
It allows you to simply and quickly administer your mail server.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    15
.br
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
    16
It's designed for Dovecot and Postfix with a PostgreSQL backend.
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    17
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    18
Each
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    19
.I subcommand
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    20
has both a long and a short form.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    21
The short form is shown enclosed in parentheses.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    22
Both forms are case sensitive.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    23
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    24
Most of the
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    25
.IR subcommand s
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    26
take one or more
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    27
.IR argument s.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    28
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    29
.SH ARGUMENTS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    30
.TP 12
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    31
.I address
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    32
The complete e\-mail address
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    33
.RI ( local\-part @ fqdn )
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    34
of an user account, alias address or relocated user.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    35
.\" --------------------------
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    36
.TP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    37
.I destination
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    38
Is either an e\-mail
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    39
.I address
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    40
when used with
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    41
.IR "ALIAS SUBCOMMANDS" .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    42
Or a
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    43
.I fqdn
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    44
when used with
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    45
.IR "ALIASDOMAIN SUBCOMMANDS" .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    46
.\" --------------------------
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    47
.TP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    48
.I fqdn
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    49
The fully qualified domain name \- without the trailing dot \- of a domain
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    50
or alias domain.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    51
.\" --------------------------
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    52
.TP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    53
.I messages
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    54
An integer value which specifies a quota limit in number of messages.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    55
.B 0
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    56
(zero) means unlimited \- no quota limit for the number of messages.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    57
.\" --------------------------
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    58
.TP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    59
.I option
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    60
is the name of a configuration option, prefixed with the section name and a
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    61
dot.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    62
For example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    63
.IB misc . transport
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    64
.br
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    65
All configuration options are described in
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    66
.BR vmm.cfg (5).
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    67
.\" --------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    68
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    69
.I service
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    70
The name of a service, commonly used with Dovecot.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    71
Supported services are:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    72
.BR imap ", " pop3 ", " sieve " and " smtp .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    73
.\" --------------------------
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    74
.TP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    75
.I storage
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    76
Specifies a quota limit in bytes.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    77
One of the following prefixes can be appended to the integer value:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    78
.BR b " (bytes), " k " (kilobytes), " M " (megabytes) or " G
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    79
(gigabytes).
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    80
.B 0
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    81
(zero) means unlimited \- no quota limit in bytes.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    82
.\" --------------------------
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
    83
.TP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    84
.I transport
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    85
A transport for Postfix, written as:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    86
.IB transport :
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    87
or
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    88
.IB transport :\c
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    89
.IR nexthop .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    90
See
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    91
.BR transport (5)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    92
for more details.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    93
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    94
.SH GENERAL SUBCOMMANDS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    95
.SS configget (cg)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    96
.BI "vmm configget" " option"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    97
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    98
This subcommand is used to display the actual value of the given
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
    99
configuration
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   100
.IR option .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   101
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   102
Example:
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   103
.PP
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   104
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   105
.B vmm configget misc.crypt_sha512_rounds
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   106
misc.crypt_sha512_rounds = 5000
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   107
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   108
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   109
.SS configset (cs)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   110
.B vmm configset
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   111
.I option value
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   112
.PP
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   113
Use this subcommand to set or update a single configuration option's value.
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   114
.I option
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   115
is the configuration option,
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   116
.I value
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   117
is the
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   118
.IR option 's
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   119
new value.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   120
.IP Note:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   121
This subcommand will create a new
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   122
.I vmm.cfg
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   123
without any comments.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   124
Your current configuration file will be backed as
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   125
.IR vmm.cfg.bak .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   126
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   127
Example:
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   128
.PP
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   129
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   130
.B vmm configget misc.transport
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   131
misc.transport = dovecot:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   132
.B vmm configset misc.transport lmtp:unix:private/dovecot\-lmtp
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   133
.B vmm cg misc.transport
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   134
misc.transport = lmtp:unix:private/dovecot\-lmtp
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   135
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   136
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   137
.SS configure (cf)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   138
.B vmm configure
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   139
.RI [ section ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   140
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   141
Starts the interactive configuration for all configuration sections.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   142
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   143
In this process the currently set value of each option will be displayed in
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   144
square brackets.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   145
If no value is configured, the default value of each option will be
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   146
displayed in square brackets.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   147
Press the return key, to accept the displayed value.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   148
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   149
If the optional argument
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   150
.I section
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   151
is given, only the configuration options from the given section will be
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   152
displayed and will be configurable.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   153
The following sections are available:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   154
.RS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   155
.TP 10
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   156
.B account
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   157
Account settings
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   158
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   159
.B bin
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   160
Paths to external binaries
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   161
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   162
.B database
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   163
Database settings
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   164
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   165
.B domain
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   166
Domain settings
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   167
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   168
.B mailbox
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   169
Mailbox settings
36
8a9ce20d2569 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 26
diff changeset
   170
.TP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   171
.B misc
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   172
Miscellaneous settings
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   173
.RE
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   174
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   175
All configuration options are described in
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   176
.BR vmm.cfg (5).
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   177
.IP Note:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   178
This subcommand will create a new
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   179
.I vmm.cfg
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   180
without any comments.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   181
Your current configuration file will be backed as
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   182
.IR vmm.cfg.bak .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   183
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   184
Example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   185
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   186
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   187
.B vmm configure mailbox
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   188
Using configuration file: /usr/local/etc/vmm.cfg
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   189
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   190
* Configuration section: `mailbox'
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   191
Enter new value for option folders [Drafts:Sent:Templates:Trash]:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   192
Enter new value for option format [maildir]: mdbox
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   193
Enter new value for option subscribe [True]:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   194
Enter new value for option root [Maildir]: mdbox
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   195
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   196
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   197
.SS getuser (gu)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   198
.BI "vmm getuser" " uid"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   199
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   200
If only the
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   201
.I uid
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   202
is available, for example from process list, the subcommand
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   203
.B getuser
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   204
will show the user's address.
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   205
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   206
Example:
36
8a9ce20d2569 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 26
diff changeset
   207
.PP
8a9ce20d2569 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 26
diff changeset
   208
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   209
.B vmm getuser 70772
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   210
Account information
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   211
-------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   212
        UID............: 70772
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   213
        GID............: 70312
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   214
        Address........: a.user@example.com
36
8a9ce20d2569 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 26
diff changeset
   215
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   216
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   217
.SS help (h)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   218
.B vmm help
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   219
.RI [ subcommand ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   220
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   221
Prints a list of available subcommands with a short description to stdout.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   222
When a
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   223
.I subcommand
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   224
was given, help for that
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   225
.I subcommand
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   226
will be displayed.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   227
After this
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   228
.B vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   229
exits.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   230
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   231
.SS listdomains (ld)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   232
.B vmm listdomains
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   233
.RI [ pattern ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   234
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   235
This subcommand lists all available domains.
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   236
All domain names will be prefixed either with `[+]', if the domain is a
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   237
primary domain, or with `[-]', if it is an alias domain name.
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   238
The output can be limited with an optional
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   239
.IR pattern .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   240
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   241
To perform a wild card search, the % character can be used at the start
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   242
and/or the end of the
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   243
.IR pattern .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   244
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   245
Example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   246
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   247
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   248
.B vmm listdomains %example%
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   249
Matching domains
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   250
----------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   251
        [+] example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   252
        [\-]     e.g.example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   253
        [\-]     example.name
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   254
        [+] example.net
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   255
        [+] example.org
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   256
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   257
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   258
.SS version (v)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   259
.B vmm version
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   260
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   261
Prints
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   262
.BR vmm 's
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   263
version and copyright information to stdout.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   264
After this
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   265
.B vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   266
exits.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   267
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   268
.SH DOMAIN SUBCOMMANDS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   269
.SS domainadd (da)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   270
.B vmm domainadd
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   271
.IR fqdn " [" transport ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   272
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   273
Adds the new domain into the database and creates the domain directory.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   274
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   275
If the optional argument
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   276
.I transport
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   277
is given, it will override the default transport
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   278
.RI ( misc.transport ") from " vmm.cfg .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   279
The specified
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   280
.I transport
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   281
will be the default transport for all new accounts in this domain.
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   282
.PP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   283
Configuration\-related behavior:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   284
.RS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   285
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   286
.I domain.auto_postmaster
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   287
When that option is set to
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   288
.BR true " (default) " vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   289
will automatically create the postmaster account for the new domain and
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   290
prompt for
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   291
.BI postmaster@ fqdn\c
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   292
\(aqs password.
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   293
.TP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   294
.I account.random_password
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   295
When the value of that option is also set to
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   296
.BR true ", " vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   297
will automatically create the postmaster account for the new domain and
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   298
print the generated postmaster password to stdout.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   299
.RE
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   300
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   301
Examples:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   302
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   303
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   304
.B vmm domainadd support.example.com smtp:[mx1.example.com]:2025
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   305
Enter new password:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   306
Retype new password:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   307
.B vmm cs account.random_password true
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   308
.B vmm domainadd sales.example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   309
Generated password: hHu8DeTC
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   310
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   311
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   312
.SS domaindelete (dd)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   313
.BI "vmm domaindelete " fqdn
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   314
.RB [ force ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   315
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   316
This subcommand deletes the domain specified by
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   317
.IR fqdn .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   318
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   319
If there are accounts, aliases and/or relocated users assigned to the given
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   320
domain,
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   321
.B vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   322
will abort the requested operation and show an error message.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   323
If you know, what you are doing, you can specify the optional keyword
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   324
.BR force .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   325
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   326
If you really always know what you are doing, edit your
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   327
.I vmm.cfg
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   328
and set the option
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   329
.I domain.force_deletion
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   330
to
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   331
.BR true .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   332
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   333
.SS domaininfo (di)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   334
.B vmm domaininfo
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   335
.IR fqdn \ [ details ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   336
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   337
This subcommand shows some information about the given domain.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   338
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   339
For a more detailed information about the domain the optional argument
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   340
.I details
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   341
can be specified.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   342
A possible
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   343
.I details
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   344
value can be one of the following five keywords:
62
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   345
.RS
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   346
.TP 14
62
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   347
.B accounts
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   348
to list the e\-mail addresses of all existing user accounts
62
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   349
.TP
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   350
.B aliasdomains
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   351
to list all assigned alias domain names
62
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   352
.TP
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   353
.B aliases
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   354
to list all available alias e\-mail addresses
62
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   355
.TP
81
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   356
.B relocated
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   357
to list the e\-mail addresses of all relocated users
81
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   358
.TP
62
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   359
.B full
64
432a037658a8 * 'vmm'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 62
diff changeset
   360
to list all information mentioned above
62
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   361
.RE
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   362
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   363
Example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   364
.PP
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   365
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   366
.B vmm domaininfo sales.example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   367
Domain information
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   368
------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   369
        Domainname.....: sales.example.com
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   370
        GID............: 70698
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   371
        Transport......: dovecot:
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   372
        Domaindir......: /srv/mail/k/70698
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   373
        Quota Limit....: Storage: 0; Messages: 0
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   374
        Aliasdomains...: 0
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   375
        Accounts.......: 1
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   376
        Aliases........: 0
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   377
        Relocated......: 0
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   378
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   379
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   380
.SS domainquota (dq)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   381
.B vmm domainquota
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   382
.IR "fqdn storage" " [" messages ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   383
.RB [ force ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   384
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   385
This subcommand is used to configure a new quota limit for the accounts of
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   386
the domain - not for the domain itself.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   387
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   388
The default quota limit for accounts is defined in the
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   389
.IR vmm.cfg " (" misc.quota_bytes " and " misc.quota_messages ).
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   390
The new quota limit will be applied to all newly created accounts.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   391
If you want to apply the new quota limit also to existing accounts, you
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   392
have to give the optional keyword
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   393
.BR force .
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   394
.br
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   395
When the argument
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   396
.I messages
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   397
was omitted the default number of messages
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   398
.B 0
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   399
(zero) will be applied.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   400
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   401
Example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   402
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   403
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   404
.B vmm domainquota example.com 1g force
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   405
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   406
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   407
.SS domaintransport (dt)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   408
.BI "vmm domaintransport" " fqdn transport"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   409
.RB [ force ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   410
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   411
A new transport for the indicated domain can be set with this subcommand.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   412
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   413
If the optional keyword
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   414
.B force
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   415
is given all account specific transport settings will be also updated.
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   416
Otherwise this setting will affect only new created accounts.
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   417
.PP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   418
Example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   419
.PP
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   420
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   421
.B vmm domaintransport support.example.com dovecot:
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   422
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   423
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   424
.SH ALIAS DOMAIN SUBCOMMANDS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   425
An alias domain is an alias for a domain that was previously added with the
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   426
subcommand
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   427
.BR domainadd .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   428
All accounts, aliases and relocated users from the domain will be also
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   429
available in the alias domain.
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   430
.br
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   431
In the following is to be assumed that example.name is an alias for
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   432
example.com.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   433
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   434
Postfix will not accept erroneously e\-mails for unknown.user@example.name
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   435
and bounce them back later to the mostly faked sender.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   436
Postfix will immediately reject all e\-mails addressed to nonexistent
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   437
users.
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   438
.br
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   439
This behavior is ensured as long as you use the recommended database
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   440
queries in your
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   441
.I $config_directory/pgsql\-*.cf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   442
configuration files.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   443
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   444
.SS aliasdomainadd (ada)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   445
.BI "vmm aliasdomainadd" " fqdn destination"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   446
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   447
This subcommand adds the new alias domain
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   448
.RI ( fqdn )
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   449
to the
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   450
.I destination
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   451
domain that should be aliased.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   452
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   453
Example:
57
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   454
.PP
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   455
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   456
.B vmm aliasdomainadd example.name example.com
57
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   457
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   458
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   459
.SS aliasdomaindelete (add)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   460
.BI "vmm aliasdomaindelete" " fqdn"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   461
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   462
Use this subcommand if the alias domain
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   463
.I fqdn
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   464
should be removed.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   465
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   466
Example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   467
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   468
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   469
.B vmm aliasdomaindelete e.g.example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   470
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   471
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   472
.SS aliasdomaininfo (adi)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   473
.BI "vmm aliasdomaininfo" " fqdn"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   474
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   475
This subcommand shows to which domain the alias domain
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   476
.I fqdn
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   477
is assigned to.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   478
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   479
Example:
57
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   480
.PP
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   481
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   482
.B vmm adi example.name
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   483
Alias domain information
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   484
------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   485
        The alias domain example.name belongs to:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   486
            * example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   487
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   488
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   489
.SS aliasdomainswitch (ads)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   490
.BI "vmm aliasdomainswitch" " fqdn destination"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   491
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   492
If the destination of the existing alias domain
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   493
.I fqdn
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   494
should be switched to another
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   495
.I destination
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   496
use this subcommand.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   497
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   498
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   499
Example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   500
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   501
.B vmm aliasdomainswitch example.name example.org
57
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   502
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   503
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   504
.SH ACCOUNT SUBCOMMANDS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   505
.SS useradd (ua)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   506
.B vmm useradd
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   507
.IR address " [" password ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   508
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   509
Use this subcommand to create a new e\-mail account for the given
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   510
.IR address .
79
0ae7597eed11 * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 66
diff changeset
   511
.PP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   512
If the
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   513
.I password
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   514
is not provided,
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   515
.B vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   516
will prompt for it interactively.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   517
When no
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   518
.I password
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   519
is provided and
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   520
.I account.random_password
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   521
is set to
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   522
.BR true ", " vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   523
will generate a random password and print it to stdout after the account
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   524
has been created.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   525
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   526
Examples:
57
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   527
.PP
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   528
.nf
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   529
.B vmm ua d.user@example.com \(dqA 5ecR3t P4s5\(rs/\(rs/0rd\(dq
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   530
.B vmm useradd e.user@example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   531
Enter new password:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   532
Retype new password:
57
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   533
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   534
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   535
.SS userdelete (ud)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   536
.BI "vmm userdelete" " address"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   537
.RB [ force ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   538
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   539
Use this subcommand to delete the account with the given
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   540
.IR address .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   541
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   542
If there are one or more aliases with an identical destination address,
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   543
.B vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   544
will abort the requested operation and show an error message.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   545
To prevent this, specify the optional keyword
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   546
.BR force .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   547
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   548
.SS userdisable (u0)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   549
.BI "vmm userdisable" " address"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   550
.RI [ "service ..." ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   551
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   552
If a user should not be able to access one or more services you can
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   553
restrict the user's access with this subcommand.
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   554
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   555
If no
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   556
.I service
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   557
was given all services
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   558
.RB ( imap ", " pop3 ", " sieve " and " smtp )
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   559
will be disabled for the account with the specified
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   560
.IR address .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   561
Otherwise only the specified
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   562
.IR service (s)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   563
will be restricted.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   564
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   565
Examples:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   566
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   567
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   568
.B vmm u0 b.user@example.com imap pop3
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   569
.B vmm userdisable c.user@example.com
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   570
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   571
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   572
.SS userenable (u1)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   573
.BI "vmm userenable" " address"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   574
.RI [ "service ..." ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   575
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   576
To allow access to one or more restricted
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   577
.IR service (s)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   578
use this subcommand.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   579
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   580
If no
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   581
.I service
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   582
was given all services
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   583
.RB ( imap ", " pop3 ", " sieve " and " smtp )
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   584
will be enabled for the account with the specified
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   585
.IR address .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   586
Otherwise only the specified
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   587
.IR service (s)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   588
will be enabled.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   589
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   590
.SS userinfo (ui)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   591
.B "vmm userinfo"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   592
.IR address " [" details ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   593
.PP
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   594
This subcommand displays some information about the account specified by
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   595
.IR address .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   596
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   597
If the optional argument
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   598
.I details
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   599
is given some more information will be displayed.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   600
Possible values for
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   601
.I details
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   602
are:
90
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   603
.RS
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   604
.TP 8
90
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   605
.B aliases
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   606
to list all alias addresses with the destination
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   607
.I address
90
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   608
.TP
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   609
.B du
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   610
to display the disk usage of the user's mail directory.
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   611
In order to summarize the disk usage each time the this subcommand is
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   612
executed automatically, set
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   613
.I account.disk_usage
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   614
in your
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   615
.I vmm.cfg
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   616
to
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   617
.BR true .
90
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   618
.TP
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   619
.B full
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   620
to list all information mentioned above
432
ad7cfbfbc68d man: Added missing `.RE' macro to sub section userinfo (ui).
Pascal Volk <neverseen@users.sourceforge.net>
parents: 416
diff changeset
   621
.RE
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   622
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   623
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   624
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   625
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   626
.B vmm ui d.user@example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   627
Account information
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   628
-------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   629
        Address........: d.user@example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   630
        Name...........: None
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   631
        UID............: 79839
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   632
        GID............: 70312
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   633
        Home...........: /srv/mail/8/70312/79839
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   634
        Mail_Location..: mdbox:~/mdbox
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   635
        Quota Storage..: [  0.00%] 0/1.00 GiB
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   636
        Quota Messages.: [  0.00%] 0/0
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   637
        Transport......: dovecot:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   638
        SMTP...........: enabled
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   639
        POP3...........: enabled
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   640
        IMAP...........: enabled
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   641
        SIEVE..........: enabled
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   642
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   643
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   644
.SS username (un)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   645
.BI "vmm username" " address name"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   646
.PP
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   647
The user's real
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   648
.I name
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   649
can be set/updated with this subcommand.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   650
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   651
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   652
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   653
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   654
.B vmm un d.user@example.com \(dqJohn Doe\(dq
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   655
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   656
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   657
.SS userpassword (up)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   658
.BI "vmm userpassword" " address"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   659
.RI [ password ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   660
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   661
The password of an account can be updated with this subcommand.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   662
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   663
If no
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   664
.I password
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   665
was provided,
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   666
.B vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   667
will prompt for it interactively.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   668
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   669
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   670
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   671
.nf
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   672
.B vmm up d.user@example.com \(dqA |\(rs/|0r3 5ecur3 P4s5\(rs/\(rs/0rd?\(dq
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   673
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   674
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   675
.SS userquota (uq)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   676
.BI "vmm userquota" " address storage"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   677
.RI [ messages ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   678
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   679
This subcommand is used to set a new quota limit for the given account.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   680
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   681
When the argument
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   682
.I messages
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   683
was omitted the default number of messages
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   684
.B 0
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   685
(zero) will be applied.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   686
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   687
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   688
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   689
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   690
.B vmm userquota d.user@example.com 750m
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   691
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   692
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   693
.SS usertransport (ut)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   694
.BI "vmm usertransport" " address transport"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   695
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   696
A different
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   697
.I transport
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   698
for an account can be specified with this subcommand.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   699
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   700
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   701
.br
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   702
Assumed you want to use Dovecot's
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   703
.BR dsync (1)
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   704
to convert a user's mailbox from Maildir format to mdbox format, you
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   705
can tell Postfix to retry later.
66
995d538a6eb5 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 64
diff changeset
   706
.PP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   707
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   708
.B vmm ut d.user@example.com \(dqretry:4.0.0 Mailbox being migrated\(dq
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   709
# convert the mailbox ... then set the transport to Dovecot's lmtp
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   710
.B vmm ut d.user@example.com lmtp:unix:private/dovecot\-lmtp
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   711
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   712
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   713
.SH ALIAS SUBCOMMANDS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   714
.SS aliasadd (aa)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   715
.BI "vmm aliasadd" " address destination ..."
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   716
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   717
This subcommand is used to create a new alias
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   718
.I address
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   719
with one or more
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   720
.I destination
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   721
addresses.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   722
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   723
Examples:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   724
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   725
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   726
.B vmm aliasadd john.doe@example.com d.user@example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   727
.B vmm aa support@example.com d.user@example.com e.user@example.com
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   728
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   729
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   730
.SS aliasdelete (ad)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   731
.BI "vmm aliasdelete" " address"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   732
.RI [ destination ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   733
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   734
Use this subcommand to delete the alias with the given
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   735
.IR address .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   736
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   737
If the optional
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   738
.I destination
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   739
address is given, only this
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   740
destination will be removed from the alias.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   741
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   742
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   743
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   744
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   745
.B vmm ad support@example.com d.user@example.com
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   746
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   747
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   748
.SS aliasinfo (ai)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   749
.BI "vmm aliasinfo" " address"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   750
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   751
Information about the alias with the given
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   752
.I address
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   753
can be displayed with this subcommand.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   754
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   755
Example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   756
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   757
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   758
.B vmm aliasinfo support@example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   759
Alias information
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   760
-----------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   761
        Mail for support@example.com will be redirected to:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   762
             * e.user@example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   763
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   764
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   765
.SH RELOCATED SUBCOMMANDS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   766
.SS relocatedadd (ra)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   767
.BI "vmm relocatedadd" " address newaddress"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   768
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   769
A new relocated user can be created with this subcommand.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   770
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   771
.I address
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   772
is the user's ex\-email address, for example b.user@example.com, and
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   773
.I newaddress
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   774
points to the new email address where the user can be reached.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   775
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   776
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   777
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   778
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   779
.B vmm relocatedadd b.user@example.com b\-user@company.tld
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   780
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   781
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   782
.SS relocatedinfo (ri)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   783
.BI "vmm relocatedinfo " address
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   784
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   785
This subcommand shows the new address of the relocated user with the given
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   786
.IR address .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   787
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   788
Example:
81
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   789
.PP
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   790
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   791
.B vmm relocatedinfo b.user@example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   792
Relocated information
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   793
---------------------
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   794
        User `b.user@example.com' has moved to `b\-user@company.tld'
81
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   795
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   796
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   797
.SS relocateddelete (rd)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   798
.BI "vmm relocateddelete " address
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   799
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   800
Use this subcommand in order to delete the relocated user with the given
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   801
.IR address .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   802
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   803
Example:
81
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   804
.PP
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   805
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   806
.B vmm relocateddelete b.user@example.com
81
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   807
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   808
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   809
.SH FILES
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   810
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   811
.I /root/vmm.cfg
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   812
will be used when found.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   813
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   814
.I /usr/local/etc/vmm.cfg
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   815
will be used when the above file doesn't exist.
81
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   816
.TP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   817
.I /etc/vmm.cfg
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   818
will be used when none of the both above mentioned files exists.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   819
.\" -----------------------------------------------------------------------
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   820
.SH SEE ALSO
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   821
.BR dsync (1),
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   822
.BR transport (5),
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   823
.BR vmm.cfg (5)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   824
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   825
.SH INTERNET RESOURCES
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   826
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   827
Wiki
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   828
http://vmm.localdomain.org/
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   829
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   830
Project site
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   831
http://sf.net/projects/vmm/
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   832
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   833
Bug tracker
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   834
http://sf.net/tracker/?group_id=213727&atid=1026862
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   835
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   836
.SH COPYING
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   837
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: 411
diff changeset
   838
users.sourceforge.net> and are licensed under the terms of the BSD License.