mail.medic.chalmers.se
Förstasidan-Teknikinfo-Sicconfd

Main command: user

Handles users and configuration of their accounts.

User control

General

user user create
Super user and users appointed by super users
Creates a new mail account. The authentication for a created account is done by Chalmers Account Database (CDKS), and the mail account name will always be the same as in CDKS, so the user name you provide must be registered in CDKS to the right person.

Note for sicmail administrators: Relevant directories in the file system are created when the first mail is delivered to it. To appoint administrators that may create account, use the "system addmins" commands.

> user user destroy
Super user
Deletes a mail account and all data associated with it. And we do mean all data.
> user user realname set realname
Super user
Sets the users real name. This information will be taken from CDKS in the future.
> user user quota set quota
Super user
Sets the users soft quota in MB. The hard quota is always four times as lasrge as the soft quota, one warning mail a day will be sent if the user is above his soft quota.

Suspension

> user user disable
Super user
Suspends a mail account temporarily. The account can no longer receive mail, a bounce is generated that the account is suspended. However, the user can still read and send mail (to tell acquaintances that he or she is switching mail address.
> user user enable
Super user
Reactivates an account that had previously been suspended.

Administrators

> user user admins add user
User administrators
Adds a user as an administrator for this mail account. The user with the same name as the mail account is automatically an administrator, and shouldn't be added to this list.
> user user admins del user
User administrators
Removes a user as an administrator for this account.
> user user admins get
User administrators
Returns a newline separated list of account names explicitly added as administrators for this account. This list also includes the user itself, for claritys sake.

Redirection of mail

Incoming emails can be sent to external email addresses. All such forwarding/copying is done before any form of filtering or sorting.

Forwarding

Setting a forward address means that all mail delivered to this account is immediately sent to an external email address. The mail is not delivered locally. Since most features are applied when delivering locally, only personal maillists will continue to work when a forward address has been set.
> user user forward set email
User administrators
Sets a forward for this mail account, to make all mail delivered to the account immediately sent on to an external mail address. Personal mailing lists is the only feature that works together with a forward, filtering and sorting doesn't.
> user user forward unset
User administrators
Removed an existing forward.

Copies

Copy addresses differ from forwarding addresses in that you can have more than one, and in that mail is delivered locally as well as sent on to one or more external email addresses.

It is explicitly allowed to have both copies and a forward set.

> user user copies add email
User administrators
Adds a copy address. A copy of all incoming mail to the account will be sent to the address(es) on the copies list. Copies are made before any filtering or sorting (i.e. before checking for spam, virii etc.)
> user user copies del email
User administrators
Removes the specified email address from the list of copy addresses.

Filtering

Virus-filter

> user user filter virus enable
User administrators
Activates virus filtering of all incoming mail. This is by no means a complete protection, it's a convenience. It consumes a lot of computing time, so only activate this if you (or the user) runs a windows client.
> user user filter virus disable
User administrators
Deactivates virus filtering.

Spam filtering

> user user filter spam enable
User administrators
Activates spam filtering with SpamAssassin. All incoming mail gets a spam value header added that measures the probability of the mail being spam - a higher value means it is more likely to be spam.
> user user filter spam disable
User administrators
Deactivates spam filtering for the account.
> user user filter spam level set lvl
User administrators
Sets the spam threshold for SpamAssassin for this account. Mail with a higher spam value will be regarded as spam. The default threshold is 5.0. It's generally a very bad idea to set this lower than 3.0.
> user user filter spam whitelist add email
User administrators
Adds a mail address to the whitelist for this accounts spam filtering. No mail from this address will be considered a spam, no matter what the spam value is.
> user user filter spam whitelist del email
User administrators
Removes a mail address from the whitelist for this user.
> user user filter spam whitelist get
User administrators
Returns a newline separated list of mail addresses in the whitelist for this account.

Sorting

Sorting incoming mail

> user user filter from email folder set folder
User administrators
Adds or changes a rules that says that all mail from the given address should be delivered to a certain folder. The folder will be created at the first delivery if it doesn't already exist. The mail address can be complete, or leave out everything either before or after the @ sign. For example, @dtek.chalmers.se means all mail addresses in the dtek.chalmers.se domain.
> user user filter from email folder unset
User administrators
Removes the sorting rule for the given sender address.
> user user filter to email folder set folder
User administrators
Adds or changes a rules that says that all mail to the given address should be delivered to a certain folder. The folder will be created at the first delivery if it doesn't already exist. The mail address can be complete, or leave out everything either before or after the @ sign. For example, @dtek.chalmers.se means all mail addresses in the dtek.chalmers.se domain.
> user user filter to email folder unset
User administrators
Removes the sorting rule for the given recipient address.
> user user filter subject email folder set folder
User administrators
Adds or changes a rules that says that all mail with a given Subject header should be delivered to a certain folder. The folder will be created at the first delivery if it doesn't already exist.
> user user filter subject email folder unset
User administrators
Removes the sorting rule for the given Subject header.
> user user filter list-id email folder set folder
User administrators
Adds or changes a rules that says that all mail with a certain list-id should be delivered to a certain folder. The folder will be created at the first delivery if it doesn't already exist. The List-Id header is set by many mailing lists, look at the complete headers of a mail to decide whether ornot that mailing list uses List-Id.
> user user filter list-id email folder unset
User administrators
Removes the sorting rule for the given list-id.
> user user filter get
User administrators
Returns a list of all filters for this mail account. Format:
virus-filter:enabled=no
spam-filter:enabled=yes:spam-filter-level=<value>:spam-filter-folder=<folder-name>
sender-filter:from=<email>:folder=<folder>
recipient-filter:to=<email>:folder=<folder>
list-id-filter:list-id=<list-id>:folder=<folder>

Mailing lists

User mailing lists

> user user maillist listname create
User administrators
Creates a personal mailing list. You send to this by modifying any mail address bound directly to this account: If localpart@domain is bound to the account, the personal mailing list address will be localpsrt+listname@domain. Note that the list owner always gets a copy of all mail sent to the list, regardless of he or she is a member of it.

Delivery to specific mail folders also occur when you use plus addresses. These two functions work together, that is, all list members each get a copy, and the users copy is delivered to the folder with the same name as the list, if that folder exists.

> user user maillist listname destroy
User administrators
Deletes a personal mailing list and all configuration data pertaining to it.
> user user maillist listname users add user [user ...]
User administrators
Adds one or more users as members of the personal mailing list. An error will be returned if all given users are members already.
> user user maillist listname users del user [user ...]
User administrators
Removes one or more users as members from the prtsonal mailing list. An error will be returned if none of the given users are members.
> user user users get
User administrators
Returns a newline separated list of all users that are members of the personal mailing list.
> user user maillist listname emails add email [email ...]
User administrators
Adds one or more external mail addresses as members of the personal mailing list. An error will be returned if all the given mail addresses are members already. Don't use this to add people who exist on this server, add them as users instead
> user user maillist listname emails del email [email ...]
User administrators
Removes one or more external mail addresses as members from the prtsonal mailing list. An error will be returned if none of the given mail addresses are members.
> user user emails get
User administrators
Returns a newline separated list of all external mail addresses that are members of the personal mailing list.

Automatic responses

Automatic response when absent

> user user vacation add from YYYY-MM-DD back YYYY-MM-DD message string
User administrators
Registers a new vacation time period. They can't overlap. Don't forget to quote the string, since it will most likely include whitespace.

During the given time period, the response will be sent to all who send you email, at most once a week. The vacation software tries to avoid sending replies to mailing lists.

> user user vacation del starting YYYY-MM-DD
User administrators
Removes the registered vacation time period that starts at the given date.

Other

Other

> user user get admin for users
User administrators
Returns a newline separated list of all the other users which the given user is an administrator for.
> user user get admin for maillists
User administrators
Returns a newline separated list of all the mailing lists which the given user is an administrator for.
> user user get admin for domains
User administrators
Returns a newline separated list of all the domains which the given user is an administrator for.
> user user get
User administrators
Returns a representation of all configuration for this account. Format:
  • Common for all:
    user:username=<username>:realname=<real-world-name>\
    :homedir=<mailserver-local-path>:maildir=<mailserver-local-path>\
    
  • If the account is disabled (no other data will follow):
    :disabled=yes
    
    :disabled=no\
    :maillist-name=<listname>\
    
  • If forwarding is on (no other data will follow):
    :forward=<email>
    
  • If the user has a quota:
    :quota-enabled=yes:quota-mb=<MB of quota>
    
    annars:
    :quota-enabled=no
    
  • Filter:
    virus-filter:enabled=no
    spam-filter:enabled=yes:spam-filter-level=<value>:spam-filter-folder=<folder-name>
    sender-filter:from=<email>:folder=<folder>
    recipient-filter:to=<email>:folder=<folder>
    list-id-filter:list-id=<list-id>:folder=<folder>
    
  • Vacation time periods:
    vacation:from=<YYYY-MM-DD>:back=<YYYY-MM-DD>:message=<text>
    ...
    
  • Administrative rights (one user, mailing list or domain field per active right):.
    admin-for:user=<uname>:maillist=<listname>:domain=<domainname>
    
  • Addresses bound to the account::
    address:personal-email=<email>
    ...
    address:maillist-email=<email>:via-maillist=<listname>
    ...
    
> user user get addresses
User administrators
Returns a newline separated list of all the mail addresses bound to the user.
> user user get all addresses
User administrators
Returns a newlinst separated list of all the mail addresses the user receives mail on, including addresses for the mailing lists he or she is a member of.