The Premiere Mailing List Management Software from CREN

ListProc Home




Technical Support





List-Owner Reference Card

August 1994, ListProc 7.0

Table of Contents

To top of page


This List-Owner Reference Card provides an introduction to the list-owner commands of the CREN* ListProc* 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 ListProc 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 Listproc List-Owner Reference, available in plain text format by sending the command get listproc ownerman as the body of a mail message to or any other CREN ListProc. This document is available from via anonymous ftp, as the PostScript file /listproc/ 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

I. List Setup Commands

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

    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.

    Turn on and off automatic deletion of subscribers whose mail bounces.

    When closed, the list will not accept any new subscribers without owner's approval.

    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
    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:
    • CCRUN
    • 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

    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.


    Enable or disable forwarding of reject/error messages to the list owners and moderators instead of to the original senders.

    When forwarded mail is sent to a list, enables or disables a header line indicating that the message is forwarded mail.

    Determines whether a list is visible or hidden when ListProc receives a command for a list of lists. HIDDEN-LIST turns on ARCHIVES-TO-SUBSCRIBERS, REVIEW-TO-SUBSCRIBERS, STATISTICS-TO-SUBSCRIBERS, SEND-TO-SUBSCRIBERS.

  • MESSAGE-LIMIT number
    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]
  • 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] ...
    Add or remove subscription managers.

    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.


    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.

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

    Determines who can issue a command for list statistics.

    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

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

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

[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

III. 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, 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 ListProc manager held the list, only he/she can free it.

Your Feedback Desired

Your suggestions for improving this document are eagerly solicited by CREN and should be sent to

* CREN is a registered Service Mark of the Corporation for Research and Educational Networking (CREN). CREN has applied for registration of ListProcessor and ListProc.

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

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

To top of page