home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume39 / planner / part01 / README < prev    next >
Encoding:
Text File  |  1993-08-23  |  3.1 KB  |  57 lines
  1. Steve Franklin  (not the original author)
  2. franklin@ug.cs.dal.ca
  3. Compiled on August 8th, 1993
  4.  
  5. Before I continue by describing what all of this does, I should point out that
  6. I am not the original author of this software. I have modified it like
  7. many before me and am now trying to simplify the documentation as so many
  8. users have requested.
  9.  
  10. Purpose: The purpose of namedp is to create an ultra cool .plan file so
  11.          that people can get random .plan's when they finger you. It
  12.          can be used in a variety of ways, and depending on how creative
  13.          you are, can make you rich beyond your wildest dreams (well, sorta)
  14.  
  15. Contents:   Makefile      Self-explanatory - type "make" to compile
  16.             logfinger     Hardly changed this - perl script to log whos fingering
  17.             lf            Short script to let you know when you were last fin'd
  18.             plan.1        Man page
  19.             plan.c        C-code for the plan application
  20.             planner       Shell script that shows a couple of neat tricks
  21.             readme.orig   Original read me that was getting a tad "congested"
  22.             renewplan     Script for starting up plan cleanly.
  23.  
  24. Changes: The original plan seemed quite concerned with who was fingering you 
  25.          from your local machine, but just logged "somebody" as fingering
  26.          you if it was from another machine. All it took was a few additions
  27.          (a la netstat) to let you figure out which machine is fingering you
  28.          and a few more changes to impress the fingerer by letting them
  29.          know their hostname. These settings are recorded into a file that
  30.          you can later query.
  31.  
  32. Requirements:  In order to run plan, you need bsd-ish architecture. Users
  33.                running ULTRIX are out of luck, as are VMS users of course.
  34.  
  35. Instructions:  The simplest way to sort through this is to first edit
  36.                "planner","renewplan" and "logfinger" to resemble your environ.
  37.                and your preferences. Then, place plan and renewplan in 
  38.                your bin directory or any dir that your $PATH variable points 
  39.                to. Simply type "renewplan" and it does the rest for you.
  40.  
  41. Questions:     Feel free to send questions to franklin@ug.cs.dal.ca
  42.                but please try to read through all the documentation as well.
  43.  
  44. Cautions:      If your machine reboots, you will have an empty named pipe
  45.                pointing at no process (it doesn't exist since the machine 
  46.                rebooted). So, you have to restart the plan process (renewplan)
  47.                after a reboot. If you don't catch it, people's finger 
  48.                processes will clog up your finger port. To get around this
  49.                I had an "at + 1 hour..." included in "renewplan" to re-exec
  50.                renewplan every hour - if there was a reboot, plan would
  51.                start up no more than an hour after the reboot. 
  52.  
  53. Example:       Check out franklin@ug.cs.dal.ca for an example of how the
  54.                namedp pipe can be used - hopefully it's up and running :)
  55.                Hopefully you guys will mail me if you get neat ideas of
  56.                your own...
  57.