home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / program / hacking / hunter / !Hunter / !Help < prev    next >
Encoding:
Text File  |  1993-07-08  |  6.6 KB  |  181 lines
  1.    _______  __  __  ______   __  __  __  __  ______  _______  ______  _____
  2.   /__  __/ / / / / / ____/  / / / / / / / / / _   / /_   __/ / ____/ / _   /
  3.     / /   / /_/ / / /__    / /_/ / / / / / / / / /    / /   / /__   / /_/ /
  4.    / /   / __  / / ___/   / __  / / / / / / / / /    / /   / ___/  / ___  \
  5.   / /   / / / / / /___   / / / / / /_/ / / / / /    / /   / /___  / /   / /
  6.  /_/   /_/ /_/ /_____/  /_/ /_/ /_____/ /_/ /_/    /_/   /_____/ /_/   /_/
  7.  
  8.                                  RELEASE 2 
  9.                                
  10.                          Written by Adrian Carpenter
  11.  
  12.                      VERSION 1.07 (16:35:33 25-Apr-1993)
  13.                                 
  14.                       © ARMFul & Adrian Carpenter 1993
  15.  
  16.  ———————
  17.  License
  18.  ———————
  19.  
  20.  This program is public domain, this software may be given free of charge, 
  21.  although charges may be used for Discs, time and postage and packaging.  
  22.  You may not use this software to obtain source code from commercial 
  23.  programs, and neither may you use this software to break someone else's 
  24.  copyright.  Neither I nor ARMFul can accept responsibility for damage to 
  25.  anything through the use or the misuse of the software, no warranty is 
  26.  expressed, implied or anything.  Please note, it is impossible to obtain
  27.  the source code for this program by using 'The Hunter', as the software
  28.  contains a system called 'Stalker' which stops it from being loaded into
  29.  'The Hunter'.  All Source and Object code remains the © Copyright of 
  30.  Adrian Carpenter and ARMFul 1993.  The 'Loader' file is © ARMFul 1993.
  31.  
  32.  ——————————————————
  33.  About 'The Hunter'
  34.  ——————————————————
  35.  
  36.  The Hunter started life as a small BASIC program, it was very slow but
  37.  was suprisingley very small in size.  It was written for Adrian Gilby 
  38.  as a program to try to get the !FishDemoS program working, although it
  39.  seemed that the programmers did rather more than I first expected.
  40.  The first versions worked well and provided easy access routines to 
  41.  convert to the ARM Code, which all later versions have been coded in.  
  42.  The Hunter provides some useful functions in manipulating Object code 
  43.  of files, it allows you to extract source code  and remove a SWI of your 
  44.  choice (This function as well, is still to be implemented).  At present
  45.  this program removes OS_UpdateMEMC from machine code programs which mostly
  46.  fails to work on machines fitted with Risc OS3.
  47.  
  48.  ————————————————
  49.  Using The Hunter
  50.  ————————————————
  51.  
  52.  This version has been provided in an Application directory unlike previous
  53.  versions, this should be loaded like other applications.  The software
  54.  will then take over the whole machine and display the 'ARMFul' Logo
  55.  (By the way the 'Loader' program and ARMFul Logo are © ARMFul 1993), you
  56.  whould now press space and now you will enter 'The Hunter'.
  57.  
  58.  This version unlike previous versions do not have case sensitive commands,
  59.  so it doesnt matter weather a command is entered as 'L' or 'l' as a small
  60.  routine converts the letter to uppercase anyway.
  61.  
  62.  On this version a much smaller menu bar has been 'Cooked' up (Thanks go
  63.  to Adrian Gilby for reminding me that the commands should not be case
  64.  sensitive and should correspond to a main letter of the command, earlier
  65.  versions meant if you wanted to load a file you entered 'A'!) so it's
  66.  much easier to select an item.  When 'The Hunter' is invoked you have the
  67.  following choices:
  68.  
  69.  <L> Load Object 
  70.  <S> Save Menu
  71.  <T> Toggle Print
  72.  <D> Disassemble
  73.  <Q> Quit
  74.  
  75.  The 'Save Menu' appears at the Command prompt, and it goes something like
  76.  this:
  77.  
  78.  <O> Save Object
  79.  <S> Save Source
  80.  
  81.  ———————————————————————
  82.  Using The Hunter Part 2
  83.  ———————————————————————
  84.  
  85.  When the Hunter is Loaded, you will get a screen which looks something 
  86.  like the following:
  87.  
  88.  <L> Load Object    <S> Save Menu      <T> Toggle Print    <D> Disassemble
  89.  <Q> Quit
  90.  -------------------------------------------------------------------------
  91.  Welcome to The Hunter v1.07
  92.  © ARMFul & Adrian Carpenter 1993
  93.  Command:>
  94.  
  95.  
  96.  The Commands above stay up to top of the screen all of the time, this is
  97.  so you don't forget which one to use!
  98.  
  99.  ———————————————————————
  100.  How to use the Commands 
  101.  ———————————————————————
  102.  
  103.  <L> Load Object
  104.  ---------------
  105.  
  106.  This command Loads up a file, before any commands can be used (With the
  107.  exception of Toggle Print and Quit), when this command is used you should
  108.  be greeted with the following prompt:
  109.  
  110.  Filename:
  111.  
  112.  At this point you should type in the name of the file which must be in the
  113.  CSD.  If you hit L by mistake, simply press return and no hard will be 
  114.  done.  Should you type in a invalid filename or the filename of a file
  115.  that does not exist then you will be warned of this with a 'File not found'
  116.  error.
  117.  
  118.  <S> Save Menu
  119.  -------------
  120.  
  121.  This command brings up a small menu, this is where the commands to save the
  122.  file currently held in the memory are housed, you have the choice of the
  123.  following:
  124.  
  125.  {
  126.  
  127.  <O> Object
  128.  ----------
  129.  
  130.  This will save the object code held in the memory.  This is used to save
  131.  a modifed file when the OS_UpdateMEMC has been found and removed (See
  132.  Disasseble) the file should be runnable.
  133.  
  134.  <S> Source
  135.  ----------
  136.  
  137.  This saves the source as a TEXT (&FFF) file, the file contains all the 
  138.  lines for compiling, so simply load it into BASIC and run it, and you
  139.  will end up with the object code.
  140.  
  141.  }
  142.  
  143.  <T> Toggle Print
  144.  ----------------
  145.  
  146.  This command toggles whether or not the program is displayed when the file
  147.  is dissasmbled.  This is a useful command because a large program will
  148.  have a large listing.  When the listing is on, the program drops it's
  149.  performance quite a lot, so if you simply want to hunt out "OS_UpdateMEMC"
  150.  is suggest that you toggle the state (Press T) until is displays 'Print is
  151.  now off'.
  152.  
  153.  <D> Disassemble
  154.  ---------------
  155.  
  156.  This drops you into the Hunters 'VERY SIMPLE' disassembler.  It simply steps
  157.  through where the program is 'Hunting' out 'OS_UpdateMEMC' commands, you
  158.  have no control over the disassembler (Apart from the Toggle Command)
  159.  and it's main use is for looking at Modules to see how certain things
  160.  are done. (For a FULL Disassembler I would reccomend !Diss from DoggySoft
  161.  I have a couple of Demo copies which look very nice indeed, contact 
  162.  DoggySoft on the Digital Databank BBS..In PD Unlimited under Groups (A1).).
  163.  
  164.  <Q> Quit
  165.  --------
  166.  
  167.  Err, actually I think this command speaks out for itself!
  168.  
  169.  ---------------------------------------------------------------------------
  170.  
  171.  If you have any problems whilst running this program, please contact me and
  172.  I will try my BEST to cure the problem.
  173.  
  174.  How to contact ARMFul
  175.  
  176.  We can be contacted on The Digital Databank BBS in PD Unlimited under
  177.  Groups (A3).
  178.  
  179.  We can also be found on Arcade and TWoC.
  180.  
  181.