University of Southern California

ITS Information Technology Services

ListProc

List-Owner Reference Card

Table of Contents

To top of page

Introduction

This List-Owner Reference Card provides an introduction to the list-owner commands of ListProc* list- and file-management software. 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.

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.

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:

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:

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

To top of page

Last updated:
June 04, 2007

The use of all USC computing resources is governed by the USC Computing Policies.