diff -r 659c4476c57c -r b678a1c43027 man/man1/vmm.1 --- a/man/man1/vmm.1 Mon Mar 24 19:22:04 2014 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1065 +0,0 @@ -.TH "VMM" "1" "2012-09-27" "vmm 0.6" "vmm" -.SH NAME -vmm \- command line tool to manage email domains/accounts/aliases -.\" ----------------------------------------------------------------------- -.SH SYNOPSIS -.B vmm -.IR subcommand " [" "argument ..." ] -.\" ----------------------------------------------------------------------- -.SH DESCRIPTION -.B vmm -(a virtual mail manager) is the easy to use command line tool for -administrators and postmasters to manage (alias) domains, accounts, aliases -and relocated users. -It allows you to simply and quickly administer your mail server. -.br -It's designed for Dovecot and Postfix with a PostgreSQL backend. -.PP -Each -.I subcommand -has both a long and a short form. -The short form is shown enclosed in parentheses. -Both forms are case sensitive. -.PP -Most of the -.IR subcommand s -take one or more -.IR argument s. -.\" ----------------------------------------------------------------------- -.SH ARGUMENTS -.TP 12 -.I address -The complete e\-mail address -.RI ( local\-part @ fqdn ) -of an user account, alias address or relocated user. -.\" -------------------------- -.TP -.I destination -Is either an e\-mail -.I address -when used with -.IR "ALIAS SUBCOMMANDS" . -Or a -.I fqdn -when used with -.IR "ALIASDOMAIN SUBCOMMANDS" . -.\" -------------------------- -.TP -.I fqdn -The fully qualified domain name \- without the trailing dot \- of a domain -or alias domain. -.\" -------------------------- -.TP -.I messages -An integer value which specifies a quota limit in number of messages. -.B 0 -(zero) means unlimited \- no quota limit for the number of messages. -.\" -------------------------- -.TP -.I option -is the name of a configuration option, prefixed with the section name and a -dot. -For example: -.IB misc . transport -.br -All configuration options are described in -.BR vmm.cfg (5). -.\" -------------------------- -.TP -.I service -The name of a service, commonly used with Dovecot. -Supported services are: -.BR imap ", " pop3 ", " sieve " and " smtp . -.\" -------------------------- -.TP -.I storage -Specifies a quota limit in bytes. -One of the following prefixes can be appended to the integer value: -.BR b " (bytes), " k " (kilobytes), " M " (megabytes) or " G -(gigabytes). -.B 0 -(zero) means unlimited \- no quota limit in bytes. -.\" -------------------------- -.TP -.I transport -A transport for Postfix, written as: -.IB transport : -or -.IB transport :\c -.IR nexthop . -See -.BR transport (5) -for more details. -.\" ----------------------------------------------------------------------- -.SH GENERAL SUBCOMMANDS -.SS configget (cg) -.BI "vmm configget" " option" -.PP -This subcommand is used to display the actual value of the given -configuration -.IR option . -.PP -Example: -.PP -.nf -.B vmm configget misc.crypt_sha512_rounds -misc.crypt_sha512_rounds = 5000 -.fi -.\" ------------------------------------ -.SS configset (cs) -.B vmm configset -.I option value -.PP -Use this subcommand to set or update a single configuration option's value. -.I option -is the configuration option, -.I value -is the -.IR option 's -new value. -.IP Note: -This subcommand will create a new -.I vmm.cfg -without any comments. -Your current configuration file will be backed as -.IR vmm.cfg.bak . -.PP -Example: -.PP -.nf -.B vmm configget domain.transport -domain.transport = dovecot: -.B vmm configset domain.transport lmtp:unix:private/dovecot\-lmtp -.B vmm cg domain.transport -domain.transport = lmtp:unix:private/dovecot\-lmtp -.fi -.\" ------------------------------------ -.SS configure (cf) -.B vmm configure -.RI [ section ] -.PP -Starts the interactive configuration for all configuration sections. -.PP -In this process the currently set value of each option will be displayed in -square brackets. -If no value is configured, the default value of each option will be -displayed in square brackets. -Press the return key, to accept the displayed value. -.PP -If the optional argument -.I section -is given, only the configuration options from the given section will be -displayed and will be configurable. -The following sections are available: -.RS -.TP 10 -.B account -Account settings -.TP -.B bin -Paths to external binaries -.TP -.B database -Database settings -.TP -.B domain -Domain settings -.TP -.B mailbox -Mailbox settings -.TP -.B misc -Miscellaneous settings -.RE -.PP -All configuration options are described in -.BR vmm.cfg (5). -.IP Note: -This subcommand will create a new -.I vmm.cfg -without any comments. -Your current configuration file will be backed as -.IR vmm.cfg.bak . -.PP -Example: -.PP -.nf -.B vmm configure mailbox -Using configuration file: /usr/local/etc/vmm.cfg - -* Configuration section: `mailbox' -Enter new value for option folders [Drafts:Sent:Templates:Trash]: -Enter new value for option format [maildir]: mdbox -Enter new value for option subscribe [True]: -Enter new value for option root [Maildir]: mdbox -.fi -.\" ------------------------------------ -.SS getuser (gu) -.BI "vmm getuser" " uid" -.PP -If only the -.I uid -is available, for example from process list, the subcommand -.B getuser -will show the user's address. -.PP -Example: -.PP -.nf -.B vmm getuser 79876 -Account information -------------------- - UID............: 79876 - GID............: 70704 - Address........: a.user@example.com -.fi -.\" ------------------------------------ -.SS help (h) -.B vmm help -.RI [ subcommand ] -.PP -Prints a list of available subcommands with a short description to stdout. -When a -.I subcommand -was given, help for that -.I subcommand -will be displayed. -After this -.B vmm -exits. -.\" ------------------------------------ -.SS listdomains (ld) -.B vmm listdomains -.RI [ pattern ] -.PP -This subcommand lists all available domains. -All domain names will be prefixed either with `[+]', if the domain is a -primary domain, or with `[-]', if it is an alias domain name. -The output can be limited with an optional -.IR pattern . -.PP -To perform a wild card search, the % character can be used at the start -and/or the end of the -.IR pattern . -.PP -Example: -.PP -.nf -.B vmm listdomains %example% -Matching domains ----------------- - [+] example.com - [\-] e.g.example.com - [\-] example.name - [+] example.net - [+] example.org -.fi -.\" ------------------------------------ -.SS listaddresses (ll) -.B vmm listaddresses -.RI [ pattern ] -.PP -This command lists all defined addresses. Addresses belonging to -alias-domains are prefixed with a '-', addresses of regular domains with -a '+'. Additionally, the letters 'u', 'a', and 'r' indicate the type of -each address: user, alias and relocated respectively. -The output can be limited with an optional -.IR pattern . -.PP -To perform a wild card search, the % character can be used at the start -and/or the end of the -.IR pattern . -.PP -Example: -.PP -.nf -.B vmm listaddresses example.com -.B vmm listaddresses %master@% -.\" ------------------------------------ -.SS listaliases (la) -.B vmm listaliases -.RI [ pattern ] -.PP -This command lists all defined aliases. Aliases belonging to -alias-domains are prefixed with a '-', addresses of regular domains with -a '+'. -The output can be limited with an optional -.IR pattern . -.PP -To perform a wild card search, the % character can be used at the start -and/or the end of the -.IR pattern . -.PP -Example: -.PP -.nf -.B vmm listaliases example.com -.B vmm listaliases %master@% -.\" ------------------------------------ -.SS listrelocated (lr) -.B vmm listrelocated -.RI [ pattern ] -.PP -This command lists all defined relocated addresses. Relocated entries -belonging to alias-domains are prefixed with a '-', addresses of regular -domains with -a '+'. -The output can be limited with an optional -.IR pattern . -.PP -To perform a wild card search, the % character can be used at the start -and/or the end of the -.IR pattern . -.PP -Example: -.PP -.nf -.B vmm listrelocated example.com -.B vmm listrelocated %master@% -.\" ------------------------------------ -.SS listusers (lu) -.B vmm listusers -.RI [ pattern ] -.PP -This command lists all user accounts. User accounts belonging to -alias-domains are prefixed with a '-', addresses of regular -domains with -a '+'. -The output can be limited with an optional -.IR pattern . -.PP -To perform a wild card search, the % character can be used at the start -and/or the end of the -.IR pattern . -.PP -Example: -.PP -.nf -.B vmm listusers example.com -.B vmm listusers %master@% -.\" ------------------------------------ -.SS listpwschemes (lp) -.B vmm listpwschemes -.PP -This subcommand lists all password schemes which could be used in the -.I vmm.cfg -as value of the -.I misc.password_scheme -option. -The output varies, depending on the used Dovecot version and the system's -libc. -.br -When your Dovecot installation isn't too old, you will see additionally a -few usable encoding suffixes. -One of them can be appended to the password scheme. -.PP -Example: -.PP -.nf -.B vmm listpwschemes -Usable password schemes ------------------------ - CRYPT SHA512-CRYPT LDAP-MD5 DIGEST-MD5 SHA256 SHA512 SSHA512 - SKEY SSHA NTLM RPA MD5-CRYPT HMAC-MD5 SHA1 PLAIN SHA CRAM-MD5 - SSHA256 MD5 LANMAN CLEARTEXT PLAIN-MD5 PLAIN-MD4 OTP SMD5 - SHA256-CRYPT - -Usable encoding suffixes ------------------------- - .B64 .BASE64 .HEX -.fi -.\" ------------------------------------ -.SS version (v) -.B vmm version -.PP -Prints -.BR vmm 's -version and copyright information to stdout. -After this -.B vmm -exits. -.\" ----------------------------------------------------------------------- -.SH DOMAIN SUBCOMMANDS -.SS domainadd (da) -.B vmm domainadd -.IR fqdn " [" transport ] -.PP -Adds the new domain into the database and creates the domain directory. -.PP -If the optional argument -.I transport -is given, it will override the default transport -.RI ( domain.transport ") from " vmm.cfg . -The specified -.I transport -will be the default transport for all new accounts in this domain. -.PP -Configuration\-related behavior: -.RS -.TP -.I domain.auto_postmaster -When that option is set to -.BR true " (default) " vmm -will automatically create the postmaster account for the new domain and -prompt for -.BI postmaster@ fqdn\c -\(aqs password. -.TP -.I account.random_password -When the value of that option is also set to -.BR true ", " vmm -will automatically create the postmaster account for the new domain and -print the generated postmaster password to stdout. -.RE -.PP -Examples: -.PP -.nf -.B vmm domainadd support.example.com smtp:[mx1.example.com]:2025 -Creating account for postmaster@support.example.com -Enter new password: -Retype new password: -.B vmm cs account.random_password true -.B vmm domainadd sales.example.com -Creating account for postmaster@sales.example.com -Generated password: pLJUQ6Xg_z -.fi -.\" ------------------------------------ -.SS domaindelete (dd) -.BI "vmm domaindelete " fqdn -.RB [ force ] -.PP -This subcommand deletes the domain specified by -.IR fqdn . -.PP -If there are accounts, aliases and/or relocated users assigned to the given -domain, -.B vmm -will abort the requested operation and show an error message. -If you know, what you are doing, you can specify the optional keyword -.BR force . -.PP -If you really always know what you are doing, edit your -.I vmm.cfg -and set the option -.I domain.force_deletion -to -.BR true . -.\" ------------------------------------ -.SS domaininfo (di) -.B vmm domaininfo -.IR fqdn \ [ details ] -.PP -This subcommand shows some information about the given domain. -.PP -For a more detailed information about the domain the optional argument -.I details -can be specified. -A possible -.I details -value can be one of the following six keywords: -.RS -.TP 14 -.B accounts -to list the e\-mail addresses of all existing user accounts -.TP -.B aliasdomains -to list all assigned alias domain names -.TP -.B aliases -to list all available alias e\-mail addresses -.TP -.B catchall -to list all catch\-all destinations -.TP -.B relocated -to list the e\-mail addresses of all relocated users -.TP -.B full -to list all information mentioned above -.RE -.PP -Example: -.PP -.nf -.B vmm domaininfo sales.example.com -Domain information ------------------- - Domain Name......: sales.example.com - GID..............: 70708 - Domain Directory.: /srv/mail/c/70708 - Quota Limit/User.: Storage: 500.00 MiB; Messages: 10,000 - Active Services..: IMAP SIEVE - Transport........: lmtp:unix:private/dovecot-lmtp - Alias Domains....: 0 - Accounts.........: 1 - Aliases..........: 0 - Relocated........: 0 - Catch-All Dests..: 1 -.fi -.\" ------------------------------------ -.SS domainquota (dq) -.B vmm domainquota -.IR "fqdn storage" " [" messages ] -.RB [ force ] -.PP -This subcommand is used to configure a new quota limit for the accounts of -the domain - not for the domain itself. -.PP -The default quota limit for accounts is defined in the -.IR vmm.cfg " (" domain.quota_bytes " and " domain.quota_messages ). -.PP -The new quota limit will affect only those accounts for which the limit -has not been overridden. If you want to restore the default to all accounts, -you may pass the keyword -.BR force . -.br -When the argument -.I messages -was omitted the default number of messages -.B 0 -(zero) will be applied. -.PP -Example: -.PP -.nf -.B vmm domainquota example.com 1g force -.fi -.\" ------------------------------------ -.SS domainservices (ds) -.B vmm domainservices -.IR fqdn " [" "service ..." ] -.RB [ force ] -.PP -To define which services could be used by the users of the domain \(em with -the given -.I fqdn -\(em use this subcommand. -.PP -Each specified -.I service -will be enabled/usable. -All other services will be deactivated/unusable. -Possible service names are: -.BR imap ", " pop3 ", " sieve " and " smtp . -.br -The new service set will affect only those accounts for which the set has not -been overridden. If you want to restore the default to all accounts, you may -pass the keyword -.BR force . -.\" ------------------------------------ -.SS domaintransport (dt) -.BI "vmm domaintransport" " fqdn transport" -.RB [ force ] -.PP -A new transport for the indicated domain can be set with this subcommand. -.PP -The new transport will affect only those accounts for which the transport has -not been overridden. If you want to restore the default to all accounts, you -may pass the keyword -.BR force . -.PP -Example: -.PP -.nf -.B vmm domaintransport support.example.com dovecot: -.fi -.\" ------------------------------------ -.SS domainnote (do) -.BI "vmm domainnote" " fqdn" -.RI [ note ] -.PP -With this subcommand, it is possible to attach a note to the specified -domain. Without an argument, an existing note is removed. -.PP -Example: -.PP -.nf -.B vmm do example.com Belongs to Robert -.fi -.\" ----------------------------------------------------------------------- -.SH ALIAS DOMAIN SUBCOMMANDS -An alias domain is an alias for a domain that was previously added with the -subcommand -.BR domainadd . -All accounts, aliases and relocated users from the domain will be also -available in the alias domain. -.br -In the following is to be assumed that example.net is an alias for -example.com. -.PP -Postfix will not accept erroneously e\-mails for unknown.user@example.net -and bounce them back later to the mostly faked sender. -Postfix will immediately reject all e\-mails addressed to nonexistent -users. -.br -This behavior is ensured as long as you use the recommended database -queries in your -.I $config_directory/pgsql\-*.cf -configuration files. -.\" ------------------------------------ -.SS aliasdomainadd (ada) -.BI "vmm aliasdomainadd" " fqdn destination" -.PP -This subcommand adds the new alias domain -.RI ( fqdn ) -to the -.I destination -domain that should be aliased. -.PP -Example: -.PP -.nf -.B vmm aliasdomainadd example.net example.com -.fi -.\" ------------------------------------ -.SS aliasdomaindelete (add) -.BI "vmm aliasdomaindelete" " fqdn" -.PP -Use this subcommand if the alias domain -.I fqdn -should be removed. -.PP -Example: -.PP -.nf -.B vmm aliasdomaindelete e.g.example.com -.fi -.\" ------------------------------------ -.SS aliasdomaininfo (adi) -.BI "vmm aliasdomaininfo" " fqdn" -.PP -This subcommand shows to which domain the alias domain -.I fqdn -is assigned to. -.PP -Example: -.PP -.nf -.B vmm adi example.net -Alias domain information ------------------------- - The alias domain example.net belongs to: - * example.com -.fi -.\" ------------------------------------ -.SS aliasdomainswitch (ads) -.BI "vmm aliasdomainswitch" " fqdn destination" -.PP -If the destination of the existing alias domain -.I fqdn -should be switched to another -.I destination -use this subcommand. -.nf -.PP -Example: -.PP -.B vmm aliasdomainswitch example.name example.org -.fi -.\" ----------------------------------------------------------------------- -.SH ACCOUNT SUBCOMMANDS -.SS useradd (ua) -.B vmm useradd -.IR address " [" password ] -.PP -Use this subcommand to create a new e\-mail account for the given -.IR address . -.PP -If the -.I password -is not provided, -.B vmm -will prompt for it interactively. -When no -.I password -is provided and -.I account.random_password -is set to -.BR true ", " vmm -will generate a random password and print it to stdout after the account -has been created. -.PP -Examples: -.PP -.nf -.B vmm ua d.user@example.com \(dqA 5ecR3t P4s5\(rs/\(rs/0rd\(dq -.B vmm useradd e.user@example.com -Enter new password: -Retype new password: -.fi -.\" ------------------------------------ -.SS userdelete (ud) -.BI "vmm userdelete" " address" -.RB [ force ] -.PP -Use this subcommand to delete the account with the given -.IR address . -.PP -If there are one or more aliases with an identical destination address, -.B vmm -will abort the requested operation and show an error message. -To prevent this, specify the optional keyword -.BR force . -.\" ------------------------------------ -.SS userinfo (ui) -.B "vmm userinfo" -.IR address " [" details ] -.PP -This subcommand displays some information about the account specified by -.IR address . -.PP -If the optional argument -.I details -is given some more information will be displayed. -Possible values for -.I details -are: -.RS -.TP 8 -.B aliases -to list all alias addresses with the destination -.I address -.TP -.B du -to display the disk usage of the user's mail directory. -In order to summarize the disk usage each time this subcommand is -executed automatically, set -.I account.disk_usage -in your -.I vmm.cfg -to -.BR true . -.TP -.B full -to list all information mentioned above -.RE -.PP -Example: -.PP -.nf -.B vmm ui d.user@example.com -Account information -------------------- - Address..........: d.user@example.com - Name.............: None - UID..............: 79881 - GID..............: 70704 - Home.............: /srv/mail/2/70704/79881 - Mail_Location....: mdbox:~/mdbox - Quota Storage....: [ 0.00%] 0/500.00 MiB - Quota Messages...: [ 0.00%] 0/10,000 - Transport........: lmtp:unix:private/dovecot-lmtp - SMTP.............: disabled - POP3.............: disabled - IMAP.............: enabled - SIEVE............: enabled -.fi -.\" ------------------------------------ -.SS username (un) -.BI "vmm username" " address" -.RI [ name ] -.PP -The user's real -.I name -can be set/updated with this subcommand. -.PP -If no -.I name -is given, the value stored for the account is erased. -.PP -Example: -.PP -.nf -.B vmm un d.user@example.com \(dqJohn Doe\(dq -.fi -.\" ------------------------------------ -.SS userpassword (up) -.BI "vmm userpassword" " address" -.RI [ password ] -.PP -The password of an account can be updated with this subcommand. -.PP -If no -.I password -was provided, -.B vmm -will prompt for it interactively. -.PP -Example: -.PP -.nf -.B vmm up d.user@example.com \(dqA |\(rs/|0r3 5ecur3 P4s5\(rs/\(rs/0rd?\(dq -.fi -.\" ------------------------------------ -.SS usernote (uo) -.BI "vmm usernote" " address" -.RI [ note ] -.PP -With this subcommand, it is possible to attach a note to the specified -account. Without an argument, an existing note is removed. -.PP -Example: -.PP -.nf -.B vmm uo d.user@example.com Only needed until end of May 2012 -.fi -.\" ------------------------------------ -.SS userquota (uq) -.BI "vmm userquota" " address storage" -.RI [ messages ] -.PP -This subcommand is used to set a new quota limit for the given account. -.PP -When the argument -.I messages -was omitted the default number of messages -.B 0 -(zero) will be applied. -.PP -Instead of -.I storage -pass the keyword -.B domain -to remove the account\-specific override, causing the domain's value to be -in effect. -.PP -Example: -.PP -.nf -.B vmm userquota d.user@example.com 750m -.fi -.\" ------------------------------------ -.SS userservices (us) -.B vmm userservices -.IR address " [" "service ..." ] -.PP -To grant a user access to the specified services, use this command. -.PP -All omitted services will be deactivated/unusable for the user with the -given -.IR address . -.PP -Instead of -.I service -pass 'domain' to remove the account\-specific override, causing the -domain's value to be in effect. -.PP -Example: -.PP -.nf -.B vmm userservices d.user@example.com SMTP IMAP -.\" ------------------------------------ -.SS usertransport (ut) -.BI "vmm usertransport" " address transport" -.PP -A different -.I transport -for an account can be specified with this subcommand. -.PP -Instead of -.I transport -pass 'domain' to remove the account\-specific override, causing the -domain's value to be in effect. -.PP -Example: -.br -Assumed you want to use Dovecot's -.BR dsync (1) -to convert a user's mailbox from Maildir format to mdbox format, you -can tell Postfix to retry later. -.PP -.nf -.B vmm ut d.user@example.com \(dqretry:4.0.0 Mailbox being migrated\(dq -# convert the mailbox ... then set the transport to Dovecot's lmtp -.B vmm ut d.user@example.com lmtp:unix:private/dovecot\-lmtp -.fi -.\" ----------------------------------------------------------------------- -.SH ALIAS SUBCOMMANDS -.SS aliasadd (aa) -.BI "vmm aliasadd" " address destination ..." -.PP -This subcommand is used to create a new alias -.I address -with one or more -.I destination -addresses. -.PP -Within the destination address, the placeholders -.IR %n , -.IR %d , -and -.IR %= -will be replaced by the local part, the domain, or the email address with '@' -replaced by '=' respectively. In combination with alias domains, this enables -domain\-specific destinations. -.PP -Examples: -.PP -.nf -.B vmm aliasadd john.doe@example.com d.user@example.com -.B vmm aa support@example.com d.user@example.com e.user@example.com -.B vmm aa postmaster@example.com postmaster+%d@example.org -.fi -.\" ------------------------------------ -.SS aliasdelete (ad) -.BI "vmm aliasdelete" " address" -.RI [ destination " ...]" -.PP -This subcommand is used to delete one or multiple -.IR destination s -from the alias with the given -.IR address . -.PP -When no -.I destination -address was specified the alias with all its destinations will be deleted. -.PP -Example: -.PP -.nf -.B vmm ad support@example.com d.user@example.com -.fi -.\" ------------------------------------ -.SS aliasinfo (ai) -.BI "vmm aliasinfo" " address" -.PP -Information about the alias with the given -.I address -can be displayed with this subcommand. -.PP -Example: -.PP -.nf -.B vmm aliasinfo support@example.com -Alias information ------------------ - Mail for support@example.com will be redirected to: - * e.user@example.com -.fi -.\" ----------------------------------------------------------------------- -.SH RELOCATED SUBCOMMANDS -.SS relocatedadd (ra) -.BI "vmm relocatedadd" " address newaddress" -.PP -A new relocated user can be created with this subcommand. -.PP -.I address -is the user's ex\-email address, for example b.user@example.com, and -.I newaddress -points to the new email address where the user can be reached. -.PP -Example: -.PP -.nf -.B vmm relocatedadd b.user@example.com b\-user@company.tld -.fi -.\" ------------------------------------ -.SS relocatedinfo (ri) -.BI "vmm relocatedinfo " address -.PP -This subcommand shows the new address of the relocated user with the given -.IR address . -.PP -Example: -.PP -.nf -.B vmm relocatedinfo b.user@example.com -Relocated information ---------------------- - User `b.user@example.com' has moved to `b\-user@company.tld' -.fi -.\" ------------------------------------ -.SS relocateddelete (rd) -.BI "vmm relocateddelete " address -.PP -Use this subcommand in order to delete the relocated user with the given -.IR address . -.PP -Example: -.PP -.nf -.B vmm relocateddelete b.user@example.com -.fi -.\" ----------------------------------------------------------------------- -.SH CATCH\-ALL SUBCOMMANDS -.SS catchalladd (caa) -.BI "vmm catchalladd" " fqdn destination ..." -.PP -This subcommand allows to specify destination addresses for a domain, which -shall receive mail addressed to unknown local parts within that domain. -Those catch\-all aliases hence \(dqcatch all\(dq mail to any address in the -domain (unless a more specific alias, mailbox or relocated entry exists). -.PP -WARNING: Catch\-all addresses can cause mail server flooding because -spammers like to deliver mail to all possible combinations of names, e.g. -to all addresses between abba@example.org and zztop@example.org. -.PP -Example: -.PP -.nf -.B vmm catchalladd example.com user@example.org -.fi -.\" ------------------------------------ -.SS catchallinfo (cai) -.BI "vmm catchallinfo " fqdn -.PP -This subcommand displays information about catch\-all aliases defined for -a domain. -.PP -Example: -.PP -.nf -.B vmm catchallinfo example.com -Catch-all information ---------------------- - Mail to unknown localparts in domain example.com will be sent to: - * user@example.org -.fi -.\" ------------------------------------ -.SS catchalldelete (cad) -.BI "vmm catchalldelete " fqdn -.RI [ destination " ...]" -.PP -With this subcommand, catch\-all aliases defined for a domain can be -removed, either all of them, or those -.IR destination s -which were specified explicitly. -.PP -Example: -.PP -.nf -.B vmm catchalldelete example.com user@example.com -.fi -.\" ----------------------------------------------------------------------- -.SH FILES -.TP -.I /root/vmm.cfg -will be used when found. -.TP -.I /usr/local/etc/vmm.cfg -will be used when the above file doesn't exist. -.TP -.I /etc/vmm.cfg -will be used when none of the both above mentioned files exists. -.\" ----------------------------------------------------------------------- -.SH SEE ALSO -.BR dsync (1), -.BR transport (5), -.BR vmm.cfg (5) -.\" ----------------------------------------------------------------------- -.SH INTERNET RESOURCES -.TP -Homepage -http://vmm.localdomain.org/ -.TP -Project site -http://sf.net/projects/vmm/ -.TP -Bug tracker -https://bitbucket.org/pvo/vmm/issues -.\" ----------------------------------------------------------------------- -.SH COPYING -vmm and its manual pages were written by Pascal Volk and are licensed under the terms of the BSD -License. \ No newline at end of file