Sign In | Sign Out | Mailing Lists | Unsubscribe or Change Settings | Help |
OpenBSD Mailing List Server
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = report[-summary][-inform] listname [date] [action[,action]] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - listname, required, is an email list at this site -full, if specified, displays the session number and interface -inform, if specified, uses the set of actions in the "inform" setting -summary, if specified, gives a table summarizing the number of events action, if specified, is a comma separated list of things to report date, if specified, determines the period of time to report on = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = EXAMPLE: report-summary nectarine 12h ALL might display the following report: Activity for nectarine from 2000-08-03 02:53 to 2000-08-03 14:53 Command: Total Succeed Stall Fail Time announce: 7 6 0 1 1.375 faq: 1 1 0 0 0.849 report: 2 1 0 1 5.439 who: 1 1 0 0 2.247 The "report" command displays raw or summarized data for recent log entries for a mailing list, and can be constrained by action or date. The "summary" command mode results in a table summarizing how many of each kind of event occurred. Otherwise, each event is reported. The specified "listname" can be any regular list, or "ALL" to report on all mailing lists, or one of the pseudo-lists "DEFAULT" or "GLOBAL". Reporting on "GLOBAL" will inform you about commands such as accept, reject, lists, which, and help. Reporting on "DEFAULT" shows commands that act on the system defaults, like "configset DEFAULT". Reporting on a regular list will inform you about things like subscription requests and attempts to post. If you specify a "date" field, the report will be restricted to a period of time. Without "date", all events since the software was installed will be reported. Dates can be specified in several formats: 1. for the last N hours, days, weeks, months, or years, use the format shown in the "Time Period" section of "help times". For example, "3h" reports on events during the last 3 hours. 2. for a given year, month, week, or day, use the format shown in the "Time Stamp" section of "help times". For example, "200007" reports on events during the month of July 2000. The "inform" command mode will cause the actions for which "report" is specified in the inform configuration setting to be displayed. Any actions specified in the report command itself will have no influence on the output. If you specify majordomo commands in a comma-separated list of actions, only those types of events will be reported. If you specify no actions, or if you use "ALL" as the action, all events will be reported. See "help topics" for a list of commands that can be reported. The following additional actions can be specified with the report command: badtoken A bad token identifier was given with the accept command. bounce A bounce to the list owner that had a recognized address. connect A connection failed due to the GLOBAL configuration settings. consult A consult token was accepted for a posted message. expire The lifetime of a request that required approval expired, and its token identifier was removed from the database. newtoken A new token identifier has been added to the token database. parse A message was sent to the server that contained no valid commands. probebounce A bounce probe message could not be delivered. tokenbounce A confirmation message could not be delivered. ALL Report everything. The actions can optionally be followed by a colon or pipe (':', '|') and one or more results. The possible results are "succeed," "stall," "fail," or "all." For example, the following command will show a report of all successful posts made to the bismuth mailing list during the last 12 days: report bismuth 12d post : succeed Actions and results can be combined with comma-separated lists. For example, the following command will show a report of all stalled and failed subscription and unsubscription attempts on the cannabis list during the last 36 hours: report cannabis 36h subscribe,unsubscribe : stall,fail It is also possible to use multiple action/result criteria with a here document. The following command would have the same result as the previous command: report cannabis 36h <<ABC subscribe : stall,fail unsubscribe : stall, fail ABC Normally, when events are reported individually, the command, address from which the request was made, result of the command and time of day are displayed. If the "full" command mode is used, the full command will be displayed on a second line, and the interface, session number, and elapsed time in seconds will be displayed on the third line, as in the following sample event: report testlist someone@example.com succeed 20:12 report testlist 7d shell 311b85c9855dae4dd63f13b34ed18f79b7f7ddef 9.358 In this example, the command "report testlist 7d" was completed at 20:12 (8:12 pm) from the shell interface. The command succeeded, and required 9.358 seconds to execute. The session number is especially useful for determining what caused a "bounce" (delivery failure). Please see "help sessioninfo" for more details. In a summary report, the time shown for each event type is the average number of seconds per event. Log entries that are older than the number of days in the log_lifetime configuration setting are removed automatically. Consequently, the report command is only useful for monitoring recent events. The triggers configuration setting can be used to adjust the frequency with which old log entries are removed; by default, this happens daily. Special Events Several events which are recorded in the log do not have a corresponding Majordomo command. Each of those events is described in this section. badtoken -------- A GLOBAL "badtoken" failure is recorded when the accept command is used with a valid token identifier that does not currently exist in the token database. This failure usually occurs when someone uses the accept command with a token that has recently expired or has been accepted or rejected by another person. This error is only recorded if a token identifier in the correct format is used. See "help showtokens" and "help tokeninfo" for an introduction to token identifiers. bounce ------ A "bounce" event is recorded when an e-mail message cannot be delivered to a subscriber of a mailing list or to someone who sent a Majordomo command to the server. connect ------- A "connect" failure is recorded in the log when a message or command cannot be completed due to the configuration settings of the GLOBAL pseudo-list. There are several situations in which this might occur: * Someone sends an e-mail message containing commands to the Majordomo server, but the return address in the "From:" header of the message is missing or contains an invalid address. * Someone sends an e-mail message of any kind that is denied by the GLOBAL access rules for the "access" action. * Someone sends an e-mail message of any kind that contains a header that is listed in the GLOBAL block_headers configuration setting. * Someone attempts to access the web interface for list administrators using invalid information (mailing list name, password, or e-mail address). consult ------- A "consult" event is recorded when a moderator of a mailing list uses the "accept" command to approve a posted message. In the case of multiple moderators, it is helpful to distinguish "consult" actions from ordinary "accept" actions for the purpose of determining which moderator approved which message. expire ------ An "expire" event is recorded when a token identifier is removed automatically from the token database because its lifetime has expired. See "help configset_triggers" and "help token_lifetime" for more information about the expiration of tokens. newtoken -------- A "newtoken" event is recorded whenever a command or posted message is held, awaiting someone's approval. parse ----- A "parse" event is recorded when an e-mail message is processed for commands by the command parser, but no commands are found. probebounce ----------- A "probebounce" event is recorded when a bounce probe message cannot be delivered to the intended recipient. Bounce probe messages are created by the bounce rules; if the probebounce results in an address being removed from a mailing list, an "unsubscribe" event is also recorded. See "help configset_bounce_rules" for more information on probes. tokenbounce ----------- A "tokenbounce" event is recorded when a confirmation message cannot be delivered to the intended recipient. If the tokenbounce results in the token ID being removed from the database, a "reject" event is also recorded. Interfaces The report-full command will include information about the interface that was used to execute a command. The interfaces are listed in the following table: email The Majordomo server address email-command The LIST-subscribe, LIST-unsubscribe, or another e-mail address that runs a specific command email-request The LIST-request address owner The LIST-owner address resend A message was posted to a mailing list token-fulfill A delayed command was completed by the mj_trigger program trigger The mj_trigger program wwwadm The web interface for list and domain administrators wwwconfirm The web interface for command confirmation wwwusr The web interface for subscribers When a command is executed by the accept command, the prefix "token-" is added to the interface name. For example, a command executed by the accept command in an e-mail message would be considered to be executed from the "token-email" interface. See Also: help accept help admin_monitor help configset_access_rules (to limit access to this command) help configset_inform help configset_log_lifetime help configset_token_lifetime help configset_triggers help sessioninfo help showtokens help times (for how to specify the report period) help tokeninfo This is the "report" help document for Majordomo 2, version 0.1201103110. For a list of all help documents, send the following command: help topics in the body of a message to majordomo@openbsd.org.
For assistance, please contact the openbsd.org administrators.
Sign In | Sign Out | Mailing Lists | Unsubscribe or Change Settings | Help |