Majordomo2 Subscriber Commands
This is a basic overview of the supported Majordomo commands for use by
subscribers. For a list of administrative commands and additional modes,
see the 'admin commands' help topic.
Many commands have options available to modify their behavior. Options
will appear next to the command names in (parentheses). Commands with
options should be sent in the format:
Multiple options may be strung together like so:
An address can generally be omitted from the command. If omitted, your
address will be used if it can be determined. Note that the address is not
optional for the alias and unalias commands.
Commands may be sent either to the majordomo server's address, or to the
list's -request address (i.e., scooters-request). For messages sent to the
-request address, the list name can be omitted from the commands. The list
cannot be omitted from commands sent to the majordomo address.
Examples of the commands that follow will assume an imaginary list named
Some commands will require your confirmation before their actions will be
taken; this can help protect you from mischief by preventing others from
submitting commands in your name. In such a case, a 'token' will be
mailed to you for approval.
The 'accept' command tells Majordomo to accept a confirmation or
consultation token, thus approving the requested action. The stalled
command will be executed and the results returned in the response
If the token is omitted from the command, the Subject: header will be
searched for one; accepting a token therefore usually requires only that
you hit "reply" on your mailer and type the word "accept".
See Also: reject
If you have more than one email address, you may wish to be able to post
from more than one of them, while receiving list mail at only a single
address. The 'alias' command allows this.
Send this command from an address that is registered with the server; the
given address will then be considered equivalent to the address from
which you sent the command.
Example: Thad has two addresses, email@example.com and firstname.lastname@example.org.
He wants to be able to post from either address, but only
wants to receive mail at email@example.com. He subscribes to
the list as firstname.lastname@example.org and, from that address, sends
approve password command
This runs the given command (and arguments) with the supplied password,
executing the command without requiring a confirmation token. In our
example below, "vespa" is the registered user's password.
Example: approve vespa alias email@example.com
This returns a Frequently Asked Questions document for the current list,
if one is available
get list file address
This retrieves the given file from the list's file storage. The file
will be mailed to the supplied address.
help topic subtopic ...
This retrieves the given help topic.
index list path (-recursive, -long)
This retrieves an index of available files.
This retrieves the given list's informational document, if one is
This retrieves the given list's introductory document, if one is
available. Note that this is not (currently) the same as the welcome
document that is sent to new subscribers.
lists (-enhanced, -short, -tiny)
This retrieves a list of lists on this server which are available to you.
The enhanced mode includes long descriptions and additional list
information, including an indication of whether you are subscribed to
each list. The short mode uses only short descriptions. The tiny mode
includes only the list names and nothing else.
password userspassword address (-random)
Change the password for the given registered address to userspassowrd.
A confirmation token will be sent to the given address to verify this
The -random option will generate a random password; naturally, no new
password need be provided in this case.
Examples: password blahblah firstname.lastname@example.org
See also: approve
register address (-nowelcome)
This adds an address to the registration database without adding it to
Example: register email@example.com
See Also: unregister
This rejects a token, preventing the requested action from being taken.
If no 'accept' command is received, the token will eventually be rejected
by default, but issuing a 'reject' command will immediately delete the
token and requested action from the server's database.
See Also: accept
set list flag address
This sets various subscription parameters. More documentation to come.
This displays various information about the address:
- Whether or not the given address is legal
- The mailbox and comment, extracted from the address
- What the address transforms to, under the various address
- Any aliases attached to the address
- Any lists the address is subscribed to
- The time the address was registered
- The time the registration data was last updated
- For each list the address is subscribed to:
- What address is receiving the list mail
- The time that the address was subscribed to the list
- The subscription class
- The subscriber flags
- The time the record was last updated
Example: show firstname.lastname@example.org
subscribe list address
This adds the address to the given list and to the registration database
if not already registered.
Examples: subscribe scooters
This removes the given address as an alias for the current address. Send
this command from an address that is registered with the server; the
given address will then be removed from the database an no longer
considered equivalent to the registered address.
Example: unalias scooters email@example.com
See Also: alias
This removes the given address from the registration database and from
every list that it might be subscribed to.
Example: unregister firstname.lastname@example.org
See Also: register, unsubscribe
unsubscribe list address
Removes an address or addresses from the given list. Even after the
address has been removed from all lists, it will still exist in the
registration database. This allows a user to leave one list and join
another without obtaining a new personal password.
Example: unsubscribe scooters email@example.com
See Also: subscribe, unregister
This shows which lists contain addresses which contain the given string.
Examples: which firstname.lastname@example.org
Returns all members of the list.
Examples: who scooters
William R. Dickson - System Administration email@example.com
Northwest Nexus - Professional Internet Services Bellevue, WA USA
Voice: 425 455-3505 Web: http://www.nwnexus.com/ Info: firstname.lastname@example.org