home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-1.iso / CDROM / FAQs / Unix / email < prev    next >
Encoding:
Text File  |  1996-09-24  |  107.1 KB  |  2,991 lines
  1. Path: informatik.tu-muenchen.de!lrz-muenchen.de!uni-erlangen.de!news.tu-chemnitz.de!zrz.TU-Berlin.DE!news.uni-ulm.de!rz.uni-karlsruhe.de!blackbush.xlink.net!tank.news.pipex.net!pipex!arclight.uoregon.edu!news.sprintlink.net!news-stk-200.sprintlink.net!news.sgi.com!news-peer.gsl.net!news.gsl.net!portc01.blue.aol.com!newsstand.cit.cornell.edu!news.acsu.buffalo.edu!news.drenet.dnd.ca!crc-news.doc.ca!nott!bcarh189.bnr.ca!nrchh45.rich.nt.com!ferret.ocunix.on.ca!resurrect
  2. From: andrew@tamarix.demon.co.uk (Andrew Josey)
  3. Newsgroups: comp.unix.unixware.misc,comp.answers,news.answers
  4. Subject: UnixWare Frequently Asked Questions (The Email system)
  5. Supersedes: <DvyxLG.20I@tamarix.demon.co.uk>
  6. Followup-To: comp.unix.unixware.misc
  7. Date: Sun, 22 Sep 1996 07:06:00 GMT
  8. Organization: Home.
  9. Lines: 2969
  10. Sender: news@tamarix.demon.co.uk
  11. Approved: news-answers-request@MIT.EDU
  12. Expires: Sun, 27 Oct 1996 00:00:00 GMT
  13. Message-ID: <R.Dy4H20.qx@tamarix.demon.co.uk>
  14. NNTP-Posting-Host: localhost
  15. Summary: Answers to questions frequently asked about SCO's UnixWare product
  16. X-NNTP-Posting-Host: tamarix.demon.co.uk
  17. X-Newsreader: TIN [version 1.2 PL2]
  18. Xref: informatik.tu-muenchen.de comp.unix.unixware.misc:17531 comp.answers:21233 news.answers:82327
  19.  
  20. Reposting article removed by rogue canceller.
  21.  
  22. Archive-name: unix-faq/unixware/email
  23. Posting-Frequency: monthly
  24. Last-modified: Aug 20 1996
  25. Version: 2.10
  26.  
  27. UnixWarefi Frequently Asked Questions List ( The Email system ) 
  28.  
  29. For more information about the files which make up the total UnixWare
  30. FAQ, see the "FAQ Overview" file posted regularly on the Internet
  31. newsgroup comp.unix.unixware.misc.
  32.  
  33. INTRODUCTION 
  34.  
  35. This is the Email section of the UnixWare Frequently Asked Questions
  36. file maintained on the Internet. Its maintainers is Andrew Josey (
  37. andrew@tamarix.demon.co.uk). Suggestions and contributions are always
  38. welcome.
  39.  
  40. The purpose of this document is to give answers to frequently asked
  41. questions on Email configuration in UnixWare 1.x and 2.x for the
  42. "mailsurr" subsystem. This document applies to both UnixWare 1.x and
  43. 2.x, please look for version specific notes within this document stating
  44. applicability of individual subsections.
  45.  
  46. This document in this revision does not cover sendmail, if you want to
  47. know about to make sendmail the default mailer, click here.
  48.  
  49. If you are setting up Email for the first time, please check Questions
  50. M2 and M15 first, which document known problems in the Email system and
  51. give an overview of key steps to setup for internet mail. If you use
  52. dialup PPP see M52.
  53.  
  54. This document and the other FAQ files may be found on the world wide web at 
  55. http://www.freebird.org/faq/ 
  56.  
  57. This document may also be obtained by anonymous ftp from the freebird
  58. archive at
  59.  
  60.  o ftp.freebird.org:/unixware/freebird/hints/FAQ/email 
  61.  o ftp1.freebird.org:/pub/mirror/freebird/hints/FAQ/email 
  62.  o ftp2.freebird.org:/pub/unixware/freebird/hints/FAQ/email 
  63.  
  64. Small print: This file is Copyright 1996 freebird.org. Permission is
  65. granted for copying for non-commercial use. Many proper names of
  66. companies and software mentioned in these files are trademarks of their
  67. respective owners. All views are those of the individual contributors
  68. and not of their employers.
  69.  
  70.  
  71. TABLE OF CONTENTS
  72.  
  73. M1) What is the default Mailer on UnixWare ?
  74. M2) Are there any mail related bug fixes for UnixWare 2 ?
  75. M3) Is there any documentation describing the mail subsystem?
  76. M4) I've seen mention of the createSurr command and autoconfiguration
  77.     of the mail subsystem - what is this and what does it do?
  78. M5) Where are the configuration files used by the mail subsystem?
  79. M6) How do I set the domain name used in the From: line?
  80. M7) What other configuration parameters can I set in the 
  81.     /etc/mail/mailcnfg file?
  82. M8) How does mail get delivered and how does the /etc/mail/mailsurr file work?
  83. M9) How can I setup mail aliasing?
  84. M10) How are uucp and smtp handled by the mailsurr file?
  85. M10.1) How do I setup uucp over TCP between two UnixWare machines?
  86. M11) I want to setup uucp outbound over a modem, how do I setup
  87.      the uucp files?
  88. M12) I'm using UW1.x and the From: line for inbound smtp
  89.      mail is in bang format when I want it in domain address format, what
  90.      should I change?
  91. M13) How do I setup mail logging?
  92. M14) How do I setup Smart Routing - using pathrouter ?
  93.  
  94. M15) What do I need to do to Set Up an Internet/Uucp Mail Gateway on UnixWare2?
  95. M15.1) Setup mail alias lookups via DNS, NIS or MHS (/etc/mail/lookupLibs)
  96. M15.2) Set the mail domain information in /etc/mail/mailcnfg
  97. M15.3) Setup any header rewrite rules (/etc/mail/rewrite)
  98. M15.4) Customizing /etc/mail/mailsurr (/usr/lib/mail/mailsurr.proto)
  99. M15.5) Setting up delivery lines to mail-servers, list-processors etc
  100. M15.6) Activating mail logging 
  101. M15.7) Setting up suitable defaults for mailx users
  102. M15.8) If you have local users, then add other mail-user agents 
  103. M15.9) Update /etc/profile
  104. M15.10) Setting up smart routing between uucp and internet zones
  105. M15.11) Add a rule to mailsurr.proto to catch mail to unknown local users.
  106. M15.12) Setup uucp over the connection server for  uucp over
  107. M15.13) Setup mail alias files
  108. M15.14) Install an alternate incoming smtpd 
  109. M15.15) Install the TCP/SPX wrappers so as to monitor who is connecting.
  110. M15.16) An example /usr/lib/mail/mailsurr.proto for this configuration
  111. M16) I have UW2 and my inbound smtpd keeps dying. Is there a fix?
  112. M17) I have UW2 - smtpd now runs as a daemon - is there a way to run
  113.      it from inetd? Running from inetd makes it more reliable and also
  114.      can be wrapped.
  115. M18) I have UW2  and my outbound smtp  does incorrect routing to MX
  116.      record sites and also continually bounces mail when sending
  117.      to an unknown user when it should only bounce once - is there a fix?
  118. M19) I'm having trouble routing email from my local machine to the net.
  119.      I'm connected to a local internet provider and can run Mosaic etc 
  120.      but can't send email. What do i need to do to make this work?
  121. M20) Mail sent to my domain mydom.com does not arrive locally on the
  122.      machine. It gets here but the local mailsystem does not recognise it
  123.      as local.
  124. M20.1) How can I set other mail domains besides my real domain
  125.             to be treated as local?
  126. M21) I'm using UnixWare2 and when mail arrives locally the Return-Path:
  127.      header has the format @myprovider:remotedomain!user or @domain:user or
  128.      @domain:user@domain.  Is there someway to put this into normal 
  129.      domain address format?
  130. M22) Large mail alias lists don't seem to work on UnixWare 2. Is this
  131.      a known problem?
  132. M23) smtp mail to hosts which only have MX records and no valid A 
  133.      records never gets there? This is with the 2.0 developer release.
  134. M24) How do I make the mailsystem send mail for local addresses off
  135.      to another host if they are not found locally without setting up
  136.      aliases?
  137. M25) How can I get mailx/dtmail to add fullname information to 
  138.      the From: line?
  139. M26) How can I set the From: line  (hiding the internal hosts to a 
  140.      mail domain)?
  141. M27) I want to setup a cluster of machines, with a single mail
  142.      gateway machine.
  143. M28) How can i make bounced email go to the postmaster if the user
  144.      address is invalid?
  145. M29) How can i debug mail delivery?
  146. M30) How can i debug the /etc/mail/rewrite rules?
  147. M31) How can I use the rewrite rules to rewrite a To: header
  148.      of the format uunet!domain!user to user@domain?
  149. M32) I have  tcp installed yet i only want to do transfers over 
  150.      uucp. How do i make the mailsurr file exclude the smtpqer delivery lines?
  151. M33) I'm sending to a SCO system over uucp which only understands 
  152.      RFC822. The UnixWare mailsystem inserts an extra From line which 
  153.      upsets the SCO mailer.
  154. M34) Where are outgoing messages stored for smtp?
  155. M35) Mail is bouncing back with problems about an invalid 
  156.      From header line, what should I do?
  157. M36) After changing the system owner to another user and 
  158.      deleting the original user, mail is still being sent to the original 
  159.      system owner for example when a new package is installed, 
  160.      and errors stating "unable to send to " appear after adding a package.
  161. M37) Why when I send local mail does my PPP link get established, for
  162.      example when I pkgadd or pkgrm a package?
  163. M38) Is it possible to change the sender address with 
  164. mailsurr's translation facilities?  The man page indicates 
  165. that only the recipient address can be changed.  
  166. Am I going to have to move to sendmail?
  167. M39) How do I setup a POP3 server on UnixWare ?
  168. M40) I'm using UnixWare 1.x and  I can't find the createSurr command, 
  169.      what should i do?
  170. M41) How do I setup my mail to be autoanswered?
  171. M42) How do I setup my mail to be forwarded?
  172. M43) How do I setup a mail-server?
  173. M44) How do I  setup a mailing list - such as Listproc ?
  174. M45) How do I  make sendmail the default mailer?
  175. M46) Mail of the address format @mylocal.domain:user@mylocal.domain is not
  176.      delivered locally, how can I fix this?
  177. M47) dtmail won't restart after my machine was switched off.
  178. M48) Inbound mail is addressed to <@site.demon.co.uk:user@domain.co.uk>
  179.      and does not get delivered to the local user.
  180. M49) I'm using PPP but don't have the interface up when the system
  181.     creates the mailsurr file, and thus it does not detect my IP
  182.     link - what can I do?
  183. M50) How can I set mailalias in the form : user@site  maps to local user?
  184. M51) What is the /etc/mail/smtpcnfg file in tf2100/UW2.1?
  185. M52) How should I setup Mail via PPP?
  186. M53) How can I setup mail to handle virtual hosts's mail?
  187. M54) I need to print all incoming mail as well as send it to local users.
  188. M55) Mail loops - its forwarded by my provider but then goes into a loop - any ideas?
  189. M56) Mail delivery does not seem to be case insensitive - any ideas?
  190.  
  191.  
  192.  
  193. Subject: M1) What is the default Mailer on UnixWare?
  194.  
  195. The default mailer on UnixWare is based on SVR4 mail and was originally
  196. developed at AT&T Bell Labs.  This mailer uses a regular-expression 
  197. based parser (/etc/mail/mailsurr) to deliver mail - this is similar in 
  198. format to sendmail but is not sendmail.
  199. It supports SMTP, UUCP mail, mailing list directories, 
  200. mail aliases and an MHS gateway.
  201.  
  202. Sendmail is also included on the system and can be used instead
  203. of the mailsurr subsystem  but is not the officially
  204. supported mailer (see question M45 for how to make sendmail
  205. the default mailer).
  206.  
  207.  
  208. Subject: M2) Are there any mail related bug fixes for UnixWare2 ?
  209.  
  210. If you have UnixWare 2.01/2.02/2.03 you should install tf2100.tar.
  211. (IGNORE THE RELEASE NOTES for tf2100 that say the fixes are in 2.03,
  212. the final version of tf2100 was after 2.03, so you do need it).
  213.  
  214. If you have UnixWare 2.1 you DO NOT need to install tf2100.tar.
  215.  
  216. IMPORTANT: before install tf2100 backup any customised versions
  217. of /etc/mail/rewrite or /usr/lib/mail/mailsurr.proto or /etc/mail/mailsurr.
  218.  
  219. This fixes various difficulties with smtpd dying, and smtp
  220. not being able to deliver to certain MX record combinations.
  221.  
  222. Symptoms:
  223. smtp core dumps and times out connections.
  224. RCPT TO: line is not fully qualified - Not compatible with MS mail.
  225. smtp.pid does not get reset properly on system reboot.
  226. smtpd dies without notice or gets into a tight loop.
  227. Popper does not send body of mail to pop3 clients.
  228.        
  229. IT IS HIGHLY RECOMMENDED THAT YOU APPLY TF2100.tar
  230. IF YOU PLAN ON CONNECTING YOUR MACHINE TO THE 
  231. INTERNET AND USING MAILSURR
  232.  
  233. My recommended solution for 2.01/2.02/2.03 is as follows: If you
  234. use the MHS gateway use tf2101.tar, if you only use smtp/uucp
  235. use tf2100.tar and then you might also consider using smap/smapd as a
  236. replacement smtpd running out of inetd (see section M17)
  237.  
  238. There is one problemette with tf2100. Its outbound smtp
  239. holds open a tcp DNS connection. An alternate smtp daemon
  240. is available to fix this on ftp.abs.net:/unixware/freebird/hints/Mail
  241. mailupd.smtp. This updated smtp daemon will also work on UW2.1.
  242.  
  243.  
  244. Tf2101.tar (applicable to 2.01/2.02 - this fix is included in 2.03) 
  245. is available  on ftp.sco.com:/UW20 
  246. fixing numerous problems with the MHS gateway. The two biggest 
  247. problems it fixes are:
  248.  
  249. 1. Users cannot reply to sender due to incorrect Sender lines
  250. 2. Attachments cannot be sent.
  251.  
  252.  
  253. Subject: M3) Is there any documentation describing the mail subsystem?
  254.  
  255. If you are using UnixWare 2, please check
  256. the on-line Dynatext documentation ; two sections are available in
  257. postscript form from the freebird archive in the files:
  258.         hints/Mail/mailserver_admin.UW2.ps.Z
  259.         hints/Mail/setup_mail.UW2.ps.Z
  260.  
  261. For information on accessing the Freebird archive
  262. see the UnixWare resource section of the  "FAQ Overview".
  263.  
  264. Subject: M4) I've seen mention of the createSurr command and autoconfiguration
  265. of the mail subsystem - what is this and what does it do?
  266.  
  267. Firstly you should setup your DNS and uucp links,  if any, and then 
  268. run the /usr/lib/mail/surrcmd/createSurr autoconfiguration command ; this 
  269. takes a look at your configuration and tries to generate an appropriate 
  270. configuration file (/etc/mail/mailsurr) for your system.  For example
  271. if you have TCP/IP installed and uucp configured then a mail configuration
  272. that attempts delivery over both those transports is produced; if this
  273. is not what you intended for example you only want to send email over
  274. uucp even though you have tcp/ip then read on.
  275.  
  276.  
  277. ** UnixWare 2 note: On UnixWare 2 the createSurr command is run
  278.    automatically on each reboot in /etc/rc2.d/S81smtp, thus any changes
  279.    you wish to make permanent must always be applied to the mailsurr.proto
  280.    file in /usr/lib/mail rather than the /etc/mail/mailsurr file. Of course
  281.    another option would be for you to comment the line out in S81smtp.
  282.    The first thing you might want to try prior to any other changes is
  283.    to run the new GUI admin tool for Mail Setup, in Admin_Tools/Mail_Setup,
  284.    select extended and save the selection.
  285.  
  286. The next section describes in some detail how createSurr works.
  287.  
  288. The mail autoconfiguration routine invoked by 
  289. /usr/lib/mail/surrcmd/createSurr consults the perl script  (note that
  290. UnixWare includes a cut down version of perl 4.036 in /usr/gnu/bin)
  291. /usr/lib/mail/surrcmd/configCheck to probe the system configuration, followed
  292. by /usr/lib/mail/surrcmd/configMail to update the /etc/mail/mailsurr file.
  293.  
  294. In detail the sequence is as follows:
  295.  
  296.         createSurr
  297.                 calls-> configCheck
  298.                                 opens-> /etc/mail/mailflgs
  299.                                         /etc/mail/mailcnfg
  300.                                         /etc/mail/smfcnfg
  301.                                         /etc/resolv.conf
  302.                                         /etc/uucp/Systems
  303.                                         /etc/confnet.d/inet/interface
  304.                                 updates-> /etc/mail/mailflgs
  305.                 calls-> configMail
  306.                                 opens-> /etc/mail/mailflgs
  307.                                         /etc/mail/mailsurr.proto
  308.                                 updates-> /etc/mail/mailsurr
  309.  
  310. Subject: M5) What are the configuration files used by the mail subsystem?
  311.  
  312. The configuration files are stored in /etc/mail and in /usr/lib/mail.
  313.  
  314. The key files in /etc/mail are:
  315.         mailcnfg        mailsurr        rewrite         lookupLibs
  316.  
  317. The key files in /usr/lib/mail are:
  318.         mailsurr.proto lookupLibs.proto
  319.  
  320. The /etc/mail/mailcnfg file:
  321.  
  322. This file  is used to initialise the mail configuration;
  323. in UnixWare 2 the GUI Mail_setup tool edits this file.
  324. The fields DOMAIN and SMARTERHOST are of particular importance.
  325.  
  326. DOMAIN  - string used to supply the domain name for the From: line
  327.  
  328. SMARTERHOST - can be set to a machine that has better routing information
  329. in case the local machine does not understand the address. Its
  330. possible and desirable for some workstations to route all mail
  331. to the SMARTERHOST; if you are connecting to the internet you probably
  332. want to set SMARTERHOST to the name of your ISP.
  333.  
  334. The /etc/mail/mailsurr file:
  335.  
  336. This file contains a set of rules for routing and transport of mail.
  337. This is further described later in this document.
  338.  
  339. The /etc/mail/rewrite file:
  340.  
  341. This is new in UnixWare 2 and allows mail header rewriting (see 
  342. rewrite(4) and the Dynatext documents referred to in section M3) .
  343.  
  344. The /etc/mail/rewrite contains functions to rewrite mail headers for
  345. local (called in the local() function) and remote delivery (called in
  346. the main() function). 
  347.  
  348. An example  of changing the From: lines to hide internal
  349. hosts is given in question M15  section 3.
  350.  
  351. The /etc/mail/lookupLibs files:
  352.  
  353. This is new in UnixWare 2 and is a file containing the names of the
  354. shared libraries to be opened when the mailalias command (which is
  355. run by mail when parsing the mailsurr file). This determines where
  356. aliases should be found. Its possible using this for alias lookup to
  357. use the DNS and NIS. 
  358. This file is autoconfigured.
  359.  
  360. The /usr/lib/mail/mailsurr.proto file:
  361.  
  362. This contains the default mailsurr rules for different configurations.
  363. This file is used to create the file /etc/mail/mailsurr. Permanent
  364. changes to /etc/mail/mailsurr should be made by editing this file.
  365. This is further described later in this document.
  366.  
  367. The /usr/lib/mail/lookupLibs.proto file:
  368.  
  369. This is new in UnixWare 2.
  370. This contains the default mailalias lookup rules. This file is used
  371. to create the file /etc/mail/lookupLibs. Permanent changes to that
  372. file should be made by editing this file.
  373. This is further described later in this document.
  374.  
  375. The /etc/mail/smtpcnfg file:
  376.  
  377. This is new in tf2100 and UnixWare 2.1.
  378. The contains initialisation information for the behaviour of smtp.
  379. See M50 for details of the default values in this file.
  380.  
  381. Subject: M6) How do I set the domain name used in the From: line?
  382.  
  383. In UnixWare2 the Mail_setup GUI tool can be used to set the domain
  384. address. This edits a file called /etc/mail/mailcnfg and adds
  385. a line, for example to set the domain to "mydomain.com"
  386.  
  387. DOMAIN=mydomain.com
  388.  
  389. Subject: M7) What other configuration parameters can I set in the 
  390. /etc/mail/mailcnfg file?
  391.  
  392.  
  393. CLUSTER - can be used to name a group of machines. The string supplied
  394. is used instead of the domain name when mail supplies the
  395. remote from line. (with the /etc/mail/rewrite file included
  396. in UnixWare 2 - i no longer use this field but add a rewrite
  397. function instead)
  398.  
  399. FAILSAFE - can be used to denote a machine to which delivery should
  400. be made in case local delivery fails - useful when using
  401. mail in a networked environment
  402.  
  403. DEL_EMPTY_FILE - if value set to no empty mailfiles are not deleted by
  404. mail or mailx
  405.  
  406. ADD_DATE - if set to true, i.e ADD_DATE=true, the mailer will add a Date:
  407. line if one does not already exit
  408.  
  409. ADD_FROM - if set to true, i.e ADD_FROM=true, the mailer will add a From:
  410. line if one does not already exit
  411.  
  412. If you're using UnixWare 1.x and you use uucp transfer you may also 
  413. want to set the REMOTEFROM field which be used to set an alternate From 
  414. line (note, not From: ).  which will be used rather than the cluster name e.g.
  415.  
  416. REMOTEFROM=real.addr.domain
  417.  
  418. (In UnixWare 2  REMOTEFROM is not supported, similar functionality
  419. can be had by using the add_from_header function from /etc/mail/rewrite)
  420.  
  421.  
  422. Subject: M8) How does mail get delivered and how does the /etc/mail/mailsurr 
  423.              file work?
  424.  
  425. Incoming mail over smtp is received over TCP/IP on port 25.
  426. In UnixWare 1.x the inetd server listens on port 25 and invokes 
  427. in.smtpd to receive the mail.  In UnixWare 2.x an smtpd daemon process listens
  428. on port 25 to receive mail
  429.  
  430. Once mail is received by the smtp receiver it is passed to
  431. the rmail process which then uses the regular expression based
  432. parser (/etc/mail/mailsurr) to decide how to do deliver the mail.
  433.  
  434. Incoming mail over uucp is queued in /var/spool/uucp/sitename and then
  435. uux scans that directory and passes the mail off to the 
  436. rmail process for delivery.
  437.  
  438. Outgoing mail is handed to rmail which based on the address and
  439. the mailsurr rules in place  delivers the mail accordingly.
  440.  
  441.  
  442. The file /etc/mail/mailsurr contains a set of rules for routing and 
  443. transport of mail.
  444.  
  445. This file is automatically created by the command
  446. /usr/lib/mail/surrcmd/createSurr by scanning the system configuration
  447. and a template mailsurr prototype file in /usr/lib/mail/mailsurr.proto.
  448.  
  449. To make permanent changes to this file edit the mailsurr.proto file
  450. and then rerun the createSurr command.
  451.  
  452. The mail autoconfiguration routine invoked by /usr/lib/mail/surrcmd/createSurr 
  453. consults the perl script /usr/lib/mail/surrcmd/configCheck to probe the system 
  454. configuration. 
  455.  
  456. After scanning the system the file /etc/mail/mailflgs 
  457. contains flags for the configuration options autoconfigured. Examination of the
  458. mailsurr.proto shows the same flags with conditional mailsurr entries.
  459.  
  460. The possible flags in /etc/mail/mailflgs are SMTR, MHS, DNS, UUCP and IP:
  461.  
  462. SMTR if SMARTERHOST is set in /etc/mail/mailcnfg
  463.  
  464. MHS is set if %g is set in /etc/mail/mailcnfg (MHS gateway )
  465. This may be set off if MHSINTERVAL is set to 0 in /etc/mail/smfcnfg
  466.  
  467. DNS is set if there is a resolver set in /etc/resolv.conf
  468. UUCP is set if there are entries in /etc/uucp/Systems
  469. IP is set if it determines there is a valid device in
  470. /etc/confnet.d/inet/interface
  471.            
  472.  
  473. The createSurr command the invokes /usr/lib/mail/surrcmd/configMail to
  474. produce the updated /etc/mail/mailsurr file.
  475.  
  476. Looking at the file created (see mailsurr(4) for full details).
  477. Each entry in the /etc/mail/mailsurr file consists of three fields.
  478.  
  479. 'sender'          'recipient'   'command'
  480.  
  481. The sender and recipient fields are regular expressions.  If
  482. these first two fields match those of the mail message being
  483. processed, the associated command is run.
  484.  
  485. Some sample mailsurr entries follow - don't worry if you don't
  486. understand these, for a full explanation you can refer to the 
  487. UnixWare man page for mailsurr(4).
  488.  
  489. # mail-server, mailing lists and information distribution handling section
  490. '.+'    'mail-server'   '<      /opt/lib/mserv/listener'
  491. '.+'    'listproc'      '<S=0;      /home/listserv/catmail -r -f'
  492.  
  493. #    Send mail for `laser' to   attached laser printer
  494. #    Make certain that failures are reported via return mail.
  495. '.+' 'laser'     '< S=0;F=*; lp -dlaser'
  496.  
  497. #    For remote mail via uucp
  498. '.+' '([^!@]+)!(.+)'     '< /usr/bin/uux - \\1!rmail (\\2)'
  499.  
  500.  
  501. Examples of mailsurr/mailsurr.proto/mailcnfg files for a uucp/internet 
  502. gateway  and client workstation in cluster configurations for both
  503. UnixWare 1.x and UnixWare 2 are available from the Freebird archive
  504. in the directory hints:
  505.         Mail/README
  506.         Mail/mailsurr
  507.         Mail/mailcnfg
  508.         Mail/client.mailcnfg
  509.         Mail/client.mailsurr
  510.         Mail/client.mailcnfg.uw2
  511.         Mail/client.mailsurr.uw2
  512.         Mail/mailcnfg.uw2
  513.         Mail/mailsurr.proto.uw2
  514.         
  515. Subject: M9) How can I setup mail aliasing?
  516.  
  517. UnixWare mail has a convenient method of alias processing, and the
  518. mailer calls a utility called mailalias. 
  519.  
  520. The mailalias utility if it cannot find a user locally or a mailbox 
  521. (UnixWare mail delivers to mailfiles as well as users - so
  522. you can just places a mailbox into /var/mail without setting
  523. up a user account) looks for a list 
  524. of alias files in the configuration file /etc/mail/namefiles.
  525.  
  526. Note that mailsurr does not use any of the sendmail aliasing
  527. files (i.e. /usr/ucblib/aliases).
  528.  
  529. The default files are /etc/mail/lists and /etc/mail/names. In our
  530. local installation we've added added a couple of local files, 
  531. /etc/mail/groups for internal groups, /etc/mail/localiases for 
  532. internal distribution and /etc/mail/fullnames 
  533. which has alternate  long names; so this file looks like:
  534.  
  535. # --- example /etc/mail/namefiles -----
  536. /etc/mail/lists
  537. /etc/mail/names
  538. # Local add-ons
  539. /etc/mail/groups
  540. /etc/mail/localiases
  541. /etc/mail/fullnames
  542. # -----end example ----
  543.  
  544. /etc/mail/groups could be:
  545.  
  546. # ---- example /etc/mail/groups -----
  547. #       All the local groups within Sitename.This is the definitive copy used by
  548. #       all the mail interfaces (it's totally transparent to them all).
  549. #
  550.  
  551. managers        john fred wendy june
  552. staff           joan michelle rita \
  553.                 sarah brendan
  554. all             managers staff
  555. # --- end example --
  556.  
  557. /etc/mail/localiases could be:
  558.  
  559. # ----- example /etc/mail/localiases ----
  560. #       localiases:
  561. #               These are purely local, readily changeable aliases for mapping
  562. #       user@site.domain to internal host!user
  563. #
  564. # This file is for the gateway
  565.  
  566. john            argus!john
  567. fred            argus!fred
  568. wendy           woolco!wendy
  569. june            sun4!june
  570. rita            olim380!rita
  571. sarah           olim380!sarah
  572. brendan         sun4!brendan
  573. # -- end example --
  574.  
  575. /etc/mail/fullnames could be:
  576.  
  577. # --- example /etc/mail/fullnames ---
  578. j.williams      john
  579. john.williams   john
  580. f.jones         fred
  581. fred.jones      fred
  582. w.jones         wendy
  583. wendy.jones     wendy
  584. r.arnold        rita
  585. rita.arnold     rita
  586. # common misspellings can also be included
  587. sara            sarah
  588. brendon         brendan
  589. # --- end example ----
  590.  
  591.  
  592. Subject: M10) How are uucp and smtp handled by the mailsurr file?
  593.  
  594. Delivery by uucp is driven off the /etc/uucp files. If you wish to
  595. do some smart routing see the later section on pathrouter..
  596.  
  597. Use of smtp can we be done either using DNS lookup or not.
  598. Typically for internal hosts in a cluster, we set smarterhost
  599. (in /etc/mail/mailcnfg) to our internet gateway, and then
  600. that host does the DNS lookup.
  601.  
  602. To choose smtp delivery before uucp swap the two lines below (example for 
  603. UnixWare 1.x).  If you want to use DNS lookup remove the "-N" from the smtpqer
  604. line.
  605.  
  606. #UnixWare 1.x example uucp delivery first, followed by smtp
  607. '.+'    '!([^!]+)!(.+)'         '< B=1024; uux -a %R -p -- \\1!rmail' '(\\2)'
  608. '.+'    '!([^!]+)!(.+)'         '< B=4096; smtpqer -N %R \\1' '\\2'
  609.  
  610.  
  611. ** UnixWare 2 note: The mailsurr lines in UnixWare 2  default to use 
  612. domain addressing rather than ! notation. They appear different but the
  613. ordering may be changed.
  614.  
  615. # UnixWare 2 example: The mail transports go here.
  616. # smtp delivery first followed by uucp
  617. # If DNS is not used, use "smtpqer -N". If DNS is used, remove the "-N".
  618. #
  619. '.+'    '([^@,:]+)@(.+)'        '< B=4096; /usr/lib/mail/surrcmd/smtpqer -f %R -s %X' '\\1@\\2'
  620. '.+'    '(@[^@,:]+[,:].+)'      '< B=4096; /usr/lib/mail/surrcmd/smtpqer -f %R -s %X' '\\1'
  621. '.+'    '([^@,:]+)@(.+)%D'      '< H=add_from_header;B=1024; uux -a %R -p -- \\2 !rmail' '(\\1)'
  622. '.+'    '@([^@,:]+)%D[,:](.+)'  '< H=add_from_header;B=1024; uux -a %R -p -- \\1 !rmail' '(\\2)' 
  623.  
  624. Tip: If you are using dialup uucp you may want to change the uux command
  625. invoked to add the "-r" flag so that mail will be queued for delivery,
  626. rather than attempting delivery at the time the mail is sent. The mail
  627. can then be sent when the uucp system polls the site which is more
  628. efficient. An example of a uucp delivery line with the -r flag added
  629. follows:
  630.  
  631. # invoke uux with -r flag to queue mail for delivery
  632. '.+'    '([^@,:]+)@(.+)%D'      '< H=add_from_header;B=1024; uux -a %R -p -- \\2 !rmail' '(\\1)'
  633. '.+'    '@([^@,:]+)%D[,:](.+)'  '< H=add_from_header;B=1024; uux -r -a %R -p -- \\1 !rmail' '(\\2)' 
  634.  
  635. Since your mailsurr file was created by the createSurr command then remember
  636. to make the changes permanent by editing the file
  637. /usr/lib/mail/mailsurr.proto (the template prototype file).
  638.  
  639. Subject: M10.1) How do I setup uucp over TCP between two UnixWare machines?
  640.  
  641. Step 1. Edit /etc/uucp/Devices and uncomment the following line
  642.  
  643. CS  - - - CS   
  644.  
  645. This then uses the connection server to make connections.
  646.  
  647.  
  648. Step 2. Edit /etc/uucp/Systems , add a line for each system you
  649. want to talk to, for example to system raven
  650.  
  651. raven     Any CS - -,listen:10103 
  652.  
  653. This entry makes "uucico" run over the TCP network.  
  654. It causes the Connection Server to connect to the "10103" service 
  655. through the "listen" service. The "10103" service invokes uucico.
  656.  
  657. Step 3. Edit /etc/uucp/Permissions, to allow remote systems 
  658. connecting over the connection server to send and request files (note
  659. that remote systems also need an entry in /etc/uucp/Systems).
  660.  
  661. LOGNAME=nuucp SENDFILES=yes REQUEST=yes
  662.  
  663.  
  664.  
  665. M11) I want to setup uucp outbound over a modem, how do I setup
  666. the uucp files?
  667.  
  668. In UnixWare2 you can do this using the Dialup_setup GUI tool.
  669.  
  670. Alternately I carry a floppy with the following files from /etc/uucp
  671. that I install when I want to setup my laptop to call outbound:
  672.  
  673.         Config  Devices Devices.tcp Dialers Systems
  674.  
  675. This configuration is for a Hayes compatible modem, and is known
  676. to work with Supra modems, Multitech ZDX modems and US Robotics.
  677. These files can be obtained from the freebird archive in the file
  678.  
  679.         hints/Mail/uucp.quick.tar.Z
  680.  
  681. Subject: M12) I'm using UW1.x and the From: line for inbound smtp
  682. mail is in bang format when I want it in domain address format, what
  683. should I change?
  684.  
  685. Change to /etc/inet/inetd.conf [ Applies only to UnixWare 1.x]
  686.  
  687. In UnixWare 1.x smtp is run as an inetd service each time a request comes
  688. in. If you're running UnixWare 1.x you most probably want to make
  689. the change below:
  690.  
  691. One problem you can get if you deliver over smtp is that the mail 
  692. subsystem rewrites the From: line from
  693. internet format to uucp format.  To change this edit the
  694. smtp line in /etc/inet/inetd.conf (on the receiving host) and add 
  695. the -r flag to tell smtpq not to rewrite the addresses.
  696.  
  697. smtp    stream  tcp     nowait  smtp    /usr/lib/mail/surrcmd/in.smtpd  in.smtpd -H novell.co.uk -r
  698.  
  699. (in the above example we fixed the Helo string to be novell.co.uk, you
  700. probably want to change this or you can omit it altogether).
  701.  
  702. Remember to restart inetd, or send it a HUP signal to re-read the config file.
  703.  
  704. # ps -ef|grep inetd
  705. root   268   262  0   Dec 01 ?        3:25 /usr/sbin/inetd 
  706. andrew 17546 17313  6 14:43:58 pts/5    0:00 grep inetd 
  707.  
  708. # kill -HUP 268
  709.  
  710. ** UnixWare 2.x note; In UnixWare 2 smtpd is run as a daemon rather than being
  711. started by the inetd process, so the above does not apply. The only
  712. option supported in UW2 is -d debug_level.  It has been reported that when
  713. upgrading from UnixWare 1.x to UnixWare 2, that some of the old daemons
  714. are not removed, so you may want to hand check your /etc/inet/inetd.conf
  715. file and comment out any in.smtpd entries carried over - remembering
  716. to restart inetd afterwards.
  717.  
  718. Subject: M13) How do I setup mail logging?
  719.  
  720. The following mailsurr entries log successful and failed deliveries in
  721. /var/mail/:log and /var/mail:errors respectively.  In UnixWare 1.x these
  722. are files, in UnixWare 2 these are directories.
  723.  
  724. # Log mail delivery
  725. #
  726. '.+'    '.+'    '> W=1;B=*; maillog -o /var/mail/:log' '-O %O %R %n %H %l --'
  727. '.+'    '.+'    'Errors W=1;B=*; maillog -o /var/mail/:errors' '-O %O %R %n %H %l --'
  728.  
  729. If you are using UnixWare 1.x and enable these be sure to setup a cron to 
  730. periodically trim them (not necessary for UnixWare 2 since it
  731. logs to one file for each day of the week, truncating any existing
  732. files at the start of each day -see below).
  733.  
  734. To turn on logging for incoming and outgoing mail, execute the 
  735. following command:
  736.  
  737. #/usr/lib/mail/surrcmd/createSurr -l on
  738.  
  739. In UnixWare 2 you can also select the appropriate part of the GUI setup
  740. to turn logging on.
  741.  
  742. ** UnixWare 2 Note:  The log files are different between UnixWare 1.x and
  743. UnixWare 2. Logs are now kept in directories with a different log being
  744. stored each day in a file denoted by the day name, ie. Monday,....Sunday
  745. for the 7 days. If you prefer the old style format of logging to
  746. just a single file , its very simple just to replace the logging tool
  747. with either your own or the one from UnixWare 1.x. (from the Freebird
  748. archive ...freebird/hints/Mail/maillog.alt).
  749.  
  750. Logs for smtp delivery are kept in /var/spool/smptq/LOG* in UnixWare 1.x
  751.  
  752. To determine problems with outgoing mail, check the /var/spool/smtpq/LOG file.
  753. Each time a mail message is sent, a log of the delivery command is appended 
  754. to this log file.  A cron entry located in /var/spool/cron/crontabs/smtp 
  755. recycles daily backup copies of the mail message deliveries on a 7 day 
  756. cycle.  This is useful for debugging mail problems.  
  757.  
  758. Some simple logging sample scripts suitable for UnixWare 1.x are contained 
  759. on the Freebird archive in mailloggers.shar, these simply show how to 
  760. tail relevant logfiles.
  761.  
  762. In UnixWare 2 daily logs for smtp delivery are now kept in the directory
  763. /var/spool/mailq/Logs.
  764.  
  765. A useful file to monitor uucp activity is:
  766.  
  767. #!/bin/sh
  768. # works on both UnixWare 1.x and UnixWare 2
  769. tail -f /var/uucp/.Admin/xferstats
  770.  
  771. To see todays uucp log for a given system
  772.  
  773. uulog -f system
  774.  
  775. To see the days logs for all systems, type 
  776.  
  777. uulog
  778.  
  779. To tail the smtp logs for UnixWare 2, you need a script:
  780.  
  781. #!/bin/sh
  782. # You'll need to chmod the files in the Logs directory
  783. # or run this with privilege
  784.  
  785. DAY=`date +%A`
  786. tail -f /var/spool/mailq/Logs/$DAY
  787.  
  788. Subject: M14) How do I setup Smart Routing - using pathrouter ?
  789.  
  790. If you wish to setup a machine to act as a smart mail gateway capable
  791. of routing, then some smart routing software is needed.  A utility
  792. suitable for use with UnixWare is pathrouter.
  793.  
  794. ** UnixWare 2 note: 
  795.  
  796. The good news is that pathrouter is now part of the 
  797. standard release and can be found in /usr/lib/mail/surrcmd/pathrouter. 
  798. There is even a man page, and it gets a mention in the Dynatext.
  799.  
  800. UnixWare 1.x pathrouter is available from the freebird archive :
  801.         freebird/hints/Mail/pathrouter.tar.Z
  802.  
  803. Pathrouter is essentially the routing part of smail2.5, with some
  804. modification for batch routing and auto detection of hostname and domain
  805. name. It's driven by a routing database in /etc/uucp/paths (which can
  806. be built manually or you could use the freely available pathalias utility).
  807.         
  808. Pathrouter can be used to lookup route information for uucp and 
  809. domain addresses.
  810.  
  811. The following  is an example of the delivery commands from the
  812. file /etc/mail/mailsurr for such a configuration which can gateway
  813. between the internet and uucp zones. 
  814.  
  815. This example for UnixWare 1.x, see later for example mailsurr.proto
  816. for UnixWare 2.
  817.  
  818. ####
  819. #### Part 3
  820. ####
  821. #### Delivery commands should go here. All addresses going
  822. #### remote should begin with a single "!".
  823. ####
  824.  
  825. # Check for binary mail. Uncomment this if you want to use it.
  826. # Smtp can not handle binary mail so use this line.
  827. #
  828. '.+'    '!([^!]+)!.+'           '< F=*;C=0; ckbinarsys -t %C -s \\1'
  829.  
  830. # Perform routing via /etc/uucp/paths database
  831. '.+'    '.*[!@].*'              'Translate T=1;B=*; R=|pathrouter -p' '%n'
  832.  
  833. # For remote mail via uucp and smtp. Uucp is first because
  834. # it is more universal and handles binary mail properly.
  835. # 
  836.  
  837. '.+'    '!([^!]+)!(.+)'         '< B=1024; uux -a %R -p -- \\1!rmail' '(\\2)'
  838.  
  839. #
  840. # If DNS is not used, use "smtpqer -N". If DNS is used, remove the "-N".
  841. #
  842. #'.+'   '!([^!]+)!(.+)'         '< B=4096; smtpqer -N %R \\1' '\\2'
  843. '.+'    '!([^!]+)!(.+)'         '< B=4096; smtpqer %R \\1' '\\2'
  844.  
  845.  
  846.  
  847. The /etc/uucp/paths file is the routing database for the pathrouter command 
  848. (see paths(4), and pathrouter(1M)) .  Each line of the file provides 
  849. routing information to either a host or to a domain (designated by a 
  850. leading ".").  Each line should have either two or three tab characters 
  851. (ascii 0x9) as separated fields.  The format of each line in the 
  852. paths file is:
  853.  
  854.         key  route   [cost]
  855.  
  856.  
  857. Note that the cost field is a delivery weighting field 
  858. which is not used by the mail subsystem (smail would use it).
  859.  
  860.  
  861. An example paths (/etc/uucp/paths) file for a gateway machine.
  862.  
  863. The following paths file is an example of setup for a gateway machine.
  864. This example prefixes the destination routes with an exclamation
  865. mark (!) to reduce the number of translations done by the rmail(1).
  866.  
  867. This example is used to rewrite the domain addresses france.fr;
  868. and any uk domain address (matched by the .uk rule) to be routed 
  869. via the uel machine.
  870.  
  871. The usg.com domain address is converted to !usg!%s in order to utilise
  872. the uucp transport rather than smtp. 
  873.  
  874. france.fr       !uel!france.fr!%s       0
  875. uel     !uel!%s 0
  876. usg     !usg!%s 0
  877. windsor !uel!windsor!%s 0
  878. ..uk     !uel!%s 0
  879. ..usg.com        !usg!%s 0
  880.  
  881.  
  882. Prefixing a name by a dot as in ".usg.com" can be used to match
  883. domains, and so this rule would match site1.usg.com to be routed
  884. thru usg!.
  885.  
  886.  
  887. Note that this example does not have "smart-host" defined, and so
  888. any addresses that are not matched by pathrouter are left unchanged. In this
  889. example it is assumed that the DNS lookup will resolve the
  890. address and perform delivery over smtp.
  891.  
  892. If you don't have DNS lookup, or you decide to route unknown
  893. addresses to the nearest backbone then add an entry
  894.  
  895. smart-host      !backbone!%s    0
  896.  
  897. An example we use here to send mail to a particular route follows; this
  898. for various internal routing to an internal gateway within the company,
  899. and allows mail to be addressed as user@fpk, user@fpk.mycomp.com or
  900. user@mycomp.com with all mail going to the one gateway.
  901.  
  902. fpk     !nj-ums.fpk.mycomp.com!%s       0
  903. fpk.mycomp.com  !nj-ums.fpk.mycomp.com!%s       0    
  904. mycomp.com      !nj-ums.fpk.mycomp.com!%s       0
  905.  
  906.  
  907. This is then combined with a delivery line within mailsurr.proto
  908. to send this over smtp:
  909.  
  910. '.+'    '!(nj-ums.fpk.mycomp.com)!(.+)' '< B=4096; /usr/lib/mail/surrcmd/smtpqer -f %R -s \\1' '\\2'          
  911.  
  912.  
  913. * UnixWare 2 note:
  914.  
  915. You may encounter some differences between the pathrouter available
  916. on the ftp sites and that included in UnixWare2.
  917. In particular the 2.0 version does not take entries in 
  918. /etc/uucp/paths of the form 
  919.  
  920. ukb.novell.com  %s      0
  921.  
  922. to be for local delivery which it should.
  923. The above example should match "user@ukb.novell.com" to be a local
  924. user and translate is to just "user" - you can work around
  925. this by add a mailsurr translation rule 
  926.  
  927.         '.+'    '([^@]+)@(ukb.novell.com)'            'Translate R=\\1'
  928.  
  929.  
  930.  
  931. Subject: M15) What do I need to do to Set Up an Internet/Uucp Mail Gateway 
  932.               on UnixWare 2?
  933.  
  934. The following section details the steps taken to setup up an email
  935. gateway on UnixWare 2 - the email gateway is connected to the internet
  936. and also has direct uucp connections over tcp and serial lines.
  937.  
  938.  
  939. Subject: M15.1) Setup mail alias lookups via DNS, NIS or MHS 
  940.                 (/etc/mail/lookupLibs)
  941.  
  942. Do you want mailalias to use  DNS, NIS or MHS to lookup for aliases?
  943. If you don't then by disabling the feature (by commenting out
  944. lines in usr/lib/mail/lookupLibs.proto) you can speed mailalias
  945. lookup.
  946.  
  947. In /usr/lib/mail is the file lookupLibs.proto; by default this contains:
  948.  
  949. /usr/lib/mail/libalias/file.so
  950. /usr/lib/mail/libalias/passwd.so
  951. <DNS>   /usr/lib/mail/libalias/dns.so
  952. <NIS>   /usr/lib/mail/libalias/nis.so
  953. <MHS>   /usr/lib/mail/libalias/extract.so    
  954.  
  955.  
  956. When createSurr is run to auto-discover the machine configuration
  957. and create a suitable mailsurr file, it will auto include the
  958. lines for the features it discovers, for example DNS being
  959. configured auto includes the line beginning <DNS>
  960.  
  961. You can insert a comment into this file to disable the line, or
  962. you can delete the line; for example to disable DNS, NIS and MHS
  963. mailalias lookup  on this machine;
  964.  
  965. /usr/lib/mail/libalias/file.so
  966. /usr/lib/mail/libalias/passwd.so
  967. <DNS>   #/usr/lib/mail/libalias/dns.so
  968. <NIS>   #/usr/lib/mail/libalias/nis.so
  969. <MHS>   #/usr/lib/mail/libalias/extract.so    
  970.  
  971.  
  972. Alternately you can replace mailalias with the UW1.x version of mailalias
  973. which then only uses the aliases as defined in /etc/mail/namefiles.
  974. (This also works around a bug in 2.01 mailalias where long alias lists
  975. are truncated -alternately installing one of the mail fix updates in
  976. question M2 will also fix this problem). Since I'm not
  977. using any aliases in the DNS/NIS presently I install the UW1.x version as 
  978. /usr/lib/mail/surrcmd/mailalias.alt and edit the line in
  979. mailsurr.proto accordingly.
  980.  
  981. The changes are as follows:
  982.  
  983. # Run all (apparently) local names through the mail alias processor.
  984. # This version uses mailalias.alt which is the 1.x version
  985. #
  986. '.+'    '.+'                    'Translate T=1;B=*; R=|/usr/lib/mail/surrcmd/mailalias.alt -P%L! -P%U! -P%L\%D! -P%U\%D! -S@%U\%D -S@%L\%D -S@%L -S@%U -r -p' '%n'
  987.  
  988. A copy of the UW1.x version of mailalias is available on the Freebird
  989. archive.
  990.  
  991. Subject: M15.2) Set the mail domain information in /etc/mail/mailcnfg
  992.  
  993. You can establish many of the mail configuration parameters  by using
  994. the Admin_Tools/Mail_Setup GUI Tool. One of the things this does is
  995. to enter parameters into the file /etc/mail/mailcnfg - a file that does
  996. not exist by default.
  997.  
  998. A typical file is as follows:
  999.  
  1000.  
  1001. ADD_DATE=1
  1002. ADD_FROM=1
  1003. ADD_RECEIVED=1
  1004. DOMAIN=novell.co.uk
  1005. SMARTERHOST=usl.com
  1006. ADD_MESSAGE_ID=1
  1007. FORCE_7BIT_HEADERS=1
  1008. FORCE_7BIT_MIME=1
  1009. ADD_TO=1
  1010. FORCE_MIME=1
  1011.  
  1012. Important parameters here are:
  1013.  
  1014. SMARTERHOST - where to send mail in the event that you are
  1015. unable to resolve or have no uucp route to a host. Typically this
  1016. is your IP provider or another friendly site.
  1017.  
  1018. DOMAIN - is the mail domain for the From: line in mail. Typically
  1019. mail will have the form From: user@nodename.domain. The next section
  1020. in this document shows a mail rewrite rule which rewrites
  1021. the From: lines so as to make all mail  seem to have come from 
  1022. just the domain name.
  1023.  
  1024.  
  1025. Subject: M15.3) Setup any header rewrite rules (/etc/mail/rewrite)
  1026.  
  1027. Using the default setup with DOMAIN=novell.co.uk, mail will appear
  1028. as if it comes from the machinename.novell.co.uk. Many installations
  1029. prefer to make it appear as if they have just one email address, their
  1030. domain name.
  1031.  
  1032. The /etc/mail/rewrite file contains functions to rewrite mail headers for
  1033. local and remote delivery. The following is a rewrite function
  1034. to search for occurrences of node.novell.co.uk and replace them with
  1035. just novell.co.uk.
  1036.  
  1037.  
  1038. function check_headers()
  1039. {
  1040. var hdr;
  1041. # loop through ALL headers
  1042. for (hdr from headers_pattern("From:"))
  1043.    # if we match a header that has something like foo.xyz.com in it
  1044.    if (hdr ~ "[a-zA-Z]\\.novell\\.co\\.uk")
  1045.      # then substitute the shorter version in its place
  1046.      hdr=gsubstitute(hdr, "[a-zA-Z0-9.]+\\.novell\\.co\\.\\uk", "novell.co.uk");
  1047. }         
  1048.  
  1049. So this function should be added to the file /etc/mail/rewrite.
  1050. There are two pre-defined special functions within this file - main()
  1051. and local().
  1052.  
  1053. You need to add  this to the function main() which is executed before
  1054. any rules in the /etc/mail/mailsurr file are executed. 
  1055.  
  1056. Other functions may be executed from mailsurr via Rewrite rules or 
  1057. H= invocations  on delivery lines. 
  1058.  
  1059. The function local() is executed for local delivery.
  1060.  
  1061. An example function to be executed by a H= invocationm is add_from_header.
  1062. This is a modified version we use for uucp connections
  1063. (this works for us below)
  1064.  
  1065. # function add_from_header
  1066. #
  1067. # Add a >From line.
  1068.  
  1069. function add_from_header()
  1070. {
  1071.     # Create the From header.
  1072.     var retpath, elementArray, newHeader;
  1073.     retpath = returnpath();
  1074.     if(strstr(retpath, "!") != 0)
  1075.         {
  1076.         # uucp incoming case
  1077.         #retpath = substitute(retpath, "^(.+)!([^!]+)$", "\\1:\\2");
  1078.         elementArray = split(retpath, ":");
  1079.         elementArray[0] = substitute(elementArray[0], "^@", "");
  1080.         newHeader = elementArray[1] @ " " @ fromdate(time()) @ " remote from " @ elementArray[0];
  1081.         }
  1082.     else if(strstr(retpath, "@") == 0)
  1083.         {
  1084.         # local delivery so add this machine's domain
  1085.         newHeader = retpath @ " " @ fromdate(time()) @ " remote from " @ usefuldomain();
  1086.         }
  1087.     else
  1088.         {
  1089.         # over smtp?
  1090.         retpath = gsubstitute(retpath, ":@", "!");
  1091.         retpath = substitute(retpath, "^@", "");
  1092.         if(strstr(retpath, ":") == 0)
  1093.             {
  1094.             retpath = substitute(retpath, "([^!@]+)@([^@]+)$", "\\2:\\1");
  1095.             }
  1096.         else
  1097.             {
  1098.             retpath = substitute(retpath, "([^:]*)[:]([^!@]+)@([^@]+)$", "\\1!\\3:\\2");
  1099.             }
  1100.  
  1101.         elementArray = split(retpath, ":");
  1102.         elementArray[0] = substitute(elementArray[0], "^@", "");
  1103.         newHeader = elementArray[1] @ " " @ fromdate(time()) @ " remote from " @ elementArray[0];
  1104.         }
  1105.  
  1106.     prepend_header(">From", ">From", newHeader);
  1107.         
  1108. }
  1109.  
  1110. function usefuldomain() {
  1111. var dom = domain();
  1112.   dom = substitute(dom, "^\.", "");
  1113.   return dom;
  1114. }     
  1115.  
  1116.  
  1117. Also see section M21 for a rewrite function for changing the
  1118. Return-Path: mail header.
  1119.  
  1120.  
  1121. Subject: M15.4) Customizing /etc/mail/mailsurr (/usr/lib/mail/mailsurr.proto)
  1122.  
  1123.  
  1124. To customize the /etc/mail/mailsurr file and make the changes
  1125. permanent you need to make the changes to the file 
  1126. /usr/lib/mail/mailsurr.proto.
  1127.  
  1128. Some example changes are below:
  1129.  
  1130. To see mail to the address "novell.co.uk" as local when the nodename is
  1131. mailgate.novell.co.uk add the following entry to /etc/mail/mailcnfg
  1132.  
  1133. %d=novell.co.uk
  1134.  
  1135. Add the following line to /usr/lib/mail/surrcmd/ (just after the ACCDOM
  1136. line in Part 2 and before the mailalias line)
  1137.  
  1138. '.+'    '([^@]+)@%d'            'Translate R=\\1'  
  1139.  
  1140. To do this change in a more generic manner add a capital D to the NODOT entry
  1141. in mailsurr.proto. (The NODOT was a typo)
  1142.  
  1143.  
  1144. An alternate to adding %d into the mailcnfg is to put the explicit
  1145. line in the mailsurr.proto file; for example:
  1146.  
  1147.  
  1148. '.+'    '([^@]+)@(uel.co.uk)'            'Translate R=\\1'   # our old domain
  1149.  
  1150.  
  1151. Subject: M15.5) Setting up delivery lines to mail-servers, list-processors 
  1152.                 etc (mailsurr.proto)
  1153.  
  1154.  
  1155. Entries can also be added to setup special delivery lines into
  1156. programmes such as the mail-server.
  1157.  
  1158. Add the entry in part 3 after the ckbinarsys line:
  1159.  
  1160. '.+'    'mail-server'   '<      /opt/lib/mserv/listener'
  1161.  
  1162.  
  1163. Subject: M15.6) Activating mail logging 
  1164.  
  1165. You won't get too far without being able to determine whats
  1166. going on. The command to switch mail logging on follows:
  1167.  
  1168. /usr/lib/mail/surrcmd/createSurr -l on
  1169.  
  1170.  
  1171. Subject: M15.7) Setting up suitable defaults for mailx users
  1172.  
  1173.  
  1174. Edit the file /etc/mail/mailx.rc and add some suitable site
  1175. defaults:
  1176.  
  1177.  
  1178. set autoprint askcc bang crt=20 dot showto
  1179. set metoo cmd=/opt/bin/mailPR page hold
  1180. set sendmail=/bin/rmail
  1181. set from
  1182.  
  1183. ignore Message-Id Received Status Content-Type Content-Length Default-Options Auto-Forwarded-From Auto-Forward-Count 
  1184.  
  1185.  
  1186. Subject: M15.8)  If you have local users, then add other mail-user agents : 
  1187. for example, mush, elm, pine etc
  1188.  
  1189. If you are using the version of Elm from the mail-server, system
  1190. wide defaults are contained in /opt/lib/elm/elm.rc, a sample is below
  1191. for our site.
  1192.  
  1193. ## /opt/lib/elm/elm.rc -- system wide defaults for elm
  1194.  
  1195. ## default hostname to override uname in From: line
  1196. ## for example.
  1197. ##   hostname = uel.co.uk
  1198. ## If not set, the From: line defaults to the uname
  1199. ## hostname = uel.co.uk
  1200. hostname = novell.co.uk
  1201. hostdomain = novell.co.uk
  1202. hostfullname = novell.co.uk
  1203.  
  1204. ## weedout unwanted mail headers
  1205. weedout via Default-Options Auto-Forwarded-From Auto-Forward-Count X-Nvlenv-01DL-Expanded Original-Content-Type Content-Type Content-Length X-Nvlenv-01Date-Transferred X-Nvlenv-01Date-Posted References
  1206.  
  1207.  
  1208. Subject: M15.9) Update /etc/profile
  1209.  
  1210.  
  1211.         EDITOR=vi
  1212.         postmark="`grep '^'$LOGNAME':' /etc/passwd | cut -d: -f5`"
  1213.         ORGANIZATION="Novell Europe."
  1214.         export EDITOR postmask ORGANIZATION
  1215.  
  1216. Subject: M15.10) Setting up smart routing between uucp and internet zones
  1217.  
  1218. As a mail gateway that has both uucp connections and an internet
  1219. connection we need to be able to smart route between the zones.
  1220. A utility called pathrouter is provided with UnixWare 2 to enable
  1221. this.
  1222.  
  1223. To enable the pathrouter utility, find the lines beginning
  1224. <PATHS> in mailsurr.proto :
  1225.  
  1226. <PATHS> # Reroute using pathrouter.
  1227. <PATHS> #
  1228. <PATHS> '.+' '[^@]+' 'Translate R=|/usr/lib/mail/surrcmd/pathrouter %n'
  1229. <PATHS>                                                                 
  1230.  
  1231. And change these to:
  1232.  
  1233. # Reroute using pathrouter.
  1234. #
  1235. #'.+' '[^@]+' 'Translate R=|/usr/lib/mail/surrcmd/pathrouter %n'
  1236. '.+'    '.*[!@].*'              'Translate T=1;B=*; R=|pathrouter -p' '%n'
  1237.  
  1238.  
  1239. Also add a uucp delivery line (before or after the smtp delivery
  1240. lines depending on your preference)
  1241.  
  1242. #Added for pathrouter
  1243. '.+'    '!([^!]+)!(.+)'         '< B=1024; uux -r -a %R -p -- \\1!rmail' '(\\2)'
  1244.  
  1245. #before <UUCP>
  1246.  
  1247. One thing I also found was to comment out calls to localmail in mailsurr.proto.
  1248.  
  1249. Install paths routing database in /etc/uucp/paths
  1250.  
  1251. Subject: M15.11) Add a rule to mailsurr.proto to catch mail to unknown local users.
  1252.  
  1253. # mailgate setup:
  1254. # This rule included for catching email sent to an unknown local user.
  1255. # This combined with  the use of pathrouter allows unknown local mail
  1256. # to be sent to user@uknown which pathrouter expands to postmaster and the
  1257. # unknown address so an error mesg still gets sent to the originator.
  1258. '.+'    '[^!@]+'                'Translate T=1;B=*; R=|localmail -p -S @unknown' '%n'
  1259.  
  1260. In /etc/uucp/paths add:
  1261.  
  1262. unknown !windsor!postmaster %s  0
  1263.  
  1264. (Note windsor is where the postmast mailbox lives)
  1265.  
  1266. For localdelivery to postmaster this would simply be:
  1267.  
  1268. unknown postmaster %s   0
  1269.  
  1270. Subject: M15.12) Setup uucp over the connection server for  uucp over
  1271. the network (rather than dialup uucp)
  1272.  
  1273. Edit /etc/uucp/Systems.tcp, add entries:
  1274.  
  1275. usl Any CS - -,listen:10103
  1276. usle Any CS - -,listen:10103
  1277. waterloo Any CS - -,listen:10103
  1278. carrera Any CS - -,listen:10103
  1279. marlow Any CS - -,listen:10103  
  1280.  
  1281. Edit /etc/uucp/Devices; enable CS - - - CS entry
  1282.  
  1283. Edit /etc/uucp/Permissions
  1284.  
  1285.  
  1286. Subject: M15.13) Setup mail alias files
  1287.  
  1288. Typically, you will want to edit /etc/mail/namefiles and add any filenames
  1289. that you wish to contain your mailing lists. See section M9 for
  1290. examples.
  1291.  
  1292. Subject: M15.14) Install an alternate incoming smtpd so that incoming
  1293. mail connections can be controlled using the TCP/SPX wrappers.
  1294.  
  1295. (see M17 for further details)
  1296.  
  1297. Subject: M15.15) Install the TCP/SPX wrappers so as to monitor who is 
  1298.                 connecting.
  1299.  
  1300. If you're paranoid (or security conscious) and want to keep logs of who is 
  1301. connecting to your machine, install the TCP/SPX wrappers. If you're
  1302. on the internet you should consider installing this package or the
  1303. netacl's from the TIS Firewall Toolkit in order to control access
  1304. to all TCP services.
  1305.  
  1306.  
  1307. Subject: M15.16) An example /usr/lib/mail/mailsurr.proto for this configuration
  1308.  
  1309. The example /usr/lib/mail/mailsurr.proto for this configuration
  1310. is attached, this version has much of the original entries removed
  1311. to just those needed for this configuration.
  1312.  
  1313.  
  1314.  
  1315. #comment ^A
  1316. ####
  1317. #### Part 1
  1318. ####
  1319. #### Accepts and Denies should go here
  1320. ####
  1321.  
  1322. # Prevent all shell meta-characters
  1323. #
  1324. '.+'    '.*[`;&|^<>()].*'       'Deny No Shell Metacharacters'
  1325. '.+'    '!*#.*'                 'Deny No Shell Metacharacters'
  1326.  
  1327.  
  1328. ####
  1329. #### Part 2
  1330. ####
  1331. #### Address translations should go here.
  1332. #### Do the appropriate mapping between various addressing schemes.
  1333. #### All remote mail should leave this section in RFC822 format
  1334. ####
  1335.  
  1336. # Collapse bang address loops that go through two or more hops
  1337. #
  1338. '.+'    '[^!@%]+![^@%]+![^@%]+' 'Translate T=1;B=*; R=|/usr/lib/mail/surrcmd/uucollapse' '%n'
  1339.  
  1340. # mailgate setup:
  1341. # Strip off local routes to domain, local.domain, uname, uname.alternate
  1342. # note the %d is for alternate domain names
  1343. #'.+'     '@(%d)[:,](.+)'     'Translate R=\\2'
  1344. '.+'     '@(%DNODOT)[:,](.+)'     'Translate R=\\2'
  1345. '.+'     '@(%L%D)[:,](.+)'     'Translate R=\\2'
  1346. '.+'     '@(%U)[:,](.+)'     'Translate R=\\2'         
  1347.  
  1348. # Reroute using pathrouter.
  1349. #
  1350. # mailgate setup:
  1351. # Comment line out and add batched version
  1352. #'.+' '.*[!@].*' 'Translate T=1;B=*;R=|/usr/lib/mail/surrcmd/pathrouter -p %n'
  1353. #'.+'   '([^@,:]+)@(.+)'        'Translate T=1;B=*; R=|/usr/lib/mail/surrcmd/pathrouter -p' '%n'
  1354. '.+'    '.*[!@].*'              'Translate T=1;B=*; R=|pathrouter -p' '%n'
  1355.  
  1356. # If you have a flat name space across multiple machines, but user-names only
  1357.         
  1358. # Map domain-routed domain addresses. That is, map all names of
  1359. # the form domain1!... -> @domain1[,@domain2]*:user@domain3 
  1360. #
  1361. # mailgate setup:
  1362. # Comment this line out as pathrouter likes to do routes ala
  1363. # !sitea!full.domain!user and this rewrites that format.
  1364. #'.+'   '(.+)!([^!:]+)!([^!:]+)'        'Translate R=!\\1:\\3@\\2'
  1365. '.+'    '(.*)!([^!:]+):(.+)'    'Translate R=\\1,@\\2:\\3'
  1366. '.+'    ',@(.+)'        'Translate R=@\\1'
  1367.  
  1368. # Map all names of the form host!user -> user@host
  1369. # The default is to give @ precedence over anything else.
  1370. # ! and @ may not be present in the same address
  1371. #
  1372. '.+'    '([^!]*)!([^!]+)'       'Translate R=\\2@\\1'
  1373.  
  1374. # Map all names of the form user%host (without any other @) -> user@host
  1375. #
  1376. '.+'    '([^@]*)%%([^@%]+)'     'Translate R=\\1@\\2'
  1377.  
  1378. # Map all names of the form host.local-domain!user -> host!user
  1379. #       (host must not have a . in it)
  1380. #
  1381. '.+'    '([^@]+)@([^.]+)'       'Translate R=\\1@\\2%D'
  1382. '.+'    '@([^.,:]+)([,:].+)'    'Translate R=@\\1%D\\2'
  1383.  
  1384. # Map all names of the form user@local-machine -> user
  1385. # Map all names of the form user@uname -> user
  1386. # Then loop back through from the top.
  1387. #
  1388. '.+'    '([^@]+)@%L%D'          'Translate R=\\1'
  1389. '.+'    '([^@]+)@%U%D'          'Translate R=\\1'
  1390. # mailgate setup:
  1391. # Accept mail to %DNODOT for local delivery
  1392. '.+'    '([^@]+)@%DNODOT'               'Translate R=\\1'
  1393. # Accept mail to alternate domains as local, i.e. our old address
  1394. '.+'    '([^@]+)@%d'            'Translate R=\\1'
  1395. '.+'    '([^@]+)@(uel.co.uk)'           'Translate R=\\1'
  1396.  
  1397. # Run all (apparently) local names through the mail alias processor.
  1398. # This version uses mailalias.alt which is the 1.x version
  1399. #
  1400. '.+'    '.+'                    'Translate T=1;B=*; R=|/usr/lib/mail/surrcmd/mailalias.alt -P%L! -P%U! -P%L\%D! -P%U\%D! -S@%U\%D -S@%L\%D -S@%L -S@%U -r -p' '%n'
  1401.  
  1402. ####
  1403. #### Part 3
  1404. ####
  1405. #### Delivery commands should go here.
  1406. ####
  1407.  
  1408. # Check for binary mail. Uncomment this if you want to use it.
  1409. #
  1410. #'.+'   '!([^!]+)!.+'           '< F=*;C=0; /usr/lib/mail/surrcmd/ckbinarsys -t %C -s \\1'
  1411.  
  1412. # mailgate setup:
  1413. # mail-server, mailing lists and information distribution handling section
  1414. '.+'    'mail-server'   '<      /opt/lib/mserv/listener'
  1415. '.+'    'listproc'      '<S=0;      /home/listserv/catmail -r -f'
  1416. '.+'    'uw-developers'         '<S=0;F=1-255;C=*;  /home/listserv/catmail -L UW-DEVELOPERS -f'
  1417.  
  1418.  
  1419. # If you have a flat name space across multiple machines, but user-names only
  1420. # exist on disjoint machines, this entry will forward any name not known
  1421. # locally off to the given host.
  1422. #
  1423. # mailgate setup: 
  1424. # Comment out these entries as they clash with use of pathrouter
  1425. # by routing the mail off to another machine
  1426. <(!ROUTEMHS||!MHS)&&SMTR&&!CLUSTER>     #'.+'   '[^@]+'                 'Translate T=1;B=*; R=|/usr/lib/mail/surrcmd/localmail -p -S @%X' '%n'
  1427. <(!ROUTEMHS||!MHS)&&SMTR&&CLUSTER>      #'.+'   '[^@]+'                 'Translate T=1;B=*; R=|/usr/lib/mail/surrcmd/localmail -p -S @%X:real' '%n'
  1428. <ROUTEMHS&&MHS> #'.+'   '[^@]+'                 'Translate T=1;B=*; R=|/usr/lib/mail/surrcmd/localmail -p -S @%g%D' '%n'
  1429.  
  1430. # mailgate setup:
  1431. # special delivery to certain hosts goes here
  1432. '.+'    '!(stubai)!(.+)' '< B=4096; /usr/lib/mail/surrcmd/smtpqer -N -f %R -s \\1' '\\2'
  1433. '.+'    '!(usl)!(.+)'           '< H=add_from_header;B=1024; uux -a %R -p -- \\1!rmail' '(\\2)'
  1434. '.+'    '!(windsor)!(.+)'           '< H=add_from_header;B=1024; uux -a %R -p -- \\1!rmail' '(\\2)'
  1435.  
  1436.  
  1437. # The mail transports go here.
  1438. #
  1439. <IP>    # If DNS is not used, use "smtpqer -N". If DNS is used, remove the "-N".
  1440. <IP>    #
  1441. <IP&&DNS&&!(SMTR&&STUP)>        '.+'    '([^@,:]+)@(.+)'        '< B=4096; /usr/lib/mail/surrcmd/smtpqer -f %R -s \\2' '\\1'
  1442. <IP&&DNS&&!(SMTR&&STUP)>        '.+'    '@([^@,:]+)[,:](.+)'    '< B=4096; /usr/lib/mail/surrcmd/smtpqer -f %R -s \\1' '\\2'
  1443.  
  1444. # mailgate setup:
  1445. #Added for pathrouter
  1446. '.+'    '!([^!]+)!(.+)'         '< H=add_from_header;B=1024; uux -r -a %R -p -- \\1!rmail' '(\\2)'
  1447.  
  1448. <UUCP>  '.+'    '([^@,:]+)@(.+)%D'      '< H=add_from_header;B=1024; uux -a %R -p -- \\2!rmail' '(\\1)'
  1449. <UUCP>  '.+'    '@([^@,:]+)%D[,:](.+)'  '< H=add_from_header;B=1024; uux -a %R -p -- \\1!rmail' '(\\2)'
  1450. <SMTR&&!STUP>   
  1451. <SMTR&&!STUP>   ####
  1452. <SMTR&&!STUP>   #### Part 3b
  1453. <SMTR&&!STUP>   ####
  1454. <SMTR&&!STUP>   #### Smarter-host processing
  1455. <SMTR&&!STUP>   ####
  1456. <SMTR&&!STUP>   
  1457. <SMTR&&!STUP>   # If none of the above work, then ship remote mail off to a smarter host.
  1458. <SMTR&&!STUP>   # Make certain that SMARTERHOST= is defined within /etc/mail/mailcnfg.
  1459. <SMTR&&!STUP>   # If there is no smarter host, then routed mail fails here.
  1460. <SMTR&&!STUP>   #
  1461. <SMTR&&!STUP>   '.+'    '@%X.+'                 'Deny Smarter host unreachable'
  1462. <CLUSTER&&SMTR&&!STUP>  '.+'    '(@.+)'                 'Translate T=1; R=@%X:real,\\1'
  1463. <CLUSTER&&SMTR&&!STUP>  '.+'    '([^@].+@.+)'           'Translate T=1; R=@%X:real:\\1'
  1464. <!CLUSTER&&SMTR&&!STUP> '.+'    '(@.+)'                 'Translate T=1; R=@%X,\\1'
  1465. <!CLUSTER&&SMTR&&!STUP> '.+'    '([^@].+@.+)'           'Translate T=1; R=@%X:\\1'
  1466.  
  1467.  
  1468. # mailgate setup:
  1469. # This rule in for catching email sent to an unknown local user.
  1470. # This combined with  the use of pathrouter allows unknown local mail
  1471. # to be sent to user@uknown which pathrouter expands to postmaster and the
  1472. # unknown address so an error mesg still gets sent to the originator.
  1473. '.+'    '[^!@]+'                'Translate T=1;B=*; R=|localmail -p -S @unknown' '%n'
  1474.  
  1475. ####
  1476. #### Part 4
  1477. ####
  1478. #### Postprocessing commands should go here.
  1479. ####
  1480.  
  1481. # Log mail delivery
  1482. #
  1483. # mailgate setup:
  1484. # Install alternate maillogger in /usr/lib/mail/surrcmd/maillog.alt
  1485. # In this example we took the maillog prog from UW1.x and installed
  1486. # that so it logs to a single file rather than a file per day, we prefer
  1487. # it that way.
  1488. <LOG>   #'.+'   '.+'    '> W=1;B=*; /usr/lib/mail/surrcmd/maillog -o /var/mail/:log' '-O %O %R %n %H %l --'
  1489. <LOG>   #'.+'   '.+'    'Errors W=1;B=*; /usr/lib/mail/surrcmd/maillog -o /var/mail/:errors' '-O %O %R %n %H %l --'
  1490. <LOG>   '.+'    '.+'    '> W=1;B=*; /usr/lib/mail/surrcmd/maillog.alt -o /var/mail/:log' '-O %O %R %n %H %l --'
  1491. <LOG>   '.+'    '.+'    'Errors W=1;B=*; /usr/lib/mail/surrcmd/maillog.alt -o /var/mail/:errors' '-O %O %R %n %H %l --'
  1492.  
  1493. Subject: M16) I have UW2 and my inbound smtpd keeps dying. Is there a fix?
  1494.  
  1495. Either upgrade to update2.03, or apply tf2100.tar
  1496. from ftp.sco.com:/UW20
  1497.  
  1498. If these don't work reliably, then an alternative is to use smap/smapd
  1499. from the TIS Firewall toolkit (see the next question on running
  1500. smtpd from inetd on UW2).
  1501.  
  1502. Subject: M17) I have UW2 - smtpd now runs as a daemon - is there a way to run
  1503. it from inetd? Running from inetd makes it more reliable and also
  1504. can be wrapped.
  1505.  
  1506. You can run the smap/smapd programmes from the TIS Firewall Toolkit V1.3
  1507. as replacements for the inbound smtpd. These have been ported
  1508. to UnixWare2 /rmail subsystem - binaries can be found in the
  1509. internet/server/fwtk/smap directory on the Freebird archive.
  1510.  
  1511. smap is a simple incoming smtp daemon invoked from inetd.
  1512. Its job in life is to store incoming mail for processing by
  1513. smapd. It runs chroot'd in the incoming mail spool area.
  1514.  
  1515. smapd reads mail from the incoming spool area, and hands it
  1516. off to the real mail subsystem
  1517.  
  1518. The idea behind this mailer is that smap is simple and understandable
  1519. and robust, and can be run on a firewall - you can also run
  1520. it as a replacement to the stock smtpd daemon if you prefer -
  1521. and this allows you to use tcp wrappers if you wish.
  1522.  
  1523. The files provided on the server with smap contain a new /etc/rc2.d/S81smtp 
  1524. script that auto detects if smapd is in place and runs smapd
  1525. on system startup - this assumes you'll reconfigure
  1526. your inetd to include the smap and restart it.
  1527.  
  1528. If you have the base UW2.01 or UW2.02 with no mailfixes get tf2100.tar
  1529. from ftp.sco.com.
  1530.  
  1531. smap/smapd use syslog for logging, tail -f /var/adm/log/osmlog
  1532.  
  1533. To install 
  1534.  
  1535.         mkdir /opt/etc
  1536.         ln -s /opt /usr/local   # smap/smapd look in /usr/local/etc
  1537.                                 # for netperm-table their config file
  1538.  
  1539.         cp smap smapd netperm-table /opt/etc
  1540.  
  1541.         chmod +rx /opt/etc/smap*
  1542.         chmod 555 /opt/etc/netperm-table
  1543.  
  1544.         mkdir /var/spool/mailq/smapin
  1545.         mkdir /var/spool/mailq/smapin/bad
  1546.  
  1547.         chown smtp:mail /var/spool/mailq/smapin /var/spool/mailq/smapin/bad
  1548.         chmod 700 /var/spool/mailq/smapin /var/spool/mailq/smapin/bad
  1549.         sh /etc/rc2.d/S81smtp stop
  1550.         cp /etc/rc2.d/S81smtp /etc/rc2.d/.S81smtp.orig
  1551.         cp S81smtp /etc/rc2.d/S81smtp
  1552.         sh /etc/rc2.d/S81smtp start
  1553.  
  1554.         
  1555. Edit inetd.conf and add the appropriate lines from the inetd.conf file
  1556.  
  1557. # if using the tcp-wrappers you need the first line 
  1558. #smtp stream tcp nowait  root    /usr/sbin/wrapd  /opt/etc/smap
  1559. smtp stream tcp nowait  root    /opt/etc/smap  /opt/etc/smap
  1560.  
  1561. Restart inetd using kill -HUP {PID}
  1562.  
  1563. where you get {PID} from ps -ef|grep inetd
  1564.  
  1565.  
  1566. Source to smap/smapd and man pages are in 
  1567.  
  1568.         /pub/unixware/usle/internet/server/fwtk
  1569.  
  1570. on ftp.novell.de and ftp.abs.net (/unixware...)
  1571.  
  1572. Subject: M18) I have UW2  and my outbound smtp  does incorrect routing to MX
  1573. record sites and also continually bounces mail when sending
  1574. to an unknown user when it should only bounce once - is there a fix?
  1575.  
  1576. Upgrade to update2.03 or tf2100.tar. 
  1577. Or obtain a replacement outbound smtp (mailupd.smtp
  1578. to replace /usr/lib/mail/surrcmd/smtp) from the Freebird archive.
  1579.  
  1580.  
  1581. Subject: M19) I'm having trouble routing email from my local machine to the net.
  1582. I'm connected to a local internet provider and can run Mosaic etc 
  1583. but can't send email. What do i need to do to make this work?
  1584.  
  1585. Either (1) use them as a SMARTERHOST (for mail forwarding if
  1586. they are agreeable),  by setting
  1587.         SMARTERHOST=ipprovider.domain
  1588. in /etc/mail/mailcnfg
  1589.  
  1590. and  updating the /etc/mail/mailsurr mail configuration file (best to
  1591. back it up first) by the following:
  1592.  
  1593.         su
  1594.         /usr/lib/mail/surrcmd/createSurr
  1595.  
  1596. CreateSurr looks at the system configuration
  1597. and using the /usr/lib/mail/mailsurr.proto file creates a new
  1598. /etc/mail/mailsurr file , in this case it enables a section of the
  1599. mailsurr file to forward all mail to unknown sites to the site
  1600. specified by SMARTERHOST. You may want to make sure that the IP
  1601. address of the site specified by SMARTERHOST is in your /etc/hosts
  1602. files.
  1603.                
  1604. Alternately (2) if you have DNS working  backup /usr/lib/mail/mailsurr.proto
  1605. and then edit it changing the smtpqer lines to remove the -N flag,
  1606. which tells smptqer to do a DNS lookup.
  1607.  
  1608. And then create a new /etc/mail/mailsurr file:
  1609.  
  1610.         su
  1611.         /usr/lib/mail/surrcmd/createSurr
  1612.                                              
  1613. If you create the /etc/mail/mailcnfg file (btw check the manual page for details
  1614. on mailcnfg) the permissions should be  444 bin mail.
  1615. On my UnixWare 1.x machines we have the following.
  1616.  
  1617. SMARTERHOST=usg
  1618. ADD_DATE=true
  1619. ADD_FROM=true
  1620. REMOTEFROM=novell.co.uk
  1621.  
  1622. You should change SMARTERHOST and REMOTEFROM accordingly.     
  1623.                                           
  1624. If you choose to have SMARTERHOST set to a fully qualified domain name
  1625. i.e. usg.novell.com
  1626.  
  1627. Then toggle two lines in part 3 of the /etc/mail/mailsurr to use
  1628. smtp delivery first...
  1629.  
  1630. You'll have something like this in part 3 (for UnixWare 1.x),
  1631.  
  1632. '.+'    '!([^!]+)!(.+)'         '< B=512; uux -a %R -p -- \\1!rmail' '(\\2)'
  1633. '.+'    '!([^!]+)!(.+)'         '< B=4096; smtpqer -N %R \\1' '\\2'
  1634.  
  1635. Swap the two lines around. 
  1636.  
  1637.                              
  1638. Subject: M20)Mail sent to my domain mydom.com does not arrive locally on the
  1639. machine. It gets here but the local mailsystem does not recognise it
  1640. as local.
  1641.  
  1642. The Mail Setup GUI has a button to select to catch mail to the domain
  1643. for local delivery. This activates the NODOT entry in the mailsurr file.
  1644. This in fact should be  DNODOT  (edit /usr/lib/mail/mailsurr.proto and
  1645. change the occurrence of NODOT to DNODOT, re-run createSurr and this
  1646. should work correctly). 
  1647.  
  1648. (Note that this is fixed in update2.03 and tf2100.tar)
  1649.  
  1650. Subject: M20.1) How can I set other mail domains besides my real domain
  1651. to be treated as local?
  1652.  
  1653. If you have multiple domain names that you want to
  1654. receive mail, you can add an entry to /etc/mail/mailcnfg
  1655.  
  1656. %d=myotherdom.com
  1657.  
  1658. Edit /usr/lib/mail/mailsurr.proto
  1659. to create a translation entry in  that file.  The user@domain
  1660. entry is shown below from the mailsurr.proto file:
  1661.  
  1662. # Map all names of the form user@local-machine -> user
  1663. # Map all names of the form user@uname -> user
  1664. # Map all names of the form user@domain
  1665. # Then loop back through from the top.
  1666. #
  1667. '.+'  '(.+)@%L'    'Translate R=\\1'
  1668. '.+'  '(.+)@%U'    'Translate R=\\1'
  1669. '.+'  '(.+)@%d'    'Translate R=\\1'   #This is the added entry for user@domain
  1670.  
  1671. Then run the script /usr/lib/mail/surrcmd/createSurr.
  1672.  
  1673. If mail is coming in via the internet you'll also need to
  1674. setup an MX record for the other domain to tell it to send mail
  1675. to this host.
  1676.  
  1677. Subject: M21) I'm using UnixWare2 and when mail arrives locally the Return-Path:
  1678. header has the format @myprovider:remotedomain!user or @domain:user or
  1679. @domain:user@domain.  Is there someway to put this into normal 
  1680. domain address format?
  1681.  
  1682.  
  1683. The following rewrite function edits the Return-path: header  
  1684. for locally delivered email into normal domain address format. 
  1685. Add the following functions to the file /etc/mail/rewrite.
  1686.  
  1687.  
  1688. function local()
  1689. {
  1690.         fix_return_path();
  1691. }
  1692.  
  1693.  
  1694. function fix_return_path()
  1695. {
  1696.     var hdr;
  1697.     # loop through the headers of this name
  1698.     for (hdr from headers("Return-path"))
  1699.         {
  1700.         if (hdr ~ "@([a-zA-Z0-9.]+):([a-zA-Z0-9.]+)!([a-zA-Z0-9.]+)" )
  1701.             {
  1702.             hdr = gsubstitute(hdr, "@([a-zA-Z0-9.]+):([a-zA-Z0-9.]+)!([a-zA-Z0-9.]+)", "\\3@\\2");
  1703.             }
  1704.         if (hdr ~ "@([a-zA-Z0-9.]+):([a-zA-Z0-9.]+)@([a-zA-Z0-9.]+)" )
  1705.             {
  1706.             hdr = gsubstitute(hdr, "@([a-zA-Z0-9.]+):([a-zA-Z0-9.]+)@([a-zA-Z0-9.]+)", "\\2@\\3");
  1707.             }
  1708.         if (hdr ~ "@([a-zA-Z0-9.]+):([a-zA-Z0-9.]+)" )
  1709.             {
  1710.             hdr = gsubstitute(hdr, "@([a-zA-Z0-9.]+):([a-zA-Z0-9.]+)", "\\2@\\1");
  1711.             }
  1712.         }
  1713. }
  1714.  
  1715.  
  1716. Subject: M22) Large mail alias lists don't seem to work on UnixWare 2. Is this
  1717. a known problem?
  1718.  
  1719. This is a bug. To fix this you need to apply one of the mail updates in 
  1720. section M2.
  1721.  
  1722. An alternative workaround is to use the UnixWare 1.x version of mailalias.
  1723. This loses some functionality , i.e. is not driven off the
  1724. /etc/mail/lookupLibs file and only looks up aliases based
  1725. off the files referenced in /etc/mail/namefiles; but then is
  1726. thus faster.
  1727.  
  1728. I have installed this on my UW2 mail gateway as 
  1729. /usr/lib/mail/surrcmd/mailalias.alt
  1730.  
  1731. and adjusted the /usr/lib/mail/mailsurr.proto file as:
  1732.  
  1733. '.+'    '.+'                    'Translate T=1;B=*; R=|/usr/lib/mail/surrcmd/mailalias.alt -P%L! -P%U! -P%L\%D! -P%U\%D! -S@%U\%D -S@%L\%D -S@%L -S@%U -r -p' '%n'
  1734.  
  1735. And then recreated the /etc/mail/mailsurr file with
  1736.  
  1737. /usr/lib/mail/surrcmd/createSurr -l on
  1738.  
  1739. A copy of the UW1.x version of mailalias is on the Freebird archive
  1740. as mailalias.bin.UW1.Z.
  1741.  
  1742. Subject: M23) smtp mail to hosts which only have MX records and no valid A 
  1743. records never gets there? This is with the 2.0 developer release.
  1744.  
  1745. This is  a bug fixed in the 2.01 version of smtpd. Update to 2.01,2.02 or 2.03
  1746. or apply tf2100.tar.
  1747.  
  1748.  
  1749. Subject: M24) How do I make the mailsystem send mail for local addresses off
  1750. to another host if they are not found locally without setting up
  1751. aliases?
  1752.  
  1753. Enable the following line in the mailsurr file, replacing the HOST.DOMAIN
  1754. field by the appropriate values.
  1755.  
  1756. # If you have a flat name space across multiple machines, but user-names only
  1757. # exist on disjoint machines, this entry will forward any name not known
  1758. # locally off to the given host.
  1759. #
  1760. #'.+'   '[^!@]+'                'Translate T=1;B=*; R=|localmail -p -S @HOST.DOMAIN' '%n'
  1761.  
  1762.  
  1763. Subject: M25) How can I get mailx/dtmail to add fullname information to 
  1764. the From: line?
  1765.  
  1766. UnixWare rmail/mail adds additional information to the From: line based
  1767. on the postmark environment variable. On our systems we typically
  1768. add the following to /etc/profile:
  1769.  
  1770.         postmark="`grep '^'$LOGNAME':' /etc/passwd | cut -d: -f5`"
  1771.         export postmark
  1772.  
  1773. Subject: M26) How can I set all the From: line  (hiding the internal hosts to a 
  1774. mail domain)?
  1775.  
  1776. This can be done either in the mail user agent , that is mailx, dtmail ,
  1777. elm or mush , which are described here , or alternately using the
  1778. rewrite rules in /etc/mail/rewrite (only in UnixWare 2 - see question
  1779. M15 section 3 for details on this feature).
  1780.  
  1781. ==>mailx/dtmail:
  1782.  
  1783. In your .mailrc for mailx,dtmail
  1784.  
  1785. set  postmark="myname@my.domian (My Fullname)"
  1786.  
  1787. From the mailx man page:
  1788.  
  1789.              postmark=string
  1790.                    The specified string is included in the comment field of
  1791.                    the From: header of messages that you send.  The string
  1792.                    is usually set to your name.  See from and translate.
  1793.                    If the string includes an @, it will be used for the
  1794.                    entire From: header.         
  1795.  
  1796. ==>For elm, edit /opt/lib/elm/elm.rc
  1797.  
  1798.  
  1799. ## /opt/lib/elm/elm.rc -- system wide defaults for elm
  1800.  
  1801. ## default hostname to override uname in From: line
  1802. ## for example.
  1803. ##   hostname = uel.co.uk
  1804. ## If not set, the From: line defaults to the uname
  1805. ## hostname = uel.co.uk
  1806. hostname = my.domain
  1807. hostdomain = my.domain
  1808. hostfullname = my.domain
  1809.  
  1810. ==>For mush
  1811.  
  1812. in your system mushrc file
  1813.  
  1814. set hostname=my.domain
  1815.  
  1816. Subject: M27) I want to setup a cluster of machines, with a single mail
  1817. gateway machine.
  1818.  
  1819. (for UW1) Use the sample files client.mailcnfg and client.mailsurr to
  1820. make the internal hosts forward all mail to the gateway. And then
  1821. just configure the mail gateway to be a smarthost for mail.
  1822.  
  1823. On UnixWare 2 setup a client machine with the GUI so that all
  1824. mail is forwarded to a smarter host - which can be your local
  1825. email gateway. Copy the resulting /etc/mail/mailsurr and /etc/mail/mailcnfg
  1826. files - install on each machine in the cluster - and edit S81smtp so
  1827. as not to call createSurr and rewrite the /etc/mail/mailsurr file on
  1828. each reboot.
  1829.  
  1830.  
  1831. Subject: M28) How can i make bounced email go to the postmaster if the user
  1832. address is invalid?
  1833.  
  1834. We use the pathrouter tool and an entry in /etc/mail/mailsurr to
  1835. enable this (pathrouter is available by ftp from ftp.novell.de:/pub/
  1836. unixware/usle/hints/Mail).
  1837.  
  1838. We map all unknown user-names to the site unknown!username
  1839.  
  1840. # map unknown local users to unknown!user
  1841. '.+'    '[^!@]+'                'Translate T=1;B=*; R=|localmail -p -S @unknown' '%n'
  1842.  
  1843. In /etc/uucp/paths unknown is mapped to
  1844.  
  1845. unknown !postmaster %s  0
  1846.  
  1847. This way the originator and the postmaster get a bounced copy.
  1848.  
  1849. A simpler way just to send the message to the postmaster follows:   
  1850. '.+'    '[^!@]+'                'Translate T=1;B=*; R=postmaster'
  1851.  
  1852.  
  1853. You should add these lines to the /usr/lib/mail/mailsurr.proto file
  1854. before part 4 (postprocessing commands),
  1855. and use the command /usr/lib/mail/surrcmd/createSurr to create a new
  1856. mailsurr file (best to backup your existing mailsurr file first).
  1857. CreateSurr looks at the system configuration
  1858. and using the /usr/lib/mail/mailsurr.proto file creates a new
  1859. /etc/mail/mailsurr file .
  1860.                                
  1861. Subject: M29) How can i debug mail delivery?
  1862.  
  1863. There are two commands you can execute to see whats happening:
  1864.  
  1865. /bin/mail -d address
  1866. message
  1867. <ctrl-d>
  1868.  
  1869. Will show you a short list of translations and delivery commands
  1870. (and will deliver the message).
  1871.  
  1872. /bin/mail -T "" address
  1873.  
  1874. will show you in gorey detail the translations taken from the
  1875. default mailsurr file.  This can be used to determine whether a problem 
  1876. can be isolated to the address translation. 
  1877.  
  1878. Subject: M30) How can i debug the /etc/mail/rewrite rules?
  1879.  
  1880. Set the following environment variable:
  1881.  
  1882. MAILR_DEBUG=10
  1883. export MAILR_DEBUG
  1884.  
  1885. /bin/mail -d email-address
  1886. msg
  1887. <ctrl-d>
  1888.  
  1889. This lets you see what the rewrite rules are doing.             
  1890.  
  1891. Subject: M31)How can I use the rewrite rules to rewrite a To: header
  1892. of the format uunet!domain!user to user@domain?
  1893.  
  1894. Add a call to the function fix_to_line() in the main() function of 
  1895. /etc/mail/rewrite so this is called for remote mail delivery.
  1896.  
  1897. function main()
  1898. {
  1899.         ...
  1900.         fix_to_line("To");
  1901. }
  1902.         
  1903. function fix_to_line(var hdrname)
  1904. {
  1905.     var hdr;
  1906.     # loop through the headers of this name
  1907.     for (hdr from headers(hdrname))
  1908.         {
  1909.         # if the header has uunet!domain!user in it
  1910.         if (hdr ~ "uunet!([a-zA-Z0-9.]+)!([a-zA-Z0-9.]+)" )
  1911.             {
  1912.             # then convert !uunet!domainr!user to user@domain
  1913.             hdr = gsubstitute(hdr, "uunet!([a-zA-Z0-9.]+)!([a-zA-Z0-9.]+)", "\\2@\\1");
  1914.             }
  1915.         }
  1916. }          
  1917.  
  1918.  
  1919.  
  1920. Subject: M32) I have  tcp installed yet i only want to do transfers over 
  1921. uucp. How do i make the mailsurr file exclude the smtpqer delivery lines?
  1922.  
  1923. Comment out the smtpqer entries in the /usr/lib/mail/mailsurr.proto and 
  1924. execute /usr/lib/mail/surrcmd/createSurr to eliminate the smtp delivery command.  
  1925.  
  1926. Subject: M33) I'm sending to a SCO system over uucp which only understands 
  1927. RFC822. The UnixWare mailsystem inserts an extra From line which upsets the SCO 
  1928. mailer.
  1929.  
  1930. (for UW1)
  1931.  
  1932. To have the From line stripped when sending mail via UUCP 
  1933. an I=1; would need to be prepended to  the uux delivery command lines in the 
  1934. mailsurr.proto file, otherwise the mail will bounce because of this 
  1935. postmark line. Then execute /usr/lib/mail/surrcmd/createSurr to update the
  1936. /etc/mail/mailsurr file.
  1937.  
  1938. Subject: M34) Where are outgoing messages stored for smtp?
  1939.  
  1940. (for UW1)All outgoing mail messages for SMTP are located in /var/spool/smtpq 
  1941. under the domain/host directories.
  1942.  
  1943. (for UW2) Mail msgs are now stored in /var/spool/mailq .
  1944.  
  1945. Subject: M35) Mail is bouncing back with problems about an invalid 
  1946. From header line, what should I do?
  1947.  
  1948. (for UnixWare 2.0x)
  1949. Please apply patch tf2100.tar. This symptom is often seen
  1950. when communicating with Microsoft Mail or cc:Mail.
  1951.  
  1952. (UW1 only)
  1953. Edit the mailsurr.proto file and either insert or
  1954. remove the I=1; field of the smtpqer delivery command line 
  1955. entries as shown below:
  1956.  
  1957. <IP&&!DNS&&!(SMTR&&STUP)>  '.+'  '([^@,:]+)@(.+)'  '< I=1;B=4096; smtpqer -N -u %R \\2' '\\1@\\2'
  1958. <IP&&!DNS&&!(SMTR&&STUP)>  '.+'  '@([^@,:]+)[,:](.+)'  '< I=1;B=4096; smtpqer -N -u %R \\1' '\\2'
  1959. <IP&&!DNS&&SMTR&&STUP>  '.+'  '([^@,:]+)@(.+)'  '< I=1;B=4096; smtpqer -N -u %R %X' '\\1@\\2'
  1960. <IP&&!DNS&&SMTR&&STUP>  '.+'  '(@[^@,:]+[,:].+)'  '< I=1;B=4096; smtpqer -N -u %R %X' '\\1'
  1961. <IP&&DNS&&!(SMTR&&STUP)>  '.+'  '([^@,:]+)@(.+)'  '< I=1;B=4096; smtpqer -u %R \\2' '\\1@\\2'
  1962. <IP&&DNS&&!(SMTR&&STUP)>  '.+'  '@([^@,:]+)[,:](.+)'  '< I=1;B=4096; smtpqer -u %R \\1' '\\2'
  1963. <IP&&DNS&&SMTR&&STUP>  '.+'  '([^@,:]+)@(.+)'  '< I=1;B=4096; smtpqer -u %R %X' '\\1@\\2'
  1964. <IP&&DNS&&SMTR&&STUP>  '.+'  '(@[^@,:]+[,:].+)'  '< I=1;B=4096; smtpqer -u %R %X' '\\1'
  1965.  
  1966. In cases where internet mail is coming in, and forwarded out via uucp, 
  1967. the I=1; field must be removed, otherwise the From line containing the 
  1968. user name and date will be stripped prior to sending the message off via 
  1969. uucp or uux.
  1970.  
  1971. NOTE:  It is advisable to remove the -B option of the smtpqer entries in the 
  1972. mailsurr.proto file to eliminate the need for batch processing.
  1973.  
  1974. Execute /usr/lib/mail/surrcmd/createSurr to update the /etc/mail/mailsurr 
  1975. file and re-test the mail once again.
  1976.  
  1977. Subject: M36) After changing the system owner to another user and 
  1978. deleting the original user, mail is still being sent to the original 
  1979. system owner for example when a new package is installed, 
  1980. and errors stating "unable to send to " appear after adding a package.
  1981.  
  1982.  
  1983. This is caused since the files
  1984.  
  1985. /var/sadm/install/admin/check and 
  1986. /var/sadm/install/admin/default contain a line 
  1987. "mail=username username2 etc.  
  1988.  
  1989. These files do not get updated when some users are deleted from the system.
  1990. The fix is to manually take out the names of the non existing user 
  1991. from the mail= line in /var/sadm/install/admin/check and 
  1992. default.
  1993.  
  1994. Subject: M37) Why when I send local mail does my PPP link get established, for
  1995. example when I pkgadd or pkgrm a package?
  1996.  
  1997. On UnixWare 2 this is triggered by the mailalias program.
  1998. There is a file in /etc/mail called lookupLibs (built from
  1999. /usr/lib/mail/lookupLibs.proto) that contains references to shared
  2000. libraries used to lookup aliases.  By default if you have DNS defined
  2001. in your mailflgs file, mailalias will connect to your name server to
  2002. ask it about aliases.  To work around this just comment out the <DNS> line
  2003. /usr/lib/mail/lookupLibs.proto and /etc/mail/lookupLibs. 
  2004.  
  2005. Subject: M38) Is it possible to change the sender address with 
  2006. mailsurr's translation facilities?  The man page indicates 
  2007. that only the recipient address can be changed.  
  2008. Am I going to have to move to sendmail?
  2009.  
  2010. Not necessary. Its possible but not elegant in UW 1.x, in 2.0 there
  2011. is now a file /etc/mail/rewrite which allows you to specify rewrite
  2012. rules for mail headers.  What I do for UW1.x is below:
  2013.  
  2014.  
  2015. For UW.1x I basically replace the delivery command with a script that
  2016. edits the mail header using sed and then pipes the edited message into
  2017. what would have been the delivery command (i.e. uux or smtp).
  2018.  
  2019. Example 1:
  2020.  
  2021. For example the next mailsurr line is for fixing some strange From:
  2022. lines coming from a Dos mailer which has a From: line of the format
  2023. domain(full name) user , fixing them to domain!user format. ( the example
  2024. below works just for mail from
  2025. site nwc-uk.ukb.novell.com to host windsor)
  2026.  
  2027. # rewrite the mail header
  2028. # s/nwc-uk.ukb.novell.com/novell/
  2029. 'nwc-uk.ukb.novell.com!.*'      '!(windsor)!(.+)'               '<B=1024;S=0;F=*; /%w/headerfix -a %R -p -- \\1!rmail' '(\\2)'
  2030.  
  2031. The headerfix command is located in /usr/lib/mail/surrcmd/headerfix
  2032.  
  2033. #!/bin/sh
  2034. # headerfix script
  2035. /bin/cat -| /bin/sed -f /usr/lib/mail/surrcmd/headfix.sed|/usr/bin/uux  $*
  2036. exit 0
  2037.  
  2038.  
  2039. Where /usr/lib/mail/surrcmd/headfix.sed contained the substitution
  2040. regular expression
  2041.  
  2042. s/\(From: nwc-uk.ukb.novell.com\)(.*!\(.*\)[         ].*)/From: nwc-uk.ukb.novell.com!\2/
  2043.  
  2044.  
  2045. Example 2:
  2046.  
  2047. Another example is where we use a script to remove some of the delivery
  2048. lines , in this case all mail to usle has some mail headers stripped,
  2049. note that this machine is a mailhub internal to our cluster
  2050.  
  2051.  
  2052. '.+'    '!(usle)!(.+)'          '< B=4096; /%w/hidesmtp -u %R \\1' '\\2'
  2053.  
  2054.  
  2055. #!/bin/sh
  2056. #set -x
  2057. /bin/cat -| /bin/sed -f /usr/lib/mail/surrcmd/hidesmtp.sed|/usr/lib/mail/surrcmd/smtpqer $*
  2058.  
  2059.  
  2060. Where /usr/lib/mail/surrcmd/hidesmtp.sed is:
  2061.  
  2062. 1d
  2063. 2s/^>From/From/
  2064. /^Received: from novell.co.uk/d
  2065. /^$/,$s/^From />From /
  2066.  
  2067. For UnixWare 2.x we add functions to the file /etc/mail/rewrite
  2068.  
  2069.  
  2070.  
  2071. Subject: M39) How do I setup a POP3 server on UnixWare ?
  2072.  
  2073.  
  2074. The POP server is included in UW2 in /usr/lib/mail/surrcmd/popper,
  2075. however there's a problem with truncation of the last mail
  2076. message with that version.
  2077.  
  2078. Either pick up tf2100 from ftp.sco.com:/UW20
  2079.  
  2080. or get one of the freeware versions from ftp.abs.net|ftp.novell.co.uk
  2081. in /pub/unixware/freebird/mailtools/popper  (source and binaries
  2082. available).
  2083.  
  2084. To make operational, you need to do the following:
  2085.  
  2086.  (i) edit /etc/services, ensure there is an entry
  2087.  
  2088. pop3            110/tcp                         # Post Office
  2089.  
  2090.  (ii) edit /etc/inetd.conf, add an entry
  2091.  
  2092.  pop3   stream  tcp     nowait  root    /replace_with_Path_to_popper/popper             popper
  2093.  
  2094.  (iii) Restart inetd, by sending a kill -HUP to the inetd PID.
  2095.  
  2096.  
  2097. Subject: M40) I'm using UnixWare 1.x and  I can't find the createSurr command, 
  2098. what should i do?
  2099.  
  2100. [This section below is UnixWare 1.x specific for folks who did not
  2101.  install the nuc package]
  2102.  
  2103. The createSurr command is in the nuc package in UnixWare 1.x.
  2104. There is a package on the Freebird archive containing only
  2105. the additional mail tools provided in the nuc package, that is
  2106. createSurr (note that you'll have to add a copy of perl yourself ) - 
  2107. the package is mailproto.tar.Z - the readme file is attached below:
  2108.  
  2109. mailproto version 1.0
  2110.  
  2111. Copyright 1993-1995 Novell, All Rights Reserved.
  2112.  
  2113. This software is provided "as is" and without any expressed or implied
  2114. warranties, including, without limitation, the implied warranties of
  2115. merchantibility and fitness for any particular purpose. 
  2116.  
  2117. This version for UnixWare 1.x.
  2118.  
  2119. This package contains the minimal mailtools for auto configuration of
  2120. the mail subsystem - these are normally contained in the nuc package.
  2121.  
  2122. DO NOT INSTALL THESE IF YOU ALREADY HAVE THE NUC PACKAGE INSTALLED OR
  2123. ARE RUNNING UNIXWARE 2!
  2124. (the package checks this and will not install over the nuc package)
  2125.  
  2126. YOU WILL ALSO NEED TO INSTALL A COPY OF PERL.
  2127. These scripts expect to find a copy of perl in /usr/gnu/bin/perl.
  2128. If you have perl installed elsewhere edit the first line of the
  2129. perl scripts to point to the correct location.
  2130.  
  2131. For information on how to setup the mail subsystem see
  2132.         hints/Mail/README
  2133.         hints/Mail/Howto_setup
  2134. from the mail-server archive.
  2135.  
  2136. The files installed by this package are:
  2137.  
  2138. /usr/lib/mail/mailsurr.proto - a prototype mailsurr file 
  2139.  
  2140. /usr/lib/mail/surrcmd/createSurr - command to generate mailsurr file
  2141. /usr/lib/mail/surrcmd/configCheck - subsidiary command used by createSurr
  2142. /usr/lib/mail/surrcmd/configMail - subsidiary command used by createSurr
  2143. /usr/lib/mail/surrcmd/getDomain - subsidiary command used by createSurr
  2144.  
  2145.  
  2146. To install the package the simplest way follows:
  2147.  
  2148. 1. Extract the tar archive. 
  2149.  
  2150. $ cd /tmp
  2151. $ su
  2152. # tar xvf mailproto.tar
  2153.  
  2154. 2. Installing the package
  2155.  
  2156.  
  2157.         pkgadd -d `pwd`
  2158.  
  2159.  
  2160. 3. Removing the package
  2161.  
  2162. # pkgrm  mailproto
  2163.  
  2164. Subject: M41) How do I setup my mail to be autoanswered?
  2165.  
  2166. This is done by using the vacation command.
  2167. To setup the default autoanswering message just type
  2168.  
  2169.         vacation
  2170.  
  2171. For example:
  2172.  
  2173.         $ vacation
  2174.         UX:vacation: INFO: Vacation notification installed
  2175.         UX:vacation: INFO: Logging will go to '/opt/lib/mserv/.maillog'
  2176.         UX:vacation: INFO: '/usr/share/lib/mail/std_vac_msg' will be used for the canned message
  2177.  
  2178. This will cause the system to send the following standard reply:
  2179.  
  2180.         Subject: AUTOANSWERED!!!
  2181.  
  2182.         I am on vacation. I will read (and answer if necessary)
  2183.         your e-mail message when I return.
  2184.  
  2185.         This message was generated automatically and you will
  2186.         receive it only once, although all messages you send
  2187.         me while I am away WILL be saved.
  2188.  
  2189.  
  2190. A list of senders is kept in the file $HOME/.maillog, and
  2191. incoming mail is kept in your normal mailbox by default,
  2192. since the UnixWare mailer keeps the forwarding information in 
  2193. /var/mail/:forward and not in the mailbox file as in earlier SVR4.0 releases.
  2194.  
  2195. If you would prefer to customise the reply, prepare a message in a
  2196. file and then give the filename as an option to the vacation utility,
  2197. for example:
  2198.  
  2199.         vacation -M message
  2200.  
  2201. For example:
  2202.         $ vacation -M Msg     
  2203.         Forwarding to |/usr/lib/mail/vacation2 -o %R -M Msg
  2204.         $
  2205.  
  2206. For example the message might contain (Note: the ``From:'' line is the address
  2207. for folks to reply to -- this should be of the form username@domain_addr, this
  2208. may not be needed if your mail subsystem puts a From: line for you, there
  2209. should be an entry ADD_FROM=true in /etc/mail/mailcnfg if using the default
  2210. mailer [/bin/mail])
  2211.  
  2212.  
  2213.         Subject: AUTOANSWERED!!!
  2214.         From: postmast@novell.co.uk (Postmaster)
  2215.  
  2216.         I am permanently on vacation. I will read (and answer if necessary)
  2217.         your e-mail message when and if  I return, and if I can be bothered.
  2218.  
  2219.         This message was generated automatically and you will
  2220.         receive it only once, although all the messages you send
  2221.         me while I am away WILL be saved.
  2222.  
  2223.         If your mail is really for the attention of somebody else, then why
  2224.         did n't you send it to them in the firstplace :-) Alternately try
  2225.         sysadmin@novell.co.uk :-)
  2226.  
  2227.           -- The Postmaster
  2228.  
  2229.  
  2230. To  read your mail while vacation is in effect:
  2231.  
  2232. You can use your normal mail user agent (elm, mush, mailx or whatever),
  2233. since the UnixWare mailer keeps the forwarding information in 
  2234. /var/mail/:forward and not in the mailbox file as in earlier SVR4.0 releases.
  2235.         
  2236.  
  2237. To remove the vacation facility:
  2238.  
  2239.         /bin/mail -F ""
  2240.  
  2241. or
  2242.         vacation -n
  2243.  
  2244. For example:
  2245.         $ /bin/mail -F ""
  2246.         UX:mail: INFO: Forwarding removed
  2247.         $ 
  2248.  
  2249. Subject: M42) How do I setup my mail to be forwarded?
  2250.  
  2251.  
  2252. To forward all your mail to another person or another mailbox use
  2253. the following command :
  2254.  
  2255. To forward to a single person, e.g.
  2256.  
  2257.         /bin/mail -F andrew
  2258.  
  2259.  
  2260. To forward to more than one person use a quoted string:
  2261.  
  2262.         /bin/mail -F "andrew plord"
  2263.  
  2264. for example:
  2265.  
  2266.  
  2267.         $ /bin/mail -F "andrew plord"
  2268.         UX:mail: INFO: Installing forwarding to local address: andrew
  2269.         UX:mail: INFO: Installing forwarding to local address: plord
  2270.         UX:mail: INFO: Forwarding to andrew plord
  2271.  
  2272. It is also possible to combine a forward with the vacation programme:
  2273.  
  2274. for example
  2275.  
  2276.         
  2277.         $ vacation -M $HOME/.MSG -f andrew
  2278.         UX:vacation: INFO: Vacation notification installed
  2279.         UX:vacation: INFO: Logging will go to '/opt/lib/mserv/.maillog'
  2280.         UX:vacation: INFO: '/opt/lib/mserv/.MSG' will be used for the canned message
  2281.  
  2282. To confirm the forward is in effect, cat the :forward/user-id file:
  2283.  
  2284.         $ cat /var/mail/:forward/mserv
  2285.         Forward to andrew | C=0;S=2;F=*; /usr/lib/mail/vacation2 -o %R -M /opt/lib/mserv/.MSG
  2286.  
  2287. Note that you should not edit the /var/mail/:forward files directly
  2288. else they will loose the correct permissions and email delivery will
  2289. fail.
  2290.  
  2291.  
  2292. Subject: M43) How do I setup a mail-server?
  2293.  
  2294. The mail-server we use at novell.co.uk is the Squirrel mail-server
  2295. version 3.01 . This is written by Johan Vromans and is mainly
  2296. written in perl.
  2297.  
  2298.  
  2299. A binary version ready for use with UW1.x or UW2 is on the
  2300. Freebird archive
  2301. ftp.abs.net:/unixware/freebird/mailtools/mail-server.bin.tar.Z.
  2302.  
  2303. The steps to install this are as follows:
  2304.  
  2305. Create an account mserv, with the home directory rooted in 
  2306. /opt/lib/mserv.  We assume the mail-server archive tree is in
  2307. /home/mserv-archive, if its elsewhere make a symlink.
  2308.  
  2309.         useradd -s /usr/bin/ksh -d /opt/lib/mserv mserv
  2310.         (mkdir /opt/lib if it does not exist)
  2311.         cd /opt/lib
  2312.         zcat mserv.tar.Z|tar xvf -
  2313.         chown -R mserv mserv
  2314.         chown root mserv/listener
  2315.  
  2316. To run the mail-server, you need to install ALL the following packages:
  2317. utils/perl-4.0pl36.pkg.tar, archivers/gzip-1.2.4.pkg.tar,
  2318. utils/gnufind-3.7.pkg.tar.  All these packages are on the
  2319. novell.co.uk mail-server archive.
  2320.  
  2321. You also need to allow  the mserv account to use cron, 
  2322. edit  /usr/lib/cron/cron.allow and add the mserv user.
  2323.  
  2324. To test prior to running out of cron, login as user mserv
  2325.  
  2326.         ./listener -noqueue
  2327.  
  2328. You can then type interactive requests
  2329.  
  2330. Once you are happy, edit the file
  2331.  
  2332.         mserv.hints
  2333.  
  2334.  
  2335. Place the files you want to serve in /home/mserv-archive,
  2336. run some of the indexing commands by hand
  2337.  
  2338.         ./makeindex
  2339.         ./makels
  2340.         ./changes
  2341.  
  2342. Then enable the crons
  2343.  
  2344.         crontab ctab
  2345.  
  2346.  
  2347. Next stage, enable in the mailsubsystem. This can be done
  2348. by editing /usr/lib/mail/mailsurr.proto and editing the following in
  2349. section 3 of the file after the ckbinarsys entry.
  2350.  
  2351. # mail-server, mailing lists and information distribution handling section
  2352. '.+'    'mail-server'   '<      /opt/lib/mserv/listener'
  2353.  
  2354.  
  2355. Then run /usr/lib/mail/surrcmd/createSurr -l on. 
  2356.  
  2357.  
  2358. #       /etc/mail/extaliases
  2359.  
  2360.  
  2361. Then run /usr/lib/mail/surrcmd/createSurr -l on. 
  2362.  
  2363.  
  2364. On the system that the mail-server runs I have a mailbox called
  2365. bit-bucket, which as long as it exists in /var/mail/bit-bucket
  2366. and is mode 660 owner mserv, group mail is used to catch
  2367. all admin mail.
  2368.  
  2369. System aliases are added a file in /etc/mail, /etc/mail/names
  2370.  
  2371. ### Mailserver ###
  2372. # if you want mail to go to real people
  2373. #mserv          plord andrew
  2374. # else put it in a mailbox
  2375. mserv           bit-bucket
  2376.  
  2377. # various typos on mail-server
  2378. mailserv        mail-server
  2379. mailserver      mail-server
  2380. mail_server     mail-server
  2381. mail-serverl    mail-server
  2382. mail-serv       mail-server
  2383. mail-serve      mail-server
  2384. mail-sarver     mail-server
  2385. mailx-server    mail-server
  2386. mailer-server   mail-server
  2387. ftpmail         mail-server
  2388.  
  2389.  
  2390. # various strange things that requestors send, best to dump them in the
  2391. # bit-bucket mailbox
  2392.  
  2393. reply-address   bit-bucket
  2394. your-address-here       bit-bucket
  2395. your-mail-address-goes-here     bit-bucket
  2396. address-to-reply-to     bit-bucket
  2397. your-email-address      bit-bucket
  2398.  
  2399.  
  2400. File Permissions:
  2401.  
  2402. All files except listener can be owned by user mserv.
  2403. listener has to be owned by root and setuid.
  2404.  
  2405.  
  2406. Subject: M44) How do I  setup a mailing list - such as Listproc ?
  2407.  
  2408. A port of ListProcessor Version 6.0, Binary distribution for UnixWare
  2409. is available on ftp.novell.de:/pub/unixware/usle/mailtools/listproc.bin.tar.Z.
  2410.  
  2411. Please observe the copyright notice below:
  2412.  
  2413. ListProcessor version 6.0 by Anastasios Kotsikonas, Copyright (c) 1991-93.
  2414. Use, duplication or disclosure by the U.S. Federal Government is subject to the
  2415. restrictions set forth in FAR 52.227-19(c), Commercial Computer Software or,
  2416. for U.S. Department of Defense Users, by DFAR 252.227-7013(c)(1)(ii).  
  2417.  
  2418.  
  2419. Note:
  2420. To make this work with the UnixWare mail subsystem (mailsurr), the
  2421. formail utility from procmail has been used as a front end to
  2422. the ListProcessor catmail utility, to edit the headers etc.
  2423.  
  2424.  
  2425. Installation instructions for this distribution
  2426.  
  2427. (1) Login as root
  2428.  
  2429. If you are running straight UnixWare 2.0 , 2.01 or 2.02
  2430. you need to apply a patch to the smtp subsystem. 
  2431.  
  2432. The supported version can be obtained from
  2433. ftp.sco.com:/UW20/tf2100.tar
  2434.  
  2435.  
  2436. (2) Then install the listproc tools into /home/listserv as follows:
  2437.  
  2438. cd /home
  2439. zcat listproc.tar.Z|tar xvf -
  2440. useradd -d /home/listserv -s /usr/bin/ksh listserv
  2441. chown -R listserv listserv
  2442. vi /usr/lib/cron/cron.allow     append listserv to the end of this file
  2443.  
  2444.  
  2445. (3) Setup the mailaliases etc:
  2446.  
  2447. You need to add entries in the /etc/mail/mailsurr file
  2448. for your mailing lists. This can be done by editing the
  2449. file /usr/lib/mail/mailsurr.proto adding the lines below
  2450. (note xopen-testing is an example) and then running the
  2451. command:
  2452.  
  2453.         /usr/lib/mail/surrcmd/createSurr -l on
  2454.  
  2455.  
  2456. ####
  2457. #### Part 3
  2458. ####
  2459. #### Delivery commands should go here.
  2460. ####
  2461.  
  2462. # Check for binary mail. Uncomment this if you want to use it.
  2463. #
  2464. #'.+'   '!([^!]+)!.+'           '< F=*;C=0; /usr/lib/mail/surrcmd/ckbinarsys -t %C -s \\1'
  2465.  
  2466. # mailgate setup:
  2467. # mail-server, mailing lists and information distribution handling section
  2468. # admin requests
  2469. '.+'    'listproc'      '<S=0;      /home/listserv/catmail -r -f'
  2470. # mailing lists
  2471. '.+'    'xopen-testing'         '<S=0;F=1-255;C=*;  /home/listserv/catmail -L XOPEN-TESTING -f'
  2472.  
  2473.  
  2474. (4) Edit /etc/mail/namefiles and add:
  2475. /etc/mail/listaliases
  2476.  
  2477. This tells mailalias to look in this file for additional aliases.
  2478. Add the following to that list, change the name (andrew)
  2479. as appropriate
  2480.  
  2481. ### Mailing Lists ###
  2482.  
  2483. # who is the overall admin for listproc
  2484. list-admin      andrew
  2485. # if you share this file on multiple machines enable the next line
  2486. # to get the mail to the right machine
  2487. #xopen-testing  lechladel!xopen-testing
  2488. xopen-testing-request   listproc
  2489.  
  2490.  
  2491. (5) Login as user listserv:
  2492.  
  2493. Edit the config file and change values in there as appropriate for
  2494. your configuration.
  2495.  
  2496. The organization line needs changing, as do the lists that
  2497. you define. In this example a list xopen-testing is shown.
  2498. This list requires all subscription requests to be approved
  2499. by the list owner.
  2500.  
  2501. Also in this example the lists are running on a machine called
  2502. lechlade, you want to change all email addresses to be those
  2503. of your mail domain.
  2504.  
  2505. Check out the documentation in the doc directory.
  2506.  
  2507. Lastly when you are ready and feel you have an understanding,
  2508. install a crontab entry .
  2509.  
  2510. Install a cron file to start the server:
  2511.         crontab crontab
  2512.  
  2513.  
  2514. This will start the server.
  2515.  
  2516. To test, send some mail to listproc, and also to xopen-testing.
  2517. It takes a while for the listproc to awake the first time, since
  2518. its only started on the hour, once awake the daemon keeps running.
  2519. Edit the crontab to start the daemon sooner.
  2520.  
  2521. To see where incoming requests go, if you configured the mailer
  2522. correctly, check the file /home/listserv/requests.
  2523.  
  2524. xopen-testing should say you are not subscribed, you can then
  2525. resend and subscribe. Check both the admin mail box and the
  2526. initiator.
  2527.  
  2528.  
  2529. Look at help/general and change the first line as required.
  2530.  
  2531. To add new lists you have to create a set of files in /home/listserv/lists
  2532. in a subdirectory as well as editing /home/listserv/config.
  2533. Check out the doc directory.
  2534.  
  2535.  
  2536. File & Directory Perms in /home/listserv
  2537.  
  2538. A couple of utilities have to be setuid listserv - see below:
  2539.  
  2540.  
  2541. total 4032
  2542. drwxr-xr-x    2 listserv other         96 Apr 12 14:56 News
  2543. drwx------    3 listserv other         96 Apr 12 14:56 arc
  2544. drwx------    5 listserv tech          96 Apr 12 14:55 archives
  2545. -rw-------    1 listserv tech           0 Jan 18  1994 batch
  2546. drwxr-xr-x    2 listserv other         96 Apr 12 14:56 bin
  2547. -rwsr-xr-x    1 listserv other         86 Apr 17 09:10 catmail
  2548. -rwsr-xr-x    1 listserv other     155400 Jan 26  1994 catmail.prog
  2549. -rw-------    1 listserv tech        6745 Feb 14 19:12 config
  2550. -rw-r--r--    1 listserv other         57 Feb 10  1994 crontab
  2551. drwx------    2 listserv tech        1024 Apr 12 14:55 doc
  2552. -rwx------    1 listserv other     175732 Jan 26  1994 farch
  2553. -rw-------    1 listserv tech          84 Jan 18  1994 flocks
  2554. -rwx------    1 listserv other      15208 Jan 26  1994 fwin
  2555. drwxr-xr-x    2 listserv tech          96 Apr 12 14:56 gateway
  2556. drwx------    2 listserv tech        1024 Apr 12 14:56 help
  2557. -rwxr-xr-x    1 listserv other      13892 Jan 26  1994 ilp
  2558. -rwx------    1 listserv other     321880 Jan 26  1994 list
  2559. -rwx------    1 listserv other     424760 Jan 26  1994 listproc
  2560. drwx------   11 listserv tech        1024 Apr 12 14:55 lists
  2561. -rwxr-xr-x    1 listserv other      45208 Jan 18  1994 make
  2562. -rw-r--r--    1 listserv tech         546 Jan 18  1994 makefile
  2563. drwxr-xr-x    4 listserv other         96 Apr 12 14:56 man
  2564. -rw-------    1 listserv other     251796 Jul  6 08:16 mbox
  2565. drwx------    2 listserv tech        1024 Jul 10 18:57 mqueue
  2566. -rwx------    1 listserv tech        1986 Jan 18  1994 news
  2567. -rw-------    1 listserv tech         892 Jul  5 10:18 owners
  2568. -rwx------    1 listserv tech        1888 Jan 18  1994 peer
  2569. -rwx------    1 listserv other     216956 Jan 26  1994 pqueue
  2570. -rwx------    1 listserv tech        1201 Jan 18  1994 queued
  2571. -rwxr-xr-x    1 listserv other        501 Jan 20  1994 rcp
  2572. -rw-------    1 listserv other         57 Jul  6 08:16 received
  2573. -rwx------    1 listserv tech         502 Jan 18  1994 redux
  2574. -rw-------    1 listserv other          0 Jul  6 08:16 requests
  2575. -rwx------    1 listserv other       4808 Jan 26  1994 rev
  2576. -rwxr-xr-x    1 listserv other       7420 Jan 26  1994 semset
  2577. -rw-------    1 listserv other          6 Jul  6 08:16 sent
  2578. -rwxr-xr-x    1 listserv other     172072 Jan 26  1994 serverd
  2579. -rwx------    1 listserv tech        6931 Jan 20  1994 setup
  2580. -rwx------    1 listserv other     169264 Jan 26  1994 start
  2581. -rwx------    1 listserv tech       23389 Jan 18  1994 systest
  2582. -rwx------    1 listserv other      22312 Jan 26  1994 tlock
  2583. -rwx------    1 listserv tech         133 Jan 18  1994 ulock
  2584. -rw-------    1 listserv tech         700 Jan 18  1994 unwanted.hosts
  2585. drwxr-xr-x    2 listserv tech        1024 Apr 12 14:56 util
  2586. -rw-r--r--    1 listserv tech         591 Jan 18  1994 welcome.live
  2587.  
  2588. Subject: M45) How do I  make sendmail the default mailer?
  2589.  
  2590. On UnixWare 2:
  2591.  
  2592. (Step 1). rename /etc/rc2.d/S81smtp to /etc/rc2.d/s81stmp
  2593. (Step 2).  Start sendmail in /etc/inet/config. Like this:
  2594.  
  2595. # The next line can be read:
  2596. # If field 3 is a Y and /usr/sbin/in.gated was not run, then run
  2597. # /usr/sbin/in.routed -q
  2598. 4b:/usr/sbin/in.routed:/usr/sbin/in.gated:Y::-q:
  2599. ###4c:/usr/sbin/route::n::add default router_placeholder 1
  2600. ###6:/usr/sbin/in.xntpd::y:/etc/inet/ntp.conf::
  2601. 7:/usr/bin/sh::y:/etc/inet/rc.inet:/etc/inet/rc.inet start:
  2602. 4c:/usr/sbin/route::y::add default 129.123.1.254 1:
  2603. ## added by JRD
  2604. 8:/usr/ucblib/sendmail::y:/usr/ucblib/sendmail.cf:-bd -q24h:
  2605. 9:/usr/sbin/syslogd::y:/etc/syslog.conf::
  2606.  
  2607.  
  2608. (Step 3). copy the /etc/ucbmail/mailsurr file over the /etc/mail/mailsurr file.
  2609.  
  2610. Note that you should also check the mailtools/sendmail directory
  2611. on the ftp archive since  there's likely to be a binary pkgadd
  2612. version of sendmail there..
  2613.  
  2614. Subject: M46) Mail of the address format @mylocal.domain:user@mylocal.domain 
  2615.               is not delivered locally, how can I fix this?
  2616.  
  2617. You need to add a line to /usr/lib/mail/mailsurr.proto
  2618. as follows:
  2619.  
  2620. After the uucollapse line add:
  2621.  
  2622. '.+'    '@(%DNODOT)[:,](.+)'               'Translate R=\\2'
  2623. '.+'    '@(%L%D)[:,](.+)'               'Translate R=\\2'
  2624. '.+'    '@(%U)[:,](.+)'         'Translate R=\\2'
  2625.  
  2626. Then run
  2627.  
  2628.         /etc/rc2.d/S81smtp stop
  2629.         /etc/rc2.d/S81smtp start            
  2630.  
  2631. Subject: M47) dtmail won't restart after my machine was switched off.
  2632.  
  2633. One of our machines was switched off with a dtmail session active
  2634. and when restarted wont let the user back into mail, saying the mail
  2635. is already being read - any ideas?
  2636.  
  2637. Check /var/mail/:readlock for a file as in username.lock
  2638.  
  2639. Try removing that file. If that does not work and you can't get
  2640. in (due to a kernel lock) move the mailbox in /var/mail aside
  2641. and rename it, then copy it back to the original name (has to be
  2642. done quickly:-)   
  2643.  
  2644. Subject: M48) Inbound mail is addressed to 
  2645.      <@site.demon.co.uk:user@domain.co.uk>
  2646.      and does not get delivered to the local user.
  2647.  
  2648.  
  2649. Our  Internet provider is Demon, and we are using the mail forwarding service.
  2650. This allows use of user@domain.co.uk, rather than the usual
  2651. user@site.demon.co.uk.
  2652.                     
  2653. The problem :-
  2654.  
  2655. The "RCPT TO:" line when receiving mail reads ( As seen in the osm log )
  2656.  
  2657. RCPT TO: <@site.demon.co.uk:user@domain.co.uk>
  2658.  
  2659. Instead of the mail being delivered to the user, it goes to root.  This is the
  2660. same for any user.  Outgoing mail is fine.   
  2661.  
  2662.  
  2663. To fix:  edit the /usr/lib/mail/mailsurr.proto file and
  2664. try the following:
  2665.  
  2666. {after uucollapse }; add
  2667.  
  2668. # Strip off local routes to domain, local.domain, uname, uname.alternate
  2669. '.+'     '@(%DNODOT)[:,](.+)'     'Translate R=\\2'
  2670. '.+'     '@(%L%D)[:,](.+)'     'Translate R=\\2'
  2671. '.+'     '@(%U)[:,](.+)'     'Translate R=\\2'
  2672. # put our alternate domain here
  2673. '.+'     '@(%site.demon.co.uk)[:,](.+)'     'Translate R=\\2'
  2674.  
  2675.                             
  2676. Subject: M49) I'm using PPP but don't have the interface up when the system
  2677.     creates the mailsurr file, and thus it does not detect my IP
  2678.     link - what can I do?
  2679.  
  2680.  
  2681. Bob Stewart writes:
  2682.  
  2683.  
  2684. If your only networking connection is via ppp, you will have to make
  2685. a change to /usr/lib/mail/surrcmd/configCheck if you want to use smtp
  2686. to send your mail.  Look for the section entitled "Check if IP is up
  2687. and running".  Add the following line immediately after the check to
  2688. just force IP as the mail transport:
  2689.  
  2690. $flaglist{IP} = 1;
  2691.  
  2692. Reboot your system, or alternately as root, type
  2693.  
  2694.         sh /etc/rc2.d/S81smtp stop
  2695.         sh /etc/rc2.d/S81smtp start
  2696.  
  2697. and verify that IP preceeds UUCP in /etc/mail/mailflgs.  
  2698.  
  2699. Subject: M50) How can I set mailalias in the form : user@site  maps to 
  2700.     local user?
  2701.  
  2702. I run multiple domains in my server and I want to map
  2703.  
  2704.         "sales@abc.com" to a user "andy"
  2705.         "editor@def.com" to a user "ron".     
  2706.  
  2707. How should I do this?
  2708. Set up the mailsurr file in the following way...
  2709.  
  2710. '.+'    '(sales)@([^@]+)(abc.com)'       'Translate T=1; R=andy'
  2711. '.+'    '(editor)@([^@]+)(def.com)'    'Translate T=1; R=ron'
  2712.             
  2713. The above matches sales@abc.com and sales@www.abc.com and any
  2714. other subdomains within abc.com.
  2715.  
  2716. To match editor and editors you can use a regexp as follows:
  2717.  
  2718. '.+'    'editor(s*)'    'Translate T=1;  R=andrew' 
  2719.  
  2720. Subject: M51) What is the /etc/mail/smtpcnfg file in tf2100/UW2.1?
  2721.  
  2722. This file is read when smtp is started.
  2723.  
  2724. It contains fields of the format 
  2725.         field=value
  2726.  
  2727. The default file with ptf2100 looks like
  2728.  
  2729. MX_FIRST=yes
  2730. USE_LOG_FILES=yes
  2731. USE_WRAPPERS=no
  2732. USE_OSM=yes
  2733. TIMEOUT=3 days
  2734. LOG_MASK=incoming, outgoing, errors
  2735.  
  2736. MX_FIRST=yes : means smtp attempts delivery to a hosts
  2737. specified Mail Exchanger record (MX DNS record) rather than the
  2738. delivering directly to the host IP address. If set to no,
  2739. then it attempts delivery directly to the host IP address and
  2740. then any MX hosts if specified.
  2741.  
  2742. USE_LOG_FILES=yes : whether to log to /var/spool/mailq/Logs. If no
  2743. value is given this defaults to yes.
  2744.  
  2745. USE_WRAPPERS=no : whether to check to access using the /etc/hosts.allow
  2746. file (as in the tcp wrappers package). I've not been able to convince
  2747. myself that this works at the moment.
  2748.  
  2749. USE_OSM=yes : whether to direct log messages to syslog (osmlog). If
  2750. yes these can be viewed using the Message_monitor GUI tool, or syslogd
  2751. can direct them to log files.
  2752.  
  2753. TIMEOUT=3 days : the time from original delivery attempt before the
  2754. mail is returned to the sender as being undeliverable. If a value of
  2755. "-1" is given the attempts continue indefinitely. An example of
  2756. 7 days timeout can also be specified as "TIMEOUT=1 week".
  2757.  
  2758. LOG_MASK=incoming, outgoing, errors : what events to be logged.
  2759. Other classes to be logged are:  "queued" - log info on msgs
  2760. placed on queues; "debug" - log debug info; "connection" - log
  2761. info on connections; "recipients" - log info about recipients.
  2762. Its possible to switch all this off with the value "nothing"
  2763. or to switch all logging on with "everything".
  2764.  
  2765. Subject: M52) How should I setup Mail via PPP?
  2766.  
  2767. Let's assume firstly that you have a PPP link up and working
  2768. and that tcp/ip services between your host and your ISP have
  2769. been established.
  2770.  
  2771. Lets also assume that you can obtain the Email FAQ  from
  2772. ftp.abs.net:/unixware/freebird/hints/FAQ/comp.unix.unixware.FAQ.m
  2773. since that explains the email subsystem in greater depth than here.
  2774.  
  2775. There are various scenarios:
  2776.  
  2777.         (1) You have your own domain name, for example
  2778.         tamarix.demon.co.uk and your ISP initiates an smtp
  2779.         transfer to your host when you start a ppp session
  2780.         (this is how demon work in the UK)
  2781.  
  2782. You need to establish your DOMAIN name for email. This can be
  2783. done by using the Mail_setup GUI tool or by editing(or creating)
  2784. the file: /etc/mail/mailcnfg
  2785.  
  2786. The mailcnfg file I use at home is
  2787.  
  2788. DOMAIN=demon.co.uk
  2789. FORCE_7BIT_HEADERS=1
  2790. FORCE_7BIT_MIME=1
  2791. ADD_TO=1
  2792. ADD_MESSAGE_ID=1
  2793. SMARTERHOST=post.demon.co.uk  
  2794.  
  2795. By setting DOMAIN=demon.co.uk outbound mail from my home machine tamarix
  2796. has the From: line set to tamarix.demon.co.uk.
  2797.  
  2798. Since you are at home you  want to try and do all mail processing
  2799. while offline - hence the use of a SMARTERHOST, whose IP address
  2800. should be added to your /etc/hosts file so as not to require
  2801. an MX lookup when sending mail (see smtpqer line later)
  2802.  
  2803. You also want to edit the file /usr/lib/mail/lookupLibs.proto
  2804. and comment out some lines in there so as to reduce DNS lookups.
  2805.  
  2806. /usr/lib/mail/libalias/home.so
  2807. /usr/lib/mail/libalias/file.so
  2808. /usr/lib/mail/libalias/passwd.so
  2809. <DNS>   #/usr/lib/mail/libalias/dns.so
  2810. <NIS>   #/usr/lib/mail/libalias/nis.so
  2811. <MHS>   #/usr/lib/mail/libalias/extract.so
  2812.  
  2813. This proto file ends up creating the file /etc/mail/lookupLibs ,
  2814. (after running the /usr/lib/mail/surrcmd/createSurr command - ran
  2815. out of /etc/rc2.d/S81smtp).
  2816.  
  2817. The /etc/mail/mailsurr file is the key file for determining how
  2818. mail gets delivered, I customize this file and then make it permanent -
  2819. after all once you've set it up why let createSurr keep rewriting it!
  2820.  
  2821. A fixed mailsurr file appropriate for PPP can be
  2822. obtained from:
  2823.         ftp.abs.net:/unixware/freebird/hints/Mail/mailsurr.ppp
  2824.  
  2825.         (2) You have a POP mailbox on the ISP server, and your
  2826.         mail account is username@your_isp_address.dom. You'll need
  2827.         to use a POP client or equivalent to get the mail onto
  2828.         your local machine. You'll then need to reply using mail on
  2829.         the local machine and want to ensure that the mail headers
  2830.         look like mail is being sent from the ISP machine.
  2831.  
  2832. In this case your mailbox is held on the ISP's machine and they
  2833. have a POP server.  You need a popclient to retrieve the mail from
  2834. the server onto your local machine. A version of the Mail Users Shell
  2835. (Mush) is available on ftp.abs.net:/unixware/freebird/mailtools/popclient
  2836. that can be used. There has also been a tool posted in this group
  2837. that will retrieve the mailbox from your ISP into the local machine,
  2838. in which case you can then use your favourite mail user agent to read it
  2839. (i don't have a copy off-hand).
  2840.  
  2841. POP allows you to retrieve mail but most servers don't allow you
  2842. to send mail. You can use smtp to send mail from your local machine
  2843. using the above configuration with one exception, you need to
  2844. rewrite the From: line for outbound mail to hide your nodename
  2845. (so in my case, mail would appear to come from demon.co.uk and
  2846. not tamarix.demon.co.uk).
  2847.  
  2848. This can be done by editing the file /etc/mail/rewrite
  2849. and adding the routine (this will need editing for your
  2850. configuration)
  2851.  
  2852. function check_headers()
  2853. {
  2854. var hdr;
  2855. # loop through ALL headers
  2856. for (hdr from headers_pattern("From:"))
  2857.    # if we match a header that has something like foo.xyz.com in it
  2858.    if (hdr ~ "[a-zA-Z]\\.demon\\.co\\.uk")
  2859.      # then substitute the shorter version in its place
  2860.      hdr=gsubstitute(hdr, "[a-zA-Z0-9.]+\\.demon\\.co\\.\\uk", "demon.co.uk");
  2861. }    
  2862.  
  2863. Add a call to this in the function main() in /etc/mail/rewrite, so this
  2864. looks like:
  2865.  
  2866. function main()
  2867. {
  2868.     add_missing_headers();
  2869.     check_headers();
  2870. }   
  2871.  
  2872.         (3) When sending mail you'll want to consider whether you
  2873.         want to relay mail via a SMARTERHOST (recommended), usually
  2874.         your ISP or whether you want to send the mail directly 
  2875.         across the internet to the remote recipient
  2876.  
  2877. In the mailsurr example above, I've assumed that this is what you'd
  2878. want to do. And in most cases this makes sense, since that way
  2879. you can let your ISP handle the routing and delivery issues.
  2880. For those odd occasions when you want to get mail somewhere quickly
  2881. or directly i use an i: prefix to say internet directly which you
  2882. may or may not find particularly useful. 
  2883.  
  2884.         (4) Perhaps you have two PPP links in different domains (like
  2885.         my home box), and can switch between them. You want to receive mail
  2886.         to both domain addresses - this requires some level of customization
  2887.  
  2888. I have some scripts (written by Mike Convey) to swap between my ISP
  2889. and my work PPP links.  At home my machine is known as tamarix, at work
  2890. its known as voyager (now if i'd kept the names the same i would
  2891. not need this!).
  2892.  
  2893. When I send email i keep the tamarix.demon.co.uk
  2894. domain in there, but occasionally i want to forward mail over the work
  2895. link to my machine. In this case I have to add a line to the mailsurr
  2896. file so that it recognises the mail as local, otherwise it sends
  2897. it off to the SMARTERHOST
  2898.  
  2899. The trick is to add another delivery line to translate the mail
  2900. for local delivery, and add your alternate nodename in there
  2901.  
  2902. '.+'    '([^@]+)@(voyager)%D'           'Translate R=\\1'
  2903.  
  2904. The %D is needed since the inbound smtp adds the Domain info.
  2905.  
  2906.         (5) Perhaps your ISP relays mail to you over uucp over TCP/IP,
  2907.         perhaps by a mail forward? What then?
  2908.  
  2909. For incoming mail this is not a problem, and you can still send
  2910. mail outwards using smtp.
  2911.  
  2912. I'm sure there are other configurations not covered here, hopefully
  2913. this will be useful to some folks!
  2914.  
  2915. Subject: M53) How can I setup mail to handle virtual hosts's mail?
  2916.  
  2917. How do I handle virtual hosts' mail with mailsurr ?
  2918.  
  2919. Example: have machine           mydomain.net
  2920. have virtual machines           virtual1.ca
  2921.                                 virtual2.ca
  2922.                                 virtual3.ca
  2923. I want to have server handle mail for
  2924.  
  2925. sales@mydomain.net
  2926. sales@virtual1.ca
  2927. sales@virtual2.ca
  2928. sales@virtual3.ca   
  2929.  
  2930. One way to handle this is to add explicit rules on the mailsurr.proto
  2931. file as follows:
  2932.  
  2933. Add this in just before the area where it deals with supposedly local names.
  2934.  
  2935. # Map all names addressed to alias@domain.com to appropriate users.
  2936. '.+'    '(sales)@(mydomain.net)'                  'Translate T=1; R=ron'
  2937. '.+'    '(sales)@(virtual1.ca)'    'Translate T=1; R=andy'
  2938. '.+'    '(sales)@(virtual2.ca)'       'Translate T=1; R=linda'
  2939. '.+'    '(sales)@(virtual3.ca)'                    'Translate T=1; R=bob'
  2940.  
  2941. In the above, all the R=names are local users or aliases (if they
  2942. are not local you can alias them to the real addresses).   
  2943.  
  2944. Subject: M54) I need to print all incoming mail as well as send it to 
  2945.    local users.
  2946.  
  2947. # Add this before any address translations to mailsurr.proto
  2948. #    Send all incomming mail to printer and to user. 
  2949. #    Do a C=* so mail is sent to the user also.
  2950. '.+'    '([^@]+)@(mydomain.com)'                '< C=*; lp      -dtest'
  2951.                   
  2952. Subject: M55) Mail loops - its forwarded by my provider but then goes into a loop - any ideas?
  2953.  
  2954. This usually occurs when the /etc/mail/mailsurr file is not
  2955. pattern matching a delivery line, specifically a line to translate the
  2956. address to a local address for delivery.
  2957.  
  2958. Examine the log file  in /var/mail/:log , look at the To
  2959. address of the bounced message. If its of the form
  2960.  
  2961.         @site.com:user@foo.domain
  2962.  
  2963. See M48.
  2964. Else check that your DOMAIN is defined in /etc/mail/mailcnfg and that
  2965. any customisations  to /etc/mail/mailsurr have been done.
  2966.  
  2967. Subject: M56) Mail delivery does not seem to be case insensitive - any ideas?
  2968.  
  2969. Problem: Any mail that is received with a capitol letter in the
  2970. recipient field is returned to the originator.  Meaning, if you compose
  2971. mail to AUser@mydom,net, it will not get to me. Instead an
  2972. ambiguous/invalid recipient error is generated. 
  2973.  
  2974. The problem occurs since the mailalias call with the mailsurr sees the
  2975. address with a domain still attached.  Translation to lower case is 
  2976. handled by the mailalias line within /etc/mail/mailsurr, in this case 
  2977. the mailalias call laves this alone as its not local, and a later line
  2978. attempts local delivery. The fix is to add another mailalias call
  2979. by duplicating the existing line.
  2980.  
  2981. Acknowledgements:
  2982.  
  2983.  
  2984. Many thanks to the following for feedback and comments on various
  2985. drafts of this FAQ: Steve Wootton, Pete Holsberg, Michael Tiernan,
  2986. Bob Stewart, Dan Daggett.
  2987.  
  2988. --
  2989. Andrew Josey,  Disclaimer: Any views expressed are not those of
  2990. my employer, either past, present or future.
  2991.