home *** CD-ROM | disk | FTP | other *** search
/ Turbo Toolbox / Turbo_Toolbox.iso / td / readme. < prev    next >
Encoding:
Text File  |  1988-08-28  |  16.5 KB  |  425 lines
  1.           TURBO DEBUGGER 1.0 - Zusatzinformationen
  2.           ----------------------------------------
  3.  
  4. Diese Dokumentation enthält zusätzliche Informationen bzw.
  5. Korrekturen in letzter Minute, die nicht im Handbuch zu finden
  6. sind. Sie besteht aus den folgenden Dateien:
  7.  
  8. o    README         Allgemeine Zusatzinformationen
  9. o    MANUAL.DOC     Zusätze und Korrekturen im Handbuch
  10. o    HELPME!.DOC    Antworten auf häufig gestellte Fragen
  11.  
  12. INHALT
  13. ------
  14.  
  15.   1.  Unterstützung bei Problemen
  16.   2.  Installation
  17.   3.  Wichtige Erweiterungen
  18.   4.  Anmerkungen und Einschränkungen
  19.   5.  Zusätze und Korrekturen im Handbuch
  20.   6.  Dateien auf den Originaldisketten
  21.  
  22.  
  23. 1. UNTERSTÜTZUNG BEI PROBLEMEN
  24. ------------------------------
  25.  
  26. Bei Problemen mit dem Turbo Debugger bitten wir Sie, zuerst diese
  27. Dokumentation, die Datei HELPME!.DOC und dann das Handbuch
  28. sorgfältig durchzulesen. Wenn danach noch Fragen offen sind,
  29. können Sie sich an eine der folgenden Stellen wenden:
  30.  
  31.   1.  Ihren Softwarehändler
  32.   2.  Schriftlich an die technische Beratung der
  33.  
  34.         Heimsoeth software GmbH & Co KG
  35.         Lindwurmstraße 88
  36.         8000 München 2
  37.  
  38.   3.  In dringenden Fällen:
  39.  
  40.         Technische Beratung
  41.         Montag - Freitag 14.00 - 17.00
  42.  
  43.         Telefon:    089/725 80 01
  44.         Telex:      5 212 636d
  45.         Telefax:    77 93 39
  46.  
  47. Sie sollten auf jeden Fall die folgenden Dinge parat haben:
  48.  
  49.   o  Produktbezeichnung und Seriennummer (steht auf den
  50.      Originaldisketten).
  51.  
  52.   o  Versionsnummer des Produkts. Diese erhalten Sie beim Aufruf
  53.      des Turbo Debuggers, wenn beim Kommandozeilenaufruf keine
  54.      Argumente angegeben und keine Tasten gedrückt wurden.
  55.  
  56.   o  Die deutschen Handbücher.
  57.  
  58.   o  Produktnamen, Modellbezeichnung Ihres Computers und
  59.      eventuell installierte Zusatz-Hardware (speziell:
  60.      Grafik-Karten, Netzwerk usw.).
  61.  
  62.   o  Bezeichnung und Versionsnummer des Betriebssystems. Diese
  63.      können Sie mit dem Befehl VER ermitteln.
  64.  
  65.   o  Inhalt der Datei AUTOEXEC.BAT.
  66.  
  67.   o  Inhalt der Datei CONFIG.SYS.
  68.  
  69.  
  70. 2. INSTALLATION
  71. ---------------
  72.  
  73. A C H T U N G: Die Installation muß mit den Originaldisketten
  74. oder exakten Kopien der Originaldisketten vorgenommen werden.
  75. Kopien der Originaldisketten lassen sich nur dann verwenden, wenn
  76. sie mit DISKCOPY erstellt wurden.
  77.  
  78. Diese Diskette enthält das Programm INSTALL.EXE, das Sie bei der
  79. Installation des Turbo Debuggers unterstützt. Es gibt zwei
  80. Möglichkeiten der Installation:
  81.  
  82.   1.Festplatte - INSTALL kopiert alle Turbo Debugger-Dateien auf
  83.      Ihre Festplatte und legt die Dateien in Unterverzeichnisse.
  84.      Die Standardvorgaben für die Unterzeichnisse lauten:
  85.  
  86.        Turbo Debugger-Verzeichnis:                  C:\TD
  87.        Unterverzeichnis für die Beispiele:          C:\TD
  88.  
  89.     Standardmäßig werden alle Dateien auf den Originaldisketten
  90.      in das Turbo Debugger-Unterverzeichnis gelegt. Wenn Sie die
  91.      Beispielprogramme lieber in ein eigenes Unterverzeichnis le-
  92.      gen wollen, müssen Sie vor der Auswahl des Befehls START
  93.      INSTALLATION den Pfad für die Beispieldateien ändern.
  94.  
  95.   2.Diskettenlaufwerk - Mit dieser Auswahl erstellen Sie eine
  96.      arbeitsfähige Version des Turbo Debuggers auf vier
  97.      Disketten, die auf einem System mit zwei Laufwerken
  98.      betrieben werden kann. Dazu benötigen Sie vier formatierte
  99.      Disketten. Bei der Installation werden die folgenden
  100.      Disketten erstellt:
  101.  
  102.        Programmdiskette - Das Hauptprogramm des Turbo Debuggers,
  103.        die README-Datei, das Anpassungsprogramm für den Turbo
  104.        Debugger, die Dateien HELPME!.DOC und MANUAL.DOC.
  105.  
  106.        Arbeitsdiskette - Die Overlay-Datei für den Turbo Debugger
  107.        und die Datei mit dem Online-Hilfesystem.
  108.  
  109.        Utility-Diskette - Hilfsprogramme des Turbo Debuggers.
  110.  
  111.       Beispieldiskette - Beispielprogramme, die zusammen mit dem
  112.        Turbo Debugger verwendet werden.
  113.  
  114. Um mit der Installation anzufangen, wechseln Sie zum Laufwerk mit
  115. dem Installationsprogramm und geben INSTALL ein. Sie erhalten
  116. daraufhin Ihre Anweisungen in einem Fenster am unteren
  117. Bildschirmrand. Wenn Sie Ihre Installation zum Beispiel von
  118. Laufwerk A: aus durchführen wollen, geben Sie
  119.  
  120.  A:
  121.   INSTALL
  122.  
  123. ein. Bevor Sie mit der Installation weitermachen, sollten Sie
  124. aber vorher diese README-Datei zu Ende lesen, um die restlichen
  125. Informationen zur Installation parat zu haben.
  126.  
  127.  
  128.  
  129. WICHTIG:  In der deutschen Version sind die Dateien MANUAL.DOC
  130.           und TDHELP.TDH (deutsch) auf einer eigenen Diskette
  131.           (TD#4). Diese werden bei der Installation nicht mit
  132.           kopiert. Sie müssen daher diese Dateien selbst ins
  133.           gewünschte Verzeichnis kopieren.
  134.  
  135.  
  136.  
  137. Die Turbo Debugger-Diskette UTILITIES/BEISPIEL enthält einige
  138. Dateien mit der Dateierweiterung .ARC: TDEXAMPL.ARC,
  139. TAEXAMPL1.ARC und TAEXAMPL2.ARC. Diese Dateien enthalten einige
  140. andere Dateien, die komprimiert wurden und in einem Archiv
  141. abgelegt wurden. Mit dem Hilfsprogramm UNPACK.COM können Sie die
  142. Dateien aus dem Archiv entnehmen. Zum Beispiel werden mit dem
  143. Befehl
  144.  
  145.   unpack tdexampl
  146.  
  147. alle Dateien, die in TDEXAMPL.ARC gespeichert sind, in das
  148. aktuelle Verzeichnis gelegt.
  149.  
  150. Wenn Sie während der Installation Probleme beim Lesen der
  151. Ausgabetexte haben, können Sie optional einen
  152. Kommandozeilenparameter angeben, um die Darstellung in
  153. Schwarzweiß zu erzwingen:
  154.  
  155.   a:install /B      - Erzwingt den Modus BW80 im Programm INSTALL
  156.  
  157. Die Angabe von /B kann dann notwendig sein, wenn Sie einen LCD-
  158. Bildschirm oder einen Farbgrafikadapter (CGA) mit einem
  159. Monochrom- oder Schwarzweiß-Bildschirm verwenden.
  160.  
  161.  
  162. 3. WICHTIGE ERWEITERUNGEN
  163. -------------------------
  164.  
  165.   3.1 Zusätzliche Kommandozeilenoptionen für TD
  166.   ---------------------------------------------
  167.  
  168.   -h  liefert eine Aufstellung mit allen Kommandozeilenoptionen,
  169.        die in TD.EXE verfügbar sind.
  170.  
  171.   -c  ermöglicht die Angabe einer Konfigurationsdatei, die beim
  172.        Aufruf des Debuggers geladen wird. Standardmäßig verwendet
  173.        der Turbo Debugger die Konfigurationsdatei TDCONFIG.TD
  174.        (wenn sie gefunden wird). Wenn Sie stattdessen die Option
  175.        -c<Datei> angeben, verwendet der Turbo Debugger die
  176.        angegebene Datei.
  177.  
  178.       Sie müssen die Konfigurationsdatei direkt hinter dem -c
  179.        angeben. Es darf kein Leerzeichen zwischen -c und dem
  180.        Dateinamen stehen. Zum Beispiel:
  181.  
  182.          TD -cKonfig Prog
  183.  
  184.        Wenn Sie hinter dem Dateinamen keine Erweiterung angeben,
  185.        hängt der Turbo Debugger die Erweiterung .TD an.
  186.  
  187.   -m  Wenn Sie bei der Kommandozeilenoption -m für die Größe des
  188.        Heaps 0 angeben, verwendet der Turbo Debugger den maximal
  189.        verfügbaren Speicherplatz, 64 KB, für den Heap. Wenn Sie
  190.        einen größeren Wert als 64 KB angeben, kann das zu
  191.        unberechenbaren Ergebnissen führen.
  192.  
  193.   -vp  Sicherung der EGA-Palette einschalten.
  194.  
  195.        Diese neue Kommandozeilenoption legt fest, ob die
  196.        Einstellung der Farbpalette einer EGA-Karte gespeichert
  197.        werden soll oder nicht. Diese Option sollte nur dann
  198.        angegeben werden, wenn das Anwenderprogramm die Register
  199.        der EGA-Palette verwendet. Wenn -vp angegeben wird, dann
  200.        wird die EGA-Palette bei allen Bildschirmumschaltungen
  201.        gerettet und wiederhergestellt. Im allgemeinen brauchen
  202.        Sie diese Option nicht angeben, es sei denn, Ihr Programm
  203.        verändert die Palettenregister oder verwendet BGI, um die
  204.        Palette zu verändern.
  205.  
  206.  
  207.   3.2 Änderungen der Kommandozeilenoptionen bei den TD-Utilities
  208.   --------------------------------------------------------------
  209.  
  210.   Um eine Liste aller Kommandozeilenoptionen der Programme
  211.   TDINST.EXE, TDREMOTE.EXE, INSTALL.EXE und TDNMI.COM zu
  212.   erhalten, rufen Sie das Programm zusammen mit der Option -h
  213.   auf:
  214.  
  215.     <Programmname> -h
  216.  
  217.   Wenn Sie eine Liste der Kommandozeilenoptionen bei den Dateien
  218.   TDMAP.EXE, TDPACK.EXE, TDRF.EXE, TDSTRIP.EXE, TDCONVRT.EXE,
  219.   TD386.EXE und TDUMP.EXE wünschen, geben Sie lediglich den
  220.   Programmnamen ein:
  221.  
  222.     <Programmname>
  223.  
  224.   Beachten Sie bitte: Wenn Sie ein 80386-System haben und die
  225.   Kommandozeilenoptionen von TD386.EXE ermitteln wollen, muß der
  226.   Treiber TDH386.SYS geladen sein.
  227.  
  228.  
  229.   3.3  TD.OVL
  230.   -----------
  231.  
  232.   Der Turbo Debugger besteht aus einer aufrufbaren Programmdatei,
  233.   TD.EXE, und einer Overlay-Datei, TD.OVL. Es werden beide
  234.   Dateien benötigt. Auf einem Festplattensystem sollten beide
  235.   Dateien im selben Verzeichnis stehen.
  236.  
  237.   Wenn Sie mit einem System arbeiten, das nur zwei
  238.   Diskettenlaufwerke hat, müssen Sie die Overlay-Datei (TD.OVL)
  239.   und die Hilfe-Datei (TDHELP.TDH) auf einer anderen Diskette
  240.   unterbringen als TD.EXE. Um den Turbo Debugger aufzurufen,
  241.   legen Sie die Diskette mit TD.EXE ein und geben dann "TD" in
  242.   der Kommandozeile ein. Daraufhin werden Sie nach der Diskette
  243.   mit der Overlay-Datei gefragt.
  244.  
  245.   Sobald Sie die Overlay-Diskette einmal eingelegt haben, sollten
  246.   Sie sie bis zum Ende des Debugger-Laufs nicht mehr
  247.   herausnehmen.
  248.  
  249.  
  250.   3.4  Die Utility TDNMI.COM
  251.   --------------------------
  252.  
  253.   Wenn Sie einen Unterbrechungsschalter mit einem PC-Kompatiblen
  254.   verwenden wollen, der den NMI-Interrupt ausschaltet, müssen Sie
  255.   das Programm TDNMI resident laden, damit der NMI jede halbe
  256.   Sekunde gelöscht wird.
  257.  
  258.   Sie können TDNMI auch mit der Option /p aufrufen, wenn Sie den
  259.   Unterbrechungsschalter des Hardware-Debuggers Periscope I
  260.   zusammen mit dem Turbo Debugger verwenden wollen. TDNMI setzt
  261.   dann in regelmäßigen Abständen das Latch des
  262.   Unterbrechungsschalters auf der Periscope-Platine zurück. Sie
  263.   können mit der Kommandozeilenoption /p zusätzlich noch eine
  264.   andere hexadezimale Adresse eingeben, wenn Sie auf der Platine
  265.   eine andere Ein-/Ausgabeadresse eingestellt haben.
  266.  
  267.  
  268.   3.5 Zusätze zur Schnittstelle des Hardware-Gerätetreibers
  269.   ---------------------------------------------------------
  270.  
  271.   oBeim Statusblock zum Ermitteln der Hardware-Fähigkeiten (Code
  272.     1), die vom Gerätetreiber zurückgegeben werden, gibt es ein
  273.     zusätzliches Feld, das hinter dem Byte für die maximale Länge
  274.     der gesuchten Daten steht. Dieses Feld ist 2 Bytes lang und
  275.     bestimmt die Adresse des Segments, in dem der Turbo Debugger
  276.     ein Byte mit dem Wert 1 schreiben muß, um Hardware-
  277.     Breakpoints zu aktivieren. Das Feld muß den Wert 0 enthalten,
  278.     wenn der Gerätetreiber keine Hardware-Breakpoints
  279.     unterstützt. Falls Hardware-Breakpoints unterstützt werden,
  280.     kann der Turbo Debugger den Gerätetreiber mit Hilfe dieses
  281.     Bytes darüber informieren, daß alle Schreiboperationen in den
  282.     Adreßraum des Programms, das gerade debuggt wird,
  283.     abgeschlossen sind und bei allen nachfolgenden Zugriffen
  284.     wieder ein Hardware-Breakpoint ausgelöst werden kann.
  285.  
  286.   oDer Spezialwert FE (hexadezimal) kann dann vom Hardware-
  287.     Gerätetreiber zurückgegeben werden, wenn der Treiber bei der
  288.     Verarbeitung eines Hardware-Breakpoints rekursiv aufgerufen
  289.     wurde. Das kann dann vorkommen, wenn ein Hardware-Breakpoint
  290.     sechs Bytes im aktuellen Programm unterhalb der aktuellen
  291.     Stackposition gesetzt wurde. Wenn der Turbo Debugger diesen
  292.     Code erhält, wird eine Meldung ausgegeben, daß der
  293.     Gerätetreiber nicht weitermachen kann, weil der Breakpoint zu
  294.     nah an der Stackposition liegt.
  295.  
  296.   3.6 Erweiterungen des Assemblers im CPU-Fenster
  297.   -----------------------------------------------
  298.  
  299.   Der Turbo Debugger unterstützt alle Befehle und Register des
  300.   80386 und 80387:
  301.  
  302.     80386-Register:
  303.  
  304.       EAX, EBX, ECX, EDX, ESI, EDI, EBP, ESP
  305.  
  306.     80386-Befehle:
  307.  
  308.       BSF, BSR, BT, BTC, BTR, BTS, CDQ, CWDE, IRETD, LFS, LGS,
  309.       LSS, MOVSX, MOVZX, POPAD, POPFD, PUSHAD, PUSHFD, SETA,
  310.       SETB, SETBE, SETE, SETG, SETL, SETLE, SETNB, SETNE,
  311.       SETNL, SETNO, SETNP, SETNS, SETO, SETP, SETS, SHLD, SHRD,
  312.       CMPSD, STOSD, LODSD, MOVSD, SCASD, INSD, OUTSD, JECXZ
  313.  
  314.     80387-Befehle:
  315.  
  316.       FCOS, FSIN, FPREM1, FSINCOS, FUCOM, FUCOMP, FUCOMPP
  317.  
  318.  
  319. 4. ANMERKUNGEN UND EINSCHRÄNKUNGEN
  320. ----------------------------------
  321.  
  322. oSie sollten bei der Anweisung FILES in Ihrer CONFIG.SYS-Datei
  323.   mindestens FILES = 10, am besten FILES = 20 angeben. Wenn Sie
  324.   Probleme beim Aufruf des Befehls File/OS Shell haben, oder TD
  325.   Ihre Quelldateien nicht findet, dann sollten Sie überprüfen, ob
  326.   die FILES-Anweisung in Ihrer CONFIG.SYS-Datei korrekt ist.
  327.  
  328. oDie FNxxxx-Varianten der Fließkommabefehle werden vom
  329.   integrierten Assembler im CPU-Fenster nicht unterstützt.
  330.  
  331.   Die Fxxxx-Befehle erzeugen im Turbo Debugger nicht automatisch
  332.   den Befehl FWAIT. Sie müssen einen FWAIT-Befehl vor den
  333.   Fließkommabefehlen gegebenenfalls manuell einfügen.
  334.  
  335. oEin einziges Mal Ctrl-Break zu drücken reicht nicht, um eine
  336.   Eingabefunktion von MS-DOS zu unterbrechen und dann zum Turbo
  337.   Debugger zurückzukehren. Sie können entweder einmal Ctrl-Break
  338.   drücken und dann die Eingabefunktion über die Konsole mit der
  339.   Eingabetaste Enter beenden oder zweimal Ctrl-Break drücken.
  340.   Damit unterbrechen Sie MS-DOS und der Turbo Debugger öffnet ein
  341.   CPU-Fenster, in dem Sie den entsprechenden Code von MS-DOS
  342.   sehen.  Nun können Sie in Ihrem Programm umherschauen, aber es
  343.   ist nicht möglich, daß Sie mit F7 oder F8 innerhalb MS-DOS
  344.   einzelne Befehle tracen oder überspringen. Sie sollten nur F9
  345.   verwenden, nachdem Sie eventuell einen Breakpoint in Ihrem
  346.   Programm gesetzt haben.
  347.  
  348. oTD386 verwendet den Interrupt INT FF, um zwischen Protected und
  349.   Virtual-Mode Infomationen auszutauschen. Deshalb können Sie mit
  350.   TD386 keine Programme debuggen, die den Interrupt INT FF selbst
  351.   verwenden. Wenn Ihr Programm den Interrupt INT FF verwendet,
  352.   sollten Sie zwischenzeitlich einen anderen Interrupt (z.B. INT
  353.   FE) verwenden, während Sie Ihr Programm mit TD386 debuggen.
  354.  
  355.  
  356. 5. ZUSÄTZE UND KORREKTUREN IM HANDBUCH
  357. --------------------------------------
  358.  
  359. Alle Zusätze und Korrekturen zum Handbuch des Turbo Debuggers,
  360. die nach dem Druck vorgenommen wurden, sind in der Datei
  361. MANUAL.DOC auf der Turbo Debugger-Diskette Hilfe/Utilities
  362. zusammengefaßt. Wir empfehlen Ihnen, die Datei MANUAL.DOC
  363. durchzulesen und die entsprechenden Korrekturen im Handbuch
  364. auszuführen. Sie können das Hilfsprogramm README.COM verwenden,
  365. um diese Datei durchzulesen. Zum Beispiel:
  366.  
  367.   README MANUAL.DOC
  368.  
  369.  
  370. 6. DATEIEN AUF DEN ORIGINALDISKETTEN
  371. ------------------------------------
  372.  
  373.   TURBO DEBUGGER/INSTALLATION
  374.   ---------------------------
  375.   INSTALL  EXE  - Installationsprogramm
  376.   README   COM  - Hilfsprogramm zum Lesen von README
  377.   TD       EXE  - Turbo Debugger
  378.   TD       OVL  - Turbo Debugger-Overlay
  379.   HELPME!  DOC  -Textdatei mit Antworten auf viele häufig
  380.                   gestellte Fragen. Bitte lesen Sie die
  381.                   Datei HELPME!.DOC sorgfältig durch, bevor Sie
  382.                   sich mit der technischen Beratung in Verbindung
  383.                   setzen.
  384.   README        - Diese Datei!
  385.  
  386.   HILFE/UTILITIES
  387.   --------------
  388.   TDHELP   TDH  - Hilfedatei des Turbo Debuggers (englisch)
  389.   TDINST   EXE  - Konfigurationsprogramm
  390.   TDMAP    EXE  -Utility zum Erstellen von Debugger-
  391.                   Informationen aus .MAP-Dateien
  392.   TDUMP    EXE  -Utility zum Auflisten von Programm- und
  393.                   Objektdateien
  394.   TDRF     EXE  -Programm zum Übertragen von Dateien
  395.   TDREMOTE EXE  - Treiberprogramm zum Ferndebuggen
  396.   TD386    EXE  - Virtueller Debugger für 80386-Systeme
  397.   TDH386   SYS  -Gerätetreiber für TD386.EXE un die 80386-
  398.                   Debugger-Register
  399.   TDSTRIP  EXE  -Utility zum Entfernen von Debugger-
  400.                   Informationen aus Programmdateien
  401.  
  402.   UTILITIES/BEISPIELE
  403.   -------------------
  404.   TDCONVRT EXE  -Utility zum Umwandeln von CodeView-
  405.                   Informationen in das Turbo Debugger-Format
  406.   TDPACK   EXE  -Utility zum Komprimieren von Debugger-
  407.                   Informationen
  408.   TDNMI    COM  -Speicherresidentes Programm, um den NMI alle
  409.                   halbe Sekunde zu löschen
  410.   UNPACK   COM  - Utility zum Erweitern von .ARC-Dateien
  411.   TDEXMPL  ARC  -Komprimierte Datei mit Beispielprogrammen für
  412.                   den Turbo Debugger
  413.   TAEXMPL1 ARC  -Komprimierte Datei mit Beispielen für den Turbo
  414.                   Assembler
  415.   TAEXMPL2 ARC  -Komprimierte Datei mit weiteren
  416.                   Beispielprogrammen für den Turbo Assembler
  417.   CHAPXMPL ARC  -Komprimierte Datei mit Beispielprogrammen aus
  418.                   einzelnen Kapiteln des Turbo Assembler-Handbuchs
  419.  
  420.   MANUAL
  421.   ------
  422.   TDHELP   TDH  - Hilfedatei des Turbo Debuggers (deutsch)
  423.   MANUAL   DOC  -Textdatei mit den Zusätzen und Korrekturen zum
  424.                   Benutzerhandbuch
  425.