home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume20 / pcomm1.2 / part02 / Readme < prev    next >
Text File  |  1989-10-25  |  8KB  |  217 lines
  1.  
  2.                   Pcomm
  3.               A Unix Telecommunication Program
  4.  
  5. Things to do first:
  6.  
  7.     1) Figure out what files you need.  There is a shell archive
  8.     called "Unixpc.shar" that contains additional (and replacement)
  9.     files for users of the AT&T Unix PC 7300/3b1.
  10.  
  11.     2) Create a default directory where the Pcomm support files will
  12.     go.  A good location might be /usr/local/lib/pcomm.
  13.  
  14.     3) Copy the sample support files Pcomm.dial_dir, Pcomm.extrnl,
  15.     Pcomm.modem, and Pcomm.param to the default directory and rename
  16.     them to change the upper case "P" to a lower case "p".  The files
  17.     should *not* have write permission to all.
  18.  
  19.     4) Copy (and rename as appropriate) the Pcomm.1, Waitfor.1, 
  20.     Matches.1, and Modem_break.1 nroff manuals to the proper /usr/man
  21.     directory.
  22.  
  23.     5) Print the Doc file by piping the output of the Unix "pr"
  24.     command with the title separated by lots of white space (to help
  25.     center it), for example:
  26.  
  27.     pr -h "           Pcomm Reference Manual        " Doc | lp
  28.  
  29. How to configure Pcomm:
  30.  
  31.     1) Edit the "config.h" file to suit your system's needs and your
  32.     personal taste.  Sites running HoneyDanBer (HDB) UUCP should pay
  33.     particular attention to the LOCK_DIR, ASCII_PID, and SETUGID
  34.     definitions.  The definitions in config.h are:
  35.  
  36.     BSD        Define if you're using a Berkeley flavor of Unix.
  37.             You will have to edit the Makefile in several
  38.             places.
  39.  
  40.     UNIXPC        If defined, use the dial(3) routines specific
  41.             to the AT&T Unix PC 7300/3b1.  Useful only if
  42.             the On Board Modem (OBM) is to be used.
  43.  
  44.     OLDCURSES    If defined, use the older version of curses(3).
  45.             (uses termcap in lieu of terminfo).
  46.  
  47.     SHAREDMEM    If defined, keeps the virtual screen area in
  48.             shared memory rather than in a file.
  49.  
  50.     NOPROMOTE    If defined, do not promote missing video
  51.             attributes to standout.  Normally, curses(3)
  52.             attempts to compensate for missing attributes.
  53.  
  54.     SETUGID        If defined, extra precautions are taken before
  55.             opening files or doing a shell escape to restore
  56.             the real UID/GID.  Useful if Pcomm is installed
  57.             as a set-user-id or get-group-id program.  HDB
  58.             programs often are set-user-id to uucp.
  59.  
  60.     LOG_CALLS    If defined, Pcomm will keep an administrative log
  61.             of all calls.  The log contains the name of the
  62.             person making the call, the phone number, and a
  63.             date/time stamp.  Useful for verifying long
  64.             distance phone bills.
  65.  
  66.     LOGFILE        The path to the log file (if LOG_CALLS is
  67.             defined).  It should have write permission to
  68.             all or be writeable under set-user/group-id
  69.             conditions.
  70.  
  71.     LIMIT_LD    If defined, Pcomm will limit long distance
  72.             (toll) calls to a privileged group.  The file
  73.             "admin.c" may require tweaking to detect long
  74.             distance numbers.
  75.  
  76.     GROUP_NAME    The name of the group that is allowed to make
  77.             long distance calls (if LIMIT_LD is defined).
  78.  
  79.     LPR        The path to the line printer program (this is
  80.             not the name of the device).
  81.  
  82.     LPRINT        The path to the "pretty" line printer program.
  83.             Typically a program that performs a "pr | lp"
  84.             function.  If none exist, use "pr | lp".
  85.  
  86.     DEFAULT_DIR    The path to the directory that contains the
  87.             default Pcomm support files.
  88.  
  89.     LOCK_DIR    The path to the directory where the UUCP lock
  90.             files are found.  On HDB systems this could
  91.             be /usr/spool/locks or /usr/spool/uucp.
  92.  
  93.     ASCII_PID    If defined, the lock files will contain an ASCII
  94.             encoded process id (PID).  On HDB systems this
  95.             is the default.
  96.  
  97.     XENIX_LOCKS    If defined, the last letter of the device name
  98.             is folded to lower case when creating the lock
  99.             file.  Newer version of XENIX may require this.
  100.  
  101.     KEEP_PORT    If defined, the port will be kept open between
  102.             dialing attempts to save time.  Some systems
  103.             may require the modem to be closed and reopened
  104.             every time.
  105.  
  106.     XMC_BROKE    Does the status line scroll up when using "magic
  107.             cookie" terminals?  Some Pyramid and AT&T
  108.             systems may require this to be defined.  Find a
  109.             magic cookie terminal (a Wyse 50 for example),
  110.             and see what happens.
  111.  
  112.     WGETCH_BROKE    Does the alarm() system call work correctly with
  113.             the wgetch() function?  Some Masscomp systems
  114.             will require this to be defined.  Symptom: the
  115.             initial screen doesn't go away by itself after 5
  116.             seconds.
  117.  
  118.     CLIST_SIZ    The size of the serial port character buffer.
  119.             The default is 64.
  120.  
  121.     INPUT_BUF    The size of the input buffer (should be about the
  122.             same size as CLIST_SIZ).  The default is 64.
  123.  
  124.     OUTPUT_BUF    The size of the output buffer (should be about
  125.             one half INPUT_BUF).  The default is 32.  Systems
  126.             without dedicated I/O processors may require a
  127.             very small INPUT_BUF value to avoid the problem
  128.             of a "choppy" display.
  129.  
  130.     MEMMOVE        The name of the memory copy routine (if none,
  131.             then use "#undef MEMMOVE").  The default is
  132.             "memmove", although quite a few versions of
  133.             "memcpy" will work (if they correctly handle
  134.             target and source overlap).
  135.  
  136.     SETUID_BROKE    Does your version of Unix allow you to flip-flop
  137.             back and forth between the real and effective
  138.             user (or group) ID?  Some Masscomp systems will
  139.             require this to be set.
  140.  
  141.     2) Edit the Makefile.  There are provisions in the Makefile to
  142.     include getcwd(3) and getopt(3) routines if they are missing
  143.     from your system.  You may want to customize the CFLAGS,
  144.     LDFLAGS, and BIN assignments to suit your needs.
  145.  
  146.     If compiling under Berkeley Unix, you will have to edit the
  147.     Makefile on the following lines:
  148.  
  149.         #for old curses(3) or Berkeley systems
  150.         CURSES = -lcurses -ltermcap
  151.         TERMLIB = -ltermcap
  152.         #CURSES = -lcurses
  153.         #TERMLIB = -lcurses
  154.  
  155.         #for System V or Berkeley worlds
  156.         BSD = -DBSD
  157.         TTY = tty_ucb.o
  158.         #BSD =
  159.         #TTY = tty_att.o
  160.  
  161.     All the defaults in config.h assume a AT&T flavor of Unix, sorry
  162.     about that...
  163.  
  164.     3) Compile pcomm and pcomm_input.  Type "make".  The "make
  165.     install" option will attempt to copy "pcomm" and "pcomm_input"
  166.     into the BIN directory given in the Makefile.  However, those
  167.     sites running HDB UUCP software may require that you to change
  168.     the mode of "pcomm" to be set-user-id to uucp.  DO NOT CHANGE
  169.     THE SET-UID/GID BITS ON THE "pcomm_input" PROGRAM.
  170.  
  171.     Three external programs (waitfor, matches, and modem_break) are
  172.     included in the distribution to help in creating auto-login
  173.     shell scripts.
  174.  
  175.     4) Update the sample modem/TTY database.  I know I'm asking the
  176.     impossible, but...  Read section 3 and the Appendices of the Doc
  177.     file first, then run Pcomm to update the modem/TTY database by
  178.     using the TTY Setup and the Modem Setup menues.  You will need
  179.     to know:
  180.  
  181.         o The types and number of modems available for dial out
  182.         o The TTY ports attached to the modems
  183.         o The range of baud rates at which the modems operate
  184.         o How to initialize the modems to suit Pcomm's needs
  185.         o How to make the modems dial
  186.  
  187.     During this step, you will need write permission on the support
  188.     files in the default directory.  RESIST THE TEMPTATION TO EDIT
  189.     THE SUPPORT FILES DIRECTLY.
  190.  
  191. Portability considerations:
  192.  
  193.     1) Pcomm makes use of the bold, blinking and standout video
  194.     attributes.  My concept of "standout" and "reverse" might be
  195.     different than yours (I like "standout" to be a brighter version
  196.     of "reverse").  Some very old versions of curses will ignore the
  197.     standout mode if you're on a magic cookie terminal.
  198.  
  199.     2) The "port.c" file has a place where you can include your own
  200.     routine to toggle the getty process on a port (if required).
  201.  
  202.     3) If you compile Pcomm with LOG_CALLS defined, you'll have to
  203.     look at the code in "admin.c" to see if the long distance
  204.     detection routine is correct for your site.
  205.  
  206.     4) Compilers that adhere to the ANSI C Standard will complain at
  207.     the declarations of perror(), malloc(), fread(), fwrite(), etc.
  208.     There is a "typedef SIG_TYPE" in the config.h file to help
  209.     silence the compiler's warning messages about the signal()
  210.     return value.
  211.  
  212. Emmet P. Gray                US Army, HQ III Corps & Fort Hood
  213. ...!uunet!uiucuxc!fthood!egray        Attn: AFZF-DE-ENV
  214.                     Directorate of Engineering & Housing
  215.                     Environmental Management Office
  216.                     Fort Hood, TX 76544-5057
  217.