home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / pmfd10c.zip / pmfd.doc next >
Text File  |  1995-12-05  |  8KB  |  200 lines
  1. ---------------------------------------
  2.  OS/2 Presentation Manager
  3.      TCP/IP Finger Daemon v1.0c
  4.  for TCP/IP v2.0, v3.0 or Warp Connect
  5. - - - - - - - - - - - - - - - - - - - -
  6. by Amilcar Ubiera
  7.    amubiera@eos.ncsu.edu
  8. - - - - - - - - - - - - - - - - - - - -
  9. last updated 12/05/95
  10. ---------------------------------------
  11.  
  12. Since OS/2 TCP/IP 2.0 nor OS/2 Connect came with a Finger Daemon, I decided
  13. to charge ahead and make one.
  14.  
  15. This simple server lets the operating system identify itself with the user
  16. that is currently using the machine. Unlike UNIX systems, OS/2 is a single
  17. user operating system, therefore, not having any native user listing features
  18. of the currently logged on users.
  19.  
  20. -------------------------
  21.  I N S T R U C T I O N S
  22. -------------------------
  23.  
  24. I. INSTALLING THE FINGER SERVER
  25.    All you need to do is unzip the archive and
  26.    put the files into a directory in your path.
  27.    There is no INSTALL executable, just run
  28.    PMFD.EXE .
  29.  
  30. II. HOW TO USE THE SERVER
  31.    1. ADDING A USER
  32.       The first time you run PMFD the user list will be empty.
  33.       To add a user just click the 'Add User' button. A dialog
  34.       window will ask you for the user ID to be added.  The user
  35.       will be then added to the 'User Select List.'
  36.  
  37.       No checking is done on the text you input, so watch
  38.       out what kind of characters you put in there, I haven't
  39.       tried everything yet.  :)
  40.  
  41.       The maximum number of users that can be added is 256 for
  42.       this version of the daemon.  And the maximum number of
  43.       characters for the ID is 32 characters long.
  44.  
  45.    2. DELETING A USER
  46.       To delete the currently highlighted user, simple click
  47.       the 'Delete User' button.
  48.  
  49.    3. SELECTING A USER
  50.       To select a user, simply click on the user ID from the
  51.       'User Select List.'  Once the user is selected, the
  52.       server will show this user to the clients inquiring
  53.       finger information.
  54.  
  55.         e.g.   Suppose you have one user with ID 'Amilcar' already
  56.                added and highlighted. When some remote client
  57.                tries to connect he/she will see:
  58.  
  59.                unix% finger @helkyn.catt.ncsu.edu
  60.                [helkyn.catt.ncsu.edu]
  61.                Login Name
  62.                Amilcar is logged-on
  63.  
  64.         e.g.   or if the remote client typed:
  65.  
  66.                unix% finger Amilcar@helkyn.catt.ncsu.edu
  67.                [helkyn.catt.ncsu.edu]
  68.                Login name: Amilcar
  69.                In real life: Amilcar M. Ubiera
  70.                Office: 502D Wood Hall NCSU
  71.                Phone: (919)-512-6755
  72.  
  73.                 --logged on--
  74.  
  75.                Plan:
  76.  
  77.                 --none--
  78.  
  79.    4. HIDING THE USER
  80.       Once a user is selected, the server will show this user
  81.       as I mentioned in section 3.  But if you're working on
  82.       some heavy duty deadlined project, and you don't want
  83.       people to know you're on-line, just click on the
  84.       'User is Hidden' check box and the server will always
  85.       respond with:
  86.  
  87.                unix% finger @helkyn.catt.ncsu.edu
  88.                [helkyn.catt.ncsu.edu]
  89.                Login Name
  90.                no one is logged-on
  91.  
  92.       until you uncheck the check box again.
  93.  
  94.    5. CONFIGURING A USER
  95.       To configure the user information just select a user
  96.       you want to configure and click on the 'Configure'
  97.       button.  A dialog box will show up with the configuration
  98.       information for the current user.  The fields that can
  99.       be modified are as follows:
  100.  
  101.                Login name:           <-- login ID
  102.                Office:               <-- office where user is located
  103.                Real Name:            <-- the users real name
  104.                Phone No.:            <-- the users phone number
  105.                Plan file location:   <-- .plan file for the user (as in unix)
  106.                Idle timeout:         <-- time to logoff user after # min idle
  107.  
  108.       These fields can be changed as you wish and they will immediately
  109.       reflect the output a client gets.
  110.  
  111.       The plan file will be shown after all the other information has
  112.       been sent to the remote connection.  This file should be a plain
  113.       ASCII file, preferably ending in .PLN for consistency.
  114.  
  115.    6. EXITING THE SERVER
  116.       To shutdown the finger server, simply click on the 'Exit'
  117.       button.  The TCP/IP socket will be closed, and fingers will no
  118.       longer be serviced.
  119.  
  120.    7. GETTING ABOUT INFORMATION
  121.       To get info on the server and the author, just click on
  122.       the 'About' button and a dialog box will pop-up with
  123.       the daemon version, my name and e-mail address for contact info.
  124.  
  125.    8. PMFD.INI <-- what about it?
  126.       So that there is no mystery, here is the structure on PMFD.INI
  127.          <INDEX OF SELECTED USER> <RETURN>
  128.          <USER1 LOGIN_ID> <RETURN>
  129.          <USER1 OFFICE> <RETURN>
  130.          <USER1 PHONE#> <RETURN>
  131.          <USER1 PLANFILE> <RETURN>
  132.          <USER1 TIMEOUT> <RETURN>
  133.          <RETURN>
  134.          <USER2 LOGIN_ID> <RETURN>
  135.          <USER2 OFFICE> <RETURN>
  136.          <USER2 PHONE#> <RETURN>
  137.          <USER2 PLANFILE> <RETURN>
  138.          <USER2 TIMEOUT> <RETURN>
  139.          <RETURN>
  140.                  .
  141.                  .
  142.                  .
  143.  
  144.       If you mangle the PMFD.INI, the program will behave strangely,
  145.       as I have experimented with it.  So just let the program do
  146.       what it needs to do, unless you follow the structure that I
  147.       show above.
  148.  
  149. III. INCOMING FINGERS LIST
  150.    This list shows the IP address, time and date of the clients
  151.    that have connected to the server.
  152.  
  153.    For example, if you running the server and a machine with IP address
  154.    152.1.43.4 was looking for finger info, you will see the following
  155.    show up:
  156.                Incoming Fingers --------
  157.                152.1.43.4  16:06(11-28)
  158.                152.1.43.4  15:55(11-28)
  159.  
  160.    This person fingered your machine at 4:06PM November 28 of this year.
  161.    And previously at 3:55 of the same day.
  162.    As the incoming fingers arrive, the most recent ones will be towards
  163.    the top.
  164.  
  165. IV. FUTURE VERSIONS OF PM FingerD
  166.  
  167. 12/05/95  PM FIngerD v1.0c:
  168.              Fixed a couple of identifaction bugs.
  169.              It reported everyone as being logged on.
  170.              This is wrong.  It is fixed now.
  171.  
  172. 12/02/95  PM FingerD v1.0b:
  173.              Added user configuration dialog box and
  174.              .PLN file support, still needs timeout
  175.              support worked on.
  176.  
  177. 11/28/95  PM FingerD v1.0a:
  178.              First release, very light version.
  179.  
  180.    -------------------
  181.  
  182.    I will continue to update this daemon, as I hunger for more features.
  183.    I am planning to add customization features on the details of the
  184.    incoming fingers, as well as loggin these to a file.  Other properties
  185.    and configuration options for the daemon will be nice later on too.
  186.  
  187.    I'll get to writing a .INF file for the currently disabled HELP buttons,
  188.    but for now, there is nothing too complex that can't be intuitively
  189.    figured out from this server to require a HELP file.
  190.  
  191.    If you have any suggestions on what to add next to this simple but
  192.    cool finger service, just drop me an e-mail.
  193.    Or if you have any bug reports and such, send them too.
  194.  
  195. --------------------------------
  196.                                        Amilcar M. Ubiera
  197.                                        amubiera@eos.ncsu.edu
  198.                                        Junior in Computer Science at NCSU
  199.                                        http://www.catt.ncsu.edu/~leo
  200.