gdb/gdbtk/library/help/trace/target.html

   1 <HTML>
   2 <HEAD>
   3 <TITLE>Target Selection Help</TITLE>
   4 </HEAD>
   5 <BODY>
   6 <H1>The Target Selection Dialog</H1>
   7 <H3>Overview</H3>
   8 <P>The Target Selection Dialog allows users to specify the debug target,
   9 the interface used to connect to the target, and some useful run
  10 options.</P>
  11
  12 <P>Target Selection topics:
  13 <UL>
  14     <LI><UL><A HREF="#select">Selecting a Target</A>
  15             <LI><A HREF="#select_tar">Specifying a Target</A>
  16             <LI><A HREF="#select_int">Choosing a Connection Interface</A>
  17         </UL>
  18     <LI><UL><A HREF="#options">Run Options</A>
  19             <LI><A HREF="#options_run_until_main">Run until 'main'</A>
  20             <LI><A HREF="#options_bp_at_exit">Set breakpoint at 'exit'</A>
  21             <LI><A HREF="#options_download_dialog">Display Download Dialog</A>
  22             <LI><A HREF="#options_compare_to_remote_executable">Compare to
  23             remote executable</A>
  24         </UL>
  25 </UL></P>
  26
  27 <H3><A NAME="select">Selecting a Target</A></H3>
  28 Selecting a target involves choosing a target for debugging and setting connection
  29 interface options for the target.
  30
  31 <P>Common targets include: "exec" for native debuggers, "remote" for establishing
  32 a connection to a target board via a serial line, "remotetcp" for TCP connections,
  33 and "sim" for connections to the simulator. There may be more depending on the
  34 configuration of the debugger being used.</P>
  35
  36 <P>In general, "remote" targets are always serial connections which require the user
  37 to specify the serial port and baud rate to be used for the connection and
  38 "remotetcp" targets are always TCP connections which require specifying the hostname
  39 and port number of the machine to which to connect. Depending upon configuration,
  40 there may be numerous serial- and TCP-based connections. These always follow the
  41 naming convention <I>target</I> and <I>target</I>tcp.</P>
  42
  43 <P>To <A NAME="select_tar"> select a target</A>, choose one of the available targets
  44 from the dropdown menu in the Connection Frame. Then <A NAME="#select_int">specify
  45 the interface options</A> for this target: selecting the baudrate and serial port
  46 from the dropdown menus (serial targets only) or entering the hostname and port number
  47 (TCP targets only).</P>
  48
  49 <H3><A NAME="options">Run Options</A></H3>
  50 Three run options which may be selected include:
  51 <DL>
  52     <DT><A NAME="options_run_until_main">Run until 'main'
  53         <DD>Sets a breakpoint at main(). This has no effect when using
  54             GDB in tracing mode.
  55     <DT><A NAME="options_bp_at_exit">Set breakpoint at 'exit'
  56         <DD>Sets a breakpoint at exit(). This has no effect when using
  57             GDB in tracing mode.
  58     <DT><A NAME="options_download_dialog">Display Download Dialog
  59         <DD>Displays a dialog showing the progress of the download to
  60             the target section by section. This has no effect when using
  61             GDB in tracing mode.
  62     <DT><A NAME="options_compare_to_remote_executable">
  63         Compare to remote executable</A>
  64         <DD>When attaching to a tracing target, compare the host's and target's
  65             executable by computing the checksum of each loadable section.
  66 </DL>
  67 </BODY>
  68 </HTML>