home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / fingerd2.zip / fingerd.txt < prev    next >
Text File  |  1994-05-30  |  6KB  |  163 lines
  1.         Fingerd for OS/2
  2.  
  3. ================== Overview =====================
  4.  
  5. This is a finger daemon for OS/2.  It is designed to work with IBM's TCP/IP
  6. version 2.0 or later.  The finger daemon supports the following features:
  7.  
  8.     Outputs a user specified file
  9.     Outputs the output of programs
  10.     Supports logging of finger requests (includes a time/date stamp)
  11.     Can beep whenever finger info is requested
  12.     Can display debugging info (same as log, but to screen)
  13.     Can execute external programs and scripts and have their
  14.       output appear in the finger info.
  15.  
  16. There is no information displayed on idle time or shell or other such
  17. things because it is irrelevent under OS/2.  (Well, not idle time, but
  18. that's for the next version).
  19.  
  20. There are a number of parameters for fingerd, which are listed as follows:
  21.  
  22.     -f filename    This parameter specifies which file is to be
  23.             used for finger requests.  This parameter is
  24.             *required*.  See the info on the finger data file.
  25.  
  26.     -l filename    This parameter specifies a file where all finger
  27.             requests will be logged to.  The file is only
  28.             appended to.
  29.  
  30.     -s servicename|portnumber
  31.             This parameter specifies that a different service or
  32.             port is to be used.  The default is the finger service,
  33.             which is usually assigned to port 79.  This parameter
  34.             is optional and will likely be removed from future
  35.             versions.
  36.  
  37.     -p protocol    This parameter allows you to choose the protocol
  38.             used.  The default protocol is tcp, but udp may
  39.             be used specified instead.  the protocol can be
  40.             either "tcp" or "udp" (without the quotes).
  41.  
  42.     -d        This parameter causes fingerd to display
  43.             the site and port number used for any finger requests.
  44.             It also reports which user the client was trying to
  45.             finger.
  46.  
  47.     -b        This parameter causes fingerd to beep whenever
  48.             a client connects to it.
  49.  
  50. ==================== Demonstration ===================
  51.  
  52. For a demonstration of this finger daemon, run demo.cmd.
  53. This shows off many of the features of this program.
  54.  
  55.  
  56. ==================== Installation ====================
  57.  
  58. fingerd can be started either manually or automatically.  To start it manually,
  59. type:
  60.  
  61.     fingerd -f x:\directory\filename.ext
  62.  
  63. where x:\directory\filename.ext is the drive, directory, and filename of the
  64. data file you are going to use.  I suggest using a filename called finger.dat
  65. and placing it in c:\tcpip\etc, or wherever your etc directory for TCP/IP is 
  66. located.  Please see the section on the finger data file before creating it.
  67.  
  68. If you are concerned about security on your system, I recommend using the
  69. -l and/or -d option.  This will allow you to keep track of systems fingering
  70. you often.  If you're really paranoid, use the -b option to make it beep.
  71. The screen output from the -d option and the output to the log file are
  72. almost the same, with the exception being that the log file also records the
  73. date and time of the finger request.
  74.  
  75. I suggest copying the file fingerd.exe to your \tcpip\bin directory.  If
  76. you want the finger daemon to automatically start each time you boot up,
  77. add it to tcpstart.cmd in \tcpip\bin.
  78.  
  79. The added lines typically look like the following:
  80.  
  81. start /min fingerd -f c:\tcpip\etc\finger.dat -l f:\tcpip\etc\finger.log -d -b
  82. echo     ..... Finger Daemon Started
  83.  
  84. You should change it as necessary.  The /min after the start command
  85. tells OS/2 to start it minimized.  Unfortunately, every time you run 
  86. tcpipcfg.exe it removes the finger daemon from tcpstart.cmd.  I am looking
  87. into a way of solving this problem.
  88.  
  89. Finger Data File
  90. ----------------
  91.     The finger data file is what is sent out on a finger request.
  92.     This file is for the most part straight ASCII.  It is highly 
  93.     recomended that no ASCII values > 127 are used, since some
  94.     *N*X type systems will gag, namely Linux.  Also, try avoiding
  95.     escape sequences, since the terminal connected to you may not
  96.     be what you are expecting.
  97.  
  98.     A feature has been added which allows you to execute a program or
  99.     script and have the output (up to 32K) piped through the finger
  100.     daemon to the client.  To use this feature, place 
  101.  
  102.         ~x command [parameters]
  103.     
  104.     starting on the left margin.  Future versions of this program will
  105.     elliminate the 32K restriction.
  106.  
  107.  
  108.     Here is an example finger data file:
  109. =====finger.dat=======
  110. Welcome to my host!
  111. ~xtest.cmd
  112. You can also do input redirection:
  113. ~xprogram.exe <inptfile.dat
  114.  
  115. You can also include other data files:
  116. ~x type otherfile.doc
  117. ======================
  118.  
  119. As you can see, this finger daemon is pretty powerful.
  120.  
  121. I suggest looking at the finger.dat file included to see how it works.  
  122. It's fairly straight forward.
  123.  
  124. Using the ~x feature will slow down the finger daemon significantly.  There is
  125. a lot of overhead when the daemon has to execute another program which cannot
  126. be eliminated.  If you are receiving a lot of finger requests, try to limit
  127. the number of external programs and/or scripts used.
  128.  
  129. This program has been tested with IBM TCP/IP version 2.0 on an ethernet
  130. network with machines running OS/2 and Linux.  SLIP connections have also been
  131. tested.  
  132.  
  133. Testing:  All features have been carefully tested, however I have only tested
  134. this with IBM TCP/IP version 2.0 since I don't have access to any other
  135. versions.  If you are running an earlier version and it works, let me know.
  136. It should work.
  137.  
  138. Features left to add:
  139.     A macro which will display info typically shown on *N*X finger.
  140.     Clean up the code.  Make lots of procedures.
  141.     Change the pipe code for asynchronous execution for unlimited output.
  142.         (This isn't really necessary, since no one wants to
  143.         receive >32 from a finger request anyway!)
  144.     Allow this program to be tied to inetd (Anyone have any info on this?)
  145.     Add support for multiple finger data files (one per user).
  146.  
  147. Forthcoming programs:
  148.     A PM write daemon and a new talk program based on ytalk.
  149.     (If I can ever get the info on how the protocols for these programs
  150.     work).
  151.  
  152. If you have comments or questions, I can be reached by email at
  153. aaronw@cats.ucsc.edu (until June 18), or by snail mail at
  154.  
  155.     Aaron Williams
  156.     35900 Turpin Way
  157.     Fremont, CA.
  158.     94536-2666, USA
  159.     Phone: (510) 792-0340, FAX: (510) 792-3243
  160.  
  161. (Please note that these numbers are subject to change since I'm graduating
  162. in a couple of weeks.  Any comments will be forwarded, however.)
  163.