home *** CD-ROM | disk | FTP | other *** search
/ Shareware Supreme Volume 6 #1 / swsii.zip / swsii / 107 / MINICOM.ZIP / INSTALL < prev    next >
Text File  |  1992-05-18  |  4KB  |  91 lines
  1.     Installation of Minicom.
  2.  
  3. Edit the Makefile to choose your C-compiler and CFLAGS. Entries
  4. for a lot of systems are already defined, you only have to
  5. uncomment them.
  6. Now edit "config.h". Change the definitions at the top to the
  7. directories where you want to install the executables and files.
  8. If everything is allright, you can type "make" and "minicom", "keyserv"
  9. and "runscript" will be compiled.
  10. If you have gotten this far, it is time to install the executables.
  11.  
  12. If you want minicom & consorts to live in /usr/local/bin and 
  13. /usr/local/etc, you can just type "make install". Otherwise you have to:
  14.  
  15. 1. Copy "minicom" to a bin directory (eg /usr/local/bin).
  16.    chown it to root and install it set-uid. (chmod 4755 minicom)
  17. 2. Copy "runscript" to the place defined in "minicom.h".
  18. 3. Do this with "keyserv" too.
  19.    Don't install "runscript" and/or "keyserv" setuid root!
  20. 4. Edit the "minicom.users" file (in the directory as defined in
  21.    "minicom.h") to add users who may use minicom. If you don't
  22.    install "minicom.users" everybody may use minicom!
  23. 5  Minicom has been installed.
  24.  
  25. Configuration.
  26.  
  27. Probably most defaults are not good enough for your system.
  28. So type (still as root) "minicom -s". This will not initialize
  29. minicom but brings you directly into the configuration menu.
  30. See "Manual.mnc" for details.
  31.  
  32. Graphics.
  33.  
  34. Minix-PC can display all IBM characters. Other Minixes cannot do this,
  35. so by default they are emulated. However, if your screen can display
  36. special characters it is possible to change your /etc/termcap so
  37. that the box-drawing characters are used by Minicom. For Minix-PC, add
  38. the next lines to your minix termcap entry:
  39.  
  40.     :gA=\311:gB=\315:gC=\273:gD=\310:gE=\272:gF=\274:gG=\332:\
  41.     :gH=\304:gI=\277:gJ=\300:gK=\263:gL=\331:gM=\307:gN=\266:\
  42.     :gO=\209:gP=\207:gQ=\198:gR=\181:gS=\210:gT=\208:gU=\206:\
  43.     :gV=\197:gW=\215:gX=\216:gY=\176:gZ=\178:
  44.  
  45. (Don't forget to add a backslash at the end of the original entry!)
  46.  
  47. Minicom does not need this termcap information, but it looks a lot nicer.
  48. The termcap entries for these graphic characters were made up
  49. by Fred van Kempen I believe, and minicom only uses gA-gL.
  50. These are the IBM box-drawing characters, their coding is:
  51.  
  52.      double lined single lined meaning               ASCII equivalent
  53.           gA           gG      upper-left corner          +
  54.           gB           gH      horizontal line            -
  55.           gC           gI      upper-right corner         +
  56.           gD           gJ      lower-left corner          +
  57.           gE           gK      vertical line              |
  58.           gF           gL      lower-right corner.        +
  59.  
  60.  
  61. x/y/z modem.
  62.  
  63. It is possible to use rz/sz from Minicom, but the newest versions
  64. don't use stdin/stdout and stderr , so you'll have to patch them.
  65. The Minix versions of rz/sz work ok, so no worries.
  66.  
  67. Security.
  68.  
  69. For those of you who never trust a program running as root, it is
  70. possible to run minicom setgid UUCP. This is not entirely trivial,
  71. so the default is to run as root anyway. To enable minicom running
  72. as group uucp, the following steps, under Minix, must be taken:
  73. - Recompile minicom with the '-D_SECURE' flag added to CFLAGS in Makefile.
  74. - Install minicom setuid root, setgid uucp like this:
  75.  
  76. -r-sr-sr-x  1 minicom  uucp        85636 May  7 19:43 minicom*
  77.  
  78. - If you use ungetty, make it setuid root, group uucp like this:
  79.  
  80. -r-sr-xr--  3 root     uucp        14698 Mar 10 21:07 /etc/getty*
  81.  
  82. - Make the lockfiles directory, /usr/spool/uucp, writable for group uucp.
  83.  
  84. When minicom starts up, it opens the modem device (that's why it has
  85. to be setuid root) and then it sets its effective uid to its real uid.
  86. Then only the setgid bit stays honoured, so that minicom runs setgid uucp.
  87. There is one major disadvantage: all files created by the minicom for
  88. the user (~/.dialdir and ~/.minirc.*) will have the group 'uucp'. I can't
  89. see major problems with this, but I don't really like it.
  90. (When oh when will Minix have a 'saved uid' and seteuid()....).
  91.