VI. Command Reference.

Here is a complete description of the set of list management-related commands recognized by ListProcessor and examples of how to submit commands to the ListProcessor. List managers should also obtain the User Reference for a brief description of user commands and the User Manual for more detailed explanation of user commands.

Everything appearing in [] below is optional; everything appearing in <> is mandatory; all arguments are case insensitive. The vertical bar ("|") is used as a logical OR operator between the arguments. Please note that the brackets or braces or parentheses themselves are NEVER a part of the command. In the syntax examples below, the word "list" must be replaced by your list name, the word "password" must be replaced by your list password, the word "options" must be replaced by any options for the command, and the word "args", short for arguments, must be replaced by any additional arguments that must be added after the options. Commands may be abbreviated, but you must give at least as many characters as needed to distinguish the command from other commands or at least enter the first three characters.

All lists have four levels of management commands: (1) the ListProcessor administrator, (2) list owners, who have ultimate control over the list,(3) list moderators, who do the day-to-day list management, i.e., receive messages to REVIEW, APPROVE, DISCARD, or FORWARD reviewed messages, and(4) subscription managers and error message recipients, both of whom have access only to commands relating to subscriptions to the list; specifically, they can ADD, DELETE, SET ...FOR, and REVIEW; however, error message recipients do not receive commands to subscribe to closed lists which subscription managers receive.

Any command which spans more than one line must have an ampersand (&) at the end of each line to indicate that the command is continued on the next line.

Recognized commands are:

A. List configuration commands

EDIT

PUT

REPORTS

CONFIGURATION

B. Commands affecting list subscriptions

ADD

ALIAS

DELETE

IGNORE

LOCK

SET

SYSTEM

UNLOCK

C. Commands affecting posting of messages

APPROVE

DISCARD

HOLD

FREE

D. File archives as lists

AFD

FUI

1. List Setup Commands

EDIt list password filename [-nolock]

Obtain specified file for editing; filename can be one of:

subscribers, aliases, news, peers, ignored, info, or welcome. (For further explanation of these files, see section on Special Files that ListProc Uses above.)

List will be automatically locked to list-specific commands until the list is UNLOCKed, a new file has been PUT, or -nolock is specified in the EDIT command. It is strongly recommended that list owners wanting to use the EDIt command on the subscribers file do so only for the purpose of examining the file and not for the purpose of modifying it. Small errors in modifying the subscribers file will cause ListProc to crash, bringing down ALL local lists. When examining a file, the -nolock option should be used.

Examples:

Let's assume there is a list called "mylist" and the owner's list management password is "beqrt". The owner of the list wants to edit the info file. The owner of "mylist" sends the following commands:

ed mylist beqrt info The info file from "mylist" will be sent to the owner; the list is locked until the info file is replaced or unlocked with an unlock command.

The owner of mylist now wants to modify the welcome file. The owner of "mylist" sends the following commands:

ED mylist beqrt welcome -nolock The welcome file from "mylist" will be sent to the owner; the list is not locked.

PUT list password filename [args]

Replace system files. Filename is as in EDIT command. These files are obtained with the EDIT command, can then be edited and replaced with the PUT command.

If the PUT command is for an alias or ignore file the [args] consists of the address(es). When PUTting a file, its contents start immediately after the command and span the entire message. No other commands can follow a PUT and no signature should be in a PUT command. Neither an alias nor an ignore file can have comments in the file. It is strongly recommended that list owner NOT use the PUT command on a subscribers file because of damage that may be done to ListProc from an improperly edited subscribers file. All modifications desired to the subscribers file can be easily and safely done using ListProc's internal commands such as ADD, DELETE, SET, etc.

Examples:

Let's use the example from the EDIT command above of a list called "mylist" and the owner's list management password is "beqrt". The owner of mylist now wants to replace the info and welcome files with new ones. The owner of "mylist" sends the following commands separately:

put mylist beqrt info

Mylist is a discussion of ideas related to what I think about life.

PUT mylist beqrt welcome

Welcome to Mylist. We will be discussing life in general and in particular.

In the first example above the list's info file will be replaced with a file saying that "Mylist is a discussion of ideas related to what I think about life." In the second example the list's welcome file will be replaced with a file saying "Welcome to Mylist. We will be discussing life in general and in particular." Notice that these are sent as two separate commands in two separate e-mail messages, and not in a single e-mail message. This is because all information put into the message after the command line is incorporated into the file. If the owner's mailer automatically appended the owner's signature to the message then that signature will be included in the file being placed.

REPorts list password

Obtain all reports about the specified local list.

CONfiguration listname password [option [args]] &

[,option [args] ...]] [,option [args] ...]]

Set a list's configuration options. The command, CONFIGURATION, without options, returns the list's current settings. If the configuration command spans more than one line then each line must end in an ampersand (&) in order to indicate that the command is continued on the next line. Options are a comma-separated list of one or more of the following keywords:

ARChive [password] [messages|digests]
NO-ARChive
Turn on/off archiving of lists. Specify a password for subscribers' access to the archives and whether single messages are to be archived or digests. The command ARCHIVE with no options results in non-password protected archive with default archiving of individual messages. If the owner wants to specify digests or messages without a password, a dash (-) is used in place of the password. If the owner wants to remove a password and not replace it, an empty string delimited by single or double quotes ("" or '') will remove it. The directory, archive name, file name of the archived material, and whether archives are stored compressed or not are set by the list manager by request from the list owner. By default every list's messages are stored in the default archive directory with the archive named after the list and no password. File names can be any letters of the alphabet, numbers, the percent character, and the underscore character. Naming may be by any one of a number of character sequences:

-The contents of a ARCHIVE-NAME header line. This method cannot be used if archiving digests.

-The current message count.

-Any combination of day of month, week of month, month name, and year.

-Any combination of issue number and volume number, which is extracted from a line saying Volume # Number #.

-The first word of the first non-blank line of the file.

-Digest number.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo archive erty messages

will cause the list "mylist" to be archived as individual messages which can be obtained from ListProc with a GET command (See GET below) using the password erty.

configuration mylist foo archive - digest

will cause the list "mylist" to be archived as digests according to the default digesting (See DEFAULT below) with no password required to obtain copies of the archived material.

ARCHIVES-TO-ALL
ARCHIVES-TO-OWNERS
ARCHIVES-TO-SUBSCRIBERS
Specify who can request material from the archives. ALL: anyone can request index and archive material. OWNERS: only owners may request archive material and index. SUBSCRIBERS: only owners and subscribers may request index and archive material.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo archives-to-subscribers

will allow only subscribers to the list "mylist" to obtain archives of the list.

AUTO-DELETE-SUBSCRIBERS
NO-AUTO-DELETE-SUBSCRIBERS
ListProcessor has the capability of automatically deleting from a list any users whose mail bounces. This allows for automatic removal of subscribers who have lost or turned off their e-mail accounts, but did not unsubscribe from your lists, or people who for some reason their e-mail addresses become unreachable. These commands turn on and off automatic deletion of subscribers whose mail bounces. When a user is automatically deleted the list owner is notified. If someone other than the list owner is defined as a recipient of system error messages, then that person is notified of the automatic removal of a user.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo auto-delete-subscribers

will allow ListProc to automatically delete any subscriber whose mail bounces. If a list is set to auto-delete-subscribers then the list owner should be aware of the fact that some list subscribers will occasionally complain of not having received any mail from the list recently. Users frequently are not aware when their home system is rejecting mail. Deleting subscribers whose mail bounces is a useful function because bounce mail takes up bandwidth and wastes CPU time. On a small machine with a slow connection to the Internet, large amounts of bounce mail can significantly slow down service on all the machine's local lists.

CLOSED-SUBSCRIPTIONS
OPEN-SUBSCRIPTIONS
OWNER-SUBSCRIPTIONS
When closed, the list will not accept any new subscribers at all. However, the owners may still submit an ADD command. When open, the list will automatically accept all people who send in subscribe requests. Although the owner does not have to approve new subscribers in an open list, the owner can receive notification of new subscribers added to a list; see SET ccpreferences. OWNER-SUBSCRIPTIONS makes a list private. When a user sends a subscribe command for the list to ListProc a message is sent to the subscription manager notifying of the request for subscription. Subscriptions are then approved by the designated people, either subscription managers or owners. OWNER-SUBSCRIPTIONS turns on ARCHIVES-TO-SUBSCRIBERS, REVIEW-TO-SUBSCRIBERS, STATISTICS-TO-SUBSCRIBERS, and SEND-BY-SUBSCRIBERS, all limiting access to information from the list to subscribers.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo open-subscriptions

will allow ListProc to automatically add anyone sending a subscribe request without obtaining approval from the list subscription manager or owner.

configuration mylist foo closed-subscriptions

will cause ListProc to send a message to the person requesting a subscription to the list saying that no new subscriptions are being accepted at this time.

configuration mylist foo owner-subscriptions

will make a list private to subscriptions. The owner or designated subscription manager will have to manually ADD new subscribers.

WIDE-OPEN-LIST
Make a list visible, allows subscribers to add themselves to a list, allows anyone to post messages to the list, and allows anyone to request a review, statistics, or archives from a list.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo wide-open-list

has the same effect as sending a command to ListProc saying

configuration mylist foo open-subscriptions, unmoderated, &

review-to-all, statistics-to-all, archives-to-all.

COMMENT string
NO-COMMENT
Sets the one line list comment (description) string. To remove the comment send an empty string delimited by single or double quotes ("" or ''). Note that only the following characters are permitted in the comment string: All the alphabetic letters from a - Z including both upper and lower case, all the numbers from 0 - 9, and the following characters [ \ t + = : ; ' . , @ # % ! _ - ] while comment strings may NOT contain the following characters: < > ` * ? , \ n

(Please note that in this discussion the symbol \t is a combined symbol which stands for the tab character and not the separate characters slash-t. Likewise \n is a combined symbol which stands for the newline character.) If a comment string is to have a colon ":" then the colon must have an escape character "\" before it "\:"

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo comment MyList\: This is my list

The listing of all lists will say "mylist@machine.address MyList: This is my list". Additionally all mail coming from "mylist" will have the comment appended to the header, "MyList: This is my list".

DEFAULT mailmode option [mailmode option]
Set the default subscription options. Mailmode choices and options are:
DEFAULT address variable|fixed
- variable allows a subscriber to change addresses with a command sent from a different address than the one the user is subscribed from.

- fixed requires a subscriber to unsubscribe from the subscribed address and resubscribe from the new address.

DEFAULT mail ack|noack|postpone|digest
- ack means a subscriber will receive a copy of his/her posting.

- noack means a subscriber will not receive a copy of his/her posting.

- postpone means all mail to a subscriber will be held until the subscriber sends a command changing mailmode to something else.

- digest causes all messages to be sent out concatenated together in groups. The user can change this by sending a command requesting a different mailmode. For example, changing mailmode to ack will turn off digests for the individual user. In contrast, if the list is set to sending out all mail as digests because it was set that way using the DIGEST frequency command, then the individual user will be unable to change that designation.

DEFAULT password string
- sets a default user password. If not set a random password is assigned to new users.
DEFAULT conceal yes|no
- yes allows other people to see the user's name and e-mail address in a list of subscribers to a list.

- no prevents others from seeing user's s name and e-mail address.

DEFAULT preference CCoption
- determines which commands sent by users are copied to owners. CCoption can be one of: CCUNSUBSCRIBE, CCRECIPIENTS, CCINFORMATION, CCSTATISTICS, CCPRIVATE, CCRUN, CCIGNORE, CCERRORS, CCREVIEW, CCALL

When any user sends a command to the ListProcessor concerning a list the owner can be set up to receive a copy of the response. This is useful if owners want to keep track of who subscribes, unsubscribes, requests information, etc. or error messages sent out to users. The more ccoptions set, the more mail a list owner or designated recipient of ccoptions will receive. It may not be advisable to set ccall on a very active list because of the very large volume of mail that may ensue. The 'default preference' only effects owners that are added after the change is made, current owners must change their options using the SET preference command (see below).

A mailmode with an empty string as an option, designated by either two double quotes("") or two single quotes(''), causes the mailmode to revert back to the system default. The user can also revert to default with a SET mailmode command and no arguments.

Examples:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo default address fixed

This will prevent any user from changing a subscribed address from another machine; it forces users to unsubscribe from their subscribed machine and resubscribe from the new address.

configuration mylist foo default mail ack

This will cause ListProc to return a copy of all messages posted to a list by any user to that subscriber as a way of acknowledging to the user that the message was sent out to the list.

configuration mylist foo default mail digest

This setting will cause the ListProcessor to mail out all messages as digests in the manner specified by the DIGEST command (See DIGEST below). Users can override this by sending in a SET listname MAIL ACK command or any other SET listname mail command.

configuration mylist foo default mail noack

With this option set, ListProc will not return a copy of all messages posted to a list by any user to that subscriber unless the subscriber uses the SET command to set his/her mailmode to ack. The subscriber's messages will, however, go out to everyone else on the list.

configuration mylist foo default conceal yes

With this option set, ListProc will conceal the names and addresses of all subscribers to a list. In the event someone sends a REVIEW command to the ListProc, they will receive back the number of subscribers only.

config mylist foo default preference ccsubscribe, ccunsubscribe

With this option set, ListProc will forward all subscribe and signoff (unsubscribe) requests from users to the list owner or person designated to receive error messages (See DELIVERY-ERRORS-TO below). When this is not set by the list owner or by the ListProc site manager, the system default is for ccignore only.

DELIVERY-ERRORS-TO address [address]
REMOVE-ERRORS-TO address [address]
Specifies to which addresses copies of error messages are to be sent, and removes recipients of error messages. If no address is designated then all error messages will go to the list owner by default. "ERRORS-TO" recipients may send commands to ADD, DELETE, SET ...FOR, and REVIEW. This allows the recipients of error messages to take corrective action without having to bother the list owner.

Examples:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo DELIVERY-ERRORS-TO & george@somewhere

This sets the recipient of all error messages set in the DEFAULT preference CCoption command (See DEFAULT preference CCoption above) to george@somewhere. The list owner will continue to receive error messages unless the list owner removes him/herself from receiving such messages with the REMOVE-ERRORS-TO command.

configuration mylist foo REMOVE-ERRORS-TO & harriet@somewhere

This will remove the person harriet@somewhere from receiving error messages.

DIGEST frequency [when] [lines bytes]
DIGEST daily hh:mm [lines bytes]
DIGEST weekly [day-of-the-week] [lines bytes]
DIGEST monthly [lines bytes]
NO-DIGESTS
Turn on/off collection of digests; define when they will be distributed. Requires specification of how frequently the digest should be sent out. Digests can be sent out daily, weekly, or monthly. If weekly, the day of the week can be specified. Digests are always sent out at midnight if the time is not indicated. In contrast, if the default for each subscriber is set to sending out all mail as digests because it was set that way using the DEFAULT mail digest command, then the individual user will be able to change that designation using a SET mailmode command. If lines and/or bytes are specified, digests will then be distributed at the specified time or whenever the number of lines exceeds the specified limit, or whenever the size of the digest exceeds the specified limit. If an owner wants to change the lines or bytes spec only, the owner may use the dash ( - ) as a place holder (one dash is enough for all cases) for frequency.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo digest daily 00:01

will mail digests daily at one minute after midnight

configuration mylist foo digest weekly wednesday 06:00

will mail digests once a week on Wednesdays at 6 am

configuration mylist foo digest monthly 250 2000

will mail digests once a month but if the digest reaches 250 lines or 2000 bytes first it will be sent out. Additional material will be sent out when the month turns over as usual. Since a time is not specified the digest will go out at midnight.

configuration mylist foo digest - 100 1024

will not change the method of sending out digests or time but in the event the digest reaches 100 lines or 1024 bytes in size the digest will be mailed out immediately, not waiting for the designated time. The "-" is used as a place holder for frequency of mailing. To turn off the specs, owners may specify zero:

configuration mylist foo digest - 0 1024

This will send a digest out whenever it is supposed to go out, or every 1024 bytes (or more); no line-count restriction is set.

DISABLE command [command]
ENABLE command [command]
Enable or disable specific user commands. This applies to specific user commands such as REVIEW or STATISTICS but does not apply to user SET commands. Disable prevents users, but not owners, from issuing these commands.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo disable review

will prevent all users, whether subscribed or not, from getting any output from a REVIEW command to ListProc on the "MyList" list.

configuration mylist foo disable subscribe

will prevent anyone from subscribing to "MyList". Anyone wanting to subscribe will have to send a message to the owner asking to be put on and the owner may add the person. However, this should not be routinely used as a means of keeping a list closed. The closed-subscriptions option is better used for this purpose.

SET-DISABLE mode [value] [mode [value]]
SET-ENABLE mode [value] [mode [value]]
mail ack|noack|postpone|digest

conceal yes|no

password

Enable or disable specific user SET commands. This applies to commands in which users set their mail mode such as SET MAIL ACK, conceal, or change their password. Owners can still SET ...FOR any commands which have been disabled.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo set-disable conceal

will prevent all users from changing their visibility on a REVIEW command. If all users are concealed, then they will remain so. If all users are visible, then they will remain visible.

configuration mylist foo set-disable password

will prevent all users from changing their list passwords.

configuration mylist foo set-enable password

will re-enable changing of passwords on a list in which changing passwords was previously disabled.

FORWARD-REJECTS
DONT-FORWARD-REJECTS
Enable or disable forwarding of reject/error messages to the list owners instead of to the original senders. If FORWARD-REJECTS is on, then listprocessor forwards listproc-generated error messages to the list owners, not the message sender.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo forward-rejects

will cause all user-generated error messages to go to the list owner or person designated as recipient of error message.

configuration mylist foo dont-forward-rejects

will allow all user generated error messages to go to the user whose command or message caused the error. The owner or designated recipient of error messages will also receive a copy of the error message.

KEEP-RESENT-LINES
DONT-KEEP-RESENT-LINES
When forwarded mail is sent to a list, enables or disables a header line indicating that the message is forwarded mail.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo keep-resent-lines

When a user forwards mail to a list this will cause ListProc to add a line to the message header saying that the message was forwarded.

HIDDEN-LIST
VISIBLE-LIST
Determines whether a list is visible or hidden when listprocessor receives a command for a list of lists. HIDDEN-LIST turns on ARCHIVES-TO-SUBSCRIBERS, REVIEW-TO-SUBSCRIBERS, STATISTICS-TO-SUBSCRIBERS, SEND-BY-SUBSCRIBERS, all limiting access to information from the list to subscribers.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo hidden-list

will prevent anyone from seeing the list named "MyList" in a LISTS command. Also prevents anyone from requesting archives, a review of the list, statistics, or from posting to the list if they are not subscribed.

MAX-MESSAGES-PER-DAY number
or
MESSAGE-LIMIT number
NO-MESSAGE-LIMIT
Determines the maximum number of messages a list will process per day. Messages above the maximum will be held until the next day and processed, or will be sent if the list is FREEed. It is a good idea to set a message limit for all lists. If the owner does not want a message limit, the limit can be set to a high number. This way, if a message loop occurs there will be a limit to how many messages will get sent out in a single day before the owner discovers and corrects the loop.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo message-limit 300

configuration mylist foo max-messages-per-day 300

will not allow more than 300 messages to go out from MyList in a single day. If more than 300 messages are posted to the list, all messages over 300 are stored until the following day before posting. The two commands, message-limit and max-messages-per-day are synonyms for each other.


MODERATED-EDIT address [address]
MODERATED-NO-EDIT address [address]
UNMODERATED
REMOVE-MODERATORS address [address]
Determine moderation of list. MODERATED-EDIT sends all messages to the moderator(s) for editing and approval. MODERATED-NO-EDIT sends all messages to the moderator(s) for approval and includes a tag identifier in the first line. Moderator sends back an approval command giving the tag identifier only. See APPROVE command. Moderators may be removed with the REMOVE-MODERATORS command. If a list is set up as MODERATED with a specified address as moderator and an additional MODERATED command is given, either MODERATED-EDIT, or MODERATED-NO-EDIT, with a new moderator address, the new moderator address is added to the pre-existing moderator address such that both addresses become moderators. In other words, the old moderator is not replaced. The only way to replace a moderator is to use the REMOVE-MODERATORS command to remove the moderator to be replaced. However, if a list is MODERATED-NO-EDIT and a MODERATED-EDIT command is given, then the list is changed, and vice versa. If a list is MODERATED but no address is specified, messages are sent to owners for approval. See APPROVE command.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo moderated-no-edit george@somewhere

will set the list so that all messages posted to the list by any subscribers will go to george@somewhere for approval. A paragraph is appended to each message telling the moderator to send an approve command if the moderator wants to allow the message to be posted.

configuration mylist foo moderated-edit george@somewhere

will set the list so that all messages posted to the list by any subscribers will go to george@somewhere but then that moderator will be able to edit the messages and send them back to ListProc for posting to the list.

configuration mylist foo moderated-no-edit

will set the list to moderated without editing of messages but since no moderator was specified, the list owner becomes the default moderator of the list.

OWNERS address [address]
New owners may be added with the OWNERS command. This command does not replace owners, it only adds new owners. To replace owners, it is necessary to use both the REMOVE-OWNERS command and the OWNERS command.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo owners george@somewhere

will add george@somewhere as an owner in addition to the current owner(s). It will not replace current owners; it only adds new owners.

REMOVE-OWNERS address [address] ...
List manager, or list owners, if list is OWNER-CONTROLLED, may remove owners.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo remove-owners george@somewhere

will remove george@somewhere from being an owner of the list "MyList".

PASSWORD string
Set or change the list management password.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo password gobbledygook

will change the list management password from "foo" to "gobbledygook".

PUBLISHED-LIST
Will add you list to the global list database. This allows users at other locations to search for you list based on the list COMMENT and list name and subscribe and unsubscribe without knowing the exact location of your list. (Global subscription)
UNPUBLISHED-LIST
Will make you list visible only if the local listproc is queried or searched.

SUBSCRIPTION-MANAGERS address [address] ...
REMOVE-SUBSCRIPTION-MANAGERS address [address] ...
REMOVE-ALL-SUBSCRIPTION-MANAGERS
Add or remove subscription managers. The SUBSCRIPTION-MANAGERS command does not remove or replace the existing subscription managers, it adds new managers. To remove managers the REMOVE-SUBSCRIPTION-MANAGERS command must be used.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo subscription-managers george@somewhere

will set george@somewhere as the subscription manager for the MyList list. All requests for subscriptions will go to that address for approval. Then george@somewhere will have to use the ADD command to subscribe the individuals requesting subscription. If the list is open to subscriptions, however, the subscription manager does not get requests because new subscribers may add themselves.

configuration mylist foo subscription-managers george@somewhere

will remove george@somewhere from being a subscription manager leaving the other subscription managers in place. If there are no other subscription managers then the list owner becomes subscription manager by default.

REPLY-TO-LIST
REPLY-TO-LIST-ALWAYS
REPLY-TO-SENDER
REPLY-TO-SENDER-ALWAYS
REPLY-TO-OMITTED
Determines whether replies automatically go to the list or to the sender of the individual message. If list is a digest replies always go to the list. When a list is set as REPLY-TO-LIST, REPLY-TO-SENDER, or REPLY-TO-OMITTED, if the sender includes a Reply-To: in the message header it takes precedence. However, if the list is set as REPLY-TO-[LIST|SENDER]-ALWAYS then the user's inclusion of a Reply-To: in the message header will be ignored.

Example:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo reply-to-list

will cause all replies to all messages to go to the list except if the sender of the reply adds a REPLY-TO: line to the message header.

configuration mylist foo reply-to-sender-always

will cause all replies to all messages to go to the sender of the message being replied to even if the person replying tries to put a REPLY-TO: line in the message header.

configuration mylist foo reply-to-omitted

will cause all replies to go neither to the list or the person replying. Usually replies go to the list owner.

REVIEW-BY-ALL
REVIEW-TO-ALL
REVIEW-BY-OWNERS
REVIEW-TO-OWNERS
REVIEW-BY-SUBSCRIBERS
REVIEW-TO-SUBSCRIBERS
Determines who can submit a REVIEW command for a list. See below for additional details.

STATISTICS-BY-ALL
STATISTICS-TO-ALL
STATISTICS-BY-OWNERS
STATISTICS-TO-OWNERS
STATISTICS-BY-SUBSCRIBERS
STATISTICS-TO-SUBSCRIBERS
Determines who can issue a command for list statistics. See below for additional details.

SEND-BY-ALL
SEND-BY-OWNERS
SEND-BY-OWNERS-CONFIRM
SEND-BY-SUBSCRIBERS
SEND-BY-SUBSCRIBERS-CONFIRM
Determines who can post to a list.

ALL: Anyone, whether subscribed to a list or not. OWNERS: Limited to list owners. SUBSCRIBERS: Both subscribers and owners. Commands using the word TO or BY are equivalent. The CONFIRM variants require the sender of the message to include

confirm: password

as one of the lines in the message.

Examples:

For a list named "mylist" whose owner password is "foo"

configuration mylist foo review-by-all

will allow anyone, whether subscribed to MyList or not, to send a REVIEW command to ListProc and receive the output.

configuration mylist foo review-to-all

will allow anyone, whether subscribed to MyList or not, to send a REVIEW command to ListProc to REVIEW MyList and receive the output. In all three commands allowing or disallowing a REVIEW command, STATISTICS command, or ability to SEND messages to the list, the TO and BY are synonyms and can be substituted for each other.

configuration mylist foo review-to-owners

will allow only the owners of MyList to send a REVIEW command to ListProc to REVIEW MyList. Subscribers and non-subscribers alike will get back an error message saying this command is not available.

configuration mylist foo review-to-subscribers

will allow only subscribers to MyList to send a REVIEW command to ListProc to REVIEW MyList. In all cases owners are always allowed to send a REVIEW command.

configuration mylist foo statistics-to-all

will allow anyone, whether subscribed to MyList or not, to send a STATISTICS command to ListProc to get use statistics for MyList.

configuration mylist foo send-by-all

will allow anyone, whether subscribed to MyList or not, to send or post messages to the list. However, non-subscribers will not receive any messages from the list.

configuration mylist foo send-by-owners

will allow only the owners of MyList to send or post messages to the list. This creates a one-way read-only list.

Review Examples for the CONFIGURATION Command:

All of the following examples assume a list called bajor-l located at somewhere.net. The owner's password is r45678.

CON bajor-l r45678 owners jim@machine.org sally@machine.org

For the list, bajor-l, adds two people as co-owners, jim@machine.org and sally@machine.org, giving their e-mail addresses. Notice that the configuration command is abbreviated as CON.

con bajor-l r45678 send-by-sub reply-to list review-by-subscr & stat-by-owners arc shazam digests arc-to-all

In this example, for the list bajor-l, send-by-sub allows only subscribers to post to the list, review-by-subscr restricts issuing a review command concerning the list to subscribers. reply-to list directs all replies to messages sent from the list back to the list. stat-by-owners restricts sending a request for list statistics to owners only. arc shazam digests causes all messages sent out from the list to be archived as digests which can be requested by anyone (arc-to-all), whether subscribed to the list or not by giving the archive password shazam. Notice that while the previous example used CON in upper case, this example uses con in lower case. The commands are generally case insensitive. Notice also that because the command spans more than one line it has an ampersand (&) at the end of the first line to signify to the listprocessor that the command is continued on the next line.

Configuration bajor-l r45678 message-limit 1205 visible-list &

no-auto-delete-subscribers keep-resent-lines dont-forward-rejects

In this example, for the list bajor-l, message-limit 1205 sets a limit on the number of messages the listprocessor sends out per day to 1205 messages; once 1205 messages have been sent out, any additional messages will be held until the next day. The owner here has set an extremely high limit which is unlikely to be met unless the list is echoing bounces back to the list. In this case the echo of bounces will continue until the 1205 message limit is reached or the owner or list manager stops the resending of these messages. On the other hand subscribers whose mail bounces will not be deleted from the list automatically (no-auto-delete-subscribers). keep-resent-lines tells the listprocessor to keep the lines saying "Forwarded " in all messages which are forwarded by subscribers to the list. dont-forward-rejects causes the listprocessor to send rejected messages back to the sender of the messages instead of forwarding them to list owners or moderators.

configuration bajor-l r45678

As mentioned previously, the configuration command without any options results in a list of the configuration options as they currently are set for the list. Below is a sample response:

Configuration of ListProcessor list bajor-l@somewhere.net

VISIBLE-LIST
OWNER-SUBSCRIPTIONS
SUBSCRIPTION-MANAGERS [owners]
SEND-BY-SUBSCRIBERS
STATISTICS-TO-SUBSCRIBERS
REVIEW-BY-SUBSCRIBERS
ARCHIVES-TO-SUBSCRIBERS
NO-ARCHIVE
UNMODERATED
DELIVERY-ERRORS-TO [kira@machine.org]
DIGEST daily 00:01 0 0
NO-MESSAGE-LIMIT
COMMENT Ongoing discussion of politics on planet Bajor
AUTO-DELETE-SUBSCRIBERS
DONT-FORWARD-REJECTS
REPLY-TO-LIST
KEEP-RESENT-LINES
OWNERS kira@machine.org jim@machine.org sally@machine.org 
PASSWORD r45678
OWNER-CONTROLLED
Compare the response above with the response a user gets when sending a review command to the listprocessor. The review command returns almost the same information but in a format that is simple to understand for the user. The configuration command with no options returns the information in a format that makes it easier for the list owner to decide on options to change.

review bajor-l short returns the following response:

***
*** list bajor-l@somewhere.net: Ongoing discussion of politics on planet Bajor
***
***  Date created: Sun Sep 11 03:39:41 1994

--- The current list settings are as follows:

PRIVATE: subscriptions controlled by jim@machine.org sally@machine.org .
SEND: open to subscribers and owners only.
VISIBLE: the list shows up in listings.
NO-ARCHIVE: no logs are kept.
STATS: open to subscribers and owners only.
REVIEW: open to subscribers and owners only.
ARCHIVES: available to subscribers and owners only.
UNMODERATED: postings not controlled.
DIGEST: digests distributed daily at 00:01 
MESSAGE-LIMIT: unlimited daily postings.
FORWARD-REJECTS: no; all listproc-generated errors sent to sender.
REPLY-TO-LIST
AUTO-DELETE-SUBSCRIBERS: yes.
KEEP-RESENT-LINES: yes; Resent- header lines preserved.
DELIVERY-ERRORS: non-delivery reports are sent to the owners.
OWNERS: kira@machine.org jim@machine.org sally@machine.org


bajor-l is a private, closed list used by the Bajoran council to discuss local
politics.  Minutes of the meetings of the council are posted to the archives.
In addition to returning the same information as the configuration command, the review command returns the info file and, if the review command is not a "review listname short" command, then it also returns the list of non-concealed subscribers.

End of options for CONFIGURATION command.

2. Commands Affecting List Subscriptions

[quiet] ADD list password address user-name

or, for adding multiple user-names:

[quiet] ADD list password {address user-name} &

{ address user-name }{ address user-name }

Add specified user(s) to the list. If more than one user is added, enclose each one in brackets {}. Multiple names may be placed on one line or place one name per line in brackets. Commands spanning more than one line require an ampersand (&) at the end of each line to indicate that the command is continued on the next line. If the optional "quiet" switch is added before the command line, the user(s) will not be notified. When adding a user to a list only the following characters are permitted in a user's address or user-name:

All the alphabetic letters from a - Z including both upper and lower case, all the numbers from 0 - 9, and the following characters [ \ t + = : ; ' . , @ # % ! _ - ] while user names may NOT contain the following characters: ` " < > [ ] { } | $ ~ * ? ! \

(Please note that in this discussion the symbol \t is a combined symbol which stands for the tab character and not the separate characters slash-t.)

Although a user-name can be as many words as the user wants, the portion that shows up in a review command is limited to five words including the e-mail address.

Examples:

For a list named "mylist" whose owner password is "foo"

add mylist foo ht56@springfield.org Albert Parker

will subscribe Albert Parker to MyList with the address ht56@springfield.org and Albert will receive a welcome message from ListProc.

quiet add mylist foo trans@springfield.org MaryLou Parker

will subscribe MaryLou Parker to MyList with the address trans@springfield.org but MaryLou will NOT receive a welcome message or any indication of having been added to the list from ListProc because in this case the quiet option was used.

add mylist foo {ht56@springfield.org Albert Parker} &

{trans@springfield.org MaryLou Parker} &

{fort@machine.org The National Janitorial Crew}

will subscribe Albert Parker, MaryLou Parker, and The National Janitorial Crew to MyList with their respective addresses. All will receive a welcome message from ListProc. Notice that the subscriber from fort@machine.org used a four-word name for the subscription. ListProc will accept up to five separate words in a subscription, one word is used for the address of the subscriber; the other four words can be used for the subscriber's name. Note that the ampersand (&) is used here to indicate that the ADD command is continued on the next line.

ALIas list password new-address address-as-subscribed

Alias an existing subscriber to a new address. Used in cases where a subscriber needs to be able to send mail from another machine or the subscriber's email address can appear in multiple formats. Mail will be accepted from both the address-as-subscribed and from the new-address. The new-address pattern may be an extended standard UNIX regular expression. For more information on regular expressions, see the section on that subject at the end of this file.

Examples:

For a list named "mylist" whose owner password is "foo" the user ht56@nebbuch.org has informed the list owner that occasionally she would like to be able to send commands to ListProc from another machine but doesn't want to have to subscribe from that machine also. The list owner complied by setting up an alias for the second account.

alias mylist foo ret@kabb.net ht56@nebbuch.org

so that all mail from the second address, ret@kabb.net, is seen by ListProc as being from ht56@nebbuch.org. Using regular expressions, the list owner can map a whole range of e-mail addresses to aliases. For example, a second user has complained that she has an account on a system called whatsoever.net which has 3 machines networked together. Mail can be addressed to her at susie@whatsoever.net. However, when she logs into her account on whatsoever.net she can randomly log into any one of the three machines and her return address can be any one of the 3 machine addresses. The 3 machines are named red, blue, and green. So when she sends mail her message header can say that the mail is from susie@red.whatsoever.net or susie@blue.whatsoever.net or susie@green.whatsoever.net. This results in ListProc having her subscribed to MyList from only one of the three machines and when she is logged into either of the other two machines her commands to ListProc are rejected. This situation is very bothersome for her and she asks the list owner if he can do anything to help her. The list owner responds by sending to ListProc the command

alias mylist foo (.+)@.*\.whatsoever.net \1@whatsoever.net

The addresses being given to the ALIAS command are regular expressions. The subject of regular expressions is covered in another section later in this manual. The end result of the above command is that whenever any mail comes in from any user whose address ends in "whatsoever.net" the person's username is attached to the string "@whatsoever.net" and the first portion, either red, blue, or green, is stripped off.

[quiet] DELETE list password address [address]

Delete the specified user(s) from the list. Multiple names may be placed on one line. If the command spans more than one line an ampersand (&) must be placed at the end of each line to indicate that the command is continued on the next line. If the optional "quiet" switch is added before the command line, the user(s) will not be notified.

Examples:

For a list named "mylist" whose owner password is "foo"

delete mylist foo ht56@springfield.org

will remove ht56@springfield.org from MyList and this user will receive a notification that he has been dropped from the list.

quiet delete mylist foo trans@springfield.org

will delete trans@springfield from MyList, but this user will not receive any notification of being dropped because the quiet option was used on the command.

delete mylist foo ht56@springfield.org &

trans@springfield.org fort@machine.org

will remove, or unsubscribe, all three users from the list. All will receive a notification message from ListProc that they have been removed from the list. Note that the ampersand (&) is used here to indicate that the DELETE command is continued on the next line.

IGNore list password address

Add a user to a file of troublesome users whose mail to a list should be discarded. The address pattern may be an extended standard UNIX regular expression. For more information on regular expressions, see the section on this topic at the end of this file.

Examples:

For a list named "mylist" whose owner password is "foo" a user has been sending abusive messages to the list and the owner wants ListProc to ignore anything coming from this user. The owner sends ListProc a command saying:

ignore mylist foo ht56@springfield.org

which directs ListProc to totally ignore anything sent to it from ht56@springfield.org. The list owner is notified that this person is still sending messages to the list but none of the messages sent gets posted to the list. Using regular expressions, the list owner can have ListProc ignore a whole range of e-mail addresses. For example, suppose the list MyList is being run for the benefit of only people from the University of Southern Madagascar. The domain for that organization is usmaf.edu. By sending the command:

ignore mylist foo ~<.*\.usmaf.edu>

the list owner instructs ListProc to ignore any address that doesn't end in "usmaf.edu". The subject of regular expressions is covered in a section later in this manual.

LOCk list password

Suspend execution of list-specific commands and queue them up for later processing. Owners may still issue such commands, unless the list is locked by the listprocessor manager. The list will still process messages.

UNLock list password

Resume execution of list-specific commands, including those queued up while the list was locked. All owners may unlock a list, unless it's locked by the listprocessor manager.

Examples:

For a list named "mylist" whose owner password is "foo"

lock mylist foo

will prevent all user commands from being sent concerning the list called MyList. Messages posted to the list will still go out. Commands sent to ListProc concerning MyList will be held until the list is unlocked.

unlock mylist foo

will unlock the list and cause any commands being held from users to be executed. Anytime a list owner sends an EDIT command without using the -nolock option, the list will be locked until the list owner sends an UNLOCK command or PUTs the file that was EDITed.

[quiet] SET list [option arg[s]] for address [address]

Allows list owner to SET subscriber mail options for the subscriber(s). If quiet, the user(s) will not be notified. The SET command also allows the list owner to SET the amount of list control messages that are sent to the person who is designated to receive error messages.

Valid options and args are:

[quiet] SET list mail ack|noack|postpone|digest

- ack | noack determines whether sender of message gets a copy of his/her posted messages back from the list. When ack is set, the user gets a copy of all mail sent to the list. When noack is set the sender does not get a copy of his/her own mail sent to the list.

- postpone causes user's mail to be held until the user releases it. This is useful if a user goes on vacation for a period of time. When the user releases the mail by sending another SET command all held mail is sent.

- digest causes a user's mail to be sent collected into a digest. Certain places like CompuServe charge for mail on a per-message basis. In this case a user may want to have all mail from a list sent in a digest instead of separate messages.

[quiet] SET list password current-password new-password

change list password for user.

[quiet] SET list address password new-address

change the address by which the list knows a user. Using the SET address command you can change the address to which your user receives mail from the list.

[quiet] SET list conceal yes|no

hide user name in commands for lists of subscribers.

List owners can set for themselves any of the following:

[quiet] SET list preference CCoption

- determines which commands sent by users are copied to owners. When a user sends any command to ListProc concerning your list a copy of the output from ListProc will come to either the list owner or the designated recipient of error messages or both. CCoption can be one of:

CCSUBSCRIBE - The list owner gets a copy of all subscription requests.

CCUNSUBSCRIBE - The list owner gets a copy of all unsubscribe requests.

CCRECIPIENTS - The list owner gets a copy of all requests for list recipients.

CCINFORMATION - The list owner gets a copy of all requests for information.

CCSTATISTICS - The list owner gets copied on all statistics requests.

CCPRIVATE -

CCRUN - The ListProc manager gets copied on all run requests.

CCIGNORE - The list owner gets all messages sent by people on the ignore file.

CCERRORS - The list owner will receive a copy of all error messages.

CCREVIEW - The list owner will be copied on all review requests.

CCALL -The list owner and/or ListProc manager gets copied on all of the above. Be aware that this option will generate a lot of mail.

SET list preference CCoption is used to make changes from the defaults which are set by the owner using the `configuration listname password default preference' command as detailed above.

In addition, options can be set for subscribers by appending the for userid@host.domain to the set command as follows:

[quiet] SET list address password new-address for user@host.domain

[quiet] SET list mail ack|noack|postpone|digest for user@host.domain

In this way, an owner can submit requests for users effecting only that user account without the need to edit the subscribers file.

Examples:

For a list named "mylist" whose owner password is "foo"

SET mylist foo mail digest for mark@where.ever.com

will tell ListProc to send all mail from the list called MyList to user mark@where.ever.com as a digest instead of single messages. The user can, of course, send a SET mail digest command himself but if either the set command is disabled by the owner or the user is so unsure of himself that he asks the list owner to do it for him this allows the list owner to do it.

SET mylist mark@last.address foo mark@where.ever.com

will tell ListProc to change the address for mark@last.address in the list called MyList to mark@where.ever.com. This would be in the event that user mark@last.address suddenly lost his account and was unable to unsubscribe from the list. If mark@last.address remembered his list subscriber password, he might have been able to change his address on the list himself using the SET list-name password old-address new-address command which is detailed in the ListProc User Manual.

SET mylist preference ccsubscribe ccunsubscribe ccerrors

will tell ListProc to send all requests to subscribe or unsubscribe and all error messages to the list owner or other designated recipient of error messages. (See the section describing the Configuration delivery-errors-to command above.)

SYStem list password user-address #user-command

Allows the list owner to issue any command on a user's behalf. This command is a vestigal command from previous versions of ListProc and it has been replaced by other commands. Its presence in this version of ListProc is only for the convenience of list owners who are accustomed to previous versions of ListProc.

3. Commands Affecting Posting of Messages to a List

APProve list password tag [tag][tag][tag].... [tag]
DIScard list password tag [tag][tag][tag].... [tag]

If the list is set up as MODERATED-NO-EDIT, discards or approves the message identified by the tag number for posting to the specified moderated list. Both APPROVE and DISCARD will accept multiple tags on one line or on several lines, each ending in an ampersand (&) except for the last line.

Examples:

For a list named "mylist" whose owner password is "foo"

APPROVE mylist foo 124 749 325

DISCARD mylist foo 097

on a list which is moderated-no-edit will tell ListProc to send messages with tag numbers 124, 749, and 325 out to the list while the second line tells ListProc to discard message number 097.

HOLd list password

Suspend distribution of messages but allow users and owners to send commands to the list. This command is complementary to the LOCK command which stops all commands to the list but allows messages to continue to be delivered.

FREe list password

Resume delivery of a held list, or reset the message-limit to zero. If the listprocessor manager held the list, only he/she can free it.

Examples:

For a list named "mylist" whose owner password is "foo"

HOLD mylist foo

will tell ListProc to suspend distribution of mail to MyList. However, commands concerning the list will still be accepted.