home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume4 / msg / fmtd1 / Config.fmtd < prev   
Encoding:
Text File  |  1986-11-30  |  11.2 KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                     Configuration Guide
  9.                            to the
  10.                       MSG Mail System
  11.  
  12.                    (C) Copyright 1986, by
  13.                         Dave Taylor
  14.  
  15.                      February 28, 1986
  16.  
  17.  
  18.      This document is intended as a supplement  to  the  Msg
  19. Users  Guide  and  is  only  of interest to sites having the
  20. source code to the msg system.
  21.  
  22.  
  23.      Virtually all of the installation dependent definitions
  24. are  contained  in  the  file  'hdrs/sysdefs.h', as detailed
  25. below;
  26.  
  27.  
  28. -------------------------------------------------------------
  29. #define USE_EMBEDDED_ADDRESSES
  30.  
  31. #define FIND_DELTA      10      /* for binary searches in path database  */
  32.  
  33. #define MAX_HEADERS     500     /* max number of messages in one file!   */
  34. #define MAX_SALIASES    503     /* number of system aliases allowed      */
  35. #define MAX_UALIASES    251     /* number of user aliases allowed        */
  36. #define MAX_IN_WEEDLIST 50      /* max headers to weed out               */
  37.  
  38. #define MAX_HOPS        35      /* max hops in return addr to E)veryone  */
  39.  
  40. #define MAX_ATTEMPTS    6       /* #times to attempt lock file creation */
  41.  
  42. #define REMOVE_AT_LAST          /* see leavembox.c */
  43.  
  44. #define DEFAULT_BATCH_SUBJECT   "no subject (file transmission)"
  45.  
  46. #define NOCHECK_VALIDNAME       /* see validname.c */
  47.  
  48. #define NOTES_HEADER            "/***** "
  49. #define NOTES_FOOTER            "/* ---------- */"
  50.  
  51. #ifdef BSD
  52. # define system_hash_file       "/usr/spool/mail/.alias_hash"
  53. # define system_data_file       "/usr/spool/mail/.alias_data"
  54. #else
  55. # define system_hash_file       "/usr/mail/.alias_hash"
  56. # define system_data_file       "/usr/mail/.alias_data"
  57. #endif
  58.  
  59.  
  60.  
  61.  
  62. Page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74. #define pathfile                "/usr/lib/nmail.paths"
  75.  
  76. #define Lsys                    "/usr/lib/uucp/L.sys"
  77.  
  78. #define DEBUG           "Msg.debug.info"
  79.  
  80. #define temp_file       "/tmp/snd."
  81. #define temp_mbox       "/tmp/mbox."
  82. #define temp_print      "/tmp/print."
  83. #define mailtime_file   ".last_read_mail"
  84. #ifdef BSD
  85. #  define default_editor        "/usr/ucb/vi"
  86. #  define mailhome              "/usr/spool/mail/"
  87. #else
  88. #  define default_editor        "/usr/bin/vi"
  89. #  define mailhome              "/usr/mail/"
  90. #endif
  91.  
  92. #define sendmail        "/usr/lib/sendmail"
  93. #define sendmailflags   "-oi"
  94. #define mailer          "/bin/rmail"
  95. #define mailx           "/usr/bin/mailx"
  96.  
  97. #define helphome        "/usr/local/lib/"
  98. #define helpfile        "main.help"
  99.  
  100. #define msgrcfile       "/.msgrc"
  101. #define mailheaders     ".msgheaders"
  102. #define unedited_mail   "emergency.mbox"
  103. #define newalias        "newalias 1>&2 > /dev/null"
  104.  
  105. #define remove          "/bin/rm -f"            /* how to remove a file */
  106. #define cat             "/bin/cat"              /* how to display files */
  107.  
  108. -------------------------------------------------------------
  109.  
  110.  
  111.  
  112. USE_EMBEDDED_ADDRESSES This controls the mailers response to
  113.                messages  that contain "Reply-To:" or "From:"
  114.                lines that actually contain a return address.
  115.                If  it's  defined, the mailer will attempt to
  116.                use the  address  specified  (overriding  the
  117.                return  address  built from the path that the
  118.                mail took).  It will look the address  up  in
  119.                the pathalias database (see the documentation
  120.                on the alias system)  for  incomplete  paths,
  121.                but it is still recommended that this be left
  122.                undefined.
  123.  
  124.  
  125.  
  126.  
  127.  
  128. Page 2
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.                     This will, of course,  make  the  mailer
  141.                not be a standard 'RFC-822' mailer, since the
  142.                mail system is defined to use the reply-to if
  143.                included rather than the return address, but,
  144.                at least for addresses on the  ARPA  net,  it
  145.                ain't going to work a lot of the time!
  146.  
  147. FIND_DELTA     This is the delta that the binary  search  of
  148.                the  pathalias database will use to determine
  149.                when it's slicing up a  single  line,  rather
  150.                than  a  multitude  of lines.   Ideally, this
  151.                should be set to 1 byte less than  the  shor-
  152.                test  line  in  the  file...the default is 10
  153.                bytes.
  154.  
  155. MAX_HEADERS      The maximum number of messages allowed in a
  156.                single mailbox.
  157.  
  158. MAX_SALIASES     The number of system aliases allowed.   (It
  159.                is recommended that this be a prime number to
  160.                improve the performance of the hashing  func-
  161.                tion (it's a complicated proof!))
  162.  
  163. MAX_UALIASES   The number of user aliases allowed.   (should
  164.                be a prime number - see the comment above)
  165.  
  166. MAX_IN_WEEDLIST The maximum number of headers  that  can  be
  167.                specified  in  the weedout list of the .msgrc
  168.                file.  A suggested  alternative  approach  if
  169.                this  number  is too small is to specify ini-
  170.                tial  substrings  in  the  file  rather  than
  171.                increasing  the number.  For example, say you
  172.                want to weedout the headers  "Latitude:"  and
  173.                "Latitudinal-Coords:",   you   could   simply
  174.                specify  "Latitud"  and  match   them   both!
  175.                Furthermore  you  could  also specify headers
  176.                like "X-" and remove  all  the  user  defined
  177.                headers!
  178.  
  179. MAX_HOPS       When replying to a G)roup, this is  the  max-
  180.                imum  number  of hops that a message can have
  181.                taken.  This is used to try to  optimize  the
  182.                return  address  (remove  cyclic loops and so
  183.                on) and regular  use  should  show  that  the
  184.                default of 35 is plenty more than you'll ever
  185.                need!
  186.  
  187. MAX_ATTEMPTS   When   reading   in   the   default   mailbox
  188.                (/usr/mail/$username)  the  mailer  creates a
  189.                file  called  "/usr/mail/$username.lock"   to
  190.                ensure  that  no  mail  is  added to the file
  191.  
  192.  
  193.  
  194. Page 3
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.                while it's being either read, or replaced (ie
  207.                written  to).   Occasionally,  this lock file
  208.                will already be in  place  since  someone  is
  209.                currently  sending you mail.  If this occurs,
  210.                the mailer will wait a few seconds and try to
  211.                create  the  lock file again.  This parameter
  212.                defines the number of tries the mailer should
  213.                take before giving up.
  214.  
  215. REMOVE_AT_LAST When it does decide to give up  after  trying
  216.                to  create  the lock file, (see MAX_ATTEMPTS,
  217.                above) this will define how to act.  If  it's
  218.                defined,  the  mailer  will attempt to remove
  219.                the lock file after the MAX_ATTEMPTS timeout.
  220.                On  the  other hand, if it's not defined (the
  221.                recommended  state)  it'll  simply  quit  the
  222.                mailer,  telling  the  user to try again in a
  223.                few minutes.
  224.  
  225. DEFAULT_BATCH_SUBJECT What the subject should be on messages
  226.                that are from redirected input but don't have
  227.                a subject specified...
  228.  
  229. NOCHECK_VALIDNAME This disables the checking  of  validnames
  230.                on  the  existing  machine.  On machines that
  231.                run a system such as  sendmail  and  use  the
  232.                sendmail   alias   feature,  this  should  be
  233.                defined.  On other  systems  this  should  be
  234.                left  as  the  default (not defined) to avoid
  235.                users generating "dead.letter" files...
  236.  
  237. NOTES_HEADER   This defines the first  "word"  of  the  line
  238.                that a notes file entry would contain.
  239.  
  240. NOTES_FOOTER   This  defines  the  footer  line   (in   it's
  241.                entirety).
  242.  
  243. system_hash_file This is the file that contains  the  hashed
  244.                version  of  the  system aliases.  It is also
  245.                used in the newalias command.  (note that  it
  246.                is defined differently if you're running on a
  247.                Berkeley system)
  248.  
  249. system_data_file This is the other file the newalias command
  250.                installs  in  the  system  alias area.  (Note
  251.                this is defined differently if you're runnnig
  252.                a bsd system)
  253.  
  254. pathfile       This  defines  the  location  of  the   alias
  255.                datafile.   This  file  is in the format that
  256.                pathalias generates, that is;
  257.  
  258.  
  259.  
  260. Page 4
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.                    machine <tab> address
  274.  
  275.                For further information, please see  the  Msg
  276.                Alias System documentation.
  277.  
  278. Lsys           This defines where the system L.sys  file  is
  279.                kept.  This is used for the mailer to quickly
  280.                know what machines the  current  machine  can
  281.                talk  to  directly (to avoid trying to search
  282.                the pathalias database to route mail to these
  283.                machines).
  284.  
  285. DEBUG          The name of the file to put in the users home
  286.                directory  if  they  choose  to  use the "-d"
  287.                debug option.
  288.  
  289. temp_file      Temporary file for sending outbound messages.
  290.                Place  to  keep  copy  of incoming mailbox to
  291.                avoid collisions with newer mail.
  292.  
  293. temp_print     File to use when creating  a  printout  of  a
  294.                message.
  295.  
  296. mailtime_file  File to compare date to  to  determine  if  a
  297.                given  message is New since the last time the
  298.                mail was read or not.
  299.  
  300. default_editor If no editor is specified in the users .msgrc
  301.                file, this is which editor to use.  ENSURE IT
  302.                IS A VALID EDITOR  ON  THIS  MACHINE!!   (Not
  303.                that  the  default home for "vi" is different
  304.                on BSD machines)
  305.  
  306. mailhome       Where all the  incoming  mailboxes  are,  and
  307.                also  where  the  'lock' files have to be put
  308.                for the mailer to know not to  add  new  mail
  309.                while  we're  reading/writing  the  mailfile.
  310.                (note that mail is kept in a different direc-
  311.                tory on Berkeley systems)
  312.  
  313. sendmail       Defines where sendmail is (if you have it  on
  314.                your system).
  315.  
  316. sendmailflags  Defines the flags to hand to sendmail if  and
  317.                when the program chooses to use it.
  318.  
  319. mailer         If you  don't  have  sendmail,  this  is  the
  320.                mailer that'll be used.
  321.  
  322.  
  323.  
  324.  
  325.  
  326. Page 5
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338. mailx          If all else fails, this mailer can be used in
  339.                a rather dumb way.
  340.  
  341. helphome       Where the help file is kept (soon to be  help
  342.                files!)
  343.  
  344. helpfile       The name of the main helpfile (kept in  "hel-
  345.                phome").
  346.  
  347. msgrcfile      The  name  of  the  automatic  control   file
  348.                (currently ".msgrc")
  349.  
  350. mailheaders      The name of the optional  file  that  users
  351.                may have that will be included in the headers
  352.                of each outbound message.
  353.  
  354. unedited_mail  In the strange case when the mailer  suddenly
  355.                finds  all  the  directories it uses shut off
  356.                (like /usr/mail and /tmp) then it'll put  the
  357.                current  mailbox  into this file in the users
  358.                home directory.
  359.  
  360. newalias       How to install new aliases..
  361.  
  362. remove         How to remove a file.
  363.  
  364. cat            How to display a file to stdout.
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392. Page 6
  393.  
  394.  
  395.  
  396.  
  397.