[BACK]Return to kernel_debugging_with_qemu.mdwn CVS log [TXT] [DIR] Up to [NetBSD Developer Wiki] / wikisrc

Diff for /wikisrc/kernel_debugging_with_qemu.mdwn between versions 1.6 and 1.19

version 1.6, 2015/02/18 16:03:37 version 1.19, 2021/12/27 14:26:28
Line 9  You need a computer running an OS capabl Line 9  You need a computer running an OS capabl
 (the "host system").  (the "host system").
 This can be NetBSD itself, Linux, or some other Unix-like OS.  This can be NetBSD itself, Linux, or some other Unix-like OS.
 These instructions have been tested with NetBSD/amd64 6.1.4 and  These instructions have been tested with NetBSD/amd64 6.1.4 and
 Debian 7 hosts.  Debian 7 hosts.   There should be at least 20 gigabytes of available
   disk space.
   
 If your host system is running NetBSD, install the following packages  If your host system is running NetBSD, install the following packages
 from pkgsrc:  from pkgsrc:
   
 * emulators/qemu >= 2.0.0nb4  * emulators/qemu >= 2.0.0nb4
 * misc/py-anita  * misc/py-anita >= 1.44
   
 If your host system uses a package system other than pkgsrc,  If your host system uses a package system other than pkgsrc,
 use that to install cvs, make, gcc, qemu, the Python pexpect  use that to install cvs, make, gcc, qemu, the Python pexpect
 library, and genisoimage or mkisofs.  Also download and   library, and genisoimage or mkisofs.  Also download and
 install the most recent anita package from  install the most recent anita package from
 <http://www.gson.org/netbsd/anita/download/>.  <http://www.gson.org/netbsd/anita/download/>.
   
 ## Building the target system  ## Building the target system
   
 Check out the NetBSD-current sources from CVS and build a full  Check out the NetBSD-current sources from CVS and build a full release
 NetBSD-current/i386 release with debug symbols using the build.sh  of NetBSD-current/i386 with debug symbols using the build.sh script.
 script.  The i386 port is the preferred test platform because the two  The i386 port is preferred because these instructions have been
 other ports supported by anita are affected by known bugs: amd64 by  successfully tested with it.
 [[PR 49276|http://gnats.NetBSD.org/49276]], and sparc by  The amd64 port won't work because of [[PR 50128|http://gnats.NetBSD.org/50128]],
 [[qemu bug 1335444|https://bugs.launchpad.net/qemu/+bug/1335444]].  and sparc has not been tested since [[qemu bug
   1399943|https://bugs.launchpad.net/qemu/+bug/1399943]] was fixed.
   
 If you do the build in a directory other than /usr/src,   If you do the build in a directory other than /usr/src,
 use the -fdebug-prefix-map option to ensure that the source file names embedded  use the -fdebug-prefix-map option to ensure that the source file names embedded
 in the debug symbols point to /usr/src, which is where the sources will be  in the debug symbols point to /usr/src, which is where the sources will be
 installed on the target system.  For example:  installed on the target system.  For example:
Line 40  installed on the target system.  For exa Line 42  installed on the target system.  For exa
 [[!template  id=programlisting text="""  [[!template  id=programlisting text="""
  $ CVSROOT=anoncvs@anoncvs.NetBSD.org:/cvsroot cvs checkout -A -P src   $ CVSROOT=anoncvs@anoncvs.NetBSD.org:/cvsroot cvs checkout -A -P src
  $ cd src   $ cd src
  $ ./build.sh -j 4 -V MKDEBUG=YES -V COPTS="-g -fdebug-prefix-map=$(pwd)=/usr/src" -O ../obj -m i386 -U release sourcesets   $ ./build.sh -j 4 -V MKDEBUG=yes -V COPTS="-g -fdebug-prefix-map=$(pwd)=/usr/src" -O ../obj -m i386 -U release sourcesets
 """]]  """]]
   
 For best performance, change the number after "-j" to the number of CPU cores  For best performance, change the number after "-j" to the number of CPU cores
Line 52  Install the system in a virtual machine, Line 54  Install the system in a virtual machine,
   
 [[!template  id=programlisting text="""  [[!template  id=programlisting text="""
  $ cd ..   $ cd ..
  $ anita --workdir work --disk-size 4G --memory-size 256M \   $ anita --workdir work --disk-size 8G --memory-size 256M \
      --sets kern-GENERIC,modules,base,etc,comp,debug,games,man,misc,tests,text,syssrc,src,sharesrc,gnusrc \       --sets kern-GENERIC,modules,base,etc,comp,debug,games,man,misc,tests,text,syssrc,src,sharesrc,gnusrc \
      install $(pwd)/obj/releasedir/i386/       install $(pwd)/obj/releasedir/i386/
 """]]  """]]
Line 60  Install the system in a virtual machine, Line 62  Install the system in a virtual machine,
 ## Booting the VMs  ## Booting the VMs
   
 Next, start two qemu virtual machines, one to run the kernel being  Next, start two qemu virtual machines, one to run the kernel being
 debugged (the "kgdb target") and another to run gdb (the "kgdb host").  debugged (the "target VM") and another to run gdb (the "gdb VM").
   
 The two VMS could be run on separate physical machines, but in this  The two VMs could be run on separate physical machines, but in this
 example, they are run on the same physical machine and share the same  example, they are run on the same physical machine and share the same
 hard disk image.  This sharing is made possible by the "-snapshot"  hard disk image.  This sharing is made possible by the "-snapshot"
 option to qemu, which ensures that the disk image is not written to by  option to qemu, which ensures that the disk image is not written to by
 either VM.  either VM.
   
 First start the kgdb target, enabling qemu's built-in GDB target stub  First start the target VM, enabling qemu's built-in GDB target stub
 on TCP port 1234:  on TCP port 1234:
   
 [[!template  id=programlisting text="""  [[!template  id=programlisting text="""
  $ qemu-system-i386 -nographic -snapshot -hda work/wd0.img -gdb tcp::1234   $ qemu-system-i386 -nographic -snapshot -hda work/wd0.img -m 128 -gdb tcp::1234
 """]]  """]]
   
 If you don't want everyone on the Internet to be able to debug your  If you don't want everyone on the Internet to be able to debug your
 target, make sure incoming connections on port 1234 are blocked in  target, make sure incoming connections on port 1234 are blocked in
 your firewall.  your firewall.
   
 In a second terminal window, start the kgdb host:  In a second terminal window, start the gdb VM:
   
 [[!template  id=programlisting text="""  [[!template  id=programlisting text="""
  $ qemu-system-i386 -nographic -snapshot -hda work/wd0.img   $ qemu-system-i386 -nographic -snapshot -hda work/wd0.img -m 256
 """]]  """]]
   
 Log in to the kgdb host as root and set up the network:  Log in to the gdb VM as root and set up the network:
   
 [[!template  id=programlisting text="""  [[!template  id=programlisting text="""
  login: root   login: root
  # dhcpcd   # dhcpcd
 """]]  """]]
   
 Start gdb on the kgdb host and connect to the target:  Start gdb on the gdb VM and connect to the target:
   
 [[!template  id=programlisting text="""  [[!template  id=programlisting text="""
  # gdb /netbsd   # gdb /netbsd
Line 100  Start gdb on the kgdb host and connect t Line 102  Start gdb on the kgdb host and connect t
 """]]  """]]
   
 where my.host.name is the domain name or IP address of the  where my.host.name is the domain name or IP address of the
 physical machine running the kgdb target qemu VM.  host system.
   
 Now you should be able to get a stack trace and start debugging  Now you should be able to get a stack trace and start debugging
 with full debug symbols and access to the source code:  with full debug symbols and access to the source code:
Line 111  with full debug symbols and access to th Line 113  with full debug symbols and access to th
 """]]  """]]
   
 If the stack trace prints very slowly (like 30 seconds per stack  If the stack trace prints very slowly (like 30 seconds per stack
 frame), it's likely because you are using a version of qemu where  frame), you are probably using an old version of qemu that fails
 the user-mode networking code fails to disable the Nagle algorithm.  to disable the Nagle algorithm.
 This is fixed in the qemu in pkgsrc, but you may run into it if your  
 qemu is not installed via pkgsrc.  
   
 ## Qemu tips  ## Qemu tips
   
Removed from v.1.6  
changed lines
  Added in v.1.19

CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb