Site Administrator Documentation

Command line scripts

add_members

Use this script to mass add members to a mailing list. Input files are plain text, with one address per line. Command line options allow you to add the addresses as digest or regular members, select whether various notification emails are sent, and choose which list to add the members to.

arch

Use this to rebuild a list's archive. This script can't be used to modify a list's raw mbox file, but once you've edited the mbox file some other way, you can use this script to regenerate the HTML version of the on-line archive.

check_db

Use this script to check the integrity of a list's config.db and config.db.last database files.

check_perms

Use this script to check, and optionally fix, the permissions of the various files in a Mailman installation.

clone_member

Use this script to clone an address on a particular list into different address. This is useful when someone is changing email addresses and wants to keep all their old configuration options. Eventually members will be able to do their own cloning, but for now, only the site administrator can do this. Command line options let you remove the old address, clone addresses in the list managers addresses, etc.

config_list

This is a very powerful script which lets you view and modify a list's configuration variables from the command line. E.g. you can dump out all the list options into a plain text file (actually a valid Python file!), complete with comments explaining each variable. Or you can apply the configuration from such a file to a particular list.

Where this might be useful is if you wanted to change the web_page_url attribute on every list. You could create a file containing only the line

web_page_url = 'http://www.mynewsite.com/mailman-relocated/'

and then feed this file back to config_list for every list on your system. config_list only sets the list variables that it finds in the input file.

digest_arch

This script is deprecated.

dumpdb

This script dumps the plain text representation for any .db database file. These files usually contain Python marshaled dictionaries, and can be found in the qfiles directory, the lists/listname directory, etc.

find_member

Use this script to search all the lists, or some subset of lists, for an address matching a regular expression. command line options let you also search the list managers as well.

list_lists

List all, or some subset of, the mailing lists in the system.

list_members

List the members of a mailing list. Command line options let you print just the regular or just the digest members, print the case-preserved addresses of the members, etc.

mmsitepass

Use this script to set the site password, which can be used any where in the system a list or user password can be used. Essentially, the site password trumps any other password, so choose wisely!

move_list

Use this script when you move Mailman to a new installation location.

newlist

Use this script to create new mailing lists.

remove_members

Use this list to remove members from a mailing list.

rmlist

Use this script to remove a mailing list. By default, a list's archives are not removed unless the --archives option is given.

sync_members

Use this to synchronize mailing lists in a list's database with a plain text file of addresses, similar to what is used for add_members. In a sense, this script combines the functionality of add_members and remove_members. Any addresses in the file that are not present in the list roster are added, and any addresses in the roster that are not present in the file are removed.

Command line options let you send various notification emails, preview the changes, etc.

update

Don't use this script manually; it is used as part of the installation and upgrade procedures.

version

Prints the Mailman version number.

withlist

This is the most powerful and flexible script in Mailman. With it you can do all manner of programmatic changes to mailing lists, or look at and interactively inspect almost any aspect of Mailman. By default, you run this using Python's interactive prompt, like so:

% cd /home/mailman
% python -i bin/withlist mylist
Loading list: mylist (unlocked)
>>> 

Here you see that you're left at the Python prompt after the list has been loaded and instantiated. Note that without the --lock option, the list is not locked. List must be locked if you plan to make modifications to any attributes (and they must be explicitly saved, as withlist does not automatically save changes to list objects).

At the prompt, the global object m is the instantiated list object. It's a Python instance so you can do all the normal things to it, view or change attributes, or make method calls on it.

Have a look also at the --run option, which lets you put your programmatic changes into a Python module (file) and run that module over any mailing list you want. This makes withlist essentially a framework for easily adding your own list-specific command line scripts.

Cron scripts

% cd /home/mailman
% python -S cron/senddigests

bumpdigests

Bumps the digest volume numbers for the specified lists. Resets the issue number to 1.

checkdbs

Checks for ending list requests (posts and subscriptions) and mails the list manager if there are any.

gate_news

Polls the NNTP servers for messages and forwards any new messages to their mailing list gateways.

mailpasswds

Sends the password reminder emails to all users and all mailing lists.

nightly_gzip

Regenerates the Pipermail gzip'd flat archive files.

qrunner

This is the primary cron script for processing messages in Mailman's queue directory qfiles.

senddigests

Sends all accumulated digests.