Middle Tennessee State University ListProc Information

ListProc 8.1 Owner Reference Card(c)

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 Owner Manual. Both the manual and this Card are available on www.cren.net/listproc/docs/index.html.

WARNING: How to Send Commands to Listprocessor
Note that all ListProcessor commands must be sent to a ListProcessor server, listproc@host.domain, for processing -- for example, to listproc@listproc.net. They must not be sent to a mailing list, since mail to a mailing list goes to all the subscribers to that list. Commands are sent as the body of an e-mail message to a ListProc server. ListProcessor ignores the subject line, so you may use whatever subject is useful for your purposes.

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



• CONfiguration listname password [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.



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



• 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.
    
    - 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:
    1. CCUNSUBSCRIBE
    2. CCRECIPIENTS
    3. CCINFORMATION
    4. CCSTATISTICS
    5. CCPRIVATE
    6. CCRUN
    7. CCIGNOR
    8. CCERRORS
    9. CCREVIEW
    10. CCALL
    
    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
• 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 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
            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.



• 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. Moderat or sends back an approval command giving the tag identifier only. See APPROVE command. Moderators may be removed with the REMOVE-MODERATORS command.



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



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



End of options for CONFIGURATION command.

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 ampers and (&) 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.
  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 EMo 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.

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, discards or approves 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.