← Back to branch summary

~ubuntu-branches/ubuntu/quantal/open-vm-tools/quantal-201207201942

« back to all changes in this revision

Viewing changes to modules/solaris/vmhgfs/docs/kadb.txt

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Baumann
  • Date: 2009-03-20 10:19:00 UTC
  • mfrom: (1.1.4 upstream) (2.4.3 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090320101900-1o604camiubq2de8
Tags: 2009.03.18-154848-2
http://bugs.debian.org/520493
Correcting patch system depends (Closes: #520493).

Show diffs side-by-side

added added

removed removed

Lines of Context:
modules/solaris/vmhgfs/docs/kadb.txt
 
1
Solaris kadb cheat sheet
 
2
=========================
 
3
 
 
4
Setting up
 
5
----------
 
6
 See Chapter 18 of Solaris' 9 "Writing Device Drivers"
 
7
 (http://docs.sun.com/db/doc/806-5222)
 
8
 
 
9
 If using a tip connection, boot with 'b kadb -d' and at the break for __start,
 
10
 create a deferred breakpoint with this command: hgfs# HgfsDevAttach:b
 
11
 
 
12
Breakpoints
 
13
-----------
 
14
 Deferred: <module># <symbol>:b
 
15
 Regular : <symbol>:b
 
16
 
 
17
 - Regular will complain if symbol isn't found.
 
18
 
 
19
 Examples:
 
20
  hgfs# HgfsDevAttach:b  --> deferred breakpoint for HgfsDevAttach
 
21
                             takes effect when hgfs module is loaded
 
22
  HgfsGetNewReq:b        --> breakpoint for HgfsGetNewReq
 
23
 
 
24
  Commands at breakpoints:
 
25
  :c : continue
 
26
  :s : single step
 
27
  :e : single step over function calls
 
28
  :u : stop after return to caller of current function
 
29
  :d : delete breakpoint
 
30
  :z : delete allbreakpoints
 
31
  
 
32
 
 
33
Viewing
 
34
-------
 
35
 
 
36
 <symbol>,<count>/<modifier>
 
37
 
 
38
 <symbol>  : symbol name, as in HgfsDevAttach, or address
 
39
 <count>   : number of items to show
 
40
 <modifier>: see pg. 348 "Writing Device Drivers" for complete list
 
41
             Common:
 
42
              d,D : 2,4-byte decimal
 
43
              x,X : 2,4-byte hex
 
44
              K   : 4-byte hex for 32 bit progs (use this for pointers)
 
45
              u,U : 2,4-byte unsigned decimal
 
46
              c,C : character, without or with ^escape notation
 
47
              s,S : string, without or with ^escape notation
 
48
              i   : instructions
 
49
              a   : prints address in symbolic form
 
50
              w,W : 2,4-byte write
 
51
 
 
52
 Examples:
 
53
  HgfsGetNewReq,24/ai --> see first 24 instructions of HgfsGetNewReq
 
54
  0x01234567,24/X     --> see 24 4-byte words at that address in hex
 
55
  *0x1234567,24/X     --> see the 24 4-byte words at memory address
 
56
                          specified in 0x1234567
 
57
  
 
58
Macros
 
59
------
 
60
$r : view registers
 
61
$c : stack trace
 
62
$b : display breakpoints
 
63
 
 
64
 
 
65
Pager (pause after <lines> lines)
 
66
-----
 
67
 0t<lines>::more
 
68
 
 
69
 
 
70
Registers
 
71
---------
 
72
 
 
73
 Display a single register: <(register)=K
 
74
 Set value of a register  : (value)>(register)
 
75
 
 
76
 Examples:
 
77
  <eip=K          Display the current contents of eip
 
78
  0xdf78b1f8>eip  Set the value of eip to 0xdf78b1f8