home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk1.iso / answers / mail / majordomo-faq < prev    next >
Internet Message Format  |  1994-09-29  |  31KB

  1. Path: bloom-beacon.mit.edu!hookup!yeshua.marcam.com!zip.eecs.umich.edu!newsxfer.itd.umich.edu!gatech!howland.reston.ans.net!news.cac.psu.edu!news.pop.psu.edu!news.pop.psu.edu!not-for-mail
  2. From: barr@pop.psu.edu (David Barr)
  3. Newsgroups: comp.mail.misc,comp.mail.sendmail,comp.mail.smail,comp.answers,news.answers
  4. Subject: Majordomo Frequently Asked Questions
  5. Supersedes: <majordomo-faq_778255381@pop.psu.edu>
  6. Followup-To: comp.mail.misc
  7. Date: 29 Sep 1994 10:03:10 -0400
  8. Organization: Penn State Population Research Institute
  9. Lines: 747
  10. Approved: news-answers-request@MIT.Edu
  11. Expires: 2 Nov 1994 14:03:01 GMT
  12. Message-ID: <majordomo-faq_780847381@pop.psu.edu>
  13. NNTP-Posting-Host: bosnia.pop.psu.edu
  14. Summary: This is a list of frequently asked questions about Majordomo,
  15.     a Perl-based package for managing mailing lists
  16. Xref: bloom-beacon.mit.edu comp.mail.misc:9630 comp.mail.sendmail:9533 comp.mail.smail:635 comp.answers:7490 news.answers:26463
  17.  
  18.  
  19. Version: $Id: majordomo-faq.html,v 1.18 1994/09/25 21:18:18 barr Exp barr $
  20. Archive-Name: mail/majordomo-faq
  21. Posting-Frequency: monthly
  22.  
  23.    Table of Contents:
  24.     1. What is Majordomo and how can I get it?
  25.           + What is Majordomo?
  26.           + Where do I get it?
  27.           + How do I install it?
  28.           + How do I upgrade from an earlier release?
  29.           + Where do I report bugs in Majordomo?
  30.           + Which is better, Majordomo or LISTSERV?
  31.     2. Problems setting up Majordomo
  32.           + I get an error "insecure usage" from the wrapper
  33.           + I get "majordomo: No such file or directory" from the wrapper
  34.           + I get an error "Can't locate majordomo.pl"
  35.           + I get "Permission denied at ..." when majordomo runs
  36.           + I told majordomo where to archive the list, why isn't it
  37.             working?
  38.           + Majordomo seems to be taking many minutes to process commands
  39.           + I'm accumulating lots of files called /tmp/resend.*.in and
  40.             .out,
  41.     3. Setting up mailing lists and aliases
  42.           + Handling bounced mail
  43.           + Semi-automated handling of bounced mail
  44.           + What's this Owner-List and List-Owner stuff? Why both?
  45.           + How should I configure resend for Reply-To headers?
  46.           + How can I hide lists so they can't be viewed by 'lists'?
  47.           + Can I have the list owner or approval person be changeable
  48.             without intervention from the Majordomo owner?
  49.           + What about all of these passwords starting in version 1.90?
  50.           + How do I tell majordomo to handle "get"-ing of binary files?
  51.           + A list is visible via lists, but can't subscribe or 'get'
  52.             files
  53.     4. Miscellaneous mailer and other problems
  54.           + Address with blanks are being treated separately
  55.           + Why aren't my digests going out?
  56.             
  57.    This FAQ is Copyright 1994 by David Barr and The Pennsylvania State
  58.    University. This document may be reproduced, so long as it is kept in
  59.    its entirety and in its original format.
  60.    
  61.    Credits:
  62.    originally written by Vincent D. Skahan. Many thanks to the members of
  63.    the majordomo-workers and majordomo-users mailing lists for many of
  64.    the questions and answers found in this FAQ. Thanks to fen@comedia.com
  65.    (Fen Labalme) for getting an HTML version started.
  66.    
  67.    You can get this FAQ by sending an e-mail message to
  68.    majordomo@pop.psu.edu with "get file majordomo-faq" in the body of
  69.    the message. You can get an HTML version on the World Wide Web at
  70.    http://www.pop.psu.edu/~barr/majordomo-faq.html. If you have any
  71.    questions or submissions regarding this FAQ, send them to
  72.    barr@pop.psu.edu (David Barr).
  73.    
  74.    
  75.      _________________________________________________________________
  76.    
  77.    
  78.    
  79. Section 1: What is Majordomo and how can I get it?
  80.  
  81.    
  82.    
  83.   WHAT IS MAJORDOMO?
  84.   
  85.    Majordomo is a program which automates the management of Internet
  86.    mailing lists. Commands are sent to Majordomo via electronic mail to
  87.    handle all aspects of list maintainance. Once a list is set up,
  88.    virtually all operations can be performed remotely, requiring no
  89.    intervention upon the postmaster of the list site.
  90.    
  91.      majordomo - n: a person who speaks, makes arrangements, or takes
  92.      charge for another. From latin "major domus" - "master of the
  93.      house". 
  94.      
  95.    Majordomo is written in Perl (at least 4.035, preferably 4.036).
  96.    
  97.    Majordomo controls a list of addresses for some mail transport system
  98.    (like sendmail or smail) to handle. Majordomo itself performs no mail
  99.    delivery (though it has scripts to format and archive messages).
  100.    
  101.    Here's a short list of some of the features of Majordomo.
  102.    
  103.      * supports various types of lists, including moderated ones.
  104.      * List options can be set easily through a configuration file,
  105.        editable remotely.
  106.      * Supports archival and remote retrieval of messages.
  107.      * Supports digests.
  108.      * Written in Perl, - easily customizable and expandable.
  109.      * Modular in design.
  110.      * Includes support for FTPMAIL.
  111.        
  112.    
  113.    
  114.    
  115.    
  116.   WHERE DO I GET IT?
  117.   
  118.    
  119.    
  120.    Via anonymous FTP at:
  121.    
  122.    ftp://ftp.greatcircle.com/pub/majordomo/
  123.    
  124.    If you don't have Perl, you can get it from:
  125.    
  126.    ftp://prep.ai.mit.edu/pub/gnu/perl-4.036.tar.gz
  127.    
  128.    The FTPMAIL package can be found in
  129.    ftp://src.doc.ic.ac.uk/packages/ftpmail or any comp.sources.misc
  130.    archive (volume 37).
  131.    
  132.    
  133.    
  134.   HOW DO I INSTALL IT?
  135.   
  136.    Majordomo comes with a rather extensive README. Read this file
  137.    completely. This FAQ is meant to be a supplement to Majordomo's
  138.    documentation, not a replacement for it. If you have any questions
  139.    that this FAQ doesn't cover, chances are that it is covered in the
  140.    README or other documentation in the Majordomo distribution.
  141.    
  142.    
  143.    
  144.   HOW DO I UPGRADE FROM AN EARLIER RELEASE?
  145.   
  146.    Be sure to browse the "Changes" and "Changelog" files to get an idea
  147.    what has changed. There currently is no canned set of instructions for
  148.    upgrading from an earlier release. The most straightforward method is
  149.    to simply install the current release in a different directory, (with
  150.    the same list/archive/digest directories) and change the mail aliases
  151.    for each list to use the new Majordomo scripts as soon as you feel
  152.    comfortable with the new setup.
  153.    
  154.    
  155.    
  156.   WHERE DO I REPORT BUGS IN MAJORDOMO?
  157.   
  158.    Send them to majordomo-workers@greatcircle.com. Be sure to include
  159.    which version of Majordomo you are using. You should also include what
  160.    operating system you are using, what version of Perl, and what mailer
  161.    (sendmail, smail, etc) and version you are using, especially if you
  162.    can't get Majordomo to work at all. But first, you must have
  163.    thoroughly read the documentation to Majordomo and this FAQ.
  164.    
  165.    
  166.    
  167.   WHICH IS BETTER, MAJORDOMO OR LISTSERV?
  168.   
  169.    Here's a slight revision of something Chris Koenigsberg posted to
  170.    comp.mail.misc, following up a thread there. Tasos, the author of
  171.    ListProc, said that he was basically on the mark concerning ListProc.
  172.    [ This section is currently under revision --Dave ]
  173.    
  174.    Chris Koenigsberg: ckk@uchicago.edu, ckoenig@midway.uchicago.edu
  175.    U. of Chicago Academic Information Technologies
  176.    
  177.      The real LISTSERV (Revised LISTSERV) relies on Bitnet networking
  178.      transport protocols.
  179.      
  180.      A complex Unix list processor was written, in a partial emulation of
  181.      the Bitnet LISTSERV. The "LISTSERV for Unix" system was renamed
  182.      "ListProc" last summer, after threats from the original LISTSERV
  183.      author, because it differs in user interface and list owner
  184.      interface from LISTSERV, and was accused of misleading users who
  185.      would confuse it with the "real thing".
  186.      
  187.      Majordomo was written, in Perl, because ListProc (AKA Unix LISTSERV)
  188.      was too complex and did not do quite what was needed to manage a set
  189.      of Usenix SAGE mailing lists.
  190.      
  191.      LISTSERV and ListProc want the whole world to be interconnected,
  192.      i.e. all mailing list server hosts can know about each other and
  193.      exchange info on remote lists; someday I imagine there'll be a
  194.      DNS-like namespace of mailing lists and server hosts out there
  195.      somehow.
  196.      
  197.      Majordomo, on the other hand, is a much smaller package, designed
  198.      for easier administration on an individual host, and I have even
  199.      heard (on the Majordomo-Users list) that some Majordomo hosts do NOT
  200.      wish their lists advertised publicly on the net.
  201.      
  202.      We (U. of Chicago Academic Information Technologies) are planning to
  203.      go ahead and offer new campus list management service soon using
  204.      Majordomo, but we did have some requests from faculty to use
  205.      ListProc (they asked for LISTSERV but since this is on Unix, they
  206.      would have to get ListProc instead).
  207.      
  208.      I tried briefly to configure and build ListProc for a comparison
  209.      test, but gave up when it got weird, probably too soon, maybe I'll
  210.      try again when I have more time to play with compilers etc :-)
  211.      Listproc documentation etc. is a bit cryptic and not well thought
  212.      out overall, at least from the point of view of someone new to the
  213.      concept trying to understand all of its complex workings. I have
  214.      seen correspondence from the Listproc author, on the ListProc users'
  215.      mailing list archives, where he defends his documentation because it
  216.      is in the usual Unix style. (maybe "damning by faint praise"? :-)
  217.      
  218.      Majordomo is simpler and written in Perl scripts, so documentation
  219.      is more comprehensive, and is improving, as an active community of
  220.      developers is contributing to it. It only took 2 days for the
  221.      current maintainers to put out small patches to fix some
  222.      recently-discovered potential security holes, and since it's Perl,
  223.      no recompilation is needed.
  224.      
  225.      Listproc requires a server daemon to be alive, which forks off child
  226.      processes somewhat like lpd, and appears to be designed to do a lot
  227.      of complex, tricky things which requires a lot of C source code
  228.      doing networking stuff (multi-level automated archiving and
  229.      indexing, with retrieval via ftpmail, automatic digestification
  230.      creation and propagation, remote cooperation of "peer" list hosts,
  231.      interactive administration via TCP connections, operation over other
  232.      transport and delivery protocols besides TCP and SMTP, maintain its
  233.      own message queueing system independently of the system mail queues,
  234.      ...), which are perhaps overkill (for us, in a completely Internet
  235.      TCP/SMTP environment), perhaps not, this is what I'd like to hear
  236.      more discussion about.
  237.      
  238.      Majordomo is more focused on the essentials of individual mailing
  239.      list management, and is implemented as Perl scripts, which are
  240.      modular and can be used in subsets, as they are individually invoked
  241.      out of system mail aliases. It lets the underlying system software
  242.      do the networking and message queueing stuff, so it doesn't have to
  243.      deal with TCP sockets etc. Majordomo's recently-added archiving,
  244.      digestification, etc. is simpler than ListProc's, and is undergoing
  245.      more improvements.
  246.      
  247.      Apparently, Listproc's daemon with its own queueing system used to
  248.      give better performance, for high-traffic lists on heavily loaded
  249.      server hosts, than older versions of sendmail. But now, newer
  250.      sendmail versions have greatly improved efficiency so Majordomo with
  251.      new sendmail may be just as fast and load-capable as a Listproc
  252.      system. (comments welcomed on this point?)
  253.      
  254.      With Listproc, if you can get it configured and running smoothly,
  255.      you can apparently join a growing inter-operating network of
  256.      cooperating "peer" list hosts, and even inter-operate with Bitnet
  257.      LISTSERV list hosts too. Thus your local users can easily find out
  258.      about other lists elsewhere, you can have local re-distributions for
  259.      a larger global list, etc. (but re-distributions can be a source of
  260.      administrative headache when global list owners try to track down
  261.      mysterious errors, or unsubscribe requests from people who aren't
  262.      subscribed to the global list.... :-).
  263.      
  264.      One big flaw in Listproc's design, in my opinion (correct me if I'm
  265.      wrong!), is that it does funny things to the headers of outgoing
  266.      messages which are arguably "wrong" in the RFC 822 SMTP world (I've
  267.      seen arguments in the ListProc users' archives), and for incoming
  268.      messages, it only uses the Unix From field (i.e. the SMTP Envelope
  269.      MAIL FROM, in the SMTP world) to determine the sender's identity,
  270.      for subscribing, unsubscribing, accepting or rejecting messages,
  271.      etc.
  272.      
  273.      Majordomo on the other hand will use the RFC 822 headers (Gene
  274.      Spafford's Perl code for parsing mail headers), so it will recognize
  275.      a "Reply-To:" for example, and will allow you to subscribe your
  276.      canonical address, even if the return path of your message is
  277.      convoluted (although the list owner may need to approve your
  278.      subscription). You have various per-list configuration options,
  279.      about what appears in the various RFC 822/SMTP headers, concerning
  280.      the return address for errors, the default reply address (to the
  281.      list, to the original author, to the list owner/moderator, etc.)...
  282.      
  283.      Both Listproc and Majordomo share concepts like moderated lists.
  284.      Listproc's moderated lists have a queue of incoming messages, and
  285.      the moderator has to approve or reject them by giving the message
  286.      queue numbers to the server, in order to clear the queue.
  287.      
  288.      For a moderated list, Majordomo simply bounces messages to the
  289.      moderator and then forgets about them, so the moderator can easily
  290.      re-submit them with an approval password in a new header. Any
  291.      message arriving with the proper approval password header will be
  292.      automatically approved and propagated to the list.
  293.      
  294.      An outfit called CREN, an offshoot of Educom, has taken over the
  295.      development of both the Bitnet LISTSERV, and the Unix Listproc, and
  296.      is planning to offer a commercial version of Listproc sometime later
  297.      in 1994. They have a global vision building on the inter-operating
  298.      "peer" list host concept, integrating gopher, ftp, etc. (their
  299.      vision statement doesn't mention WWW but I assume that must be added
  300.      soon :-).
  301.      
  302.      We are very interested to see if CREN's new Listproc version will
  303.      come with improved support, including better documentation, and we
  304.      might consider switching to it sometime in the future, but we are
  305.      planning to stick with Majordomo for now.
  306.      
  307.    
  308.      _________________________________________________________________
  309.    
  310.    
  311.    
  312.    
  313.    
  314. Section 2: Problems setting up Majordomo
  315.  
  316.    
  317.    
  318.   I GET AN ERROR "INSECURE USAGE" FROM THE WRAPPER
  319.   
  320.    The argument to ".../wrapper" should be simply "majordomo", not The
  321.    full path to majordomo or resend. "wrapper" has where to look compiled
  322.    in to it (the "W_BIN" setting in the Makefile) for security reasons,
  323.    and will not let you specify another directory.
  324.    
  325.    Your alias should say:
  326.    
  327.  
  328.         |"/path/to/majordomo/wrapper majordomo"
  329.  
  330.    
  331.    
  332.    
  333.    
  334.   I GET "MAJORDOMO: NO SUCH FILE OR DIRECTORY" FROM THE WRAPPER
  335.   
  336.    Make sure that the #! statement at the beginning of all the Majordomo
  337.    Perl executables contain the correct path to the perl program. (the
  338.    default is /usr/local/bin/perl) Make sure also that majordomo and all
  339.    the related scripts are in the W_BIN directory as defined in the
  340.    Makefile when you compiled the wrapper.
  341.    
  342.    
  343.    
  344.   I GET AN ERROR "CAN'T LOCATE MAJORDOMO.PL"
  345.   
  346.    
  347.  
  348. > Whenever I send either mail to a list or a command to majordomo, receive
  349. > the following:
  350. >
  351. > Can't locate majordomo.pl in @INC at /usr/majordom/mjdm/resend line 61.
  352. > 554 "|/usr/majordom/mjdm/resend -p bulk  -l test -f brian -h  -s
  353. > test-outgoing".
  354. > .. unknown mailer error 2
  355.  
  356.    [from Brent Chapman]
  357.    Majordomo adds "$homedir" from the majordomo.cf file to the @INC array
  358.    before it goes looking for "majordomo.pl". Since it's not finding it,
  359.    I'd guess you have one of two problems:
  360.    
  361.    1) $homedir is set improperly (or not set at all; there is no default)
  362.    in your majordomo.cf file.
  363.    
  364.    2) majordomo.pl is not in $homedir, or is not readable.
  365.    
  366.    [from John P. Rouillard]
  367.    3) Note that the new majordomo.cf file checks to see if the
  368.    environment variable $HOME is set first, and uses that for $homedir.
  369.    Since the wrapper always sets HOME to the correct directory, you get a
  370.    nice default, unless you are running a previously built wrapper, in
  371.    which case you may get the wrong directory.
  372.    
  373.    [from Andreas Fenner]
  374.    4) I had the same problem when I installed majordomo (1.62). My
  375.    Problem was a missing ";" in the majordomo.cf file - just in the line
  376.    before setting homedir .... My hint for you: Check your perl-files
  377.    carefully.
  378.    
  379.    
  380.    
  381.   I GET "PERMISSION DENIED AT ..." WHEN MAJORDOMO RUNS
  382.   
  383.    
  384.  
  385. > > shlock: open(">/usr/local/lib/majordomo/shlock.15260"):
  386. > Permission denied at /usr/local/lib/majordomo/shlock.pl line 131,
  387. >  line 7.
  388.  
  389.    The directory "/usr/local/lib/majordomo" needs to be writable by the
  390.    uid/gid that the "wrapper" program run as, so that Majordomo can
  391.    create its lock file.
  392.    
  393.    In general, for any file Majordomo writes, both the file _AND_ the
  394.    directory the file is in must be writable by Majordomo, so that it can
  395.    create lock files and new versions of the data file (Majordomo usually
  396.    "updates" a file by creating "file.new" and then, when that has
  397.    succeeded, deleting "file" and renaming "file.new" to "file").
  398.    
  399.  
  400. > Also, should everything in my majordomo directory by owned by
  401. > majordom and the group set to majordom?
  402.  
  403.    Basically, yes, and it should all (including the directory itself) be
  404.    writable by whatever uid/gid wrapper is set to run as.
  405.    
  406.    
  407.    
  408.   I TOLD MAJORDOMO WHERE TO ARCHIVE THE LIST, WHY ISN'T IT WORKING?
  409.   
  410.    
  411.  
  412. > I don't get it: is the list archive a file or a directory?
  413. > I chose directory and it doesn't work, though I'm not sure why.
  414. > The relevant majordomo.cf entry looks like:
  415. > $filedir = "/usr/local/mail/majordomo/archive";
  416. > $filedir_suffix = "";
  417.  
  418.    [From John Rouillard]
  419.    The archive variables in majordomo.cf aren't used to archive anything.
  420.    You have to use a separate archive program, or a sendmail alias to do
  421.    the archiving. The info is used to generate a directory where the
  422.    archive files are being placed by some other mechanism.
  423.    
  424.    You are telling majordomo to look in the directory:
  425.  
  426.         /usr/local/mail/majordomo/archive/
  427.  
  428.    for files that it should allow to be gotten using the get command.
  429.    
  430.    Majordomo comes with three different archive programs that run under
  431.    wrapper, that do various types of archiving. Look in the contrib
  432.    directory.
  433.    
  434.    
  435.    
  436.   MAJORDOMO SEEMS TO BE TAKING MANY MINUTES TO PROCESS COMMANDS
  437.   
  438.    
  439.  
  440. > Commands are being processed at the rate of about one every 10 minutes.
  441. > What's going wrong, why is Majordomo so slow?
  442.  
  443.    Majordomo tries to lock the log file (by creating a lock file in the
  444.    directory with the log file) for 10 minutes for each log message,
  445.    before giving up. It's typically going to log one log message for each
  446.    command in the input. If the directory containing the file is not
  447.    writable by the Majordomo user/group, then majordomo won't be able to
  448.    lock the file and thus will take a very long time to process commands.
  449.    
  450.    
  451.    Check the permissions on the log file and all the directories where
  452.    majordomo files are located. Double-check the permission on the
  453.    wrapper.
  454.    
  455.    If you are on a non-POSIX system, it must be both suid and sgid (mode
  456.    6755) to whatever you defined your majordomo user and group to be. It
  457.    must not be setuid root!
  458.    
  459.    OR
  460.    
  461.    In a POSIX system the wrapper must be setuid root, and double-check
  462.    that W_UID and W_GID are of the majordomo user and group. Don't set
  463.    W_UID to be 0!
  464.    
  465.    
  466.    
  467.   I'M ACCUMULATING LOTS OF FILES CALLED /TMP/RESEND.*.IN AND .OUT WHAT ARE
  468.   THESE AND HOW CAN I GET RID OF THEM?
  469.   
  470.    This is a known bug in Majordomo 1.92. There was a typo on line 347.
  471.    Make this change to resend:
  472.  
  473. 347c347
  474.      unlink();
  475.  
  476.    
  477.      _________________________________________________________________
  478.    
  479.    
  480.    
  481.    
  482.    
  483. Section 3: Setting up mailing lists and aliases
  484.  
  485.    
  486.    
  487.   HANDLING BOUNCED MAIL
  488.   
  489.    
  490.  
  491. > If a subscriber sends a message to a mailing list containing addresses
  492. > that cause bounces, then the subscriber/sender gets a copy of the
  493. > bounced mail.  They don't care to receive the bounce.  Can this be
  494. > prevented? (Without removing the offending addresses from the list --
  495. > I'm aware of the Majordomo 'bounce' utility.)
  496.  
  497.    This was somewhat of a RTFM question. The answer is to use 'resend' to
  498.    your advantage. The following is an example of a sendmail alias that I
  499.    was using:
  500.  
  501.    sample: :include:/usr/local/mail/lists/sample
  502.  
  503.    Whereas this example (from the 'sample.aliases' file distributed with
  504.    Majordomo) fixes the problem.
  505.  
  506.    sample: "|/usr/local/mail/majordomo/wrapper resend -p bulk -M 10000
  507.            -l Sample -f Owner-Sample -h GreatCircle.COM -s
  508.            sample-outgoing"
  509.    sample-outgoing: :include:/usr/local/mail/lists/sample
  510.    owner-sample: joe
  511.  
  512.    See the 'resend.README' file for more info on resend's options.
  513.    
  514.    What this does is force outgoing mail to have the out-of-band envelope
  515.    FROM be "Owner-Sample@GreatCircle.COM", and thus all bounces will be
  516.    redirected to that address. (Users often see this mirrored in the
  517.    message body as the "From " or "Return-Path:" header). 'resend' also
  518.    inserts a "Sender:" line with the same address to help people identify
  519.    where it came from, but that header is not used for the bounce
  520.    address.
  521.    
  522.    If you are using sendmail v8.x, you don't have to use 'resend' to do
  523.    the same thing. You simply have to define an alias like this:
  524.  
  525. owner-sample: joe,
  526.  
  527.    Note the trailing comma is necessary to prevent sendmail from
  528.    resolving the alias first before putting it in the header. Without the
  529.    comma, it will put "joe" in the envelope from instead of
  530.    "owner-sample". Either address will work, of course, but the generic
  531.    address is preferred should the owner ever change.
  532.    
  533.    
  534.    
  535.   SEMI-AUTOMATED HANDLING OF BOUNCED MAIL
  536.   
  537.    
  538.  
  539. >The documentation, I guess, isn't very clear on this, but how does one
  540. >implement the bounce list/bounce-remind program so that people that go
  541. >'boing' can be dealt with in a somewhat more automated manner?
  542. >
  543. >Uh . . . how exactly is this accomplished?
  544.  
  545.    [From John Rouillard]
  546.    There is nothing special about this. Just create a mailing list called
  547.    bounces. I usually set mine up as an auto list just to make life
  548.    easier.
  549.    
  550.    All that bounce does is create an email message to that says:
  551.  
  552.    approve [passwd] unsubscribe [listname] [address]
  553.    approve [passwd] subscribe bounces [address]
  554.  
  555.    The [address] and [listname], are given on the command line to bounce.
  556.    The address of the majordomo, and the passwords are retrieved from the
  557.    .majordomo file in your home directory.
  558.    
  559.    A sample .majordomo file might look like (shamelessly stolen from the
  560.    comments at the top of the bounce script):
  561.  
  562.    this-list       passwd1         Majordomo@This.COM
  563.    other-list      passwd2         Majordomo@Other.GOV
  564.    bounces         passwd3         Majordomo@This.COM
  565.    bounces         passwd4         Majordomo@Other.GOV
  566.  
  567.    A command of "bounce this-list user@fubar.com" will mail the following
  568.    message to Majordomo@This.COM:
  569.  
  570.    approve passwd1 unsubscribe this-list user@fubar.com
  571.    approve passwd3 subscribe bounces user@fubar.com (930401 this-list)
  572.  
  573.    while a command of "bounce other-list user@fubar.com" will mail the
  574.    following message to Majordomo@Other.COM:
  575.  
  576.    approve passwd2 unsubscribe other-list user@fubar.com
  577.    approve passwd4 subscribe bounces user@fubar.com (930401 this-list)
  578.  
  579.    Note that the date and the list the user was bounced from are included
  580.    as a comment in the address used for the "subscribe bounces" command.
  581.    
  582.    
  583.    
  584.   WHAT'S THIS OWNER-LIST AND LIST-OWNER STUFF? WHY BOTH?
  585.   
  586.    [From David Barr]
  587.    The "standard" is spelled out in RFC 1211 - "Problems with the
  588.    Maintenance of Large Mailing Lists".
  589.    
  590.    It's here where the "owner-listname" and "listname-request" concepts
  591.    got their start. (well it was before this, but this is where it was
  592.    first spelled out)
  593.    
  594.    Personally, I don't use "listname-owner" anywhere. You don't really
  595.    have to put both, since the "owner" alias is usually only for bounces,
  596.    which you add automatically anyway with resend's "-f" flag, or having
  597.    Sendmail v8.x's "owner-listname" alias.
  598.    
  599.    (while I'm on the subject) The "-approval" is a Majordomo-ism, and is
  600.    only necessary if you want bounces and approval notices to go to
  601.    different mailboxes. (though you'll have to edit some code in
  602.    majordomo and request-answer if you want to get rid of the -approval
  603.    alias, since it's currently hardwired in)
  604.    
  605.    So, to answer your question, I'd say "no". You don't have to have
  606.    both. You should just have "owner-list".
  607.    
  608.    
  609.    
  610.   HOW SHOULD I CONFIGURE RESEND FOR REPLY-TO HEADERS?
  611.   
  612.    Whether you should have a "Reply-To:" or not depends on the charter
  613.    of your list and the nature of its users. If the list is a discussion
  614.    list and you generally want replies to go back to the list, you can
  615.    include one. Some people don't like being told what to do, and prefer
  616.    to be able to choose whether to send a private reply or a reply to the
  617.    list just by using the right function on their mail agent. Take note
  618.    that if you do use a "Reply-To:", then some mail agents make it much
  619.    harder for a person on the list to send a private reply.
  620.    
  621.    If you are using resend, use the '-r ' flag to set the Reply-To field
  622.    to the list, or use the 'reply_to' config keyword for 1.9x or greater.
  623.    
  624.    
  625.    
  626.    
  627.   HOW CAN I HIDE LISTS SO THEY CAN'T BE VIEWED BY 'LISTS'?
  628.   
  629.    That is what advertise and noadvertise are for. The two keywords take
  630.    regular expressions that are matched against the from address of the
  631.    sender. A list display follows the rules:
  632.    
  633.     1. If the from address is on the list, it is shown.
  634.     2. If the from address matches a regexp in noadvertise (e.g. /.*/)
  635.        the list is not shown.
  636.     3. If the advertise list is empty, the list is shown unless 2
  637.        applies.
  638.     4. If the advertise list is non-empty, the from address must match an
  639.        address in advertise. Otherwise the list is not shown. Rule 2
  640.        applies, so you could allow all hosts in umb.edu except hosts in
  641.        cs.umb.edu.
  642.        
  643.    
  644.    
  645.    
  646.    
  647.   CAN I HAVE THE LIST OWNER OR APPROVAL PERSON BE CHANGEABLE WITHOUT
  648.   INTERVENTION FROM THE MAJORDOMO OWNER?
  649.   
  650.    Sure! Just make owner-listname and/or listname-approval be another
  651.    majordomo list. (probably hidden, for simplicity's sake)
  652.    
  653.    
  654.    
  655.   WHAT ABOUT ALL OF THESE PASSWORDS STARTING IN VERSION 1.90?
  656.   
  657.    Think of three separate passwords:
  658.     1. A master password that can be used by both resend and majordomo
  659.        contained in [listname].passwd. To be used by the master list
  660.        manager when using writeconfig commands etc. This allows someone
  661.        who handles a number of mailing lists all using the same password.
  662.     2. A password for the manager of this one list. The admin_passwd can
  663.        be used by subsidiary majordomo list maintainers.
  664.     3. A password for those concerned with the list content
  665.        (approve_passwd)
  666.        
  667.    This way the administration and moderation functions can be split. The
  668.    original reason for maintaining [listname].passwd was to allow a new
  669.    config file to be put in if the config file was trashed and the
  670.    admin_password was obliterated, and may still be useful to allow a
  671.    single password to be used for admin functions by the majordomo admin
  672.    or some other "superadmin".
  673.  
  674. > [...stupid question - is the admin passwd in the config file a file name
  675. > or the password itself for the list ? ...]
  676.  
  677.    The password itself. This is the only way that the list-maintainer
  678.    could change the password since they wouldn't have access to the file.
  679.    
  680.    
  681.    
  682.    
  683.   HOW DO I TELL MAJORDOMO TO HANDLE "GET"-ING OF BINARY FILES?
  684.   
  685.    Majordomo is not designed to be a general-purpose file-by-mail
  686.    system. If you want to do anything more than trivial "get"-ing of text
  687.    files (archives, etc) than you should get and install ftpmail.
  688.    Majordomo has hooks to allow transparent access to files via ftpmail
  689.    (see majordomo.cf).
  690.    
  691.    
  692.    
  693.   A LIST IS VISIBLE VIA LISTS, BUT CAN'T SUBSCRIBE OR 'GET' FILES
  694.   
  695.    [From Brent Chapman]
  696.    I'll bet your list name has capital letters in it... Majordomo smashes
  697.    all list names to all-lower-case before attempting to use the list
  698.    name as part of a filename. So, while it's OK to advertise (for
  699.    instance) "Majordomo-Users" and have the headers say
  700.    "Majordomo-Users", the files and archive directory all need to be
  701.    "majordomo-users*".
  702.      _________________________________________________________________
  703.    
  704.    
  705.    
  706.    
  707.    
  708. Section 4: Miscellaneous mailer problems
  709.  
  710.    
  711.    
  712.   ADDRESS WITH BLANKS ARE BEING TREATED SEPARATELY
  713.   
  714.    
  715.  
  716. > Does anyone else have the problem:
  717. >
  718. > If a subscriber to the list is
  719. >       John Doe
  720. >
  721. > Majordomo or sendmail treats this as 3 addresses:
  722. >       John
  723. >       Doe
  724. >
  725. >
  726. > Of course the first two always fail.
  727.  
  728.    [From Alan Millar]
  729.    Majordomo does not treat these as three addresses. Your apparent
  730.    version of Sendmail does.
  731.    
  732.    Remember that all Majordomo does is add and remove addresses from a
  733.    list. Majordomo does not interpret the contents of the list for
  734.    message distribution; the system mailer (such as sendmail) does.
  735.    
  736.    I'm using SMail3 instead of sendmail, and it has an alternative (read
  737.    "stupid") view of how mixed angle-bracketed and non-angle-bracketed
  738.    addresses should be interpreted. I found that putting a comma at the
  739.    end of each line was effective to fix the problem, and I got to keep
  740.    my comments. So I patched Majordomo to add the comment at the end of
  741.    each address it writes to the list file.
  742.    
  743.    You can also add the $listname.strip option so that none of the
  744.    addresses are angle-bracketed. (the "strip" config option for 1.90)
  745.    
  746.    
  747.    
  748.   WHY AREN'T MY DIGESTS GOING OUT?
  749.   
  750.    
  751.  
  752. >I'm not sure how to set up the digest feature of majordomo 1.92 to send
  753. >digests out.  Currently, it is digesting incoming mail, but that's all it's
  754. >doing.
  755.  
  756.    [from John Rouillard]
  757.  
  758.   echo mkdigest   | mail majordomo@...
  759.  
  760.    This will force a digest to be created. Or you can set the max size in
  761.    the digest list config file down low, and force automatic generation.
  762.    There are some patches for 1.92 that will allow other ways of
  763.    specifying automatic digest sending. The patch is in the contrib
  764.    directory.
  765.