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

Main command: maillist

Handles mailing lists, the kind that's usually done with :include:-filer in /etc/aliases. What mail addresses that are bound to what mailing list is determined by the domain administrators (with the domain command).

General operations

Create/destroy mailing lists

To prevent name collisions, there are certain limits to the names you can use when you create a maillist. Only superusers can create a list with an arbitrary name.

Domain administrators can only create maillists that begins with the first component of their domain name, followed by a dash. The administrator for dtek.chalmers.se and etek.chalmers.se can only create maillists starting with dtek- or etek-.

The same rules applies to manipulating a maillist. Thus, the domain administrator can change a list they just created, and thus they can add a user as an administrator for it.

> maillist listname create
Superusers, Domain administrators
Creates a new maillist with the name listname. The list can then be set as recipient for mail addresses. The maillist name can only be seen by its administrators, not by the outside. There is no connection between maillist name and any email addresses delivered to it.
> maillist listname destroy
Superusers, Domain administrators
Removes a maillist and all data referring to it (including bindings from mail addresses). Regular maillist administrators can't remove their maillists. Domain administrators for a domain that begins with the same component as the maillist can remove it, in the same manner as he or she could create it.

Configurations for the list

> maillist listname fullname set string
Maillist administrators
Sets the lists "fullname", the name that the users see when they list what maillists they are members of. This should be something unique and descriptive, like "Medics blue group".
> maillist listname selfsubscribe enable
Maillist administrators
Make the list self subscribable, which means that users can add and remove themselves as members of the list. They can also add or remove users they have administratove rights for. Only effects roghts for the commands users add and users del.

Default is that the list isn't self subscribable.

> maillist listname selfsubscribe disable
Maillist administrators
Make the list not self subscribable.

If you do this with a list that has been self subscribable for a long time, remember that the users that have subscribed will not be able to remove themselves from the list afterwards.

Maillist information

maillist listname get addresses
Maillist administrators
Returns a newline-separated list of all email addresses bound to listname.
maillist listname get
Maillist administrators
Return a (possibly very long) complete description of listname, including all members and administrators.
maillist listname get csv
Maillist administrators
Return a (possibly very long) complete description of listname, as above, but in CSV format:
 maillist:
   1  * name=<listname>
   0+ * address=<localpart@domain>
   0+ * user=<member-uname>
   0+ * email=<member-email>
   0+ * admin=<admin-uname>
 

The data is as far as possible formatted to be readable in an 80-character terminal, using continuation lines.

Administrators

Administrators have the rights to do almost anything with a maillist. Only dependable and trustworthy users should be made admins for a maillist. It is a good idea to use someone who has some real-world responsibility for the group that the maillist represents.

Changing administrators

A maillist administrator cannot remove her/himself from the list. She/he can only add another user as admin, and that user can then remove the initial adminstrator.

This prevents attempts to do the same thing in the opposite order (which wouldn't work), makes the new administrator start using the system immediately, and prevents maillists from being without any administrators at all.

> maillist listname admins add user
Maillist administrators
Add a user as administrator for listname.
> maillist listname admins del user
Maillist administrators
Remove a user as administrator for listname.

Fetching administrators

> maillist listname admins get
Maillist administrators
Returns a newline-separated list of which users are in listname's admin list. This list does not contain users that are implicitly administrators via a domain administratorship.

List members

Email sent to addresses bound to a maillist, is delivered to the list's members.

Users

Add users using their username. Do not add one of their email addresses, as email addresses change more over time than usernames.

Ordinary users cannot see the membership list of a maillist, but they can see if they are members themselves or not.

> maillist listname users add user [user ...]
Maillist administrators
User administrators if list is self-subscribable
Add one or more users as members of the list. If all users given were already members, an error message is returned.

If this is a self-subscribable maillist, the command is only permitted if the user issuing it have administrative privileges for all users given as arguments.

> maillist listname users del user [user ...]
Maillist administrators
User administrators if list is self-subscribable
Removes one or more users as members of the list. If none of the users given were members, an error message is returned.

If this is a self-subscribable maillist, the command is only permitted if the user issuing it have administrative privileges for all users given as arguments.

> maillist listname users get
Maillist administrators
Returns a newline-separated list of usernames for all members.

Only available to Maillist administrators. Regular users can check whether they're members of the list with the has member command below.

> maillist listname has member user
User administrators
Returns a status-code depending on whether the given user is a member of the list (100 Ok.) or not (518 Not present.).

This command can be run by anyone with administrative privileges for the user being asked about.

External email addresses

If a recipient is not a Chalmers user, add their email address instead. If the recipient is a Chalmers user, add his/her username with the above commands instead.

> maillist listname emails add email [email ...]
Maillist administrators
Adds one or more external email addresses as members of the list. An error message is returned if all the given email addresses were already members.
maillist listname emails del email [email ...]
Maillist administrators
Remove one or more external email addresses from the list. An error message is returned if none of the given email addresses were members.
maillist listname emails get
Maillist administrators
Returns a newline-separated list of external email addresses that are members of the list.