RASFinger v0.2 rev 2
====================
Copyright (C) 1996/97 Oliver Dippel

Purpose:
--------
Retrieves informations about all users logged on to a Windows/NT RAS-Server.

Requirements:
-------------
This program only runs under Windows/NT.

Usage:
------
rasfinger [-S s][-I ip][-v][-?|h]
        -S s : get information from RAS-Server s
        -I ip: show the port matching the IP address ip
        -v   : show verbose output
        -?|h : show this help information

With no argument given, the userinformation from the local machine is 
retrieved. You can also specify the NETBIOS name of another RAS server by
using the -S commandline option. The name of the remote RAS server can be
given in one of the following ways: 
   RASFINGER -S RASSERVER
   RASFINGER -S \\RASSERVER
The output of such a command looks like:
  ------//------
RASFinger (C) 1996/97 by Oliver Dippel, od@mabi.de,  Version 0.2 rev 2
RAS Version       : NT Server 3.5/3.51 RAS server/client
RAS used/all ports: 5/10
RasAdminPortEnum: server result code=2123
RasAdminPortEnum: Completed successfully
Port name    DType Dev name                                 User name
PcimacISDN1  ISDN  Pcimac                                   ch
PcimacISDN2  ISDN  Pcimac                                   od
PcimacISDN3  ISDN  Pcimac                                   ad
PcimacISDN4  ISDN  Pcimac                                   hifreak
COM5         Modem Motorola 3400-HGM                        ak
COM6         Modem Motorola 3400-HGM-lame                   -
COM1         Modem USR Sportster 33600-HGM                  -
COM2         Modem USR Sportster 33600-HGM-lame             -
COM3         Modem USR Sportster 33600-HGM                  -
COM4         Modem USR Sportster 33600-HGM                  -
  ------//------
The "RAS Version" field can have one of the following values:
  LAN Manager version 1.0 RAS server
  NT Server 3.5/3.51 RAS server/client
  NT Server 4.0 RAS server/client
"Used ports" are the ports on the RAS server that are in use for dial-in,
"all ports" are all available ports for dial-in/dial-out.
The next two lines result from the debug code in the release version of 
Windows NT (;-).
The last lines are describing the port: The portname as it appears in the 
remote access configuration, the device type of the port, the device name 
and the user currently connected to that port.

With the commandline option -v you get a lot more information about each 
used port. The output looks like the following for each CONNECTED port:
  ------//------
Port name    DType Dev name                                 User name      
PcimacISDN1  ISDN  Pcimac                                   ch
   Line Speed                : 64000
   Messenger service         : YES
   Multilink active          : NO
   NETBIOS gateway active    : YES
   Online since              : Tue Dec 10 21:45:00 1996
   Sent/Received             :     147849      29167
   Uncompressed Sent/Received:     231006      59193
   Compressed   Sent/Received:     163615      26493
   IP No                     : 1.2.3.4
   Workstation               : CH
  ------//------
The first line show the line speed of the connection.
The next three lines are describing the the flags for "Messenger service",
"active Multilink" and "active NETBIOS gateway".
The next line shows the information about the connection duration.
In the next three lines there is a lot of information about the transfer 
statistics. Especially the info about uncompressed transfer is very 
interesting since the eventlog of the NT server does only include the 
compressed transfer information. Finally you get information about the IP
number that is assigned to the caller and the remote workstation name.
The option "-I ip" has been included on special demand. You can specify an
ipaddress ip, which results in an output that is restricted to the connected
port with the client ip address "ip" (if there is any). Hope this helps you, 
Rick !

Release history
---------------
 *	96-11-11	start of development on rasfinger
 *	96-11-13	0.1 rev 1
 *				Bugfree (?) first version of rasfinger
 *				gets all ports and connected users, no transfer info
 *	96-11-19	0.1 rev 2
 *				making experiments with RAS_PORT_0 array
 *	96-11-20	0.1 rev 3
 *				try to get connection info via RasAdminPortGetInfo()
 *				added (v)erbose info about connection: 
 *				bytes, time, multilink, ..
 *	96-12-10	0.2 rev 0
 *				RELEASE Version 0.2 - first official release
 *				identicaly with 0.1 rev 3, added icon, created docu
 *	96-12-17	0.2 rev 1
 *				changed some internal stuff, extended error messages
 *	97-11-11	0.2 rev 2
 *				added linespeed info, added option only to show the 
 *				portinfo for a specified IP address


Legal stuff and status of this software:
----------------------------------------
This program comes without any warranty either implied or expressed. In no
case shall the author be liable for any damage or unwanted behavior of any
computer hardware and/or software.

RASFINGER is postcardware. 

This means that this program is donated to the public domain and is 
basically free. The only restictions is that you are encouraged to send 
me a postcard from your city. See the address at the bottom of the text.


Thanks:
-------
I want thank Christoph H. Hochstaetter for the hints on various items of
programming during the last years.


About the author:
-----------------
The Author can be reached via an ground based or electron based transport 
system.

snail mail:
Oliver Dippel
In der Wann 31
35037 Marburg
GERMANY

email:
dippel@mabi.de
dippel@mathematik.uni-marburg.de
(Just for the case one of the addresses expires ..)
