PortScan 1.0b introduction and help file, WD_40 10/13/1999

Please give me any feedback/bug reports!  oilspray@yahoo.com


(Table of Contents)

1.0 Introduction & Disclaimer
 1.1  Introduction
 1.2  Disclaimer

2.0 Features
 2.1   Scan: 
 2.2   Send Port
 2.3   Recv Port
 2.4   Stop Port
 2.5   Delay (MS)
 2.6   Open Sockets
 2.7   Quick Scan
 2.8   Reset on Halt
 2.9   Save on Halt
 2.10  Close IRC Ports
 2.11  Resolve Hostnames
 2.12  Common Ports Only
 2.13  Scan Results
 2.14  Result Logging
  2.14a  Save button
  2.14b  Filename
  2.14c  Overwrite

3.0 Teaser!
------------------------


1.0  Introduction & Disclaimer

   PortScan 1.0b is a mIRC based TCP port scanner.  If you've taken
the time to download this, I'm sure you know what a port scanner
is and how to use one.  
   Does the GUI look farmilliar?  Yes, I copied the basic layout of a popular
port scanner, however, my options are better, the code is my own, and my error
checking is better! So :P  
   I will be completly redoing the GUI in my next
release. 1) So that it's not a rip of the other scanner.  2) It's getting
cluttered don't you think?  3)  With all the new features, I need more space!


   Be advised:  Port scanning is illegal!
This is an educational utility designed for you to test the security
of your network. I (WD_40) will not be held responsible for the use,
or misuse of this script in any way.

  PortScan is provided "AS IS" without warranty of any kind, either express or
implied, including but not limited to the implied warranties of
merchantability and fitness for a particular purpose. In no event shall
WD_40 be liable for any damages whatsoever including direct,
indirect, incidental, consequential, loss of business profits, special
damages, costs or consequences of legal proceedings or litigation, even if 
WD_40 has been advised of the possibility of such damages.  Use at your own risk.
By using this script you agree to the terms and conditions described above.  
WD_40 will not be held responsible in any way for your failure to read, or inability
to understand the above stated conditions.

2.0 Features

   2.1 Scan
       The "Scan:" editbox is where you enter the IP address or hostname (which will be
       resolved to an IP) of the remote system you wish to scan.  If you uncheck the 
       "Resolve Hostnames" checkbox (refer to section 2.10 for more info) hostnames will not
       be resolved to an IP address.  This is not recommended, however the option is there.

       Note:  At this point in time if you enter a numeric IP address, PortScan does not check 
              to see if that address exists before attempting to scan it.  If you see the number
              of open sockets steadily increasing, there's a good chance the IP you entered doesn't
              exist.  You should Halt the scan and Reset all the sockets to avoid running out of
              socket recourses.

   2.2 Send Port
       This field displays the port that is currently being connected to.  Set this value to
       the port you want to start scanning from before pressing the Scan button.
 
   2.3 Recv Port
       This field displays the last port that a successful connection was made on.

   2.4 Stop Port
       Set this field to the final port the scan will stop on.

   2.5 Delay (MS)
       This field specifies the amount of time (in milliseconds) to wait before making
       the next connection.  Note: One of my beta testers said that while he was scanning
       Netscape complained it didn't have enough socket buffer space.  If you set this
       delay to a higher value, PortScan won't have as many sockets open and that should
       take care of the problem.  Perhaps in my next version I will limit the ammount of 
       sockets that PortScan can open.

   2.6 Open Sockets
       Shows how many sockets are in use.  

   2.7 Quick Scan
       When this checkbox is enabled the port is closed as soon as a connection is made.
       No data is read from the port and displayed to the results box.

   2.8  Reset on Halt
       When enabled, this option will close all sockets when the scan is halted or completed

   2.9  Save on Halt
       Automatically writes the contents of the results box to the file specified in the "Filename"
       field at the bottom of the GUI.  See section 2.13 for more info on logging

   2.10 Close IRC Ports
       If PortScan detects that it has connected to an IRC server, this feature will automatically close the 
       connection so that the results box will not be flooded with the IRC server's " *** AUTH " notices.

   2.11 Resolve Hostnames
        When enabled, PortScan will attempt to resolve the hostname in the "IP" field at the top of
        the GUI.  If you enter a value into the "IP" field that begins with a letter, PortScan assumes it's a
        hostname and automatically checks the "Resolve Hostnames" field.  If you enter a numerical IP, PortScan
        automatically unchecks "Resolve Hostnames"

   2.12 Common Ports Only
       Disables "Send Port" and "Rcev Port" and reads target ports from the common-ports.txt that
       is distributed with this script.  You may add ports you wish to scan to this file.  Correct syntax is:
       <port number> [optional port description] separated by at least one space.  In this version the port file
       is hard-coded, so do not rename it.  In my next release I will allow you to specify the port file you want
       to use.

   2.13 Scan Results
       Displays the open ports found on the remote system you're scanning.  Also displays any information received 
       from the remote system (as long as "Quick Scan" is not checked) and a description of the port if available.
       (Port definitions are located in "common-ports.txt" that is packaged with this script.)

   2.14 Result Logging

     2.14a Save Button
         Will write everything in the Scan Results box into the text file specified in the "Filename:" box located
         at the bottom of the GUI
 
     2.14b Filename
         Enter the path and filename of the file you want PortScan to log the results to.
         Pressing the "Filename" button will open the log if it exists.
   
     2.14c Overwrite
         When checked, the specified file will be overwritten when PortScan writes the log file.


   3.0 Teaser!
       Here's a sneak preview for what's cookin' in v2.0...

       - Ability to scan through a wingate!

       - IP broadcast list, you could scan an entire subnet if you want!
         Configurable port list files, no more hard-coded filenames!
         And anything else I think of along the way...
      
       - In v2.0 I will convert from pixels to DBU.  Some users that use a bigger font than normal
         get a messed up GUI.  DBU should fix that.
       
       - Ability to scan an IRC Nickname

  
Please give me any feedback, suggestions or bug reports!

E-Mail: 
oilspray@yahoo.com

IRC: 
Nicknames -
 WD_40, c0wboy

Networks-
 irc.dal.net;#scripts~are~us
           or
     irc.blazed.net
