Sign In Sign Out Mailing Lists Unsubscribe or Change Settings Help

Majordomo2 list server

= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
archive-delete[-hidden][-force]    listname date_count_number
archive-get[-immediate][-hidden]   listname date_count_number
archive-get-digest[-mime][-hidden] listname date_count_number 
archive-index[-hidden]             listname date_count_number
archive-part-delete                listname message_number part_number
archive-part-edit                  listname message_number part_number
archive-part-get[-clean]           listname message_number part_number
archive-stats[-hidden]             listname date_count_number
archive-summary                    listname
archive-sync                       listname pattern
archive-part-replace listname message_number part_number <<ENDTAG
[New Contents]
ENDTAG
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
date_count_number, if specified, indicates one or more messages
listname,          required,     is the name of a mailing list
message_number,    if specified, indicates a single message
part_number,       if specified, refers to a portion of a message
pattern,           if specified, indicates the names of files
-clean,   if specified, removes dangerous portions of an HTML part
-delete,  if specified, causes messages to be removed from the archive
-digest,  if specified, causes messages to be mailed in digests
-edit,    if specified, allows part of a posted message to be changed
-force,   if specified, removes messages which await digest delivery
-get,     if specified, causes whole messages to be displayed
-hidden,  if specified, displays only hidden messages (admins only)
-immediate, if specified, displays messages without pretty formatting
-index,   if specified, displays a summary of each message
-mime,    if specified, causes digests to be mailed in "mime" format
-part,    if specified, causes part of a posted message to be displayed
-replace, if specified, replaces part of a message with new contents
-stats,   if specified, displays per-user statistics
-summary, if specified, lists archive files and their contents
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
The following command modes will sort the results of the 
  archive-get or archive-index command:
-author,  if specified, causes messages to be sorted by author
-date,    if specified, causes messages to be sorted by date
-reverse, if specified, reverses the order of the messages
-subject, if specified, causes messages to be sorted by subject
-thread,  if specified, causes messages to be sorted by thread
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =

The archive command is used to retrieve posted messages that have been
sent to a mailing list.  

In the examples that follow, where you see LISTNAME, instead use the 
name of an actual mailing list.


Dates, message numbers, and counts
----------------------------------
There are several ways to indicate which messages you want to 
retrieve from an archive.  The four basic ways are:
 
  1. A date or time frame.  For example, the number "200109"
  would represent all messages posted during the 9th month (September)
  of the year 2001.  See "help times" for more details.

  2. A message number.  For example, the number "200107/14" would
  represent the 14th message in the 200107 (July, 2001) archive.

  3. A message count.  For example, the number "25" would
  represent the last 25 messages that were delivered to the 
  subscribers of a mailing list and stored in the archive.

  4. A time span.  For example, the term "38d" would refer to all
  messages posted to a mailing list during the last 38 days.
  See "help times" for more details.

The first three can be combined into ranges of messages by separating
them with a hyphen surrounded by spaces.  For example, the range
  200107 - 200109
would retrieve all messages posted during the months of July, August,
or September, 2001.

Detailed examples appear later in this document.  First, the
archive-index and archive-get commands will be introduced.


archive-index
-------------
The archive-index command will display a summary of individual messages
within an archive.  The details in the summary usually include the
message number and date, the e-mail address of the author, the subject
of the message, and the size of the message in kilobytes.  The message
number of a message can be used to retrieve messages individually.

The archive message number indicates the position of the message within a
particular archive file.  For example, "200101/12" means the 12th message
in the January, 2001 archive.  


archive-get
-----------
The archive-get command is used to retrieve the actual contents of
posted messages.  When the archive-get command is used, each message
that is retrieved will be mailed to you, just as if you had received it
when it was first delivered to the mailing list.  List administrators
can use this in combination with the "default user" command to resend
messages to individual subscribers who wish to receive a new copy.  See
"help default" for an introduction to the "default user" command.

When the archive-get-immediate command is used, all of the messages that
are retrieved will be sent within one message, exactly as they are
stored in the archive, with all message headers intact.

The archive-get-digest or archive-get-digest-mime command will cause
messages to be bundled into digests, typically with no more than 1000
lines in each digest.  Usually, a plain text digest is sent, but the
"mime" command mode will cause the messages to be bundled into MIME
digests, in which each message is an attachment.  Each digest will be
mailed to you in a separate message.


Example:  A simple message count
    archive-index test 20
  would retrieve an index of the last 20 messages posted to the "test" list,
    archive-get test 20
  would retrieve the last twenty messages themselves.

Example:  A date or time frame
    archive-index test 1999
  shows all messages in all of the 1999 archives of the "test" list.
    archive-get test 199903
  retrieves all messages in the March 1999 archive of the "test" list.
    archive-index test 19990305
  shows only messages posted on the "test" list the day of 5 March 1999.
  (Refer to "help times" for details of the date field syntax.)

Example:  A message number
    archive-get test 199903/4
  retrieves the 4th message in the March 1999 archive of the "test" list.

Example:  A time span
    archive-index test 36h
  would display a summary of every message posted to the "test" list
  during the last 36 hours.

Example:  Retrieving messages from an auxiliary list archive
    archive-get test bugs.199903
  retrieves all messages in the March 1999 archive of the auxiliary list
  "bugs" of the "test" mailing list.  See "help auxiliary_list" for more
  details on auxiliary lists.

Example:  A range of dates
    archive-get almond 20000205 - 20000207
  would retrieve all messages distributed on the "almond" list
  during the 5th, 6th, and 7th of February, 2000.

Example:  A range with two count fields
    archive-index lime 15 - 3
  would retrieve an index of the 15 messages immediately preceding
  the 3rd most recent message sent to the "lime" list. This unusual
  result happens because the last field of the range (3) indicates the
  range ends with the 3rd most recent post. The start of the range,
  as with a single message count, counts backwards from the end.

Example:  A list of message numbers
    archive-index currant 200101/5 200101/12 200103/8
  would display a summary of three messages posted to the "currant"
  list:  the 5th and 12th messages from January 2001, and the 8th
  message from March 2001.

Example:  A range with a message number and a count
    archive-get lemon 200001/3 - 15
  will retrieve the third message in the January 2000 archive of the
  "lemon" list, and 14 messages following it, even if those messages are
  found in other archives, such as February 2000 or later. 

Example:  A range with a count and a message number
    archive-get peach 12 - 200001/3
  will retrieve the third message in the January 2000 archive of the
  "peach" list, and 11 messages preceding it, even if those messages are
  found in other archives, such as December 1999 or earlier. 

Example:  A range with a count and a time frame
    archive-index tangerine 10 - 1998
  would retrieve an index of the last ten messages posted to the
  "tangerine" list on or before December 31, 1998.

Example:  A range with a time frame and a count
    archive-index tangerine 199803 - 10
  would retrieve an index of the first 10 messages posted to the
  "tangerine" list on or after March 1, 1998.

Example:  A range with a message number and a time frame
    archive-get-digest olive 1997034/6 - 199705
  would mail one or more digests of messages from the archive of the
  "olive" mailing list. The range of messages would begin with the 6th
  message in the archive of the 4th week of March 1997, and end with
  the last message posted to list in May 1997.


Sorting the results
-------------------
Both the archive-get and the archive-index command take additional
command modes that will sort the results.  

The "author" command mode will cause the messages to be sorted by the
address of the author.  The sorting is done by domain first, similar to
the results of the who command.  

The "date" command mode will cause the messages to be sorted by the
date.  The dates that are given to messages in the archive can be
based upon the time of arrival or the time of delivery; see 
"help configset_archive_date" for more information.

The "subject" command mode will sort the messages alphabetically by
subject, ignoring any leading "Re: " reply markers.

The "thread" command mode will sort the messages by thread.  When one
posted message is a reply to another, those two messages will be grouped
together.  Aside from this grouping, the messages will be presented
chronologically.  Older archive databases may lack the "msgid" field
that allows threading to work consistently; these databases can be
updated by the list administrators with the archive-sync command.

The "reverse" command mode will cause the order of the results to be
reversed.  For example, the command:

  archive-get-immediate-reverse LISTNAME 200104

will display the messages from April, 2001, with the most recent
messages appearing first.


Searching the archives
----------------------
A "here document" can be used to specify search patterns A
pattern beginning with "~s" will search the subjects of messages.  A
pattern beginning with "~a" will search the addresses of the people who
posted the messages.  For example, the following command would match
messages that were posted in the year 2001 and have the word "Unknown"
in the subject header:

archive-index LISTNAME 2001 <<ABCD
  ~s/Unknown/
ABCD

Only messages that match all of the patterns will be retrieved.  See
"help here_document" and "help patterns" for more details on here
documents and search patterns.


archive-summary
---------------
The archive-summary command lists all of the archive files that are
available for a mailing list.  The number of messages, lines, and bytes
in each archive file are also shown.  This command does not take a
filespec or other argument.  Just use the following command:

  archive-summary LISTNAME

This command will only show archives of messages that were posted to the
list.  To see archived of messages that were posted to a sublist, use
the following command:

  archive-summary LISTNAME:SUBLIST

See "help auxiliary_list" for more information about sublists.


archive-stats
-------------
The archive-stats command is used to get a sorted report of the number
of messages posted by each address to a mailing list for the messages
specified by "filespec". For instance, to find out who posted most often
on a mailing list during September 2000, use this command:

  archive-stats LISTNAME 200009

The cumulative size of the messages posted by each author is also shown
in the report.


archive-delete (for administrators only)
----------------------------------------
The archive-delete option takes the usual arguments: dates, message
counts, message numbers, and combinations thereof.   It is possible to
delete all of the archives for a mailing list with one command, and a
message can be prevented from appearing in a digest by deleting it.  Use
the archive-index command before running the archive-delete command if
you wish to verify which messages will be deleted.  If you wish to
delete a recent message from the archives, but want to make sure that
all digests containing the message have been sent, use the
"digest-status" command to examine the state of the digests.  See 
"help digest" for more details.

Example:
  digest-status LISTNAME ALL

If you attempt to delete a message that has not yet been delivered in a
digest, that message will not be removed unless you use the "force"
command mode.

Example:
  archive-delete-force LISTNAME 200107/14

After one or more messages have been deleted, the numbers of the
remaining messages are not changed. For example, if message number
200008/2 were deleted,  200008/1 and 200008/3 would be the first two
messages in the August 2000 archive.  Deleting a message causes the
index and count files to be updated automatically, so "archive-sync" is
not needed after "archive-delete".

Messages that are posted by people with the "hidepost" setting will
be marked as hidden, and an "X-no-archive: yes" header will be added to
those messages.  In addition, messages that match the patterns in
the noarchive_body and noarchive_headers configuration settings will
receive the same treatment.  If the "hidden" command mode is used, only
messages that are marked as hidden will be deleted.  The hidden command
mode also applies to the archive-get and archive-index commands.  An
administrative password is required to use it.

The message archives are used by the delivery system to construct
message digests.  If an attempt is made to delete a message that
is awaiting delivery as part of a digest, it will not be removed unless
the "force" command mode is also used.


archive-sync (for administrators only)
--------------------------------------
The archive-sync command synchronizes the messages in one or more
archive files with the archive databases.  It allows list administrators
to update the databases after new archives have been imported into a
mailing list's file space.

The archive-sync command is necessary after you alter the archives using
some means outside of Majordomo (for example, editing an archive file
using an operating system command.)  It is also necessary after you
upload an archive file using the put command.  

The archive-sync command expects messages in an archive file to be in
"mbox" format.  Each message must begin with a line containing the
word "From" followed by the e-mail address of the message's author
and the date of the message, for example:

From z@example.com  Sun Jan  9 21:56:07 2000


The archive-sync command takes one argument, which must be the
date of a particular archive file or a Majordomo pattern matching
one or more archive files (see "help patterns").  For example,

  archive-sync LISTNAME 200005

would synchronize the May 2000 archive databases with the
messages themselves.  

Alternately, if you have a bunch of files to process at once, you can
specify a pattern and all files matching that pattern will be
synchronized.  For example,

  archive-sync LISTNAME /^19991/

would synchronize the October, November, and December, 1999 archives.
The archive names against which the pattern is matched can be seen using
the archive-summary command.

In your mailing list's file space, all archive file names must begin
with the list name, followed by a period and the date of the archive,
for example:

  LISTNAME.200204

However, when you list archive files to synchronize, only the date
should be included, for example:

  archive-sync LISTNAME 200204


When using archive-sync, any message without an X-Archive-Number header
will be given a new number, one greater than the highest number in the
archive, and a new header.  Any archive number that does not correspond
to the archive in question will be replaced by one that does (in this
way, it is possible to combine archives).

When messages are stored in the archive, the date that is stored in
the database will depend upon the archive_date configuration setting
(see "help configset_archive_date" for more details.)  When the 
archive-sync command is run, the date will be recalculated from the
Received headers of each message, causing the dates to change.


archive-part
------------
The archive-part command mode has four variations which can be used
to view, edit, delete, or change part of a single message within the
archive.  Each message has at least one part, and each part within a
message is numbered.  Part number 0 is used to refer to the whole
message.  To see an example of message numbering, read the "Special
features for posted messages" section of the "help tokeninfo" document.

The archive-part-get command will display the contents of a part of
a message.

The archive-part-edit command will display part of a message in a
way that makes it easy to change the part's contents.

The archive-part-replace command will replace part of a message with
new contents.  The archive databases will be synchronized automatically.

The archive-part-delete command will remove part of a message.  The
archive databases will be synchronized automatically.

The archive-part-get-clean or archive-part-edit-clean will remove
potentially dangerous portions of a text/html body part, such as
images, fill-out forms, and scripts, before the part is displayed.


Notes for list administrators
-----------------------------
List archives may be organized by year, month, week, or day, at the
discretion of the list owners.   The organization is controlled by the
archive_split configuration setting.  Additionally, the size of an
individual archive file can be limited using the archive_size
configuration setting.  These settings only affect the disposition of
future messages, and have no effect upon existing archives.

By default, messages are stored in the file space of a mailing list, in
the "/public/archive" directory.  The following command:
  index LISTNAME archive
will usually display a list of the files in the archive.  The location
of the archive can be changed by altering the archive_dir configuration
setting.  Changing this setting will not cause any existing archives
to be relocated automatically.  If the new directory is outside the file
space of a mailing list, the "get" and "index" commands will no longer be
useful for retrieving the files.

Archive file names begin with the name of the mailing list, followed by
a period and a date.  For example, a message posted to the "prunus"
mailing list in July 2001 might be stored in the "prunus.200107" file.
The archive_split configuration setting determines the style of date
(for example, "weekly" or "quarterly") that is used for any new
messages.  Although any new archive files will use four digits to
specify the year, archives with two-digit years are supported for
backward compatibility.

The archive_size configuration setting can be used to limit the total
size of an archive file.  If the size is limited, a hyphen and two digit
number are added to the name of each archive file.  For example, the
messages posted to the "prunus" mailing list in June 2002 might be
stored in the "prunus.200206-00" and "prunus.200206-01" archive files.

Messages posted to auxiliary lists are also archived, but the file name
of the archive is adjusted to include the auxiliary list name.  For
example, a message posted to the "plum" auxiliary list of the "prunus"
mailing list during July 2001 would be stored in the
"prunus.plum.200107" file.

By default, the list archives are available to subscribers who
authenticate themselves using a personal password.  Access to the the
archive command is controlled by the access_rules and archive_access
configuration settings.

Administrators should note that the archive number of a message is not
the same as the sequence number of the message.  For example, a sequence
number of 85 refers to the 85th message ever posted to the mailing list
(see "help configset_sequence_number" for a more thorough explanation.)

Mail headers can be used by people who post messages to a mailing list
to indicate that they do not wish the message to be displayed in a
public archive.  Majordomo honors the following two headers by default:

  X-no-archive: yes
  Restrict: no-external-archive

Additional headers can be supported by changing the noarchive_headers
configuration setting; see "help configset_noarchive_headers" for
more details.

If a public archive of the list is available, for example a WWW archive
created by software other than Majordomo, the archive_url configuration
setting can be adjusted by the list owners to indicate the location of
the archive.


See Also:
   help admin_delivery
   help auxiliary_list
   help configset_archive_access (to restrict access to this command)
   help configset_archive_date
   help configset_archive_dir (to store archives in a different directory)
   help configset_archive_size
   help configset_archive_split
   help configset_archive_url
   help configset_noarchive_headers
   help configset_sequence_number
   help default
   help get   (which may be used in some cases to retrieve archives)
   help here_document
   help index (which may be used to show which archives are available)
   help patterns
   help put   (which is used to create the archive directory)
   help times (for an introduction to time spans and time frames)

This is the "archive" help document for 
Majordomo 2, version 0.1200410180.

For a list of all help documents, send the following command:
   help topics
in the body of a message to majordomo@lists.mj2.org.

For assistance, please contact the lists.mj2.org administrators.
Sign In Sign Out Mailing Lists Unsubscribe or Change Settings Help