home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume16 / pcomm2 / part02 / Readme < prev    next >
Text File  |  1988-09-14  |  6KB  |  169 lines
  1.  
  2.                   Pcomm
  3.               A Unix Telecommunication Program
  4.  
  5. Things to do first:
  6.  
  7.     1) Figure out what files you need to extract.  There is a shell
  8.     archive called "Unixpc.shar" that contains additional (and
  9.     replacement) 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.modem,
  15.     and Pcomm.param to the default directory and rename them to
  16.     change the uppercase "P" to a lower case "p".  The files should
  17.     *not* have write permission to all.
  18.  
  19.     4) Copy (and rename as appropriate) the Pcomm.1 nroff manual to
  20.     the proper /usr/man directory.
  21.  
  22.     5) Print the Doc file by piping the output of the Unix "pr"
  23.     command with the title separated by lots of white space (to help
  24.     center it), for example:
  25.  
  26.     pr -h "           Pcomm Reference Manual            " Doc | lp
  27.  
  28. How to configure Pcomm:
  29.  
  30.     1) Edit the "config.h" file to suit your system's needs and your
  31.     personal taste.  Sites running HoneyDanBer (HDB) UUCP should pay
  32.     particular attention to the LOCK_DIR, ASCII_PID, and SETUGID
  33.     definitions.  The definitions in config.h are:
  34.  
  35.     UNIXPC        If defined, use the dial(3) routines specific
  36.             to the AT&T Unix PC 7300/3b1.  Useful only if
  37.             the On Board Modem (OBM) is to be used.
  38.  
  39.     OLDCURSES    If defined, use the older version of curses(3).
  40.             (uses termcap in lieu of terminfo).  Some
  41.             versions of the AT&T Unix PC 7300/3b1 may
  42.             require this.
  43.  
  44.     SHAREDMEM    If defined, keeps the virtual screen area in
  45.             shared memory rather than in a file.  Some
  46.             performance gains are realized if shared memory
  47.             is used.
  48.  
  49.     NOPROMOTE    If defined, do not promote missing video
  50.             attributes to standout.  Normally, curses(3)
  51.             attempts to compensate for missing attributes.
  52.  
  53.     SETUGID        If defined, extra precautions are taken before
  54.             opening files or doing a shell escape to restore
  55.             the real UID/GID.  Useful if Pcomm is installed
  56.             as a set-user-id or get-group-id program.  HDB
  57.             programs often are set-user-id to uucp.
  58.  
  59.     LOG_CALLS    If defined, Pcomm will keep an administrative log
  60.             of all calls.  The log contains the name of the
  61.             person making the call, the phone number, and a
  62.             date/time stamp.  Useful for verifying long
  63.             distance phone bills.
  64.  
  65.     LOGFILE        The path to the log file (if LOG_CALLS is
  66.             defined).  It should have write permission to
  67.             all or be writeable under set-user/group-id
  68.             conditions.
  69.  
  70.     LIMIT_LD    If defined, Pcomm will limit long distance
  71.             (toll) calls to a privileged group.  The file
  72.             "admin.c" may require tweeking to detect what is
  73.             a long distance number.
  74.  
  75.     GROUP_NAME    The name of the group that is allowed to make
  76.             long distance calls (if LIMIT_LD is defined).
  77.  
  78.     LPR        The path to the line printer program (this is
  79.             not the name of the device).
  80.  
  81.     LPRINT        The path to the "pretty" line printer program.
  82.             Typically a program that performs a "pr | lp"
  83.             function.  If none exist, use the same as LPR.
  84.  
  85.     DEFAULT_DIR    The path to the directory that contains the
  86.             default Pcomm support files.
  87.  
  88.     LOCK_DIR    The path to the directory where the UUCP lock
  89.             files are found.  On HDB systems this would
  90.             typically be /usr/spool/locks.
  91.  
  92.     ASCII_PID    If defined, the lock files will contain an ASCII
  93.             encoded process id (PID).  On HDB systems this
  94.             is the default.
  95.  
  96.     KEEP_PORT    If defined, the port will be kept open between
  97.             dialing attempts to save time.  Some systems
  98.             may require the modem to be closed and reopened
  99.             every time.
  100.  
  101.     XMC_BROKE    Does the status line scroll up when using "magic
  102.             cookie" terminals?  Some Pyramid and AT&T
  103.             systems may require this to be defined.  Find a
  104.             magic cookie terminal (a Wyse 50 for example),
  105.             and see what happens.
  106.  
  107.     WGETCH_BROKE    Does the alarm() system call work correctly with
  108.             the wgetch() function?  Some Masscomp systems
  109.             will require this to be defined.  Symptom: the
  110.             initial screen doesn't go away by itself after 5
  111.             seconds.
  112.  
  113.     2) Edit the Makefile.  There are provisions in the Makefile to
  114.     include getcwd() and getopt() routines if they are missing from
  115.     your system.  You may want to customize the CFLAGS, LDFLAGS, and
  116.     BIN assignments to suit your needs.
  117.  
  118.     3) Compile pcomm and pcomm_input.  Type "make".  The Makefile
  119.     will attempt to install "pcomm" and "pcomm_input" into the BIN
  120.     directory given in the Makefile.  However, those sites running
  121.     HDB UUCP software may require you to change the mode of "pcomm"
  122.     to be set-user-id to uucp.  DO NOT CHANGE THE SET-UID/GID BITS
  123.     ON THE "pcomm_input" PROGRAM.
  124.  
  125.     4) Update the sample modem/TTY database.  I know I'm asking the
  126.     impossible, but...  Read section 3 and the Appendices of the Doc
  127.     file first, then run Pcomm to update the modem/TTY database by
  128.     using the TTY Setup and the Modem Setup menues.  You will need
  129.     to know:
  130.  
  131.         o The types and number of modems available for dial out
  132.         o The TTY ports attached to the modems
  133.         o The range of baud rates at which the modems operate
  134.         o How to initialize the modems to suit Pcomm's needs
  135.         o How to make the modems dial
  136.  
  137.     During this step, you will need write permission on the support
  138.     files in the default directory.  RESIST THE TEMPTATION TO EDIT
  139.     THE SUPPORT FILES DIRECTLY.
  140.  
  141. Portability considerations:
  142.  
  143.     1) This program was written with AT&T System V in mind.  It
  144.     makes use of System V specific routines such as shared memory
  145.     and the ioctl() calls of termio(7).  There is currently no
  146.     port to Berkeley or v7 Unix.
  147.  
  148.     2) Pcomm makes use of the bold, blinking and standout video
  149.     attributes.  My concept of "standout" and "reverse" might be
  150.     different than yours (I like "standout" to be a brighter version
  151.     of "reverse").  Check your terminfo database...
  152.  
  153.     3) The "port.c" file has a place where you can include your own
  154.     routine to toggle the getty process on a port (if required).
  155.  
  156.     4) If you compile Pcomm with LOG_CALLS defined, you'll have to
  157.     look at the code in "admin.c" to see if the long distance
  158.     detection routine is correct for your site.
  159.  
  160.     5) Compilers that adhere to the draft ANSI C Standard will bark
  161.     at the declartions of signal(), perror(), malloc(), fread(), and
  162.     fwrite().
  163.  
  164. Emmet P. Gray                US Army, HQ III Corps & Fort Hood
  165. ...!uunet!uiucuxc!fthood!egray        Attn: AFZF-DE-ENV
  166.                     Directorate of Engineering & Housing
  167.                     Environmental Management Office
  168.                     Fort Hood, TX 76544-5057
  169.