     
                   
                        
                        
                     

        ADUMP v1.0 (C) Copyright 1998 by tHeRaiN/UCF
     

     I.   What is A-DUMP?
     ~~~~~~~~~~~~~~~~~~~~~~~
         ADUMP is the ultimate dumper for SoftIce.

     II.  Disclaimer
     ~~~~~~~~~~~~~~~
         I, the author, am *NOT* responsible for any damage caused
         by the use of ADUMP.  Although the program was tested
         with only Windows 95. it may be in some cases incompatible.

     III. Usage and commands description
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
         ADUMP is very simple,just run the program
         and type 'h' to get a list of all avail commands.

         Notice: the () means that the parameter is optional
                 and [] means that the parameter should be filled up.

         Commands:
         ~~~~~~~~~~
         A [FN] [SIZE]                Assemble mapping file info to create
                                      one.It's runned automaticly
                                      when ADump first initialiase,
                                      giving [FN]  = %temp%\adump.log
                                      and    [SIZE]= 1,000,000 bytes.
                                      You can re-use this command to
                                      close the existing mapping file
                                      and create a new one.

         D (OFFS) (C) (FILTER) (CH)   Displays memory.
                                      It's have some extra features.
                                      The (C) = display lines count
                                      eg: d 82E70000 2,this displays
                                      two lines only.
                                      The (FILTER) = character list that
                                      should only be displayed.
                                      eg: d 82E70000 10 ABCDEF,this
                                      displays only the (FILTER) characters
                                      and all other are displayed with a '.'
                                      or with the (CH) value.


         L [FN] [C]  (OFFS)           Load file into memory.
                                      This command should know
                                      the [FileName] to load from
                                      and the bytes [Count] to read
                                      and u can optionally specify
                                      the memory location to read into.
                                      It by default reads into .CUROFFS

         W [FN] [C]  (OFFS)           Write memory to file.
                                      This command is almost like the 'L'
                                      except that it Write and not Loads.

         F [CH] [C]  (OFFS)           Fill memory with data.
                                      This should'nt be very usefull,
                                      because Winice can fill data-string not
                                      only a single characters.
                                      [CH]   = character to fill with.
                                      [C]    = count.
                                      (OFFS) = target memory offs (optional)

         H                            Display a quick help of all
                                      avail commands.

         R                            Display internal variables,which are:
                                       STARTOFFS: Mapped memory starting offs.
                                       ENDOFFS  : Mapped memory ending offs.
                                       LIMIT    : This equal .endoffs-.startoffs
                                       CUROFFS  : Current memory offs.
                                       MAPFN    : Mapping file name.
                                       MAPFSIZE : Mapping file size.
                                       ANFILTER : Alpha-Numeric characters filter.

         CLS                          Clears the screen.

         VER                          Display version.

         [ENTER]                      Executes the last user command.

         ? [NUMBER]                   Basic expression evaluator.
                                      [Number] or a [String]
                                      use the '+' sign before the number
                                      to indicate a decimal number.
                                      U can use it to evaluate the
                                      interval variables.
                                      eg: ? .anfilter
                                          ? .mapfsize

         ! [EXTERNAL-COMMAND]         Executes an external command.
                                      it can be use as:
                                      ![command]  = WinExec(Command)
                                      !![command] = dos-prompt command.
                                      !!!         = Shells to dos.

         Q                            Quit & saves current mapped file.


     IV.  Techincal Notes
     ~~~~~~~~~~~~~~~~~~~~
         ADump was coded using a Delphi3 using console mode application.
         I say Delphi3 console applications are'nt the best/fast
         to do memory manipulations,and stuff like this.

     V.   Credits
     ~~~~~~~~~~~~
         At this point I want to thank all the SoftIce dumpers makers
         from [The_Owl..Quine] for beeing helpfull by releasing
         the source code.

     VI.   History
     ~~~~~~~~~~~~~
           N/A

     VII.  Future Version
     ~~~~~~~~~~~~~~~~~~~~~
          I think i'll rewrite/optimize my source code
            so i might release in the future versions.

          Some new ideas will be added.

     VIII. The author
     ~~~~~~~~~~~~~~~~~~
         The author is tHeRaiN and also known as hACKER's FiNGERs
         email: newlbguy@yahoo.com

     IX.  Personal Greetinx and Thanx
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
         The_Owl  I want to greet thank the_owl for all his help
                   and his support and for beeing too kind with me.

         ANAKiN   Thanx for your nice and easy document skeleton.
                   It's my first time i write docs,and this
                   seems to be perfect with me.


         The_Owl,Iceman,DarkStalker,Quine,GOZ,[Drone],dOMNAR,Lorian,
         dJHD,in_sane,_MARQUIS,Lordbyte,Stone,Illumitie,
         . . . and all others i forgot.

        Groups Greetz:  UCF | F4CG | DEMON | PGC | LAC

        PS: Readers,forgive me for my poor english,i'm a coder,not a writer.
