LIST CONFIGURATION COMMANDS

EDIT

PUT

REPORTS

CONFIGURATION


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-TO-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-TO-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.

[BACK] to the Command Reference Directory

[BACK] to the Table of Contents