home *** CD-ROM | disk | FTP | other *** search
/ ftp.qualcomm.com / 2014.06.ftp.qualcomm.com.tar / ftp.qualcomm.com / eudora / servers / unix / srialpop.shar / README < prev    next >
Text File  |  1997-03-26  |  10KB  |  222 lines
  1.  
  2.         S R I A L P O P -- POP over serial lines
  3.         (sccs info README 2.4 96/10/09)
  4.  
  5.         Author: Rudi van Houten <R.vanHouten@cc.ruu.nl>
  6.                 Ac.Comp.Centr.Utrecht (Netherlands)
  7.         With thanks to:
  8.                 Steve Dorner <sdorner@qualcomm.com>
  9.                 Scott Hannahs <sth@slipknot.mit.edu>
  10.                 Mogen Trab Damsgaard <trab@kubism.ku.dk>
  11.  
  12. ========================== COPYRIGHT NOTICE =============================
  13. This package srialpop is written by and copyright Rudi van Houten
  14. <R.vanHouten@cc.ruu.nl>, it is tested and used now at ACCU (Ac.Comp.
  15. Centr.Utrecht, the Netherlands) for several years.
  16.  
  17. The package consists of four files:
  18.     srialpop.c  the C source of the program
  19.     Makefile    to build and eventually install the package
  20.     README      an old documentation describing the package
  21.     INSTALL     a newer document with concise installation instructions
  22.  
  23. I grant everybody the right to use the package and eventually
  24. adapt it to local requirements. Please document your changes in the
  25. program source with comments explicitely stating that a modification
  26. to the original package has been made. I don't want to be blamed for
  27. your errors nor get the praise for your inventions.
  28.  
  29. Also everybody has the right to bundle this package with other software
  30. (e.g. a POP client) on distribution media, but THEN THE UNCHANGED VERSION
  31. MUST BE DISTRIBUTED, and no extra fee may be charged for the presence
  32. of srialpop in the bundle. If there is a need to modify srialpop for
  33. special purposes these modification should be made available as a separate
  34. file (e.g. a diff file to be applied with Larry Wall's patch program).
  35.  
  36. I present this package as is, feeling it can be of use. But no
  37. guarantees are given about its proper working or behaviour. It has
  38. been used at ACCU for some years now without troubles, so I think it may
  39. be bug free. But I cannot be held responsible for any damage or other
  40. misery resulting from using srialpop.
  41. ===========================================================================
  42.  
  43.     The Macintosh POPmail client Eudora offers a possibility
  44.     to perform the POP and SMTP conversations over a serial
  45.     (dialup) connection. Therefore is needed a 'psuedo-account'
  46.     on a machine where Eudora can login. That account must have
  47.     permission to execute senndmail and popper, not only local
  48.     but also remote (via rsh) on all machines where a popserver
  49.     or smtpserver must be contacted. Eudora is secretive with
  50.     the password while showing its progress (if properly
  51.     configured), but nobody can prevent a curious Macontosh
  52.     owner from looking with ResEdit (or alike's). It can be a
  53.     security leak.
  54.     The same considerations apply to the IBM-PC client NUPop
  55.     that also can use serial tty-lines to acquire mail.
  56.     
  57.     This program srialpop is written to take care of these
  58.     trade off's. It must be used as the pseudo-account's
  59.     loginshell. The commands which are recognized by the
  60.     program are 'logout' and 'exit' (to finish the session
  61.     of course) and 'telnet <host> <port> ...' which performs
  62.     a TCP/IP connection with the indicated host/port. The
  63.     supplied portnumber is checked against a list of valid
  64.     portnumbers (now only POP, SMTP, PH and PASSWD).
  65.     All other commands cause an exit with errormessage.
  66.     
  67.     So the pseudo-account doesn't need permissions to run
  68.     popper and sendmail, neither needed are permissions to
  69.     run rsh to another machine or let another machine rsh
  70.     in. And a diligent POPmail user who tries to login on
  71.     the psuedo-account will discover that there is no fun.
  72.     Since nobody can be prevented to learn srialpop's
  73.     password it is mandatory that the home directory for
  74.     pseudo-user srialpop is unwritable for srialpop.
  75.     
  76.     The program is straightforward and rather simple, and
  77.     it is free. Yet I claim a copyright, with which I mean
  78.     that anybody who feels a need to change (parts of) this
  79.     program is under the obligation to document the changes
  80.     and the need thereof in the program distribution files.
  81.     Neither may this program be selled (as if anybody would
  82.     buy this gadget), or distributed for a fee that extends
  83.     a reasonable retribution for the 8k it occupies on disk
  84.     or other media (I don't ask money, why should you).
  85.     I have tested the program for some time now and found no
  86.     bugs/problems. That doeesn't mean of course there are not.
  87.     I offer this program free for everyone to use because I
  88.     think it can be useful and is less dangerous then the
  89.     shellscript originally suggested by Steve Dorner. But if
  90.     you stumble over an error I am in no way responsible for
  91.     the damage that can cause, however I don't expect disasters.
  92.     I should welcome (by email) any notification of changes,
  93.     corrections and enhancements in the form of the new program
  94.     source or a diff.
  95.  
  96.     At A.C.C.U. we rent POP mailboxes to users as a special cheap
  97.     service. The users who obtain that service can only use email
  98.     via the POP/SMTP mechanism. The owner of a POPmail account
  99.     can not do any work on the UNIX machine, only change his/her
  100.     password (their login shell is a script that consists of a
  101.     call to /bin/passwd), and they don't need a home directory.
  102.     Hence the service can be cheap.
  103.  
  104.     The passwd entry for pseudo-user srialpop is:
  105.     (splitted for layout reasons)
  106.     srialpop:passwd:uid:gid:POP dialup dummy account:\
  107.                         /home/srialpop:/home/srialpop/srialpop
  108.  
  109.     The passwd entry for a POPmail account:
  110.     popuser:passwd:uid:gid:POPmailuser:/home/srialpop:/usr/local/etc/chpw
  111.  
  112.     And the script /usr/local/etc/chpw used as their loginshell:
  113.     #!/bin/sh
  114.     exec /bin/passwd
  115.  
  116.     (Or place /bin/passwd as "loginshell" in /etc/passwd)
  117.     
  118.     Rudi van Houten  <rudi@cc.ruu.nl>
  119.     Ac.Comp.Centr.Utrecht
  120.     Budapestlaan 6
  121.     3584 CD Utrecht Netherlands
  122.  
  123.     ********************
  124.     Known bugs:
  125.  
  126.     **NOTE for NUPop users **
  127.     If srialpop is used the end-of-line indicator must be set
  128.     to "^M^J" in the "Options -> Serial" menu of NUPop.
  129.     ****
  130.  
  131.     There are some quirks with end-of-line definitions.
  132.     TCP/IP requires CR-LF (according to the RFC's), but I
  133.     never encountered a TCP/IP connection that was not satisfied
  134.     with only LF.
  135.     Someone reported that his system produced and accepted an
  136.     end-of-line consisting of LF-CR, I didn't save the mails and
  137.     forgot the details.
  138.     When using public datanet systems (as X.25 in Europe) there
  139.     can be a problem that X.25 considers CR as end-of-packet and
  140.     the LF that is sent thereafter by the UNIX-system or POP-client
  141.     is then considered as the start of a new packet, that never is
  142.     closed. When I will have some time to spare I will look at that,
  143.     but perhaps someone else will find a solution earlier (I expect
  144.     it can be solved by setting appropriate LF-CR translations in
  145.     srialpop and defining a single CR as end-of-line in Eudora/NUPop).
  146.  
  147.  
  148.     Program history:
  149.     9 dec 91   original version, only installed at ACCU
  150.                The distribution contains one file 'srialpop.c'
  151.     11 dec 91  some changes in IO-handling after Steve Dorner
  152.                viewed the program and made some sugeestions
  153.     - V1.0-
  154.     18 aug 92  added port 105 for PH service
  155.     20 Oct 92  changes for conditional compilation on Silicon
  156.                Graphics sent in by Scott Hannahs
  157.                <sth@slipknot.mit.edu>
  158.     - V1.1-
  159.     22 Nov 92  added a wait time before exit to satisfy the
  160.                Macintosh CTB Hayes Modem Tool.
  161.                added port 106 for password service
  162.                Introduce the use of a make to enable simple
  163.                definitions of symbols.
  164.     14 dec 92  added exclusion of tab expansion
  165.                (Mogen Trab Damsgaard <trab@kubism.ku.dk>)
  166.     - V1.2-
  167.     8 June 93  now change the terminal settings for the whole
  168.                life of the program. Read the commands in blocks
  169.                of one character and do the echo from the program.
  170.     - V1.3-
  171.     15 June 93 V1.2 did send the second character of CR-LF (or 
  172.                LF-CR) line-end from the telnet command to the
  173.                connected server via the socket. This character
  174.                is now catched and thrown away. Some popservers
  175.                couldn't handle this, but I didn't see this
  176.                since popper did not have troubles.
  177.     - V1.4-
  178.     12 July 93 Add logging capabilities.
  179.                If the logging on file is used be sure to create
  180.                a file srialpop.log in srialpop's home directory
  181.                that is writable by srialpop since srialpop is
  182.                unable to create a file there.
  183.     - V1.5-
  184.     sep 93     Add some remarks concerning ULTRIX in the README
  185.  
  186. This version of srialpop has been successfully tested on:
  187. Convex OS 10.1
  188. DEC (Philips) P9070 ATT SYS V/68 R3V6
  189.  
  190. Continue the story:
  191.     - V2.0
  192.     aug 95      In the Makefile the values for logging and
  193.                 flow control can be defined. Also code is
  194.                 added to detect which include files (strings.h,
  195.                 unistd.h, sgtty.h, termio.h, termios.h) must
  196.                 be used.
  197.  
  198.     - V2.1      interim release
  199.     - V-2.2 
  200.     apr '96        add NO_SMTP and file INSTALL (never released).
  201.                 If NO_SMTP is defined in the Makefile srialpop
  202.                 will not allow connection the the SMTP port (25).
  203.                 The POP clients must use the POP server to send mail.
  204.     - V2.3
  205.     oct '96        documentation changes, copyright notice.
  206.  
  207. I have tried to install srialpop on the systems in the list below.
  208. The systems marked with an asterisk (*) it is only compiled and tried
  209. out via a telnet login but NOT actually tested on a tty port.
  210.  
  211. Convex OS 9
  212. Motorola SYSTEM V/68 Release R3V6
  213. ULTRIX 4.3 (*)
  214. SGI IRIX 5.4 (*)
  215. SunOS 4.1.3
  216. Solaris 2.4 (Sun Sparc only) (*)
  217. IBM AIX 3.21 and 4.1
  218. DEC Alpha OSF/1 3.0 (*)
  219.  
  220. Some friends of mine have tried the Makefile and compilation on Linux.
  221. Without problems, but they didn't test the results.
  222.