ListProc command summary

Table of contents: About this document; Basics; Lists; Subscriptions; Messages; Management; SET* and CON*; Information elsewhere.

About this document

This document lists ListProc commands grouped by what they control, not by who can use them, and not in alphabetical order.

To make organizational structure and relationships more apparent, explanations are very limited, and syntax for multiple commands are combined and abbreviated.

This document was written by David Cohen using information on the Internet and from ListProc commands.  Comments and suggestions about it are welcome.

Basics

ListProc, short for ListProcessor, is email list management software from CREN.

How to post messages

Send email messages to be received by all subscribers of a list to listname@hostname, where listname is the list's name, and hostname is the domain name of the computer managing the list.

The list owner's email addresses are: listname@hostname, listname-request@hostname, and owner-listname@hostname.

Where to submit ListProc commands

Via email
Send to listproc@host, where host is the computer managing the list.
Put ListProc commands in the message body.
The subject field is ignored.
The subscriber's address, if needed, is obtained from return address.
Via Interactive ListProcessor (ilp)
Type commands at a prompt.
Get immediate feedback.
Need appropriate software running on client and ListProc computers.
Review your command privileges using ?|privileges command.
Via lp-web, the ListProc Web Interface

Command to get help using ListProc

HELp [topic|TOPICS|LISTProc|LIVe] (none: brief description of each command)
SET* preference CCHELP (receive copies of help requests)

Rules for commands in email messages

Lists

List of lists

Get a list of lists
LISts [local|global [keywords]] (no arguments: all visible and published lists)
WHIch[-OWNED] (lists subscribed or owned only)
SET* preference CCLISTS (receive copies of list requests)
Settings for a specific list
CON* [NO-]COMMENT string (also the "To:" field unless reflector option is on) (C-13)
CON* {HIDDEN|VISIBLE}-LIST (C-1; R-7)
CON* [UN]PUBLISHED-LIST (to global list database) (C-19; R-8)

Information about a list

List's settings and info-file formatted for reading
REView list SHOrt|DEScription (return list's settings and info-file)
INFormation list (return info file which contains list's purpose)
SET* preference [CCINFORMATION|CCREVIEW]... (copied on these requests)
CON* REVIEW-{BY|TO}-{ALL|OWNERS|SUBSCRIBERS[-SHORT]} (BY=TO) (who can REVIEW; OWNERS includes moderators) (C-6; R-11)
For list owner via files in LPDIR/lists/listname directory
EDIt|PUT list password info|welcome|news|peers [-nolock]
Other information
REPorts list password (request all reports)
version|release (get ListProc version, and email addresses of ListProc and its manager)

Subscriptions

Subscriber list requests

REView list [SUBscribers]
SET* CONceal YES|NO (whether people can see the user's name & address in the subscriber list)
SET* preference CCRECIPIENTS (copied on requests for subscriber list)

Subscribe or unsubscribe (if no address: uses from-address)

SUBscribe|JOIn list [for address] name
UNSubscribe|SIGNOFF list [for address]
PURge password (Leave all lists on local host)

Add and remove subscribers, by subscription manager (quiet: user not notified)

[quiet] ADD list password address [user-name...]
[quiet] ADD list password {address [user-name...]}...
ALIas list password new-address address-as-subscribed
[quiet] DELETE list password address...
IGNORE list password address...
purge password address... (for ListProc manager to remove users from all lists on local server)

Change address and password

SET* ADDress password new-address (change address)
SET* PASsword password new-password (change password for PURGE, SET ADDRESS, and ilp)

Subscribing security settings

CON* ADDress variable|fixed (allow address change, or require an add and a delete) (C-?)
CON* [NO-]ALTERNATE-ADDRESS-COMMANDS (allow anyone to sub/unsub/set for anyone else) (v8.1) (C-22; R-5)
CON* [DONT-]CONFIRM-ALL-[UN]SUBSCRIPTIONS (C-20/21; R-3/4)
CON* [DONT-]ALLOW-EMPTY-SUBSCRIBER-NAMES (v8.1) (C-23; R-2)

Management of subscriptions

CON* CLOSED|OPEN|OWNER-SUBSCRIPTIONS (whether subscription requests are rejected, processed, or sent to owner) (C-2; R-1)
CON* [REMOVE-[ALL-]]SUBSCRIPTION-MANAGERS address... (add/remove managers; default: owners) (C-3)
SET* preference CCUNSUBSCRIBE|CCSUBSCRIBE (CC'ed on subscription requests)
CON* [NO-]AUTO-DELETE-SUBSCRIBERS (if mail bounces) (C-14; R-18)

Edit subscriber databases

EDIt|PUT list password subscribers|aliases|ignored [-nolock]

Messages

When postings are received

SET* MAIL ACK|NOACK|DIGEST[-NOMIME]|POSTPONE (set mail receiving mode; ACK: receive email you send)
CON* [NO-]DIGEST [daily [hh:mm]] | monthly | [weekly [day-of-the-week]] [lines bytes] (C-11; R-14)
CON* [NO-]MESSAGE-LIMIT number (maxiumum postings per day) (C-12; R-15)
CON* MAX-MESSAGES-PER-DAY number (same as CON* MESSAGE-LIMIT)

Header and message modification

CON* [NO-]REFLECTOR (Reflector: "To:" header as received, not the comment, and no preset "Reply to:") (C-18; R-21)
CON* LISTNAME-[NOT-]IN-SUBJECT (C-25)
CON* REPLY-TO-{LIST[-ALWAYS]|SENDER[-ALWAYS]|OMITTED} (If no -ALWAYS, message header Reply-To used.) (C-16; R-17)
CON* [DONT-]KEEP-RESENT-LINES (forwarded mail) (C-17; R-19)
CON* OUTBOUND-MESSAGE-FILTER off|default|program... (C-26)
CON* [NON-]MIME-MODERATION-MESSAGES (moderator receives each message as MIME attachment) (C-24)

Message moderation

Who can post
CON* SEND-BY-{ALL|OWNERS|SUBSCRIBERS}[-CONFIRM] (If -CONFIRM, add "Confirm: pw" line in messages.) (C-4; R-6)
For moderator to manage messages, when MODERATED-NO-EDIT
APProve|DIScard list password tag...
HOLd|FREe list password (message postings and delivery errors)
Set whether manager receives unpostable posts
SET* preference CCIGNORE (posts from addresses in ignore list)
SET* preference CCPRIVATE (posts by non-subscribers if only subscribers may post)
Add & remove moderators (if any moderators, messages sent to them first for approval to post)
CON* [UN]MODERATED-[NO-]EDIT address... (C-9; 13)
CON* REMOVE-MODERATORS address...
Posting quantity per user
STATistics|STATs list [address|-all]
CON* {STATISTICS|STATS}-{BY|TO}-{ALL|OWNERS|SUBSCRIBERS]} (BY=TO) (who can STAT) (C-5; R-10)
SET* preference CCSTATISTICS (copied on STAT requests)

Archives

Actions by subscriber
INDex archive [/password] [-ALL]
SEArch [archive] [/password] [-ALL] [pattern]
GET|SENdme [archive] file [/password]
AFD|FUI add|delete|review|query|deliver|deliver_files|deliver-debug {[archive] [/password] [files]}... [user-address]...
Settings by manager
CON* ARCHIVES-TO-ALL|OWNERS|SUBSCRIBERS (C-7; R-12)
CON* [NO-]ARChive [password] [messages|digests] (ListProc manager only) (C-8; R-9)
SET* preference CCGET|CCINDEX (copied on GET or INDEX requests)
CON* WEB-ARCHIVE off|default|program... (only if archiving enabled) (C-27)

Management

List management responsibilities

Managers have responsibilties and capabilities not available to regular users.  Possible list users are:

Add & remove owners (by ListProc manager and, if owner controlled, list owner)

CON* [REMOVE-]OWNERS address... (C-28; R-22)
CON* {MANAGER|OWNER}-CONTROLLED (MANAGER is ListProc manager) (C-32)
CON* PASSWORD new-password (default is list name in uppercase) (C-29)

Who gets error messages

CON* {DELIVERY|REMOVE}-ERRORS-TO address... (undeliverable email) (default: owner) (C-10; R-20)
CON* [DONT-]FORWARD-REJECTS (request-errors to the list managers instead of to the original senders) (C-15; R-16)
SET* preference CCERRORS (receive copies of error messages)

Other commands

SET* preference CCALL (receive copies of all requests and errors)
SET* preference CCHELP CCLISTS CCINFORMATION CCREVIEW CCRECIPIENTS CCSUBSCRIBE CCUNSUBSCRIBE CCIGNORE CCPRIVATE CCSTATISTICS CCERRORS CCSET CCSEARCH CCRUN CCGET CCINDEX (same as CCALL?) (A "-" before an option turns it off.)
CON* WIDE-OPEN-LIST (anyone can subscribe and post, and get review, statistics, and archives)
[UN]LOCk list password (stop processing of commands)
SET* preference CCSEARCH
SET* preference CCRUN
RUN list [password cmd [args]]
system list password user-address #user-request (issue request for another user)

Commands by ListProc manager

CON* THREADS (C-30)
CON* MTA-HOST host|- [port] (set MTA, mail transfer agent, hosts) (C-31)

SET* and CON* to set & query settings/configuration

SET* for settings (address, mail, password, conceal, preference) for specified users

To apply the setting to one's self, substitute SET* with
SET|QUEry list
To do the SET command for other specified users, substitute SET* with
[quiet] SET|QUEry list, and append for address...
Multiple settings can be set on one SET* command, and is in the form
[option [args]]...
To see current settings (address, mail, password, conceal, preferences), specify no options.

For managers to set the user SET defaults, and whether users can use SET commands

Set the default for new users, substitute SET* with
CON* DEFAULT
Allow or disallow non-owners to use a SET command, substitute SET* with
CON* SET-{ENABLE|DISABLE}
CON* ENABLE|DISABLE command... (specific commands by users)
To receive copies of all SET requests:
SET* preference CCSET

CON* for configuration by managers only

To set the specified setting, substitute CON* with
CONfiguration|CONfigure list password
Multiple settings can be set on one CON* command, and is in the form
[option [args]],...
To see the current settings, don't specify any options.

Information elsewhere

ListProc resources from CREN

Sites with ListProc documentation for their users

Other resources

Other email list management software

[web] [home] [about] [copyright] [contact] This page changed 2003 April 8.