man/man1/vmm.1
branchv0.6.x
changeset 475 e321b764268e
parent 473 9b9cccebccf0
child 477 86fa217cba11
equal deleted inserted replaced
474:4353981e3a7f 475:e321b764268e
     1 .TH "VMM" "1" "2011-11-09" "vmm 0.6" "vmm"
     1 .TH "VMM" "1" "2011-11-10" "vmm 0.6" "vmm"
     2 .SH NAME
     2 .SH NAME
     3 vmm \- command line tool to manage email domains/accounts/aliases
     3 vmm \- command line tool to manage email domains/accounts/aliases
     4 .\" -----------------------------------------------------------------------
     4 .\" -----------------------------------------------------------------------
     5 .SH SYNOPSIS
     5 .SH SYNOPSIS
     6 .B vmm
     6 .B vmm
   204 will show the user's address.
   204 will show the user's address.
   205 .PP
   205 .PP
   206 Example:
   206 Example:
   207 .PP
   207 .PP
   208 .nf
   208 .nf
   209 .B vmm getuser 70772
   209 .B vmm getuser 79876
   210 Account information
   210 Account information
   211 -------------------
   211 -------------------
   212         UID............: 70772
   212         UID............: 79876
   213         GID............: 70312
   213         GID............: 70704
   214         Address........: a.user@example.com
   214         Address........: a.user@example.com
   215 .fi
   215 .fi
   216 .\" ------------------------------------
   216 .\" ------------------------------------
   217 .SS help (h)
   217 .SS help (h)
   218 .B vmm help
   218 .B vmm help
   331 .PP
   331 .PP
   332 Examples:
   332 Examples:
   333 .PP
   333 .PP
   334 .nf
   334 .nf
   335 .B vmm domainadd support.example.com smtp:[mx1.example.com]:2025
   335 .B vmm domainadd support.example.com smtp:[mx1.example.com]:2025
       
   336 Creating account for postmaster@support.example.com
   336 Enter new password:
   337 Enter new password:
   337 Retype new password:
   338 Retype new password:
   338 .B vmm cs account.random_password true
   339 .B vmm cs account.random_password true
   339 .B vmm domainadd sales.example.com
   340 .B vmm domainadd sales.example.com
   340 Generated password: hHu8DeTC
   341 Creating account for postmaster@sales.example.com
       
   342 Generated password: pLJUQ6Xg_z
   341 .fi
   343 .fi
   342 .\" ------------------------------------
   344 .\" ------------------------------------
   343 .SS domaindelete (dd)
   345 .SS domaindelete (dd)
   344 .BI "vmm domaindelete " fqdn
   346 .BI "vmm domaindelete " fqdn
   345 .RB [ force ]
   347 .RB [ force ]
   395 .PP
   397 .PP
   396 .nf
   398 .nf
   397 .B vmm domaininfo sales.example.com
   399 .B vmm domaininfo sales.example.com
   398 Domain information
   400 Domain information
   399 ------------------
   401 ------------------
   400         Domainname.....: sales.example.com
   402         Domain Name......: sales.example.com
   401         GID............: 70698
   403         GID..............: 70708
   402         Transport......: dovecot:
   404         Domain Directory.: /srv/mail/c/70708
   403         Domaindir......: /srv/mail/k/70698
   405         Quota Limit/User.: Storage: 500.00 MiB; Messages: 10,000
   404         Quota Limit....: Storage: 0; Messages: 0
   406         Active Services..: IMAP SIEVE
   405         Aliasdomains...: 0
   407         Transport........: lmtp:unix:private/dovecot-lmtp
   406         Accounts.......: 1
   408         Alias Domains....: 0
   407         Aliases........: 0
   409         Accounts.........: 1
   408         Relocated......: 0
   410         Aliases..........: 0
       
   411         Relocated........: 0
   409 .fi
   412 .fi
   410 .\" ------------------------------------
   413 .\" ------------------------------------
   411 .SS domainquota (dq)
   414 .SS domainquota (dq)
   412 .B vmm domainquota
   415 .B vmm domainquota
   413 .IR "fqdn storage" " [" messages ]
   416 .IR "fqdn storage" " [" messages ]
   481 subcommand
   484 subcommand
   482 .BR domainadd .
   485 .BR domainadd .
   483 All accounts, aliases and relocated users from the domain will be also
   486 All accounts, aliases and relocated users from the domain will be also
   484 available in the alias domain.
   487 available in the alias domain.
   485 .br
   488 .br
   486 In the following is to be assumed that example.name is an alias for
   489 In the following is to be assumed that example.net is an alias for
   487 example.com.
   490 example.com.
   488 .PP
   491 .PP
   489 Postfix will not accept erroneously e\-mails for unknown.user@example.name
   492 Postfix will not accept erroneously e\-mails for unknown.user@example.net
   490 and bounce them back later to the mostly faked sender.
   493 and bounce them back later to the mostly faked sender.
   491 Postfix will immediately reject all e\-mails addressed to nonexistent
   494 Postfix will immediately reject all e\-mails addressed to nonexistent
   492 users.
   495 users.
   493 .br
   496 .br
   494 This behavior is ensured as long as you use the recommended database
   497 This behavior is ensured as long as you use the recommended database
   506 domain that should be aliased.
   509 domain that should be aliased.
   507 .PP
   510 .PP
   508 Example:
   511 Example:
   509 .PP
   512 .PP
   510 .nf
   513 .nf
   511 .B vmm aliasdomainadd example.name example.com
   514 .B vmm aliasdomainadd example.net example.com
   512 .fi
   515 .fi
   513 .\" ------------------------------------
   516 .\" ------------------------------------
   514 .SS aliasdomaindelete (add)
   517 .SS aliasdomaindelete (add)
   515 .BI "vmm aliasdomaindelete" " fqdn"
   518 .BI "vmm aliasdomaindelete" " fqdn"
   516 .PP
   519 .PP
   532 is assigned to.
   535 is assigned to.
   533 .PP
   536 .PP
   534 Example:
   537 Example:
   535 .PP
   538 .PP
   536 .nf
   539 .nf
   537 .B vmm adi example.name
   540 .B vmm adi example.net
   538 Alias domain information
   541 Alias domain information
   539 ------------------------
   542 ------------------------
   540         The alias domain example.name belongs to:
   543         The alias domain example.net belongs to:
   541             * example.com
   544             * example.com
   542 .fi
   545 .fi
   543 .\" ------------------------------------
   546 .\" ------------------------------------
   544 .SS aliasdomainswitch (ads)
   547 .SS aliasdomainswitch (ads)
   545 .BI "vmm aliasdomainswitch" " fqdn destination"
   548 .BI "vmm aliasdomainswitch" " fqdn destination"
   637 .PP
   640 .PP
   638 .nf
   641 .nf
   639 .B vmm ui d.user@example.com
   642 .B vmm ui d.user@example.com
   640 Account information
   643 Account information
   641 -------------------
   644 -------------------
   642         Address........: d.user@example.com
   645         Address..........: d.user@example.com
   643         Name...........: None
   646         Name.............: None
   644         UID............: 79839
   647         UID..............: 79881
   645         GID............: 70312
   648         GID..............: 70704
   646         Home...........: /srv/mail/8/70312/79839
   649         Home.............: /srv/mail/2/70704/79881
   647         Mail_Location..: mdbox:~/mdbox
   650         Mail_Location....: mdbox:~/mdbox
   648         Quota Storage..: [  0.00%] 0/1.00 GiB
   651         Quota Storage....: [  0.00%] 0/500.00 MiB
   649         Quota Messages.: [  0.00%] 0/0
   652         Quota Messages...: [  0.00%] 0/10,000
   650         Transport......: dovecot:
   653         Transport........: lmtp:unix:private/dovecot-lmtp
   651         SMTP...........: enabled
   654         SMTP.............: disabled
   652         POP3...........: enabled
   655         POP3.............: disabled
   653         IMAP...........: enabled
   656         IMAP.............: enabled
   654         SIEVE..........: enabled
   657         SIEVE............: enabled
   655 .fi
   658 .fi
   656 .\" ------------------------------------
   659 .\" ------------------------------------
   657 .SS username (un)
   660 .SS username (un)
   658 .BI "vmm username" " address name"
   661 .BI "vmm username" " address name"
   659 .PP
   662 .PP