1<html lang="en"> 2<head> 3<title>Remote Debugging - Debugging with GDB</title> 4<meta http-equiv="Content-Type" content="text/html"> 5<meta name="description" content="Debugging with GDB"> 6<meta name="generator" content="makeinfo 4.13"> 7<link title="Top" rel="start" href="index.html#Top"> 8<link rel="prev" href="Targets.html#Targets" title="Targets"> 9<link rel="next" href="Configurations.html#Configurations" title="Configurations"> 10<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> 11<!-- 12Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 131998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 14Free Software Foundation, Inc. 15 16Permission is granted to copy, distribute and/or modify this document 17under the terms of the GNU Free Documentation License, Version 1.3 or 18any later version published by the Free Software Foundation; with the 19Invariant Sections being ``Free Software'' and ``Free Software Needs 20Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,'' 21and with the Back-Cover Texts as in (a) below. 22 23(a) The FSF's Back-Cover Text is: ``You are free to copy and modify 24this GNU Manual. Buying copies from GNU Press supports the FSF in 25developing GNU and promoting software freedom.''--> 26<meta http-equiv="Content-Style-Type" content="text/css"> 27<style type="text/css"><!-- 28 pre.display { font-family:inherit } 29 pre.format { font-family:inherit } 30 pre.smalldisplay { font-family:inherit; font-size:smaller } 31 pre.smallformat { font-family:inherit; font-size:smaller } 32 pre.smallexample { font-size:smaller } 33 pre.smalllisp { font-size:smaller } 34 span.sc { font-variant:small-caps } 35 span.roman { font-family:serif; font-weight:normal; } 36 span.sansserif { font-family:sans-serif; font-weight:normal; } 37--></style> 38<link rel="stylesheet" type="text/css" href="../cs.css"> 39</head> 40<body> 41<div class="node"> 42<a name="Remote-Debugging"></a> 43<p> 44Next: <a rel="next" accesskey="n" href="Configurations.html#Configurations">Configurations</a>, 45Previous: <a rel="previous" accesskey="p" href="Targets.html#Targets">Targets</a>, 46Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a> 47<hr> 48</div> 49 50<h2 class="chapter">20 Debugging Remote Programs</h2> 51 52<p><a name="index-remote-debugging-1059"></a> 53If you are trying to debug a program running on a machine that cannot run 54<span class="sc">gdb</span> in the usual way, it is often useful to use remote debugging. 55For example, you might use remote debugging on an operating system kernel, 56or on a small system which does not have a general purpose operating system 57powerful enough to run a full-featured debugger. 58 59 <p>Some configurations of <span class="sc">gdb</span> have special serial or TCP/IP interfaces 60to make this work with particular debugging targets. In addition, 61<span class="sc">gdb</span> comes with a generic serial protocol (specific to <span class="sc">gdb</span>, 62but not specific to any particular target system) which you can use if you 63write the remote stubs—the code that runs on the remote system to 64communicate with <span class="sc">gdb</span>. 65 66 <p>Other remote targets may be available in your 67configuration of <span class="sc">gdb</span>; use <code>help target</code> to list them. 68 69<ul class="menu"> 70<li><a accesskey="1" href="Connecting.html#Connecting">Connecting</a>: Connecting to a remote target 71<li><a accesskey="2" href="File-Transfer.html#File-Transfer">File Transfer</a>: Sending files to a remote system 72<li><a accesskey="3" href="Server.html#Server">Server</a>: Using the gdbserver program 73<li><a accesskey="4" href="Remote-Configuration.html#Remote-Configuration">Remote Configuration</a>: Remote configuration 74<li><a accesskey="5" href="Remote-Stub.html#Remote-Stub">Remote Stub</a>: Implementing a remote stub 75</ul> 76 77 </body></html> 78 79