68 lines
		
	
	
	
		
			3.1 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
			
		
		
	
	
			68 lines
		
	
	
	
		
			3.1 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
<HTML>
 | 
						|
<HEAD>
 | 
						|
<TITLE>Target Selection Help</TITLE>
 | 
						|
</HEAD>
 | 
						|
<BODY>
 | 
						|
<H1>The Target Selection Dialog</H1>
 | 
						|
<H3>Overview</H3>
 | 
						|
<P>The Target Selection Dialog allows users to specify the debug target,
 | 
						|
the interface used to connect to the target, and some useful run
 | 
						|
options.</P>
 | 
						|
 | 
						|
<P>Target Selection topics:
 | 
						|
<UL>
 | 
						|
    <LI><UL><A HREF="#select">Selecting a Target</A>
 | 
						|
            <LI><A HREF="#select_tar">Specifying a Target</A>
 | 
						|
            <LI><A HREF="#select_int">Choosing a Connection Interface</A>
 | 
						|
        </UL>
 | 
						|
    <LI><UL><A HREF="#options">Run Options</A>
 | 
						|
            <LI><A HREF="#options_run_until_main">Run until 'main'</A>
 | 
						|
            <LI><A HREF="#options_bp_at_exit">Set breakpoint at 'exit'</A>
 | 
						|
            <LI><A HREF="#options_download_dialog">Display Download Dialog</A>
 | 
						|
            <LI><A HREF="#options_compare_to_remote_executable">Compare to
 | 
						|
            remote executable</A>
 | 
						|
        </UL>
 | 
						|
</UL></P>
 | 
						|
 | 
						|
<H3><A NAME="select">Selecting a Target</A></H3>
 | 
						|
Selecting a target involves choosing a target for debugging and setting connection
 | 
						|
interface options for the target. 
 | 
						|
 | 
						|
<P>Common targets include: "exec" for native debuggers, "remote" for establishing
 | 
						|
a connection to a target board via a serial line, "remotetcp" for TCP connections,
 | 
						|
and "sim" for connections to the simulator. There may be more depending on the
 | 
						|
configuration of the debugger being used.</P>
 | 
						|
 | 
						|
<P>In general, "remote" targets are always serial connections which require the user
 | 
						|
to specify the serial port and baud rate to be used for the connection and
 | 
						|
"remotetcp" targets are always TCP connections which require specifying the hostname
 | 
						|
and port number of the machine to which to connect. Depending upon configuration,
 | 
						|
there may be numerous serial- and TCP-based connections. These always follow the
 | 
						|
naming convention <I>target</I> and <I>target</I>tcp.</P>
 | 
						|
 | 
						|
<P>To <A NAME="select_tar"> select a target</A>, choose one of the available targets
 | 
						|
from the dropdown menu in the Connection Frame. Then <A NAME="#select_int">specify
 | 
						|
the interface options</A> for this target: selecting the baudrate and serial port
 | 
						|
from the dropdown menus (serial targets only) or entering the hostname and port number
 | 
						|
(TCP targets only).</P>
 | 
						|
 | 
						|
<H3><A NAME="options">Run Options</A></H3>
 | 
						|
Three run options which may be selected include:
 | 
						|
<DL>
 | 
						|
    <DT><A NAME="options_run_until_main">Run until 'main'
 | 
						|
        <DD>Sets a breakpoint at main(). This has no effect when using
 | 
						|
            GDB in tracing mode.
 | 
						|
    <DT><A NAME="options_bp_at_exit">Set breakpoint at 'exit'
 | 
						|
        <DD>Sets a breakpoint at exit(). This has no effect when using
 | 
						|
            GDB in tracing mode.
 | 
						|
    <DT><A NAME="options_download_dialog">Display Download Dialog
 | 
						|
        <DD>Displays a dialog showing the progress of the download to
 | 
						|
            the target section by section. This has no effect when using
 | 
						|
            GDB in tracing mode.
 | 
						|
    <DT><A NAME="options_compare_to_remote_executable">
 | 
						|
        Compare to remote executable</A>
 | 
						|
        <DD>When attaching to a tracing target, compare the host's and target's
 | 
						|
            executable by computing the checksum of each loadable section.
 | 
						|
</DL>
 | 
						|
</BODY>
 | 
						|
</HTML>
 |