Translations by Joel Pickett

ERROR: The locks for some lists could not be acquired. This means that either Mailman was still active when you upgraded, or there were stale locks in the %(lockdir)s directory. You must put Mailman into a quiescent state and remove all stale locks, then re-run "make update" manually. See the INSTALL and UPGRADE files for details.

Print the Mailman version.

Using Mailman version:

General framework for interacting with a mailing list object. There are two ways to use this script: interactively or programmatically. Using it interactively allows you to play with, examine and modify a MailList object from Python's interactive interpreter. When running interactively, a MailList object called `m' will be available in the global namespace. It also loads the class MailList into the global namespace. Programmatically, you can write a function to operate on a MailList object, and this script will take care of the housekeeping (see below for examples). In that case, the general usage syntax is: %% bin/withlist [options] listname [args ...] Options: -l / --lock Lock the list when opening. Normally the list is opened unlocked (e.g. for read-only operations). You can always lock the file after the fact by typing `m.Lock()' Note that if you use this option, you should explicitly call m.Save() before exiting, since the interpreter's clean up procedure will not automatically save changes to the MailList object (but it will unlock the list). -i / --interactive Leaves you at an interactive prompt after all other processing is complete. This is the default unless the -r option is given. --run [module.]callable -r [module.]callable This can be used to run a script with the opened MailList object. This works by attempting to import `module' (which must be in the directory containing withlist, or already be accessible on your sys.path), and then calling `callable' from the module. callable can be a class or function; it is called with the MailList object as the first argument. If additional args are given on the command line, they are passed as subsequent positional args to the callable. Note that `module.' is optional; if it is omitted then a module with the name `callable' will be imported. The global variable `r' will be set to the results of this call. --all / -a This option only works with the -r option. Use this if you want to execute the script on all mailing lists. When you use -a you should not include a listname argument on the command line. The variable `r' will be a list of all the results. --quiet / -q Suppress all status messages. --help / -h Print this message and exit Here's an example of how to use the -r option. Say you have a file in the Mailman installation directory called `listaddr.py', with the following two functions: def listaddr(mlist): print mlist.GetListEmail() def requestaddr(mlist): print mlist.GetRequestEmail() Now, from the command line you can print the list's posting address by running the following from the command line: %% bin/withlist -r listaddr mylist Loading list: mylist (unlocked) Importing listaddr ... Running listaddr.listaddr() ... mylist@myhost.com And you can print the list's request address by running: %% bin/withlist -r listaddr.requestaddr mylist Loading list: mylist (unlocked) Importing listaddr ... Running listaddr.requestaddr() ... mylist-request@myhost.com As another example, say you wanted to change the password for a particular user on a particular list. You could put the following function in a file called `changepw.py': from Mailman.Errors import NotAMemberError def changepw(mlist, addr, newpasswd): try: mlist.setMemberPassword(addr, newpasswd) mlist.Save() except NotAMemberError: print 'No address matched:', addr and run this from the command line: %% bin/withlist -l -r changepw mylist somebody@somewhere.org foobar

Unlock a locked list, but do not implicitly Save() it. This does not get run if the interpreter exits because of a signal, or if os._exit() is called. It will get called if an exception occurs though.

Unlocking (but not saving) list: %(listname)s

Finalizing

Loading list %(listname)s

(locked)

(unlocked)

Unknown list: %(listname)s

No list name supplied.

--all requires --run

Importing %(module)s...

Running %(module)s.%(callable)s()...

The variable `m' is the %(listname)s MailList instance

Increment the digest volume number and reset the digest number to one. Usage: %(PROGRAM)s [options] [listname ...] Options: --help/-h Print this message and exit. The lists named on the command line are bumped. If no list names are given, all lists are bumped.

Check for pending admin requests and mail the list owners if necessary. Usage: %(PROGRAM)s [options] Options: -h/--help Print this message and exit.

Notice: %(discarded)d old request(s) automatically expired.

%(count)d %(realname)s moderator request(s) waiting

%(realname)s moderator request check result

Pending subscriptions:

Pending posts:

From: %(sender)s on %(date)s Subject: %(subject)s Cause: %(reason)s

Cull bad and shunt queues, recommended once per day. This script goes through the 'bad' and 'shunt' queue directories and, if mm_cfg.BAD_SHUNT_STALE_AFTER is > 0, it removes all files more than that many seconds old. If mm_cfg.BAD_SHUNT_ARCHIVE_DIRECTORY is a writable directory, the old files are moved there. Otherwise they are deleted. Only regular files immediately subordinate to the 'bad' and 'shunt' directories are processed. Anything else is skipped. Usage: %(PROGRAM)s [options] Options: -h / --help Print this message and exit.

Process disabled members, recommended once per day. This script cruises through every mailing list looking for members whose delivery is disabled. If they have been disabled due to bounces, they will receive another notification, or they may be removed if they've received the maximum number of notifications. Use the --byadmin, --byuser, and --unknown flags to also send notifications to members whose accounts have been disabled for those reasons. Use --all to send the notification to all disabled members. Usage: %(PROGRAM)s [options] Options: -h / --help Print this message and exit. -o / --byadmin Also send notifications to any member disabled by the list owner/administrator. -m / --byuser Also send notifications to any member disabled by themselves. -u / --unknown Also send notifications to any member disabled for unknown reasons (usually a legacy disabled address). -b / --notbybounce Don't send notifications to members disabled because of bounces (the default is to notify bounce disabled members). -a / --all Send notifications to all disabled members. -f / --force Send notifications to disabled members even if they're not due a new notification yet. -l listname --listname=listname Process only the given list, otherwise do all lists.

[disabled by periodic sweep and cull, no message available]

Poll the NNTP servers for messages to be gatewayed to mailing lists. Usage: gate_news [options] Where options are --help -h Print this text and exit.

Send password reminders for all lists to all users. This program scans all mailing lists and collects users and their passwords, grouped by the list's host_name if mm_cfg.VIRTUAL_HOST_OVERVIEW is true. Then one email message is sent to each unique user (per-virtual host) containing the list passwords and options url for the user. The password reminder comes from the mm_cfg.MAILMAN_SITE_LIST, which must exist. Usage: %(PROGRAM)s [options] Options: -l listname --listname=listname Send password reminders for the named list only. If omitted, reminders are sent for all lists. Multiple -l/--listname options are allowed. -h/--help Print this message and exit.

Password // URL

%(host)s mailing list memberships reminder

Re-generate the Pipermail gzip'd archive flat files. This script should be run nightly from cron. When run from the command line, the following usage is understood: Usage: %(program)s [-v] [-h] [listnames] Where: --verbose -v print each file as it's being gzip'd --help -h print this message and exit listnames Optionally, only compress the .txt files for the named lists. Without this, all archivable lists are processed.