Internals: Commands.pm

This module does the mail commands processing.

parse(), add(), del(), subscribe(), signoff(), invite(), last(), index(), getfile(), confirm(), set(), distribute(), reject(), modindex(), review(), verify(), remind(), info(), stats(), help(), lists(), which(), finished().

Parses the command line and calls the adequate subroutine (following functions) with the arguments of the command. This function is called by sympa::DoCommand() (see sympa-docommand, page�).

IN:

1. sender(+): the command sender
2. robot(+): robot
3. i(+): command line
4. sign_mod: 'smime' undef

OUT: 'unknown_cmd' $status - command process result

Adds a user to a list (requested by another user), and can send acknowledgements. New subscriber can be notified by sending template 'welcome'.

IN:

1. what(+): command parameters: listname, email and comments eventually
2. robot(+): robot
3. sign_mod: 'smime' undef - authentification

OUT: 'unknown_list' 'wrong_auth' 'not_allowed' 1 undef

Removes a user to a list (requested by another user), and can send acknowledgements. Unsubscriber can be notified by sending template 'removed'.

IN:

1. what(+): command parameters: listname and email
2. robot(+): robot
3. sign_mod: 'smime' undef - authentification

OUT: 'unknown_list' 'wrong_auth' 'not_allowed' 1

Subscribes a user to a list. New subscriber can be notified by sending him template 'welcome'.

IN:

1. what(+): command parameters: listname and comments eventually
2. robot(+): robot
3. sign_mod: 'smime' undef - authentification

OUT: 'unknown_list' 'wrong_auth' 'not_allowed' 1 undef

Unsubscribes a user from a list. He can be notified by sending him template 'bye'.

IN:

1. which(+): command parameters: listname and email
2. robot(+): robot
3. sign_mod: 'smime' undef - authentification

OUT: 'syntax_error' 'unknown_list' 'wrong_auth' 'not_allowed' 1 undef

Invites someone to subscribe to a list by sending him the template 'invite'.

IN:

1. what(+): command parameters: listname, email and comments
2. robot(+): robot
3. sign_mod: 'smime' undef - authentification

OUT: 'unknown_list' 'wrong_auth' 'not_allowed' 1 undef

Sends back the last archive file by calling List::archive_send() function (see list-archive-send, page�).

IN:

1. which(+): listname
2. robot(+): robot

OUT: 'unknown_list' 'no_archive' 'not_allowed' 1

Sends the list of archived files of a list.

IN:

1. which(+): listname
2. robot(+): robot

OUT: 'unknown_list' 'no_archive' 'not_allowed' 1

Sends back the requested archive file by calling List::archive_send() function (see list-archive-send, page�).

IN:

1. which(+): commands parameters: listname and filename(archive file)
2. robot(+): robot

OUT: 'unknown_list' 'no_archive' 'not_allowed' 1

Confirms the authentification of a message for its distribution on a list by calling function List::distribute_msg() for distribution (see list-distribute-msg) or by calling List::send_to_editor() for moderation (see ).

IN:

1. what(+): authentification key (command parameter)
2. robot(+): robot

OUT: 'wrong_auth' 'msg_not_found' 1 undef

Changes subscription options (reception or visibility)

IN:

1. what(+): command parameters: listname and reception mode (digestdigestplainnomailnormal...) or visibility mode(concealnoconceal).
2. robot(+): robot

OUT: 'syntax_error' 'unknown_list' 'not_allowed' 'failed' 1

Distributes the broadcast of a validated moderated message.

IN:

1. what(+): command parameters: listname and authentification key
2. robot(+): robot

OUT: 'unknown_list' 'msg_not_found' 1 undef

Refuses and deletes a moderated message. Rejected message sender can be notified by sending him template 'reject'.

IN:

1. what(+): command parameters: listname and authentification key
2. robot(+): robot

OUT: 'unknown_list' 'wrong_auth' 1 undef

Sends a list of current messages to moderate of a list (look into spool queuemod) by using template 'modindex'.

IN:

1. name(+): listname
2. robot(+): robot

OUT: 'unknown_list' 'not_allowed' 'no_file' 1

Sends the list of subscribers of a list to the requester by using template 'review'.

IN:

1. listname(+): list name
2. robot(+): robot
3. sign_mod: 'smime' undef - authentification

OUT: 'unknown_list' wrong_auth no_subscribers 'not_allowed' 1 undef

Verifies an S/MIME signature.

IN:

1. listname(+): list name
2. robot(+): robot
3. sign_mod: 'smime' undef - authentification

OUT: 1

Sends a personal reminder to each subscriber of a list or of every list (if $which = *) using template 'remind' or 'global_remind'.

IN:

1. which(+): * listname
2. robot(+): robot
3. sign_mod: 'smime' undef - authentification

OUT: 'syntax_error' 'unknown_list' 'wrong_auth' 'not_allowed' 1 undef

Sends the list information file to the requester by using template 'info_report'.

IN:

1. listname(+): name of concerned list
2. robot(+): robot
3. sign_mod: 'smime' undef - authentification

OUT: 'unknown_list' 'wrong_auth' 'not_allowed' 1 undef

Sends the statistics about a list using template 'stats_report'.

IN:

1. listname(+): list name
2. robot(+): robot
3. sign_mod: 'smime' undef - authentification

OUT: 'unknown_list' 'not_allowed' 1 undef

Sends the help file for the software by using template 'helpfile'.

IN:

1. : ?
2. robot(+): robot

OUT: 1 undef

Sends back the list of public lists on this node by using template 'lists'.

IN:

1. : ?
2. robot(+): robot

OUT: 1 undef

Sends back the list of lists that sender is subscribed to. If he is owner or editor, managed lists are noticed. Message is sent by using template 'which'.

IN:

1. : ?
2. robot(+): robot

OUT: 1

Called when 'quit' command is found. It sends a notification to sender: no process will be done after this line.

IN: -

OUT: 1

get_auth_method()

Called by processing command functions to return the authentification method and to check the key if it is 'md5' method.

IN:

1. cmd(+): requesting command
2. email(+): used to compute auth if needed in command
3. error(+): ref(HASH) - keys are:
   • type: $type for message_report template parsing
   • data: ref(HASH) for message_report template parsing
   • msg: for do_log()
4. sign_mod(+): 'smime' - smime authentification undef - smtp or md5 authentification
5. list: ref(List) undef - in a list context or not

OUT: 'smime' 'md5' 'smtp' - authentification method if checking not failed undef