List-Owner Reference Card

August 1994, ListProcessor 7.0

Click here jump to the text

Introduction
I. List Setup Commands
- File/Report Commands
  - EDIt,
    PUT
  - REPorts
- Configuration Commands
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

Introduction

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

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.

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

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

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.

Your Feedback Desired

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

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

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