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