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.

The SET and CON commands are abbreviated, with details in the SET* and CON* section.
Each (C-#; R-#) refers to the line numbers in the list returned by the CON and REVIEW commands.
A vertical bar "|" separates choices; specify one.
Words that appear as these do, are to be typed as is, but case doesn't matter.
Although UPPERcase letters are required, lowercase letters that follow are optional.
Words that appear as these do, are the default.
Words that appear as these do, are to be replaced by actual values.
Words within [square brackets] are [optional].

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

To continue a command on the next line, end the line with an ampersand (&).
Each command must be shorter than 1024 characters.
A separate acknowledgment email is returned for each command.
To signify no command argument where one is required, use a pair of quotes with nothing between them.

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]

info: sent out to anyone requesting information from ListProc about your list.
welcome: automatically sent out to all new subscribers to a list.
news: information necessary for establishing the gateway between newsgroup and list.
peers: file is a special file which coordinates the peering of lists.

Other information

REPorts list password (request all reports)

version|release (get ListProc version, and email addresses of ListProc and its manager)

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]

subscribers: list of all subscribers (e-mail address, name, and switches)
alias: for each subscriber, list additional addresses that should be recognized
ignored: list of users whose messages should not be posted

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)

Management

List management responsibilities

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

Regular users (subscribers, and possibly anyone): subscribe, query, post.
System manager or ListProcessor administrator: install/configure ListProc, create lists, specify lists' owners.
List owner or administrator: configure list, and can delegate responsibilty to next three.
Subscription managers: add or remove individuals to the list.
Moderators: approve messages and guide on-line discussions.
Error-message managers: contact users who submit invalid commands, remove users with invalid addresses.

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

Other email list management software

Listserv by L-Soft International
Majordomo, community-supported free software
Mailman, free software distributed under the GNU General Public License