man/man1/vmm.1
author Pascal Volk <user@localhost.localdomain.org>
Tue, 13 Dec 2011 00:34:39 +0000
branchv0.6.x
changeset 487 fb0af82ab4af
parent 479 b33bdc0c3669
child 516 b2084e7f6854
permissions -rw-r--r--
VMM/cli/subcommands: Fixed a TypeError in user_info().
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
479
b33bdc0c3669 man1: Updated configuration related descriptions/examples,
Pascal Volk <user@localhost.localdomain.org>
parents: 478
diff changeset
     1
.TH "VMM" "1" "2011-11-13" "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
479
b33bdc0c3669 man1: Updated configuration related descriptions/examples,
Pascal Volk <user@localhost.localdomain.org>
parents: 478
diff changeset
   130
.B vmm configget domain.transport
b33bdc0c3669 man1: Updated configuration related descriptions/examples,
Pascal Volk <user@localhost.localdomain.org>
parents: 478
diff changeset
   131
domain.transport = dovecot:
b33bdc0c3669 man1: Updated configuration related descriptions/examples,
Pascal Volk <user@localhost.localdomain.org>
parents: 478
diff changeset
   132
.B vmm configset domain.transport lmtp:unix:private/dovecot\-lmtp
b33bdc0c3669 man1: Updated configuration related descriptions/examples,
Pascal Volk <user@localhost.localdomain.org>
parents: 478
diff changeset
   133
.B vmm cg domain.transport
b33bdc0c3669 man1: Updated configuration related descriptions/examples,
Pascal Volk <user@localhost.localdomain.org>
parents: 478
diff changeset
   134
domain.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
475
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   209
.B vmm getuser 79876
410
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
-------------------
475
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   212
        UID............: 79876
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   213
        GID............: 70704
410
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
.\" ------------------------------------
473
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   258
.SS listpwschemes (lp)
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   259
.B vmm listpwschemes
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   260
.PP
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   261
This subcommand lists all password schemes which could be used in the
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   262
.I vmm.cfg
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   263
as value of the
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   264
.I misc.password_scheme
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   265
option.
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   266
The output varies, depending on the used Dovecot version and the system's
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   267
libc.
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   268
.br
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   269
When your Dovecot installation isn't too old, you will see additionally a
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   270
few usable encoding suffixes.
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   271
One of them can be appended to the password scheme.
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   272
.PP
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   273
Example:
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   274
.PP
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   275
.nf
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   276
.B vmm listpwschemes
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   277
Usable password schemes
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   278
-----------------------
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   279
        CRYPT SHA512-CRYPT LDAP-MD5 DIGEST-MD5 SHA256 SHA512 SSHA512
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   280
        SKEY SSHA NTLM RPA MD5-CRYPT HMAC-MD5 SHA1 PLAIN SHA CRAM-MD5
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   281
        SSHA256 MD5 LANMAN CLEARTEXT PLAIN-MD5 PLAIN-MD4 OTP SMD5
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   282
        SHA256-CRYPT
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   283
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   284
Usable encoding suffixes
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   285
------------------------
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   286
        .B64 .BASE64 .HEX
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   287
.fi
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   288
.\" ------------------------------------
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   289
.SS version (v)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   290
.B vmm version
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   291
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   292
Prints
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   293
.BR vmm 's
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   294
version and copyright information to stdout.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   295
After this
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   296
.B vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   297
exits.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   298
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   299
.SH DOMAIN SUBCOMMANDS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   300
.SS domainadd (da)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   301
.B vmm domainadd
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   302
.IR fqdn " [" transport ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   303
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   304
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
   305
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   306
If the optional argument
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   307
.I transport
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   308
is given, it will override the default transport
479
b33bdc0c3669 man1: Updated configuration related descriptions/examples,
Pascal Volk <user@localhost.localdomain.org>
parents: 478
diff changeset
   309
.RI ( domain.transport ") from " vmm.cfg .
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   310
The specified
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   311
.I transport
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   312
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
   313
.PP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   314
Configuration\-related behavior:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   315
.RS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   316
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   317
.I domain.auto_postmaster
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   318
When that option is set to
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   319
.BR true " (default) " vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   320
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
   321
prompt for
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   322
.BI postmaster@ fqdn\c
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   323
\(aqs password.
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   324
.TP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   325
.I account.random_password
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   326
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
   327
.BR true ", " vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   328
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
   329
print the generated postmaster password to stdout.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   330
.RE
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   331
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   332
Examples:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   333
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   334
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   335
.B vmm domainadd support.example.com smtp:[mx1.example.com]:2025
475
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   336
Creating account for postmaster@support.example.com
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   337
Enter new password:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   338
Retype new password:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   339
.B vmm cs account.random_password true
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   340
.B vmm domainadd sales.example.com
475
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   341
Creating account for postmaster@sales.example.com
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   342
Generated password: pLJUQ6Xg_z
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   343
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   344
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   345
.SS domaindelete (dd)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   346
.BI "vmm domaindelete " fqdn
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   347
.RB [ force ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   348
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   349
This subcommand deletes the domain specified by
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   350
.IR fqdn .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   351
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   352
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
   353
domain,
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   354
.B vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   355
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
   356
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
   357
.BR force .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   358
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   359
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
   360
.I vmm.cfg
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   361
and set the option
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   362
.I domain.force_deletion
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   363
to
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   364
.BR true .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   365
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   366
.SS domaininfo (di)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   367
.B vmm domaininfo
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   368
.IR fqdn \ [ details ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   369
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   370
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
   371
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   372
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
   373
.I details
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   374
can be specified.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   375
A possible
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   376
.I details
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   377
value can be one of the following five keywords:
62
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   378
.RS
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   379
.TP 14
62
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   380
.B accounts
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   381
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
   382
.TP
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   383
.B aliasdomains
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   384
to list all assigned alias domain names
62
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   385
.TP
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   386
.B aliases
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   387
to list all available alias e\-mail addresses
62
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   388
.TP
81
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   389
.B relocated
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   390
to list the e\-mail addresses of all relocated users
81
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   391
.TP
62
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   392
.B full
64
432a037658a8 * 'vmm'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 62
diff changeset
   393
to list all information mentioned above
62
869de537a020 * 'VirtualMailManager/VirtualMailManager.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 59
diff changeset
   394
.RE
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   395
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   396
Example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   397
.PP
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   398
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   399
.B vmm domaininfo sales.example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   400
Domain information
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   401
------------------
475
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   402
        Domain Name......: sales.example.com
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   403
        GID..............: 70708
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   404
        Domain Directory.: /srv/mail/c/70708
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   405
        Quota Limit/User.: Storage: 500.00 MiB; Messages: 10,000
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   406
        Active Services..: IMAP SIEVE
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   407
        Transport........: lmtp:unix:private/dovecot-lmtp
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   408
        Alias Domains....: 0
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   409
        Accounts.........: 1
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   410
        Aliases..........: 0
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   411
        Relocated........: 0
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   412
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   413
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   414
.SS domainquota (dq)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   415
.B vmm domainquota
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   416
.IR "fqdn storage" " [" messages ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   417
.RB [ force ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   418
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   419
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
   420
the domain - not for the domain itself.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   421
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   422
The default quota limit for accounts is defined in the
479
b33bdc0c3669 man1: Updated configuration related descriptions/examples,
Pascal Volk <user@localhost.localdomain.org>
parents: 478
diff changeset
   423
.IR vmm.cfg " (" domain.quota_bytes " and " domain.quota_messages ).
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   424
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
   425
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
   426
have to give the optional keyword
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   427
.BR force .
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   428
.br
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   429
When the argument
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   430
.I messages
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   431
was omitted the default number of messages
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   432
.B 0
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   433
(zero) will be applied.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   434
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   435
Example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   436
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   437
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   438
.B vmm domainquota example.com 1g force
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   439
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   440
.\" ------------------------------------
473
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   441
.SS domainservices (ds)
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   442
.B vmm domainservices
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   443
.IR fqdn " [" "service ..." ]
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   444
.RB [ force ]
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   445
.PP
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   446
To define which services could be used by the users of the domain \(em with
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   447
the given
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   448
.I fqdn
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   449
\(em use this subcommand.
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   450
.PP
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   451
Each specified
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   452
.I service
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   453
will be enabled/usable.
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   454
All other services will be deactivated/unusable.
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   455
Possible service names are: 
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   456
.BR  imap ", " pop3 ", " sieve " and " smtp .
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   457
.br
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   458
When the keyword
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   459
.B force
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   460
was omitted, the service setting will be the default for new created
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   461
accounts.
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   462
Otherwise it will additionally apply the settings to all existing accounts
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   463
of the domain.
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   464
.\" ------------------------------------
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   465
.SS domaintransport (dt)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   466
.BI "vmm domaintransport" " fqdn transport"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   467
.RB [ force ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   468
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   469
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
   470
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   471
If the optional keyword
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   472
.B force
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   473
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
   474
Otherwise this setting will affect only new created accounts.
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   475
.PP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   476
Example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   477
.PP
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   478
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   479
.B vmm domaintransport support.example.com dovecot:
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   480
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   481
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   482
.SH ALIAS DOMAIN SUBCOMMANDS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   483
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
   484
subcommand
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   485
.BR domainadd .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   486
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
   487
available in the alias domain.
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   488
.br
475
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   489
In the following is to be assumed that example.net is an alias for
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   490
example.com.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   491
.PP
475
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   492
Postfix will not accept erroneously e\-mails for unknown.user@example.net
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   493
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
   494
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
   495
users.
22
576a4709a44f * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 21
diff changeset
   496
.br
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   497
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
   498
queries in your
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   499
.I $config_directory/pgsql\-*.cf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   500
configuration files.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   501
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   502
.SS aliasdomainadd (ada)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   503
.BI "vmm aliasdomainadd" " fqdn destination"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   504
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   505
This subcommand adds the new alias domain
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   506
.RI ( fqdn )
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   507
to the
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   508
.I destination
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   509
domain that should be aliased.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   510
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   511
Example:
57
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   512
.PP
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   513
.nf
475
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   514
.B vmm aliasdomainadd example.net example.com
57
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   515
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   516
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   517
.SS aliasdomaindelete (add)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   518
.BI "vmm aliasdomaindelete" " fqdn"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   519
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   520
Use this subcommand if the alias domain
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   521
.I fqdn
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   522
should be removed.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   523
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   524
Example:
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
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   527
.B vmm aliasdomaindelete e.g.example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   528
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   529
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   530
.SS aliasdomaininfo (adi)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   531
.BI "vmm aliasdomaininfo" " fqdn"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   532
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   533
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
   534
.I fqdn
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   535
is assigned to.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   536
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   537
Example:
57
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   538
.PP
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   539
.nf
475
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   540
.B vmm adi example.net
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   541
Alias domain information
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   542
------------------------
475
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   543
        The alias domain example.net belongs to:
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   544
            * example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   545
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   546
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   547
.SS aliasdomainswitch (ads)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   548
.BI "vmm aliasdomainswitch" " fqdn destination"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   549
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   550
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
   551
.I fqdn
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   552
should be switched to another
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   553
.I destination
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   554
use this subcommand.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   555
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   556
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   557
Example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   558
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   559
.B vmm aliasdomainswitch example.name example.org
57
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   560
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   561
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   562
.SH ACCOUNT SUBCOMMANDS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   563
.SS useradd (ua)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   564
.B vmm useradd
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   565
.IR address " [" password ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   566
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   567
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
   568
.IR address .
79
0ae7597eed11 * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 66
diff changeset
   569
.PP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   570
If the
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   571
.I password
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   572
is not provided,
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   573
.B vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   574
will prompt for it interactively.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   575
When no
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   576
.I password
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   577
is provided and
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   578
.I account.random_password
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   579
is set to
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   580
.BR true ", " vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   581
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
   582
has been created.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   583
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   584
Examples:
57
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   585
.PP
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   586
.nf
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   587
.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
   588
.B vmm useradd e.user@example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   589
Enter new password:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   590
Retype new password:
57
38c42e09677a * 'man/de/man1/vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 37
diff changeset
   591
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   592
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   593
.SS userdelete (ud)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   594
.BI "vmm userdelete" " address"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   595
.RB [ force ]
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
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
   598
.IR address .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   599
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   600
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
   601
.B vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   602
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
   603
To prevent this, specify the optional keyword
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   604
.BR force .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   605
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   606
.SS userinfo (ui)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   607
.B "vmm userinfo"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   608
.IR address " [" details ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   609
.PP
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   610
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
   611
.IR address .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   612
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   613
If the optional argument
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   614
.I details
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   615
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
   616
Possible values for
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   617
.I details
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   618
are:
90
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   619
.RS
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   620
.TP 8
90
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   621
.B aliases
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   622
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
   623
.I address
90
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   624
.TP
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   625
.B du
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   626
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
   627
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
   628
executed automatically, set
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   629
.I account.disk_usage
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   630
in your
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   631
.I vmm.cfg
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   632
to
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   633
.BR true .
90
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   634
.TP
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   635
.B full
1734eb5101c6 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 81
diff changeset
   636
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
   637
.RE
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   638
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   639
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   640
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   641
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   642
.B vmm ui d.user@example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   643
Account information
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   644
-------------------
475
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   645
        Address..........: d.user@example.com
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   646
        Name.............: None
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   647
        UID..............: 79881
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   648
        GID..............: 70704
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   649
        Home.............: /srv/mail/2/70704/79881
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   650
        Mail_Location....: mdbox:~/mdbox
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   651
        Quota Storage....: [  0.00%] 0/500.00 MiB
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   652
        Quota Messages...: [  0.00%] 0/10,000
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   653
        Transport........: lmtp:unix:private/dovecot-lmtp
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   654
        SMTP.............: disabled
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   655
        POP3.............: disabled
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   656
        IMAP.............: enabled
e321b764268e man1: Copied new formatted/translated command output into the examples.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 473
diff changeset
   657
        SIEVE............: enabled
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   658
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   659
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   660
.SS username (un)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   661
.BI "vmm username" " address name"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   662
.PP
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   663
The user's real
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   664
.I name
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   665
can be set/updated with this subcommand.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   666
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   667
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   668
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   669
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   670
.B vmm un d.user@example.com \(dqJohn Doe\(dq
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   671
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   672
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   673
.SS userpassword (up)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   674
.BI "vmm userpassword" " address"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   675
.RI [ password ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   676
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   677
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
   678
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   679
If no
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   680
.I password
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   681
was provided,
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   682
.B vmm
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   683
will prompt for it interactively.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   684
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   685
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   686
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   687
.nf
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   688
.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
   689
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   690
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   691
.SS userquota (uq)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   692
.BI "vmm userquota" " address storage"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   693
.RI [ messages ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   694
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   695
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
   696
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   697
When the argument
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   698
.I messages
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   699
was omitted the default number of messages
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   700
.B 0
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   701
(zero) will be applied.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   702
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   703
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   704
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   705
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   706
.B vmm userquota d.user@example.com 750m
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   707
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   708
.\" ------------------------------------
473
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   709
.SS userservices (us)
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   710
.B vmm userservices
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   711
.IR address " [" "service ..." ]
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   712
.PP
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   713
To grant a user access to the specified services, use this command.
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   714
.PP
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   715
All omitted services will be deactivated/unusable for the user with the
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   716
given
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   717
.IR address .
9b9cccebccf0 man1: Removed obsolete commands and added new commands.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 432
diff changeset
   718
.\" ------------------------------------
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   719
.SS usertransport (ut)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   720
.BI "vmm usertransport" " address transport"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   721
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   722
A different
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   723
.I transport
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   724
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
   725
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   726
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   727
.br
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   728
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
   729
.BR dsync (1)
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   730
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
   731
can tell Postfix to retry later.
66
995d538a6eb5 * 'VirtualMailManager/Account.py'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 64
diff changeset
   732
.PP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   733
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   734
.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
   735
# 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
   736
.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
   737
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   738
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   739
.SH ALIAS SUBCOMMANDS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   740
.SS aliasadd (aa)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   741
.BI "vmm aliasadd" " address destination ..."
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   742
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   743
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
   744
.I address
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   745
with one or more
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   746
.I destination
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   747
addresses.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   748
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   749
Examples:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   750
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   751
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   752
.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
   753
.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
   754
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   755
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   756
.SS aliasdelete (ad)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   757
.BI "vmm aliasdelete" " address"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   758
.RI [ destination ]
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   759
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   760
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
   761
.IR address .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   762
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   763
If the optional
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   764
.I destination
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   765
address is given, only this
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   766
destination will be removed from the alias.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   767
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   768
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   769
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   770
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   771
.B vmm ad support@example.com d.user@example.com
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   772
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   773
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   774
.SS aliasinfo (ai)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   775
.BI "vmm aliasinfo" " address"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   776
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   777
Information about the alias with the given
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   778
.I address
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   779
can be displayed with this subcommand.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   780
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   781
Example:
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   782
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   783
.nf
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   784
.B vmm aliasinfo support@example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   785
Alias information
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   786
-----------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   787
        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
   788
             * e.user@example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   789
.fi
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   790
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   791
.SH RELOCATED SUBCOMMANDS
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   792
.SS relocatedadd (ra)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   793
.BI "vmm relocatedadd" " address newaddress"
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   794
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   795
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
   796
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   797
.I address
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   798
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
   799
.I newaddress
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   800
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
   801
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   802
Example:
23
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   803
.PP
d5ad5432e9eb * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 22
diff changeset
   804
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   805
.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
   806
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   807
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   808
.SS relocatedinfo (ri)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   809
.BI "vmm relocatedinfo " address
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   810
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   811
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
   812
.IR address .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   813
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   814
Example:
81
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   815
.PP
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   816
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   817
.B vmm relocatedinfo b.user@example.com
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   818
Relocated information
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   819
---------------------
416
f32b323fd347 man: Replaced unnecessary \(aq glyphs in man1/vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 411
diff changeset
   820
        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
   821
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   822
.\" ------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   823
.SS relocateddelete (rd)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   824
.BI "vmm relocateddelete " address
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   825
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   826
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
   827
.IR address .
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   828
.PP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   829
Example:
81
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   830
.PP
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   831
.nf
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   832
.B vmm relocateddelete b.user@example.com
81
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   833
.fi
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   834
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   835
.SH FILES
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   836
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   837
.I /root/vmm.cfg
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   838
will be used when found.
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   839
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   840
.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
   841
will be used when the above file doesn't exist.
81
89b71a9abfcf * 'install.sh'
Pascal Volk <neverseen@users.sourceforge.net>
parents: 79
diff changeset
   842
.TP
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   843
.I /etc/vmm.cfg
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   844
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
   845
.\" -----------------------------------------------------------------------
21
6feb31787a66 * 'vmm.1'
Pascal Volk <neverseen@users.sourceforge.net>
parents:
diff changeset
   846
.SH SEE ALSO
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   847
.BR dsync (1),
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   848
.BR transport (5),
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   849
.BR vmm.cfg (5)
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   850
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   851
.SH INTERNET RESOURCES
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   852
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   853
Wiki
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   854
http://vmm.localdomain.org/
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   855
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   856
Project site
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   857
http://sf.net/projects/vmm/
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   858
.TP
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   859
Bug tracker
477
86fa217cba11 man: Updated the URL of the bug tracker.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 475
diff changeset
   860
https://bitbucket.org/pvo/vmm/issues
410
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   861
.\" -----------------------------------------------------------------------
2bc9c36c1387 man/man1: Reworked/updated vmm.1.
Pascal Volk <neverseen@users.sourceforge.net>
parents: 162
diff changeset
   862
.SH COPYING
478
6278a7a2a476 Updated the author's e-mail address.
Pascal Volk <user@localhost.localdomain.org>
parents: 477
diff changeset
   863
vmm and its manual pages were written by Pascal Volk <user+vmm AT
6278a7a2a476 Updated the author's e-mail address.
Pascal Volk <user@localhost.localdomain.org>
parents: 477
diff changeset
   864
localhost.localdomain.org> and are licensed under the terms of the BSD
6278a7a2a476 Updated the author's e-mail address.
Pascal Volk <user@localhost.localdomain.org>
parents: 477
diff changeset
   865
License.