home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / mail / sendmail / sendmail-5.65c+IDA-1.4.4.1 / ida / charset / Install < prev    next >
Encoding:
Internet Message Format  |  1991-04-03  |  5.0 KB

  1. Date: Thu, 28 Mar 91 13:50:22 +0100
  2. From: Keld J|rn Simonsen <keld@dkuug.dk>
  3. To: Paul-Pomes@uiuc.edu
  4. Subject: Installation and Configuration Guide
  5. X-Charset: ASCII
  6. X-Char-Esc: 29
  7.  
  8. Multiple character set support in sendmail is provided by this
  9. package.
  10.  
  11. These patches provide support for non-ASCII character sets in
  12. sendmail.  About 90 7- and 8-bit character sets are supported,
  13. including the ISO 8859 character sets, PC codepages, and Mac character
  14. set.  Actually almost all of the so-called ECMA collection of
  15. character sets is covered, plus many vendor defined character sets.
  16.  
  17. Messages are converted to ASCII for transmission, so full
  18. interoperability and transparancy is guaranteed.  It should be noted
  19. that sending out 8-bit characters in SMTP is a violation of current
  20. RFC standards and it will create quite unintelligible messages on many
  21. systems.
  22.  
  23. The conversion to ASCII is done with a mnemonic representation.
  24. Recipients without special software will be able to read the message.
  25. The conversion is fully reversible without information loss, so if
  26. the receiver has sufficient software and hardware, the message can be
  27. displayed in the right way.
  28.  
  29. A conversion filter program 'conv', together with the pager in the
  30. mail user agent, provides rudimentary support when the hardware is
  31. available for the recipient.
  32.  
  33. When mutual agreement has been achieved between two communicating
  34. systems, these patches can also be used to transmit 8-bit character
  35. sets.  This is useful for instance between UUCP sites, or between
  36. cooperating sites that send 8-bit mail out over SMTP.
  37.  
  38.  
  39.     Installation of character set support patches to sendmail
  40.  
  41. [ These and the IDA patches have already been applied to the sendmail
  42.   sources.  The character set conversion code is enabled by setting
  43.   #define BIT8 in conf.h  -pbp]
  44.  
  45. The patches have been used for sendmail 5.61, 5.64 and 5.65.  They
  46. will most likely also work on later sendmail versions.
  47.  
  48. IDA patches are required.
  49.  
  50. The sendmail patches requires prior installation of the character
  51. set conversion package.  This currently consist of two shar files:
  52. ch.shar01 and ch.shar02.  Create a source directory for these and
  53. unshar, make and make install the shar files.  Default installation
  54. is in /usr/lib/char, /usr/lib and /usr/include, so you need sufficient
  55. privileges for these catalogues.  The 'conv' program is not installed
  56. anywhere, but could be copied to /usr/local/bin or similar places
  57. for public access.
  58.  
  59. [ In this package, /usr/lib/char is rename to /usr/local/lib/mail/char. ]
  60.  
  61. Then apply the sendmail patches to the source of sendmail, and
  62. remake and reinstall sendmail.
  63.  
  64.  
  65. Configuration
  66.  
  67. In the ida/cf/Sendmail.mc file, define the local mailer to use the
  68. internal character set of your machine.  If this is, for example,
  69. ISO 8859-1 (LATIN1) it could be done by:
  70.  
  71. Mlocal,    P=/bin/mail, F=DFMSlmnrs,    A=mail -d $u, C=LATIN1, X=29
  72.  
  73. Valid character set names, and what encodings they cover, are listed
  74. in the file CHARSETS.  The character set is specified with the "C="
  75. option in the Mailer definition.  Case is not significant.
  76.  
  77. The last parameter above is the compose character for specifying
  78. out-of-band characters.  This can be "&" or a control character.
  79. The default is ASCII decimal 29 (035, GS), which has the advantage
  80. of being invisible in the 'more' and 'page' pagers (but not in 'less').
  81. The compose character is given by the option "X=" followed by the decimal
  82. ASCII (or other character set) value.
  83.  
  84. If special arrangements have been made with adjacent UUCP or SMTP sites
  85. to allow 8bit messages, mailers for them are specified similar to these
  86. examples.
  87.  
  88. MUUCP,   P=/usr/bin/uux, F=CDFMUVSpu, S=19, R=19,    A=uux - -z -r $h!rmail ($u),C=ASCII,X=29
  89. MUUCP-L1, P=/usr/bin/uux, F=CDFMUSpu, S=19/0, R=19/0, A=uux - -z -r $h!rmail ($u),C=latin1, X=29
  90. MUUCP-850, P=/usr/bin/uux, F=CDFMUSpu, S=19/0, R=19/0, A=uux - -z -r $h!rmail ($u),C=CP850, X=29
  91.  
  92. MTCP,   P=[IPC], F=CDFMXhnmpu, E=\r\n, A=IPC $h,C=ASCII,X=29
  93. MTCP-L1, P=[IPC], F=CDFMXhnmpu, E=\r\n, A=IPC $h,C=LATIN1,X=29
  94. MTCP-850, P=[IPC], F=CDFMXhnmpu, E=\r\n, A=IPC $h,C=CP850,X=29
  95.  
  96. Use mailertable to declare the appropriate mailer for those sites.
  97.  
  98.  
  99. Modifications to IDA sendmail consist of: 
  100.  
  101. 1. New mailer definitions: C for character set, and X for escape char
  102. in decimal.  Appropriate changes to headers.c and sendmail.h .
  103.  
  104. 2. In collect.c the appropiate mailer for the incoming mail is found
  105. and if the header "X-Charset" or "X-Char-Esc" is found, these are
  106. used instead. The header is untouched. The body is converted from
  107. the found charset to ascii, which is the internal char set of sendmail.
  108.  
  109. 3. In deliver.c  the receiving mailer is determined and the 
  110. corresponding charset is found. This is written with two
  111. new headers, or if they exist, the old headers are revised.
  112. Then the body of the message is converted from ascii to 
  113. the receiving character set.
  114.  
  115. 4. A new routine findheader() has been added in headers.c for locating
  116. and modifying a header.
  117.  
  118. 5. The rutine sfgets() in util.c has been changed to allow 8-bit data.
  119.  
  120. Keld.Simonsen@dkuug.dk 1991-03-24
  121. (revised Paul-Pomes@uiuc.edu, 1991-04-03)
  122.