projects / OpenSPARC-T2-SAM / blame
| Commit | Line | Data |
|---|---|---|
| 920dae64 AT |
1 | /* |
| 2 | * Copyright 2007 Sun Microsystems, Inc. All rights reserved. | |
| 3 | * Use is subject to license terms. | |
| 4 | */ | |
| 5 | #pragma ident "@(#)README.dbx-hack 1.3 07/05/30 SMI" | |
| 6 | ||
| 7 | ## | |
| 8 | ## DBX Debugging information for Legion | |
| 9 | ## | |
| 10 | ## This explains how to use the dbx debugging hooks in legion | |
| 11 | ## | |
| 12 | ||
| 13 | GETTING STARTED | |
| 14 | --------------- | |
| 15 | To get started, create a symlink from src/procs/sunsparc/debug/dbxrc to .dbxrc | |
| 16 | in the directory where sim is to be executed and run sim from within | |
| 17 | dbx. E.g: | |
| 18 | ||
| 19 | % ln -s <path_to_legion_ws>/src/procs/sunsparc/debug/dbxrc .dbxrc | |
| 20 | % dbx | |
| 21 | (dbx) run -a 1.conf | |
| 22 | ||
| 23 | Note: control for executing debugging commands can be returned to dbx at | |
| 24 | anytime with ^C. | |
| 25 | ||
| 26 | DEBUGGING COMMANDS | |
| 27 | ------------------ | |
| 28 | ||
| 29 | simbreak <pc> | |
| 30 | ||
| 31 | Breakpoint on the given <pc>. Breakpoints can be installed prior to | |
| 32 | simulation or during after transferring control to dbx with ^C . The | |
| 33 | simulation is restarted with the conventional dbx "cont" command. | |
| 34 | ||
| 35 | simstep [n] | |
| 36 | ||
| 37 | Single step or <n> times single step the current CPU. | |
| 38 | ||
| 39 | simregs | |
| 40 | ||
| 41 | Dump the current CPU's registers. | |
| 42 | ||
| 43 | simmmuregs | |
| 44 | ||
| 45 | Dump the current CPU's MMU-specific registers. | |
| 46 | ||
| 47 | simdumpdtlb | |
| 48 | ||
| 49 | Dump the current CPU's D-TLB. | |
| 50 | ||
| 51 | simdumpitlb | |
| 52 | ||
| 53 | Dump the current CPU's I-TLB. | |
| 54 | ||
| 55 | simfocus [n] | |
| 56 | ||
| 57 | Print the currently 'focused' CPU, the target of the "simregs", | |
| 58 | "simmmuregs" etc commands or switch the 'focus' to the supplied id. | |
| 59 | Note: this command operates using legion-gids, NOT cpuids. | |
| 60 | ||
| 61 | simx <paddr> [n] | |
| 62 | ||
| 63 | Dump 8-bytes or dump <n> successive 8-bytes at the supplied physical | |
| 64 | address. | |
| 65 | ||
| 66 | simtrans <vaddr> | |
| 67 | ||
| 68 | If possible translate the supplied virtual address into a physical | |
| 69 | address using the current context and current contents of the I&D-TLBs. | |
| 70 | ||
| 71 | simdis <paddr> [n] | |
| 72 | ||
| 73 | Disassemble or disassemble <n> successive instructions at the supplied | |
| 74 | physical address. | |
| 75 | ||
| 76 | simscratch [n] | |
| 77 | ||
| 78 | If no argument is provided, this will print the scratchpad registers | |
| 79 | for the currently 'focused' CPU. Otherwise it will print the scratchpad | |
| 80 | registers of the CPU passed as an argument. | |
| 81 | Note: this command operates using legion-gids, NOT cpuids. | |
| 82 | ||
| 83 | simcmpregs | |
| 84 | ||
| 85 | Dump the current CMP registers. | |
| 86 | ||
| 87 | simshowbreak | |
| 88 | ||
| 89 | Display active simulation breakpoints. | |
| 90 | ||
| 91 | simdumpbreak <fname> | |
| 92 | ||
| 93 | Dump the defined breakpoints to a text file. | |
| 94 | ||
| 95 | simrestorebreak <fname> | |
| 96 | ||
| 97 | Restore previously defined and saved breakpoints from a text file. |