[Top] [Contents] [Index] [ ? ]
vmailmgr CGI Documentation
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
1. Introduction
This is the documentation for the CGI programs for vmailmgr.
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
1.1 Common Form Configuration
The following form fields are common to all of the vmailmgr CGI
programs.
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
1.1.1 Required Form Fields
Field:
vdomain
Description:
This field specifies the name of the virtual domain under which
to perform this operation.
Syntax:
`' or
`'
Field:
password
Description:
Unless noted below, this field specifies the password of the
administrator for the given virtual domain.
Syntax:
`'
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
1.1.2 Optional Form Fields
Field:
error_redirect
Description:
If this field is set, any operation that results in an error
will be redirected to the given URL. If not set, a
pre-programmed document (which includes the error message) will
be output.
Syntax:
`'
Field:
redirect
Description:
If this field is set, any operation that completes successfully
with be redirected to the given URL. If not set, a
pre-programmed document (which includes the completion message)
will be output.
Syntax:
`'
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
2. listvdomain
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
2.1 Overview
This CGI program will list the mailboxes and aliases in a virtual
domain in a three-column table. The first column lists the mailbox or
alias name, the second column is either `Alias' or `Mailbox', and the
third column lists the destination.
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
2.2 Form Configuration
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
2.2.1 Required Form Fields
No additional form fields are Required.
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
2.2.2 Optional Form Fields
Field:
body-flags
Description:
If present, the contents of this field is inserted into the
`
' tag at the start of the document.
Syntax:
`'
Field:
cell-align
Description:
Sets the cell alignment. Defaults to `left'.
Syntax:
`'
Field:
cell-post
Description:
If present, the contents of this field will be output prior to
every `' tag.
Syntax:
`'
Field:
cell-pre
Description:
If present, the contents of this field will be output after
every `
' tag.
Syntax:
`'
Field:
p-align
Description:
Sets the default paragraph alignment. Defaults to `left'.
Syntax:
`'
Field:
title-post
Description:
If present, the contents of this field are output after the
title text. Defaults to `'.
Syntax:
`'
Field:
table-align
Description:
Sets the allignment of the table listing the users. Defaults to
`left'.
Syntax:
`'
Field:
title-pre
Description:
If present, the contents of this field are output before the
title text. Defaults to `
'.
Syntax:
`'
Field:
userlink
Description:
If this field is present, all user names will be enclosed in a
link to the contents of this field. If the field contains a
'%', it will be replaced by the user name.
Syntax:
`'
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
3. vaddalias
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
3.1 Overview
This CGI program can be used to add an alias to a virtual domain.
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
3.2 Form Configuration
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
3.2.1 Required Form Fields
Field:
username
Description:
The virtual user name of the alias to create.
Syntax:
`'
Field:
destination
Description:
The destination address or addresses of the alias, separated by
commas. If an address does not contain a host name (separated
from the user name with an `@'), it is treated as local to the
virtual domain and must already exist.
Syntax:
`'
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
3.2.2 Optional Form Fields
Field:
newpass1, newpass2
Description:
These two fields specify the new password of the user. They
must match for the password to be changed. The first eight
characters are relevant, and may be any combination of letters,
digits, or punctuation symbols. If these fields are not present
or are empty, a null passcode is used.
Syntax:
`'
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
4. vadduser
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
4.1 Overview
This CGI program can be used to add a user mailbox to a virtual
domain.
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
4.2 Form Configuration
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
4.2.1 Required Form Fields
Field:
username
Description:
The virtual user name of the alias to create.
Syntax:
`'
Field:
newpass1, newpass2
Description:
These two fields specify the new password of the user. They
must match for the password to be changed. The first eight
characters are relevant, and may be any combination of letters,
digits, or punctuation symbols.
Syntax:
`'
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
4.2.2 Optional Form Fields
Field:
destination
Description:
The destination address or addresses to direct a copy of
incoming mail, separated by commas. If an address does not
contain a host name (separated from the user name with an `@'),
it is treated as local to the virtual domain and must already
exist. If this field is not present or blank, no forwarding
will be done.
Syntax:
`'
Field:
userdir
Description:
This field can be used to specify the user mail directory name
relative to the virtual domain's users directory. If this field
is not present, the directory name will be the same as the user
name.
Syntax:
`'
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
5. vchattr
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
5.1 Overview
This CGI program can be used to change the attributes of an existing
user in a virtual domain.
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
5.2 Form Configuration
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
5.2.1 Required Form Fields
Field:
username
Description:
The virtual user name to modify.
Syntax:
`'
Field:
attribute
Description:
The number of the attribute to modify. The possible values are:
`1'
The password. Use the `vpasswd' CGI to do this.
`2'
The forwarding destination. Use the `vchforwards' to do
this.
`3'
The hard quota.
`4'
The soft quota.
`5'
The message size limit.
`6'
The message count limit.
`7'
The account's expiry time.
`8'
Set to zero to disable delivery to the account's mailbox
(without deleting the account). Set to non-zero to enable
delivery.
`9'
The personal information string.
Syntax:
`'
Field:
newvalue
Description:
The new value for the given attribute. The format of this new
value is dependant on the type of the attribute.
Syntax:
`'
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
6. vchforwards
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
6.1 Overview
This CGI program can be used to change the forwarding destination of
an existing user.
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
6.2 Form Configuration
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
6.2.1 Required Form Fields
Field:
username
Description:
The virtual user name to modify.
Syntax:
`'
Field:
destination
Description:
The destination address or addresses of the alias, separated by
commas. If an address does not contain a host name (separated
from the user name with an `@'), it is treated as local to the
virtual domain and must already exist.
Syntax:
`'
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
6.2.2 Optional Form Fields
Field:
enable
Description:
Set this field to `0' to cause mailbox delivery to this account
to be disabled after changing the alias. Set it to any number
except `0' to cause mailbox delivery to be enabled before
changing the alias. If it is not set, the mailbox is neither
enabled nor disabled.
Syntax:
`'
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
7. vdeluser
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
7.1 Overview
This CGI program deletes a user from a virtual domain.
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
7.2 Form Configuration
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
7.2.1 Required Form Fields
Field:
username
Description:
The virtual user name of the user to delete.
Syntax:
`'
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
8. vpasswd
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
8.1 Overview
This CGI program can be used to change the password of a user either
by the user themself or by the domain administrator.
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
8.2 Form Configuration
The password field used by this CGI may match either the password of
the virtual domain administrator or that of the user being modified.
_________________________________________________________________
[ < ] [ > ] [ << ] [ Up ] [ >> ] [Top] [Contents] [Index] [
? ]
8.2.1 Required Form Fields
Field:
username
Description:
This field specifies the name of the user that is to be
modified.
Syntax:
`'
Field:
newpass1, newpass2
Description:
These two fields specify the new password of the user. They
must match for the password to be changed. The password may
contain any combination of letters, digits, or punctuation
symbols.
Syntax:
` '
_________________________________________________________________
[Top] [Contents] [Index] [ ? ]
Table of Contents
1. Introduction
1.1 Common Form Configuration
1.1.1 Required Form Fields
1.1.2 Optional Form Fields
2. listvdomain
2.1 Overview
2.2 Form Configuration
2.2.1 Required Form Fields
2.2.2 Optional Form Fields
3. vaddalias
3.1 Overview
3.2 Form Configuration
3.2.1 Required Form Fields
3.2.2 Optional Form Fields
4. vadduser
4.1 Overview
4.2 Form Configuration
4.2.1 Required Form Fields
4.2.2 Optional Form Fields
5. vchattr
5.1 Overview
5.2 Form Configuration
5.2.1 Required Form Fields
6. vchforwards
6.1 Overview
6.2 Form Configuration
6.2.1 Required Form Fields
6.2.2 Optional Form Fields
7. vdeluser
7.1 Overview
7.2 Form Configuration
7.2.1 Required Form Fields
8. vpasswd
8.1 Overview
8.2 Form Configuration
8.2.1 Required Form Fields
_________________________________________________________________
[Top] [Contents] [Index] [ ? ]
Short Table of Contents
1. Introduction
2. listvdomain
3. vaddalias
4. vadduser
5. vchattr
6. vchforwards
7. vdeluser
8. vpasswd
_________________________________________________________________
[Top] [Contents] [Index] [ ? ]
About this document
This document was generated by Bruce.Guenter.dyndns.org on December,
29 2004 using texi2html
The buttons in the navigation panels have the following meaning:
Button Name Go to From 1.2.3 go to
[ < ] Back previous section in reading order 1.2.2
[ > ] Forward next section in reading order 1.2.4
[ << ] FastBack previous or up-and-previous section 1.1
[ Up ] Up up section 1.2
[ >> ] FastForward next or up-and-next section 1.3
[Top] Top cover (top) of document
[Contents] Contents table of contents
[Index] Index concept index
[ ? ] About this page
where the Example assumes that the current position is at
Subsubsection One-Two-Three of a document of the following structure:
* 1. Section One
* 1.1 Subsection One-One
* ...
1.2 Subsection One-Two
* 1.2.1 Subsubsection One-Two-One
* 1.2.2 Subsubsection One-Two-Two
* 1.2.3 Subsubsection One-Two-Three <== Current Position
* 1.2.4 Subsubsection One-Two-Four
1.3 Subsection One-Three
* ...
1.4 Subsection One-Four
_________________________________________________________________
This document was generated by Bruce.Guenter.dyndns.org on December,
29 2004 using texi2html