doc/web/source/howto/general_subcommands.rst
author Pascal Volk <user@localhost.localdomain.org>
Mon, 27 Jan 2014 21:27:21 +0000
changeset 702 01db2457bbed
parent 622 e60b8ed5fd35
child 682 697350dd9369
permissions -rw-r--r--
VMM/handler: Improved domaininfo subcommand. Check all labels for ASCII-compatible encoding, not only the first one. If something is in ACE format, convert it to IDNA.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
591
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     1
===================
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     2
General subcommands
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     3
===================
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     4
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     5
configget
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     6
---------
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     7
Syntax:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     8
 | **vmm configget** *option*
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
     9
 | **vmm cg** *option*
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    10
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    11
This subcommand is used to display the actual value of the given
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    12
configuration *option*.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    13
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    14
Example:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    15
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    16
.. code-block:: console
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    17
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    18
 root@host:~# vmm configget misc.crypt_sha512_rounds
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    19
 misc.crypt_sha512_rounds = 5000
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    20
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    21
.. versionadded:: 0.6.0
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    22
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    23
configset
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    24
---------
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    25
Syntax:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    26
 | **vmm configset** *option value*
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    27
 | **vmm cs** *option value*
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    28
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    29
Use this subcommand to set or update a single configuration option's value.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    30
*option* is the configuration option, *value* is the *option*'s new value.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    31
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    32
.. note::
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    33
 This subcommand will create a new :file:`vmm.cfg` without any comments.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    34
 Your current configuration file will be backed as :file:`vmm.cfg.bak`.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    35
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    36
Example:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    37
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    38
.. code-block:: console
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    39
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    40
 root@host:~# vmm configget domain.transport
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    41
 domain.transport = dovecot:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    42
 root@host:~# vmm configset domain.transport lmtp:unix:private/dovecot-lmtp
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    43
 root@host:~# vmm cg domain.transport
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    44
 domain.transport = lmtp:unix:private/dovecot-lmtp
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    45
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    46
.. versionadded:: 0.6.0
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    47
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    48
configure
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    49
---------
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    50
Syntax:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    51
 | **vmm configure** [*section*]
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    52
 | **vmm cf** [*section*]
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    53
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    54
Starts the interactive configuration for all configuration sections.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    55
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    56
In this process the currently set value of each option will be displayed
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    57
in square brackets.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    58
If no value is configured, the default value of each option will be
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    59
displayed in square brackets.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    60
Press the return key, to accept the displayed value.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    61
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    62
If the optional argument *section* is given, only the configuration options
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    63
from the given section will be displayed and will be configurable.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    64
The following sections are available:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    65
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    66
======== ==========================
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    67
section  description
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    68
======== ==========================
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    69
account  Account settings
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    70
bin      Paths to external binaries
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    71
database Database settings
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    72
domain   Domain settings
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    73
mailbox  Mailbox settings
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    74
misc     Miscellaneous settings
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    75
======== ==========================
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    76
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    77
All configuration options are described in :manpage:`vmm.cfg(5)`.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    78
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    79
.. note::
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    80
 This subcommand will create a new :file:`vmm.cfg` without any comments.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    81
 Your current configuration file will be backed as :file:`vmm.cfg.bak`.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    82
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    83
Example:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    84
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    85
.. code-block:: console
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    86
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    87
 root@host:~# vmm configure mailbox
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    88
 Using configuration file: /usr/local/etc/vmm.cfg
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    89
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    90
 * Configuration section: `mailbox'
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    91
 Enter new value for option folders [Drafts:Sent:Templates:Trash]:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    92
 Enter new value for option format [maildir]: mdbox
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    93
 Enter new value for option subscribe [True]:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    94
 Enter new value for option root [Maildir]: mdbox
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    95
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    96
getuser
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    97
-------
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    98
Syntax:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
    99
 | **vmm getuser** *uid*
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   100
 | **vmm gu** *ui*
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   101
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   102
If only the *uid* is available, for example from process list, the
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   103
subcommand **getuser** will show the user's address.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   104
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   105
Example:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   106
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   107
.. code-block:: console
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   108
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   109
 root@host:~# vmm getuser 79876
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   110
 Account information
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   111
 -------------------
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   112
         UID............: 79876
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   113
         GID............: 70704
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   114
         Address........: a.user@example.com
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   115
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   116
help
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   117
----
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   118
Syntax:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   119
 | **vmm help** [*subcommand*]
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   120
 | **vmm h** [*subcommand*]
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   121
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   122
Prints a list of available subcommands with a short description to stdout.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   123
When a *subcommand* was given, help for that *subcommand* will be displayed.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   124
After this :command:`vmm` exits.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   125
622
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   126
listaddresses
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   127
-------------
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   128
Syntax:
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   129
 | **vmm listaddresses** [*pattern*]
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   130
 | **vmm ll** [*pattern*]
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   131
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   132
This command lists all defined addresses. Addresses belonging to
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   133
alias-domains are prefixed with a '-', addresses of regular domains with
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   134
a '+'.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   135
Additionally, the letters 'u', 'a', and 'r' indicate the type of each
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   136
address: user, alias and relocated respectively. The output can be limited
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   137
with an optional *pattern*.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   138
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   139
To perform a wild card search, the **%** character can be used at the start
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   140
and/or the end of the *pattern*.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   141
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   142
Example:
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   143
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   144
.. code-block:: console
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   145
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   146
 root@host:~# vmm ll example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   147
 Matching addresses
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   148
 ------------------
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   149
         [u+] a.user@example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   150
         [r+] b.user@example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   151
         [u+] d.user@example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   152
         [u+] john.doe@example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   153
         [u+] postmaster@example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   154
         [a+] support@example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   155
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   156
.. versionadded:: 0.6.0
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   157
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   158
listaliases
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   159
-----------
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   160
Syntax:
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   161
 | **vmm listaliases** [*pattern*]
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   162
 | **vmm la** [*pattern*]
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   163
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   164
This command lists all defined aliases. Aliases belonging to alias-domains
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   165
are prefixed with a '-', addresses of regular domains with a '+'.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   166
The output can be limited with an optional *pattern*.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   167
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   168
To perform a wild card search, the **%** character can be used at the start
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   169
and/or the end of the *pattern*.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   170
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   171
Example:
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   172
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   173
.. code-block:: console
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   174
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   175
 root@host:~# vmm listaliases example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   176
 Matching aliases
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   177
 ----------------
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   178
         [+] support@example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   179
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   180
.. versionadded:: 0.6.0
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   181
591
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   182
listdomains
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   183
-----------
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   184
Syntax:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   185
 | **vmm listdomains** [*pattern*]
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   186
 | **vmm ld** [*pattern*]
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   187
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   188
This subcommand lists all available domains.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   189
All domain names will be prefixed either with '[+]', if the domain is
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   190
a primary domain, or with '[-]', if it is an alias domain name.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   191
The output can be limited with an optional pattern.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   192
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   193
To perform a wild card search, the **%** character can be used at the start
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   194
and/or the end of the *pattern*.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   195
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   196
Example:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   197
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   198
.. code-block:: console
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   199
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   200
 root@host:~# vmm listdomains %example%
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   201
 Matching domains
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   202
 ----------------
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   203
         [+] example.com
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   204
         [-]     e.g.example.com
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   205
         [-]     example.name
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   206
         [+] example.net
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   207
         [+] example.org
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   208
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   209
listpwschemes
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   210
-------------
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   211
Syntax:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   212
 | **vmm listpwschemes**
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   213
 | **vmm lp**
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   214
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   215
This subcommand lists all password schemes which could be used in the
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   216
:file:`vmm.cfg` as value of the *misc.password_scheme* option.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   217
The output varies, depending on the used Dovecot version and the system's
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   218
libc.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   219
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   220
When your Dovecot installation isn't too old, you will see additionally
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   221
a few usable encoding suffixes.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   222
One of them can be appended to the password scheme.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   223
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   224
Example:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   225
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   226
.. code-block:: console
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   227
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   228
 root@host:~# vmm listpwschemes
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   229
 Usable password schemes
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   230
 -----------------------
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   231
         CRYPT SHA512-CRYPT LDAP-MD5 DIGEST-MD5 SHA256 SHA512 SSHA512
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   232
         SKEY SSHA NTLM RPA MD5-CRYPT HMAC-MD5 SHA1 PLAIN SHA CRAM-MD5
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   233
         SSHA256 MD5 LANMAN CLEARTEXT PLAIN-MD5 PLAIN-MD4 OTP SMD5
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   234
         SHA256-CRYPT
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   235
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   236
 Usable encoding suffixes
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   237
 ------------------------
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   238
         .B64 .BASE64 .HEX
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   239
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   240
.. versionadded:: 0.6.0
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   241
622
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   242
listrelocated
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   243
-------------
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   244
Syntax:
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   245
 | **vmm listrelocated** [*pattern*]
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   246
 | **vmm lr** [*pattern*]
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   247
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   248
This command lists all defined relocated addresses.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   249
Relocated entries belonging to alias-domains are prefixed with a '-',
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   250
addresses of regular domains with a '+'.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   251
The output can be limited with an optional *pattern*.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   252
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   253
To perform a wild card search, the **%** character can be used at the start
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   254
and/or the end of the *pattern*.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   255
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   256
Example:
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   257
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   258
.. code-block:: console
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   259
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   260
 root@host:~# vmm listrelocated example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   261
 Matching relocated users
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   262
 ------------------------
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   263
         [+] b.user@example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   264
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   265
.. versionadded:: 0.6.0
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   266
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   267
listusers
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   268
---------
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   269
Syntax:
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   270
 | **vmm listusers** [*pattern*]
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   271
 | **vmm lu** [*pattern*]
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   272
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   273
This command lists all user accounts.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   274
User accounts belonging to alias-domains are prefixed with a '-', addresses
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   275
of regular domains with a '+'.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   276
The output can be limited with an optional *pattern*.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   277
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   278
To perform a wild card search, the **%** character can be used at the start
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   279
and/or the end of the *pattern*.
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   280
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   281
Example:
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   282
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   283
.. code-block:: console
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   284
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   285
 root@host:~# vmm listusers example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   286
 Matching user accounts
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   287
 ----------------------
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   288
         [+] a.user@example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   289
         [+] d.user@example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   290
         [+] john.doe@example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   291
         [+] postmaster@example.com
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   292
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   293
.. versionadded:: 0.6.0
e60b8ed5fd35 doc/web: Updated and extended documentation.
Pascal Volk <user@localhost.localdomain.org>
parents: 591
diff changeset
   294
591
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   295
version
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   296
-------
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   297
Syntax:
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   298
 | **vmm version**
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   299
 | **vmm v**
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   300
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   301
Prints :command:`vmm`'s version and copyright information to stdout.
2b165e90e225 doc/web: Added the 'Howto'.
Pascal Volk <user@localhost.localdomain.org>
parents:
diff changeset
   302
After this :command:`vmm` exits.