Click here jump to the text

Table of Contents

• Introduction

• I. List Setup Commands
  • File/Report Commands
    • EDIt, PUT

    • REPorts

  • Configuration Commands
    • ARChive, NO-ARChive

    • ARCHIVES-TO-ALL, ARCHIVES-TO-OWNERS, ARCHIVES-TO-SUBSCRIBERS

    • AUTO-DELETE-SUBSCRIBERS, NO-AUTO-DELETE-SUBSCRIBERS

    • CLOSED-SUBSCRIBERS, OPEN-SUBSCRIBERS, WIDE-OPEN-LIST

    • COMMENT, NO-COMMENT

    • DEFAULT

    • DELIVERY-ERRORS-TO, REMOVE-ERRORS-TO

    • DIGEST, NO-DIGEST

    • DISABLE, ENABLE, SET-DISABLE, SET-ENABLE

    • FORWARD-REJECTS, DONT-FORWARD-REJECTS

    • HIDDEN-LIST, VISIBLE-LIST

    • KEEP-RESENT-LINES, DONT-KEEP-LINES

    • MAX-MESSAGES-PER-DAY, MESSAGE-LIMIT, NO-MESSAGE-LIMIT

    • MODERATED-EDIT, MODERATED-NO-EDIT, UNMODERATED, REMOVE-MODERATORS

    • OWNERS, REMOVE-OWNERS

    • OWNER-SUBSCRIPTIONS

    • PASSWORD

    • REPLY-TO-LIST, REPLY-TO-LIST-ALWAYS, REPLY-TO-SENDER, REPLY-TO-SENDER-ALWAYS, REPLY-TO-OMITTED

    • REVIEW-BY-ALL, REVIEW-BY-OWNERS, REVIEW-BY-SUBSCRIBERS

    • SEND-BY-ALL, SEND-BY-OWNERS, SEND-BY-SUBSCRIBERS

    • STATISTICS-BY-ALL, STATISTICS-BY-OWNERS, STATISTICS-BY-SUBSCRIBERS

    • SUBSCRIPTION-MANAGERS, REMOVE-SUBSCRIPTION-MANAGERS, REMOVE-ALL-SUBSCRIPTION-MANAGERS

• II. Commands Affecting List Subscriptions
  • ADD, DELETE

  • ALIAs

  • IGNore

  • LOCk, UNLock

  • SET

  • SYStem

• III. Commands Affecting Posting of Messages to a List
  • APProve, DIScard

  • HOLd, FREe

• Your Feedback Desired

To top of page

This List-Owner Reference Card provides an introduction to the list-owner commands of the CREN* ListProcessor* list- and file-management software, also known as ListProc*. The commands documented in this reference are not generally available to subscribers who do not own the list affected by the command being used.

This reference assumes familiarity with the ListProcessor User Reference Card and does not replicate that document's explanation of ListProc's subscriber commands.

The syntax is used in this document is the same as that of of the User Reference Card.

For additional information, including specialized commands, use the ListProc HELP command or refer to the Listprocessor List-Owner Reference, available in plain text format by sending the command get listproc ownerman as the body of a mail message to listproc@listproc.net or any other CREN ListProcessor. This document is available from ftp.cren.net via anonymous ftp, as the PostScript file /listproc/ownercard.ps and as the RTF file /listproc/ownercard.rtf (open the latter with Microsoft Word or WordPerfect*, and set the orientation to landscape before printing).

To top of page

File/Report Commands

EDIt list password filename [-nolock]

Obtain specified file for editing; filename can be one of:
subscribers, aliases, news, peers, ignored, info, or welcome.
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.

PUT list password filename [args]

Replace system files. Filename is as in EDIT command.

REPorts list password

Obtain all reports about the specified local list.

To top of page

Configuration Commands

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

  To top of page

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

• AUTO-DELETE-SUBSCRIBERS
• NO-AUTO-DELETE-SUBSCRIBERS
  Turn on and off automatic deletion of subscribers whose mail bounces.

• CLOSED-SUBSCRIPTIONS
• OPEN-SUBSCRIPTIONS
  When closed, the list will not accept any new subscribers without owner's approval.

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

• 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 '').

  To top of page

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

• 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

  To top of page

  The 'default preference' only effects owners that are added after the change is made, current owners must change their options using the SET command.

  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.

• 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. "ERRORS-TO" recipients may send commands to ADD, DELETE, SET ...FOR, and REVIEW.

• DIGEST frequency [when]
  • DIGEST daily hh:mm
  • DIGEST weekly [day-of-the-week]
  • DIGEST monthly

  To top of page

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

• DISABLE command [command]
• ENABLE command [command]
  Enable or disable specific user commands.

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

• FORWARD-REJECTS
• DONT-FORWARD-REJECTS
  Enable or disable forwarding of reject/error messages to the list owners and moderators instead of to the original senders.

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

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

• MAX-MESSAGES-PER-DAY number
• 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.

• 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 designated 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. Persons designated as moderator may issue a REVIEW command when REVIEW-BY-OWNERS is set and receive error messages when FORWARD-REJECTS is set.

  To top of page

• OWNERS address [address]
  New owners may be added with the OWNERS command.

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

• PASSWORD string
  Set list management password.

• SUBSCRIPTION-MANAGERS address [address] ...
• REMOVE-SUBSCRIPTION-MANAGERS address [address] ...
• REMOVE-ALL-SUBSCRIPTION-MANAGERS
  Add or remove subscription managers.

• OWNER-SUBSCRIPTIONS
  Makes a list private. Subscriptions are approved by the designated people, either subscription managers or owners. Turns on ARCHIVES- TO-SUBSCRIBERS, REVIEW-TO-SUBSCRIBERS, STATISTICS-TO- SUBSCRIBERS, and SEND-TO-SUBSCRIBERS.

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

• REVIEW-BY-ALL>
• REVIEW-BY-OWNERS
• REVIEW-BY-SUBSCRIBERS
  Determines who can submit a REVIEW command for a list. REVIEW-BY- OWNERS includes those designated as moderators.

• STATISTICS-BY-ALL
• STATISTICS-BY-OWNERS
• STATISTICS-BY-SUBSCRIBERS
  Determines who can issue a command for list statistics.

• SEND-BY-ALL
• SEND-BY-OWNERS
• SEND-BY-SUBSCRIBERS
  Determines who can post to a list. [ALL: Anyone. OWNERS: Limited to owners. SUBSCRIBERS: Both subscribers and owners. Commands using the word TO or BY are equivalent.

To top of page

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

ALIas list password new-address address-as-subscribed

Alias an existing subscriber to a new address. The new-address pattern may be an extended standard UNIX regular expression.

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

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.

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.

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

To top of page

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.
  • postpone causes user's mail to be held until the user releases it.
  • digest causes a user's mail to be sent collected into a digest.

• [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.

• [quiet] SET list conceal yes|no
  hide user name in requests for lists of subscribers.

SYStem list password user-address #user-command

Allows the list owner to issue any command on a user's behalf.

To top of page

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, allows the moderator to discard or approve the message identified by the tag number for posting to the specified moderated list.

HOLd list password

Suspend distribution of messages but allow users and owners to send commands to the list.

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.

Distribution of this document in its entirety is permitted; partial reproduction or modification other than minor reformatting without CREN's written permission is forbidden.

ListProcessor List-Owner Reference Card Distribution code: User Copyright 1994 by the Corporation for Research and Educational Networking.