The Unsorted BBS Collection/thegreatunsorted.tar/thegreatunsorted/hacking/phreak_utils_pc/super5.doc

Text File | 1993-01-15 | 14.3 KB | 256 lines

SuperPhreek 5.0 Documentation and instructions.
Written by Terrible Terry the Tyrant.

C O N T E N T S

          I   Introduction
         II   Features
        III   The file menu options
         IV   The modem menu options
          V   The setup menu options
         VI   The run menu options
        VII   What next?
       VIII   Credits


- I - INTRODUCTION

SuperPhreek 5.0 is a utility that uses your modem to locate other
remote modems connected to computers in auto-answer mode. Many
computer systems are connected to the outside world via a modem and
telephone line. SuperPhreek will sequentially scan for those
computer systems. When SuperPhreek connects to a remote system, it
immediately hangs up and logs the telephone number to a user-
definable device, which is usually a disk or printer. If
SuperPhreek does not find the dialed number to be a remote system,
it hangs up and goes on to the next number in the series. Because
some telephone numbers are not assigned to anyone, SuperPhreek
dials from user-assigned blocks of telephone numbers called "sets".
Fifteen sets are available for your dialing pleasure. It is these
sets that allow you to skip blocks of numbers that you do not wish
to call. SuperPhreek incorporates pull-down windows and supports
a mouse. SuperPhreek will run on any PC with 256K and a modem.

- II - FEATURES

SuperPhreek supports the use of comports 1 through 4, and baudrates
up to 9600. All parity, stopbits, and databits configurations are
supported. SuperPhreek supports most any video card, and will
adjust accordingly. A special temp file records every 100th number
dialed, in case of power failure. You may stop SuperPhreek at any
time and quit the program, without loosing any information. All
configuration data is saved to the currently selected filename upon
exit. When you re-run SuperPhreek, you should re-load the desired
configuration file. If you did not select a configuration filename,
SuperPhreek will assign "NONAME.SPC" and "NONAME.DAT" for your
default data files. You may re-load any configuration file you had
previously saved if you like, or let SuperPhreek use its default
NONAME files. SuperPhreek is BNU and X00 compatible.

- III - The file menu options

The file menu options allow you to LOAD and SAVE any special
configuration. If for instance you have SuperPhreek setup with
special sets of numbers, delay rates, Hayes commands etc. you may
wish to save them for use when you return to re-run SuperPhreek
sometime, especially if you would like to start dialing where you
left off. To do this, setup SuperPhreek the way you want it, and
select the SAVE option in the files menu. Select a filename you
like, or let SuperPhreek use its own NONAME.SPC filename. This is
done by pressing the TAB key until the input line is highlighted.
You may now enter a filename. Now, to save all configuration data
for next time, press the TAB key again until the Ok is highlighted.
Now press RETURN. You configuration data will be saved. Now, the
next time you want to resume dialing with the same configuration
data, you may re-load the data you need. Remember, SuperPhreek will
automatically re-load NONAME.SPC when it is first run. If
NONAME.SPC exists, that configuration data will be loaded. You may
still load a different configuration file anytime you like. Be
warned that if you load a new configuration file, your old one will
NOT be saved. You must save it yourself if you want to keep the
current version of it. Generally speaking, the LOAD option works
the same as the SAVE option does as far as functionality. Remember
to use the TAB key to get around in the LOAD and SAVE windows. Be
sure to TAB over to the Ok and press RETURN to save or load.
SuperPhreek supports the SHELL command. To SHELL to DOS, press
RETURN when the SHELL option is green in the file menu. Type EXIT
to return to SuperPhreek. Technical: High was set to 655360 -
150000. Low was set to 0. The stack was left alone also.

- IV - The modem menu options.

SuperPhreek supports com ports 1 through 4. Select the COMPORT
option on the modem menu to select a comport. Use your TAB key to
get around the COMPORT window. The other modem menu selections are
the same. Use combinations of TAB and up/down arrows to get around.
Highlight the Ok and press RETURN to activate you selections. It
is suggested that you use 8 databits, 1 stopbits, No parity and
1200 baud. This is SuperPhreek's default setup. Please see that the
correct comport is selected before you start SuperPhreek to
dialing. SuperPhreek defaults to comport 2. If your modem works on
comport 1, then please change comports. Use SAVE in the files menu
to save that configuration if you like, or SuperPhreek will do it
for you automatically using the NONAME files.

- V - The setup menu options.

There are four options in the SETUP menu. The first one is the Init
Strings option. This option allows you to select Hayes modem
strings to suit your modem. Please refer to your modem manual for
further information on Hayes modem commands. Basically, it is these
Hayes modem commands that tell your modem how to act. Not all
modems are created equal, and some may need a configuration
different than SuperPhreek's default Hayes strings modem
configuration. The Init Strings describes the strings' jobs. The
first is issued when SuperPhreek first runs. This is a good place
for the ATM0 or ATM1 command. This will turn off or on you modems
speaker respectively. The second field is the string to send when
dialing each time. This is where your ATDT or ATDP command will go.
These commands dial TONE or PULSE respectively. Tone is the
default, although some people do not have tone dialing lines, and
they can change this field if that is the case. The third and final
field is the Hayes command to be send on exit of SuperPhreek. This
is usually something like ATZ. It might be something to reset the
modem to the way it was before SuperPhreek woke up. All three of
the fields here in the Init Strings window allow 127 characters,
although not many modems will allow such a long command. Please use
a combination of the TAB and arrow keys to navigate the window. To
get to the #2 strings line, TAB over to it. You will know you are
on it when it gets bright. You can now edit it, by pressing the
arrow key to the right or you can just start typing and re-do
everything in the line. TAB over to the Ok symbol and press RETURN
to activate your selections. The second option on the setup menu
is the Redial Time option. This is the time that SuperPhreek allows
before it redials the next number in the series. As with all other
options described above, you will need to use a combination of your
TAB and arrow keys to navigate this window. Select the appropriate
speed and TAB over to the Ok and hit RETURN to activate.
SuperPhreek's default setting here is the best by far. Unless you
have a very good reason, leave this option alone. The third option
on the Setup menu is the Numbers option. This is where you will
setup your dialing sets. These are numbers that SuperPhreek will
dial from to look for a remote system. There are fifteen sets here.
SuperPhreek will first look to set #1 to dial from. If there are
no entrees in set #1, it will go to set #2 and so on, until it
finds a valid set. There are three fields for each of the fifteen
sets in the Numbers window. The first field is any long distance
prefix that you might want to dial before the actual 7 digit
phonenumber. You of coarse do not have to have a long distance
number in this field, and actually may never need to, unless maybe
if it is a 1800 long distance number, which would make it a free
call anyway. This first long distance entry field will never be
incremented, as it is only added to the beginning of the actual 7
digit phonenumber for dialing. If you are dialing local
phonenumbers, you will not have anything in this first field at
all. The second field in the Numbers window is the 7 digit
telephone number to start dialing from. This number will be the
first number that is dialed. It will be dialed, and incremented
until it reaches what is in the third field in the Numbers window.
Once a set has expired (the START phonenumber is equal to the STOP
phonenumber), that set will never be dialed again, and the next set
will be called upon. Remember, the START phonenumber is the second
field, and the STOP phonenumber is the third field. To modify any
of these fields, simply use you TAB key to tab over to the set and
field in that set you would like to modify. The long distance field
(the first field in any given set) allows 127 characters to be
entered, which is way more than enough. The second and third fields
(the START and STOP phonenumbers) in any given set allows a 7
character number. To make the changes permanent in the Numbers
window, TAB over to the Ok message at the bottom of the screen, and
hit RETURN. Type an ESCAPE to escape with no changes. Once you have
a setup you like, you might consider Saving it from the Files menu.
If you do not, SuperPhreek will save it for you, and automatically
re-load the setup for you. If you exit the program in the middle
of a dialing session, SuperPhreek will know where to re-start
dialing from. The third option in the Setup menu is the Output Data
option. This window allows you to configure several very important
data collection options. There are two clusters of options at the
top of this screen, and two input lines down below. Cluster #1
allows you to set the output device for where the hits (connections
to remote systems) have been made. Legal options here are the
printer, file, or screen. By default, the screen is the only device
active. You will use a combination of your TAB and arrow keys to
navigate this cluster. Use your space bar to activate and
deactivate options in this first cluster. If file is selected, all
hits will be logged to disk. The filename of the file to log hits
to is in the second input line at the bottom of this Output Data
screen. Use you TAB key as usual to navigate to it for
modification. SuperPhreek's default filename to save the hits to
is NONAME.DAT. You do not have to change this filename if you do
not want to. If this file exists, it will not be overwritten, only
appended to. If this file does not exist, it will be created for
logging hits to. If you toggle the printer option in the first
cluster in the Output Data window, the printer will also be used
to log hits. Any device that has a X by it in this first cluster
will be used for logging. The printer device may vary from user to
user, so the second cluster option was added to SuperPhreek. This
second cluster allows you to select a printer device. Valid devices
are PRN (the most common and the default) or the AUX or the PRN2
devices. If you decide to play around and select a device that is
non-existent, you will receive a big fat system crash. SuperPhreek
does allot of checking (called idiot-proofing), but it will not
kiss your ass! Use some responsibility. If you don't know what your
printer device is, then it is most likely the default setting of
PRN. Leave this option alone if you don't know anything about what
I am talking about. So, basically, the first cluster (output hits
device(s)) works with the second input line in the Output Data
window. Cluster #2 in the Output Data window is only looked at if
the printer device is to be logged. If you do not have the hits
logged to the printer, then this second cluster (printer device)
will never be looked at. You MAY have SuperPhreek log hits to one
or more of the options in the first cluster (the output hit to
option). For instance, you can have SuperPhreek log all hits to the
screen, the file named in the second input line, and the printer
device named in the second cluster box. Once you have SuperPhreek
setup the way you like it, and are ready to commence scanning for
remote systems, you might consider saving all the selected options.
If you do not, SuperPhreek will save it for you, and re-load it
upon re-execution. The HELP option in SuperPhreek is for quick
overviews of what is what. Several Function keys are active. See
the Help window selection QuickKeys.
The data that is output when a system is encountered is simple.
First the phonenumber, then the set that was dialed from, then the
time and date of connect, then the number of hit is was - if it was
the 10th hit, there will be a 10 here.

- VII - What next?

Once you have a nice collection of telephone numbers in your file,
or on your printer paper, SuperPhreek's job is done. What you do
with this information is not my business. You may dial these
computers up if you like, and see what they are all about. You
might let DataBase Hacker do it for you though. DataBase Hacker was
written by another local, Lord Random. I understand that the next
version of DataBase Hacker will not only dial a remote system up
and interrogate it, but give you passwords when it is done for your
exploring pleasure. I also understand that the next version of
DataBase Hacker might have an option to allow the use of
SuperPhreek data files to be uses as a source of dialage, meaning
that DataBase hacker will use the list of telephone numbers output
by SuperPhreek to dial from, and interrogate those systems.

- VIII - Credits

Lord Random and The Master Cylinder are as responsible for giving
me the idea to write SuperPhreek 5.0. Had it not been for several
arguments we have had about programing languages, I might never
have wanted to prove that Pascal is by far the easiest language to
program in :) :). The async routines are the popular ASYNC12
routines written by Mark. The program was written in Turbo Pascal
6.0 using only object oriented programing routines from the Turbo
Vision library. Other than these two libraries used, the bulk 100K
of SuperPhreek is code by me, Terrible Terry the Tyrant.
SuperPhreek contains some 4000 lines of original code. If you were
to include all of the units and libraries used, the code would
surly exceed 20,000 lines. Please note that I did not have to
borrow from Turbo Vision, or Async12, but did, and SuperPhreek is
all the better for it. The source code is unavailable - sorry, you
try to write one!

There will not be a SuperPhreek 5.x or 6.0, as this version is
about as good as it gets.

Terrible Terry the Tyrant - 1/92