home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / ELM23-2 / ELM23-2.ZIP / manuals / Config.doc < prev    next >
Text File  |  1994-04-24  |  16KB  |  463 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                EEllmm CCoonnffiigguurraattiioonn GGuuiiddee
  20.  
  21.  
  22.  
  23.  
  24.                   _H_o_w _t_o _i_n_s_t_a_l_l _a_n_d _c_u_s_t_o_m_i_z_e _t_h_e _E_l_m _m_a_i_l _s_y_s_t_e_m
  25.  
  26.  
  27.                                      Dave Taylor
  28.  
  29.                             Hewlett-Packard Laboratories
  30.                                  1501 Page Mill Road
  31.                                     Palo Alto CA
  32.                                         94304
  33.  
  34.  
  35.  
  36.                    email: taylor@hplabs.HP.COM  or  hplabs!taylor
  37.  
  38.  
  39.  
  40.           >>> Elm is now in the public trust. Bug reports, comments, etc. to: <<<
  41.  
  42.                                     Syd Weinstein
  43.                                Datacomp Systems, Inc.
  44.                                    3837 Byron Road
  45.                           Huntingdon Valley, PA 19006-2320
  46.  
  47.                           email: elm@DSI.COM  or  dsinc!elm
  48.  
  49.  
  50.  
  51.                        ((CC)) Copyright 1986,1987 by Dave Taylor
  52.             ((CC)) Copyright 1988, 1989, 1990 by The USENET Community Trust
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.                                EEllmm CCoonnffiigguurraattiioonn GGuuiiddee
  79.  
  80.                                     (Version 2.3)
  81.  
  82.  
  83.                                      Dave Taylor
  84.  
  85.                             Hewlett-Packard Laboratories
  86.                                  1501 Page Mill Road
  87.                                     Palo Alto CA
  88.                                         94304
  89.  
  90.                    email: taylor@hplabs.HP.COM  or  hplabs!taylor
  91.  
  92.  
  93.           >>>  Elm  is now in the public trust. Bug reports, comments, etc.
  94.                                        to: <<<
  95.  
  96.  
  97.                                     Syd Weinstein
  98.                                Datacomp Systems, Inc.
  99.                                    3837 Byron Road
  100.                           Huntingdon Valley, PA 19006-2320
  101.  
  102.                           email: elm@DSI.COM  or  dsinc!elm
  103.  
  104.  
  105.                                      May 1, 1990
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.                This document is intended as a supplement to the  _E_l_m  _U_s_e_r_s
  113.           _G_u_i_d_e and _E_l_m _R_e_f_e_r_e_n_c_e _G_u_i_d_e and should be of interest mainly to
  114.           people at a site either installing or maintaining the source code
  115.           to the EEllmm mail system, or modifying the code.
  116.  
  117.           It  is  _r_e_q_u_i_r_e_d that installation be done by using the _C_o_n_f_i_g_u_r_e
  118.           script supplied with the system.  Please see  the  file  _I_n_s_t_r_u_c_t
  119.           for further information on running _C_o_n_f_i_g_u_r_e.
  120.  
  121.           The remainder of this document will discuss the various questions
  122.           asked by the _C_o_n_f_i_g_u_r_e script and the options available  via  di-
  123.           rect  editing  of  various  files  and  parameters.  As indicated
  124.           above, almost all of the sites that install EEllmm should  find  the
  125.           _C_o_n_f_i_g_u_r_e script more than sufficient.
  126.  
  127.  
  128.  
  129.           Elm Configuration Guide                               Version 2.3
  130.  
  131.  
  132.  
  133.  
  134.  
  135.           Elm Configuration Guide                               Version 2.3
  136.  
  137.  
  138.  
  139.           UUssiinngg CCoonnffiigguurree
  140.  
  141.                _C_o_n_f_i_g_u_r_e  is  a shell script that will automatically deter-
  142.           mine the type of system it is running on and tune the  parameters
  143.           of  Elm  to  fit  that system and its environment.  Where the in-
  144.           staller has a choice, it asks questions of the  installer.   _C_o_n_-
  145.           _f_i_g_u_r_e  provides  its  own instructions when run, so they are not
  146.           repeated here.  However, when the installer is presented  with  a
  147.           choice, this next section explains some of the options available.
  148.           Not all the questions or  options  to  those  questions  are  ex-
  149.           plained.
  150.  
  151.  
  152.  
  153.                Enable calendar feature?
  154.  
  155.           Elm has a feature to take specially marked lines within mail mes-
  156.           sages and add them to a file for use by the system calendar  pro-
  157.           gram.   The  command to do this extraction needs to be enabled to
  158.           work.  There is also a follow on question regarding the  name  of
  159.           the calendar file:
  160.  
  161.                Default calendar file?
  162.  
  163.           which is usually calendar on most systems.  This file will reside
  164.           in the users home directory, not their .elm directory.
  165.  
  166.                Does your /etc/passwd file keep full  names  in  Berkeley/V7
  167.           format (name first thing after ':' in GCOS field)?
  168.  
  169.           Elm uses the full name from the password file if it is available.
  170.           There are two major ways this name is stored.   Berkeley/V7  sys-
  171.           tems  place  the name as the entire GCOS field string, that is it
  172.           starts directly after the ':'  that  delimits  the  fields.   USG
  173.           (UNIX(R) Systems Group, or AT&T) systems put the users name after
  174.           a department number and separate it from that number  by  a  '-'.
  175.           The  end  of the users full name in these systems is a '('.  Look
  176.           at your /etc/password file and if either version applies,  answer
  177.           yes  to  that  version.   If neither applies, answer no.  Elm can
  178.           still get the users name from the ".fullname" file in their  home
  179.           directory.
  180.  
  181.                Every  now  and then someone has a (gethostname, uname) that
  182.           lies about the hostname but can't be fixed for political or  eco-
  183.           nomic  reasons.   Would  you like to pretend (gethostname, uname)
  184.           isn't there and maybe compile in the hostname?
  185.  
  186.           Elm needs to know the correct name of the host on which it is ex-
  187.           ecuting  to be able to create the proper headers for the outbound
  188.           mail.  Some systems use one name for uucp and  another  name  for
  189.           the  system  and  others just don't reply to the subroutines with
  190.  
  191.           __________
  192.           (R)UNIX is a registered trademark of AT&T.
  193.  
  194.  
  195.           May 1, 1990                   Page 2
  196.  
  197.  
  198.  
  199.  
  200.  
  201.           Elm Configuration Guide                               Version 2.3
  202.  
  203.  
  204.  
  205.           the proper name.  In this case it will be necessary to compile in
  206.           the  name.   In all other cases this should not be needed.  It is
  207.           provided just in case there is a problem with your system.
  208.  
  209.                Does your mailer understand INTERNET addresses?
  210.  
  211.           Elm will work with systems that can process the `@' character  of
  212.           INTERNET format addresses or with the `!' format of uucp address-
  213.           es.  If your mail delivery agent understands the `@'  format  ad-
  214.           dresses,  they  should be used and this question is answered yes.
  215.           If when you send mail with the  `@'  format  addresses  (such  as
  216.           elm@dsi.com), they bounce, then answer this question no.
  217.  
  218.                Am I going to be running as a setgid program?
  219.  
  220.           On USG type systems and many other types, access to the mailboxes
  221.           and the mailbox directory is via the group permissions.  The mail
  222.           user  agents,  such as Elm, need write access into this directory
  223.           to be able to move the mailbox around due to internal editing and
  224.           to  create lock files.  If the permissions on your mailbox direc-
  225.           tory are drwxrwxr-x, then Elm needs to be a setgid program.
  226.  
  227.                What is the default editor on your system?
  228.  
  229.           If no editor is specified in the users _._e_l_m_/_e_l_m_r_c _f_i_l_e_,  this  is
  230.           which editor to use.  The editor is used to compose outbound mail
  231.           messages.
  232.  
  233.                What pager do you prefer to use with Elm?
  234.  
  235.           This is the standard pager to use for reading messages.   Besides
  236.           the usual system pagers, two Elm specific internal options exist:
  237.           builtin and builtin+.  The built-in pager is  faster  to  execute
  238.           but  much  less  flexible than the system provided pagers.  The +
  239.           version just clears the page before  displaying  the  next  page.
  240.           Otherwise the two versions are identical.
  241.  
  242.           OOtthheerr CCoonnffiigguurraabbllee PPaarraammeetteerrss
  243.  
  244.                The  following parameters rarely need to be changed, but are
  245.           provided if you need them.  _C_o_n_f_i_g_u_r_e does not prompt  for  their
  246.           values.   To  change  them, edit the _h_d_r_s_/_s_y_s_d_e_f_s_._h file directly
  247.           after running Configure.
  248.  
  249.           FIND_DELTA
  250.                     This is  the  delta  that  the  binary  search  of  the
  251.                     pathalias  database  will  use  to  determine when it's
  252.                     slicing up a single line, rather than  a  multitude  of
  253.                     lines.    Ideally,  this  should  be set to 1 byte less
  254.                     than the shortest line in the file...the default is  10
  255.                     bytes.
  256.  
  257.           MAX_IN_WEEDLIST
  258.                     The  maximum number of headers that can be specified in
  259.  
  260.  
  261.           May 1, 1990                   Page 3
  262.  
  263.  
  264.  
  265.  
  266.  
  267.           Elm Configuration Guide                               Version 2.3
  268.  
  269.  
  270.  
  271.                     the weedout list of the _._e_l_m_/_e_l_m_r_c file.   A  suggested
  272.                     alternative  approach if this number is too small is to
  273.                     specify initial substrings in the file rather than  in-
  274.                     creasing  the  number.   For  example,  say you want to
  275.                     weedout the headers  ``Latitude:''  and  ``Latitudinal-
  276.                     Coords:'',  you  could  simply specify ``Latitud''" and
  277.                     match them both!  Furthermore you  could  also  specify
  278.                     headers  like  ``X-''  and  remove all the user defined
  279.                     headers!
  280.  
  281.           MAX_HOPS  When replying to a G)roup, this is the  maximum  number
  282.                     of hops that a message can have taken.  This is used to
  283.                     try to optimize the return address (remove cyclic loops
  284.                     and so on) and regular use should show that the default
  285.                     of 35 is plenty more than you'll ever need!
  286.  
  287.           system_text_file
  288.                     This is the source  text  file  for  the  system  level
  289.                     aliases.   See either the _n_e_w_a_l_i_a_s_(_1_L_) man page, or _T_h_e
  290.                     _E_l_m _A_l_i_a_s _S_y_s_t_e_m _U_s_e_r_s _G_u_i_d_e for further details.
  291.  
  292.           system_hash_file
  293.                     This is the file that contains the  hashed  version  of
  294.                     the system aliases.
  295.  
  296.           system_data_file
  297.                     This is the other file the _n_e_w_a_l_i_a_s command installs in
  298.                     the system alias area and contains the actual addresses
  299.                     for  each  of  the aliases contained in the hashed data
  300.                     file.
  301.  
  302.           ALIAS_TEXT
  303.                     This is where the  individual  users  alias  text  file
  304.                     lives.
  305.  
  306.           ALIAS_HASH
  307.                     Where the hashed aliases are stored,
  308.  
  309.           ALIAS_DATA
  310.                     and where the alias address data itself is kept.
  311.  
  312.           DEBUGFILE The name of the file to put in the users home directory
  313.                     if they choose to use the `-d' debug option.
  314.  
  315.           OLDEBUG   The name of the file to save the previous debug  output
  316.                     as.  (this feature was added to ensure that users want-
  317.                     ing to mail bug reports  wouldn't  automatically  over-
  318.                     write the debug log of the session in question)
  319.  
  320.           temp_lock_dir
  321.                     Directory for lock files for XENIX.
  322.  
  323.           temp_file Temporary file for sending outbound messages.
  324.  
  325.  
  326.  
  327.           May 1, 1990                   Page 4
  328.  
  329.  
  330.  
  331.  
  332.  
  333.           Elm Configuration Guide                               Version 2.3
  334.  
  335.  
  336.  
  337.           temp_form_file
  338.                     A place to store temporary forms (for Forms Mode) while
  339.                     answering them.
  340.  
  341.           temp_mbox Place to keep copy of incoming mailbox to avoid  colli-
  342.                     sions with newer mail.
  343.  
  344.           temp_print
  345.                     File to use when creating a printout of a message.
  346.  
  347.           temp_edit File to use when editing the mailbox file on XENIX.
  348.  
  349.           temp_uuname
  350.                     Where to redirect output of the _u_u_n_a_m_e_(_1_M_) command.
  351.  
  352.           mailtime_file
  353.                     File to compare date to to determine if a given message
  354.                     is New since the last time the mail was read or not.
  355.  
  356.           readmsg_file
  357.                     File to use when communicating with the _r_e_a_d_m_s_g program
  358.                     (see that program for more information)
  359.  
  360.           smflags   Defines  the  flags to hand to _s_e_n_d_m_a_i_l if and when the
  361.                     program chooses to use it.
  362.  
  363.           smflagsv  Defines the flags to hand to _s_e_n_d_m_a_i_l in verbose voyuer
  364.                     mode.
  365.  
  366.           mailer    If  you don't have _s_e_n_d_m_a_i_l, this is the mailer that'll
  367.                     be used.
  368.  
  369.           helpfile  The help file name prefix.
  370.  
  371.           ELMRC_INFO
  372.                     The file containing textual  messages  associated  with
  373.                     each  EEllmm  variable setting in the users _`_`_._e_l_m_/_e_l_m_r_c_'_'
  374.                     file.  This is used when the user chooses to  auto-save
  375.                     the options from within the main program.
  376.  
  377.           elmrcfile The  name of the automatic control file within the _._e_l_m
  378.                     directory. (currently _e_l_m_r_c)
  379.  
  380.           old_elmrcfile
  381.                     When a new elmrc file is saved, the  old  one  is  also
  382.                     saved, being renamed to whatever this identifier is set
  383.                     to.
  384.  
  385.           mailheaders
  386.                     The name of the optional file that users may have  that
  387.                     will  be  included in the headers of each outbound mes-
  388.                     sage.
  389.  
  390.  
  391.  
  392.  
  393.           May 1, 1990                   Page 5
  394.  
  395.  
  396.  
  397.  
  398.  
  399.           Elm Configuration Guide                               Version 2.3
  400.  
  401.  
  402.  
  403.           dead_letter
  404.                     If the user decides not to send a message it  will  in-
  405.                     stead  be saved to this filename in their home directo-
  406.                     ry.
  407.  
  408.           unedited_mail
  409.                     In the strange case when the mailer suddenly finds  all
  410.                     the  directories  it  uses shut off (like _/_u_s_r_/_m_a_i_l and
  411.                     _/_t_m_p) then it'll put the current mailbox into this file
  412.                     in the users home directory.
  413.  
  414.           newalias  How  to  install  new aliases..(note: you MUST have the
  415.                     '-q' flag!)
  416.  
  417.           readmsg   What the _r_e_a_d_m_s_g_(_1_L_) program is installed as.
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.           May 1, 1990                   Page 6
  460.  
  461.  
  462.  
  463.