1 /* Main code for remote server for GDB.
2 Copyright (C) 1989, 1993, 1994, 1995, 1997, 1998, 1999, 2000, 2002, 2003,
3 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
35 unsigned long cont_thread;
36 unsigned long general_thread;
37 unsigned long step_thread;
38 unsigned long thread_from_wait;
39 unsigned long old_thread_from_wait;
42 static int extended_protocol;
44 static int response_needed;
45 static int exit_requested;
47 static char **program_argv, **wrapper_argv;
49 /* Enable miscellaneous debugging output. The name is historical - it
50 was originally used to debug LinuxThreads support. */
53 int pass_signals[TARGET_SIGNAL_LAST];
57 const char *gdbserver_xmltarget;
59 /* The PID of the originally created or attached inferior. Used to
60 send signals to the process when GDB sends us an asynchronous interrupt
61 (user hitting Control-C in the client), and to wait for the child to exit
62 when no longer debugging it. */
64 unsigned long signal_pid;
67 /* A file descriptor for the controlling terminal. */
70 /* TERMINAL_FD's original foreground group. */
71 pid_t old_foreground_pgrp;
73 /* Hand back terminal ownership to the original foreground group. */
76 restore_old_foreground_pgrp (void)
78 tcsetpgrp (terminal_fd, old_foreground_pgrp);
82 /* Set if you want to disable optional thread related packets support
83 in gdbserver, for the sake of testing GDB against stubs that don't
85 int disable_packet_vCont;
86 int disable_packet_Tthread;
87 int disable_packet_qC;
88 int disable_packet_qfThreadInfo;
93 return all_threads.head != NULL;
97 start_inferior (char **argv, char *statusptr)
99 char **new_argv = argv;
102 if (wrapper_argv != NULL)
106 for (i = 0; wrapper_argv[i] != NULL; i++)
108 for (i = 0; argv[i] != NULL; i++)
110 new_argv = alloca (sizeof (char *) * count);
112 for (i = 0; wrapper_argv[i] != NULL; i++)
113 new_argv[count++] = wrapper_argv[i];
114 for (i = 0; argv[i] != NULL; i++)
115 new_argv[count++] = argv[i];
116 new_argv[count] = NULL;
120 signal (SIGTTOU, SIG_DFL);
121 signal (SIGTTIN, SIG_DFL);
124 signal_pid = create_inferior (new_argv[0], new_argv);
126 /* FIXME: we don't actually know at this point that the create
127 actually succeeded. We won't know that until we wait. */
128 fprintf (stderr, "Process %s created; pid = %ld\n", argv[0],
133 signal (SIGTTOU, SIG_IGN);
134 signal (SIGTTIN, SIG_IGN);
135 terminal_fd = fileno (stderr);
136 old_foreground_pgrp = tcgetpgrp (terminal_fd);
137 tcsetpgrp (terminal_fd, signal_pid);
138 atexit (restore_old_foreground_pgrp);
141 if (wrapper_argv != NULL)
143 struct thread_resume resume_info;
146 resume_info.thread = -1;
147 resume_info.step = 0;
149 resume_info.leave_stopped = 0;
151 sig = mywait (statusptr, 0);
152 if (*statusptr != 'T')
157 (*the_target->resume) (&resume_info);
159 sig = mywait (statusptr, 0);
160 if (*statusptr != 'T')
163 while (sig != TARGET_SIGNAL_TRAP);
168 /* Wait till we are at 1st instruction in program, return signal
169 number (assuming success). */
170 return mywait (statusptr, 0);
174 attach_inferior (int pid, char *statusptr, int *sigptr)
176 /* myattach should return -1 if attaching is unsupported,
177 0 if it succeeded, and call error() otherwise. */
179 if (myattach (pid) != 0)
184 fprintf (stderr, "Attached; pid = %d\n", pid);
187 /* FIXME - It may be that we should get the SIGNAL_PID from the
188 attach function, so that it can be the main thread instead of
189 whichever we were told to attach to. */
192 *sigptr = mywait (statusptr, 0);
194 /* GDB knows to ignore the first SIGSTOP after attaching to a running
195 process using the "attach" command, but this is different; it's
196 just using "target remote". Pretend it's just starting up. */
197 if (*statusptr == 'T' && *sigptr == TARGET_SIGNAL_STOP)
198 *sigptr = TARGET_SIGNAL_TRAP;
203 extern int remote_debug;
205 /* Decode a qXfer read request. Return 0 if everything looks OK,
209 decode_xfer_read (char *buf, char **annex, CORE_ADDR *ofs, unsigned int *len)
211 /* Extract and NUL-terminate the annex. */
213 while (*buf && *buf != ':')
219 /* After the read marker and annex, qXfer looks like a
220 traditional 'm' packet. */
221 decode_m_packet (buf, ofs, len);
226 /* Write the response to a successful qXfer read. Returns the
227 length of the (binary) data stored in BUF, corresponding
228 to as much of DATA/LEN as we could fit. IS_MORE controls
229 the first character of the response. */
231 write_qxfer_response (char *buf, const void *data, int len, int is_more)
240 return remote_escape_output (data, len, (unsigned char *) buf + 1, &out_len,
244 /* Handle all of the extended 'Q' packets. */
246 handle_general_set (char *own_buf)
248 if (strncmp ("QPassSignals:", own_buf, strlen ("QPassSignals:")) == 0)
250 int numsigs = (int) TARGET_SIGNAL_LAST, i;
251 const char *p = own_buf + strlen ("QPassSignals:");
254 p = decode_address_to_semicolon (&cursig, p);
255 for (i = 0; i < numsigs; i++)
261 /* Keep looping, to clear the remaining signals. */
264 p = decode_address_to_semicolon (&cursig, p);
269 strcpy (own_buf, "OK");
273 if (strcmp (own_buf, "QStartNoAckMode") == 0)
277 fprintf (stderr, "[noack mode enabled]\n");
286 /* Otherwise we didn't know what packet it was. Say we didn't
292 get_features_xml (const char *annex)
294 /* gdbserver_xmltarget defines what to return when looking
295 for the "target.xml" file. Its contents can either be
296 verbatim XML code (prefixed with a '@') or else the name
297 of the actual XML file to be used in place of "target.xml".
299 This variable is set up from the auto-generated
300 init_registers_... routine for the current target. */
302 if (gdbserver_xmltarget
303 && strcmp (annex, "target.xml") == 0)
305 if (*gdbserver_xmltarget == '@')
306 return gdbserver_xmltarget + 1;
308 annex = gdbserver_xmltarget;
313 extern const char *const xml_builtin[][2];
316 /* Look for the annex. */
317 for (i = 0; xml_builtin[i][0] != NULL; i++)
318 if (strcmp (annex, xml_builtin[i][0]) == 0)
321 if (xml_builtin[i][0] != NULL)
322 return xml_builtin[i][1];
330 monitor_show_help (void)
332 monitor_output ("The following monitor commands are supported:\n");
333 monitor_output (" set debug <0|1>\n");
334 monitor_output (" Enable general debugging messages\n");
335 monitor_output (" set remote-debug <0|1>\n");
336 monitor_output (" Enable remote protocol debugging messages\n");
337 monitor_output (" exit\n");
338 monitor_output (" Quit GDBserver\n");
341 /* Subroutine of handle_search_memory to simplify it. */
344 handle_search_memory_1 (CORE_ADDR start_addr, CORE_ADDR search_space_len,
345 gdb_byte *pattern, unsigned pattern_len,
346 gdb_byte *search_buf,
347 unsigned chunk_size, unsigned search_buf_size,
348 CORE_ADDR *found_addrp)
350 /* Prime the search buffer. */
352 if (read_inferior_memory (start_addr, search_buf, search_buf_size) != 0)
354 warning ("Unable to access target memory at 0x%lx, halting search.",
359 /* Perform the search.
361 The loop is kept simple by allocating [N + pattern-length - 1] bytes.
362 When we've scanned N bytes we copy the trailing bytes to the start and
363 read in another N bytes. */
365 while (search_space_len >= pattern_len)
368 unsigned nr_search_bytes = (search_space_len < search_buf_size
372 found_ptr = memmem (search_buf, nr_search_bytes, pattern, pattern_len);
374 if (found_ptr != NULL)
376 CORE_ADDR found_addr = start_addr + (found_ptr - search_buf);
377 *found_addrp = found_addr;
381 /* Not found in this chunk, skip to next chunk. */
383 /* Don't let search_space_len wrap here, it's unsigned. */
384 if (search_space_len >= chunk_size)
385 search_space_len -= chunk_size;
387 search_space_len = 0;
389 if (search_space_len >= pattern_len)
391 unsigned keep_len = search_buf_size - chunk_size;
392 CORE_ADDR read_addr = start_addr + keep_len;
395 /* Copy the trailing part of the previous iteration to the front
396 of the buffer for the next iteration. */
397 memcpy (search_buf, search_buf + chunk_size, keep_len);
399 nr_to_read = (search_space_len - keep_len < chunk_size
400 ? search_space_len - keep_len
403 if (read_inferior_memory (read_addr, search_buf + keep_len,
406 warning ("Unable to access target memory at 0x%lx, halting search.",
411 start_addr += chunk_size;
420 /* Handle qSearch:memory packets. */
423 handle_search_memory (char *own_buf, int packet_len)
425 CORE_ADDR start_addr;
426 CORE_ADDR search_space_len;
428 unsigned int pattern_len;
429 /* NOTE: also defined in find.c testcase. */
430 #define SEARCH_CHUNK_SIZE 16000
431 const unsigned chunk_size = SEARCH_CHUNK_SIZE;
432 /* Buffer to hold memory contents for searching. */
433 gdb_byte *search_buf;
434 unsigned search_buf_size;
436 CORE_ADDR found_addr;
437 int cmd_name_len = sizeof ("qSearch:memory:") - 1;
439 pattern = malloc (packet_len);
442 error ("Unable to allocate memory to perform the search");
443 strcpy (own_buf, "E00");
446 if (decode_search_memory_packet (own_buf + cmd_name_len,
447 packet_len - cmd_name_len,
448 &start_addr, &search_space_len,
449 pattern, &pattern_len) < 0)
452 error ("Error in parsing qSearch:memory packet");
453 strcpy (own_buf, "E00");
457 search_buf_size = chunk_size + pattern_len - 1;
459 /* No point in trying to allocate a buffer larger than the search space. */
460 if (search_space_len < search_buf_size)
461 search_buf_size = search_space_len;
463 search_buf = malloc (search_buf_size);
464 if (search_buf == NULL)
467 error ("Unable to allocate memory to perform the search");
468 strcpy (own_buf, "E00");
472 found = handle_search_memory_1 (start_addr, search_space_len,
473 pattern, pattern_len,
474 search_buf, chunk_size, search_buf_size,
478 sprintf (own_buf, "1,%lx", (long) found_addr);
480 strcpy (own_buf, "0");
482 strcpy (own_buf, "E00");
488 #define require_running(BUF) \
489 if (!target_running ()) \
495 /* Handle all of the extended 'q' packets. */
497 handle_query (char *own_buf, int packet_len, int *new_packet_len_p)
499 static struct inferior_list_entry *thread_ptr;
501 /* Reply the current thread id. */
502 if (strcmp ("qC", own_buf) == 0 && !disable_packet_qC)
504 require_running (own_buf);
505 thread_ptr = all_threads.head;
506 sprintf (own_buf, "QC%x",
507 thread_to_gdb_id ((struct thread_info *)thread_ptr));
511 if (strcmp ("qSymbol::", own_buf) == 0)
513 if (target_running () && the_target->look_up_symbols != NULL)
514 (*the_target->look_up_symbols) ();
516 strcpy (own_buf, "OK");
520 if (!disable_packet_qfThreadInfo)
522 if (strcmp ("qfThreadInfo", own_buf) == 0)
524 require_running (own_buf);
525 thread_ptr = all_threads.head;
526 sprintf (own_buf, "m%x", thread_to_gdb_id ((struct thread_info *)thread_ptr));
527 thread_ptr = thread_ptr->next;
531 if (strcmp ("qsThreadInfo", own_buf) == 0)
533 require_running (own_buf);
534 if (thread_ptr != NULL)
536 sprintf (own_buf, "m%x", thread_to_gdb_id ((struct thread_info *)thread_ptr));
537 thread_ptr = thread_ptr->next;
542 sprintf (own_buf, "l");
548 if (the_target->read_offsets != NULL
549 && strcmp ("qOffsets", own_buf) == 0)
551 CORE_ADDR text, data;
553 require_running (own_buf);
554 if (the_target->read_offsets (&text, &data))
555 sprintf (own_buf, "Text=%lX;Data=%lX;Bss=%lX",
556 (long)text, (long)data, (long)data);
563 if (the_target->qxfer_spu != NULL
564 && strncmp ("qXfer:spu:read:", own_buf, 15) == 0)
570 unsigned char *spu_buf;
572 require_running (own_buf);
573 strcpy (own_buf, "E00");
574 if (decode_xfer_read (own_buf + 15, &annex, &ofs, &len) < 0)
576 if (len > PBUFSIZ - 2)
578 spu_buf = malloc (len + 1);
582 n = (*the_target->qxfer_spu) (annex, spu_buf, NULL, ofs, len + 1);
586 *new_packet_len_p = write_qxfer_response
587 (own_buf, spu_buf, len, 1);
589 *new_packet_len_p = write_qxfer_response
590 (own_buf, spu_buf, n, 0);
596 if (the_target->qxfer_spu != NULL
597 && strncmp ("qXfer:spu:write:", own_buf, 16) == 0)
603 unsigned char *spu_buf;
605 require_running (own_buf);
606 strcpy (own_buf, "E00");
607 spu_buf = malloc (packet_len - 15);
610 if (decode_xfer_write (own_buf + 16, packet_len - 16, &annex,
611 &ofs, &len, spu_buf) < 0)
617 n = (*the_target->qxfer_spu)
618 (annex, NULL, (unsigned const char *)spu_buf, ofs, len);
622 sprintf (own_buf, "%x", n);
628 if (the_target->read_auxv != NULL
629 && strncmp ("qXfer:auxv:read:", own_buf, 16) == 0)
637 require_running (own_buf);
639 /* Reject any annex; grab the offset and length. */
640 if (decode_xfer_read (own_buf + 16, &annex, &ofs, &len) < 0
643 strcpy (own_buf, "E00");
647 /* Read one extra byte, as an indicator of whether there is
649 if (len > PBUFSIZ - 2)
651 data = malloc (len + 1);
657 n = (*the_target->read_auxv) (ofs, data, len + 1);
661 *new_packet_len_p = write_qxfer_response (own_buf, data, len, 1);
663 *new_packet_len_p = write_qxfer_response (own_buf, data, n, 0);
670 if (strncmp ("qXfer:features:read:", own_buf, 20) == 0)
673 unsigned int len, total_len;
674 const char *document;
677 require_running (own_buf);
679 /* Grab the annex, offset, and length. */
680 if (decode_xfer_read (own_buf + 20, &annex, &ofs, &len) < 0)
682 strcpy (own_buf, "E00");
686 /* Now grab the correct annex. */
687 document = get_features_xml (annex);
688 if (document == NULL)
690 strcpy (own_buf, "E00");
694 total_len = strlen (document);
695 if (len > PBUFSIZ - 2)
700 else if (len < total_len - ofs)
701 *new_packet_len_p = write_qxfer_response (own_buf, document + ofs,
704 *new_packet_len_p = write_qxfer_response (own_buf, document + ofs,
710 if (strncmp ("qXfer:libraries:read:", own_buf, 21) == 0)
713 unsigned int len, total_len;
715 struct inferior_list_entry *dll_ptr;
718 require_running (own_buf);
720 /* Reject any annex; grab the offset and length. */
721 if (decode_xfer_read (own_buf + 21, &annex, &ofs, &len) < 0
724 strcpy (own_buf, "E00");
728 /* Over-estimate the necessary memory. Assume that every character
729 in the library name must be escaped. */
731 for (dll_ptr = all_dlls.head; dll_ptr != NULL; dll_ptr = dll_ptr->next)
732 total_len += 128 + 6 * strlen (((struct dll_info *) dll_ptr)->name);
734 document = malloc (total_len);
735 if (document == NULL)
740 strcpy (document, "<library-list>\n");
741 p = document + strlen (document);
743 for (dll_ptr = all_dlls.head; dll_ptr != NULL; dll_ptr = dll_ptr->next)
745 struct dll_info *dll = (struct dll_info *) dll_ptr;
748 strcpy (p, " <library name=\"");
750 name = xml_escape_text (dll->name);
754 strcpy (p, "\"><segment address=\"");
756 sprintf (p, "0x%lx", (long) dll->base_addr);
758 strcpy (p, "\"/></library>\n");
762 strcpy (p, "</library-list>\n");
764 total_len = strlen (document);
765 if (len > PBUFSIZ - 2)
770 else if (len < total_len - ofs)
771 *new_packet_len_p = write_qxfer_response (own_buf, document + ofs,
774 *new_packet_len_p = write_qxfer_response (own_buf, document + ofs,
781 if (the_target->qxfer_osdata != NULL
782 && strncmp ("qXfer:osdata:read:", own_buf, 18) == 0)
788 unsigned char *workbuf;
790 strcpy (own_buf, "E00");
791 if (decode_xfer_read (own_buf + 18, &annex, &ofs, &len) < 0)
793 if (len > PBUFSIZ - 2)
795 workbuf = malloc (len + 1);
799 n = (*the_target->qxfer_osdata) (annex, workbuf, NULL, ofs, len + 1);
803 *new_packet_len_p = write_qxfer_response
804 (own_buf, workbuf, len, 1);
806 *new_packet_len_p = write_qxfer_response
807 (own_buf, workbuf, n, 0);
813 /* Protocol features query. */
814 if (strncmp ("qSupported", own_buf, 10) == 0
815 && (own_buf[10] == ':' || own_buf[10] == '\0'))
817 sprintf (own_buf, "PacketSize=%x;QPassSignals+", PBUFSIZ - 1);
819 /* We do not have any hook to indicate whether the target backend
820 supports qXfer:libraries:read, so always report it. */
821 strcat (own_buf, ";qXfer:libraries:read+");
823 if (the_target->read_auxv != NULL)
824 strcat (own_buf, ";qXfer:auxv:read+");
826 if (the_target->qxfer_spu != NULL)
827 strcat (own_buf, ";qXfer:spu:read+;qXfer:spu:write+");
829 /* We always report qXfer:features:read, as targets may
830 install XML files on a subsequent call to arch_setup.
831 If we reported to GDB on startup that we don't support
832 qXfer:feature:read at all, we will never be re-queried. */
833 strcat (own_buf, ";qXfer:features:read+");
835 if (transport_is_reliable)
836 strcat (own_buf, ";QStartNoAckMode+");
838 if (the_target->qxfer_osdata != NULL)
839 strcat (own_buf, ";qXfer:osdata:read+");
844 /* Thread-local storage support. */
845 if (the_target->get_tls_address != NULL
846 && strncmp ("qGetTLSAddr:", own_buf, 12) == 0)
848 char *p = own_buf + 12;
849 CORE_ADDR parts[3], address = 0;
852 require_running (own_buf);
854 for (i = 0; i < 3; i++)
862 p2 = strchr (p, ',');
874 decode_address (&parts[i], p, len);
878 if (p != NULL || i < 3)
882 struct thread_info *thread = gdb_id_to_thread (parts[0]);
887 err = the_target->get_tls_address (thread, parts[1], parts[2],
893 sprintf (own_buf, "%llx", address);
902 /* Otherwise, pretend we do not understand this packet. */
905 /* Handle "monitor" commands. */
906 if (strncmp ("qRcmd,", own_buf, 6) == 0)
908 char *mon = malloc (PBUFSIZ);
909 int len = strlen (own_buf + 6);
917 if ((len % 2) != 0 || unhexify (mon, own_buf + 6, len / 2) != len / 2)
927 if (strcmp (mon, "set debug 1") == 0)
930 monitor_output ("Debug output enabled.\n");
932 else if (strcmp (mon, "set debug 0") == 0)
935 monitor_output ("Debug output disabled.\n");
937 else if (strcmp (mon, "set remote-debug 1") == 0)
940 monitor_output ("Protocol debug output enabled.\n");
942 else if (strcmp (mon, "set remote-debug 0") == 0)
945 monitor_output ("Protocol debug output disabled.\n");
947 else if (strcmp (mon, "help") == 0)
948 monitor_show_help ();
949 else if (strcmp (mon, "exit") == 0)
953 monitor_output ("Unknown monitor command.\n\n");
954 monitor_show_help ();
962 if (strncmp ("qSearch:memory:", own_buf, sizeof ("qSearch:memory:") - 1) == 0)
964 require_running (own_buf);
965 handle_search_memory (own_buf, packet_len);
969 /* Otherwise we didn't know what packet it was. Say we didn't
974 /* Parse vCont packets. */
976 handle_v_cont (char *own_buf, char *status, int *signal)
980 struct thread_resume *resume_info, default_action;
982 /* Count the number of semicolons in the packet. There should be one
991 /* Allocate room for one extra action, for the default remain-stopped
992 behavior; if no default action is in the list, we'll need the extra
994 resume_info = malloc ((n + 1) * sizeof (resume_info[0]));
995 if (resume_info == NULL)
998 default_action.thread = -1;
999 default_action.leave_stopped = 1;
1000 default_action.step = 0;
1001 default_action.sig = 0;
1009 resume_info[i].leave_stopped = 0;
1011 if (p[0] == 's' || p[0] == 'S')
1012 resume_info[i].step = 1;
1013 else if (p[0] == 'c' || p[0] == 'C')
1014 resume_info[i].step = 0;
1018 if (p[0] == 'S' || p[0] == 'C')
1021 sig = strtol (p + 1, &q, 16);
1026 if (!target_signal_to_host_p (sig))
1028 resume_info[i].sig = target_signal_to_host (sig);
1032 resume_info[i].sig = 0;
1038 resume_info[i].thread = -1;
1039 default_action = resume_info[i];
1041 /* Note: we don't increment i here, we'll overwrite this entry
1042 the next time through. */
1044 else if (p[0] == ':')
1046 unsigned int gdb_id = strtoul (p + 1, &q, 16);
1047 unsigned long thread_id;
1052 if (p[0] != ';' && p[0] != 0)
1055 thread_id = gdb_id_to_thread_id (gdb_id);
1057 resume_info[i].thread = thread_id;
1065 resume_info[i] = default_action;
1067 /* Still used in occasional places in the backend. */
1068 if (n == 1 && resume_info[0].thread != -1)
1069 cont_thread = resume_info[0].thread;
1072 set_desired_inferior (0);
1075 (*the_target->resume) (resume_info);
1079 *signal = mywait (status, 1);
1080 prepare_resume_reply (own_buf, *status, *signal);
1081 disable_async_io ();
1085 write_enn (own_buf);
1090 /* Attach to a new program. Return 1 if successful, 0 if failure. */
1092 handle_v_attach (char *own_buf, char *status, int *signal)
1096 pid = strtol (own_buf + 8, NULL, 16);
1097 if (pid != 0 && attach_inferior (pid, status, signal) == 0)
1099 /* Don't report shared library events after attaching, even if
1100 some libraries are preloaded. GDB will always poll the
1101 library list. Avoids the "stopped by shared library event"
1102 notice on the GDB side. */
1104 prepare_resume_reply (own_buf, *status, *signal);
1109 write_enn (own_buf);
1114 /* Run a new program. Return 1 if successful, 0 if failure. */
1116 handle_v_run (char *own_buf, char *status, int *signal)
1118 char *p, *next_p, **new_argv;
1122 for (p = own_buf + strlen ("vRun;"); p && *p; p = strchr (p, ';'))
1128 new_argv = calloc (new_argc + 2, sizeof (char *));
1129 if (new_argv == NULL)
1131 write_enn (own_buf);
1136 for (p = own_buf + strlen ("vRun;"); *p; p = next_p)
1138 next_p = strchr (p, ';');
1140 next_p = p + strlen (p);
1142 if (i == 0 && p == next_p)
1146 /* FIXME: Fail request if out of memory instead of dying. */
1147 new_argv[i] = xmalloc (1 + (next_p - p) / 2);
1148 unhexify (new_argv[i], p, (next_p - p) / 2);
1149 new_argv[i][(next_p - p) / 2] = '\0';
1158 if (new_argv[0] == NULL)
1160 /* GDB didn't specify a program to run. Use the program from the
1161 last run with the new argument list. */
1163 if (program_argv == NULL)
1165 /* FIXME: new_argv memory leak */
1166 write_enn (own_buf);
1170 new_argv[0] = strdup (program_argv[0]);
1171 if (new_argv[0] == NULL)
1173 /* FIXME: new_argv memory leak */
1174 write_enn (own_buf);
1179 /* Free the old argv and install the new one. */
1180 freeargv (program_argv);
1181 program_argv = new_argv;
1183 *signal = start_inferior (program_argv, status);
1186 prepare_resume_reply (own_buf, *status, *signal);
1191 write_enn (own_buf);
1196 /* Handle all of the extended 'v' packets. */
1198 handle_v_requests (char *own_buf, char *status, int *signal,
1199 int packet_len, int *new_packet_len)
1201 if (!disable_packet_vCont)
1203 if (strncmp (own_buf, "vCont;", 6) == 0)
1205 require_running (own_buf);
1206 handle_v_cont (own_buf, status, signal);
1210 if (strncmp (own_buf, "vCont?", 6) == 0)
1212 strcpy (own_buf, "vCont;c;C;s;S");
1217 if (strncmp (own_buf, "vFile:", 6) == 0
1218 && handle_vFile (own_buf, packet_len, new_packet_len))
1221 if (strncmp (own_buf, "vAttach;", 8) == 0)
1223 if (target_running ())
1225 fprintf (stderr, "Already debugging a process\n");
1226 write_enn (own_buf);
1229 handle_v_attach (own_buf, status, signal);
1233 if (strncmp (own_buf, "vRun;", 5) == 0)
1235 if (target_running ())
1237 fprintf (stderr, "Already debugging a process\n");
1238 write_enn (own_buf);
1241 handle_v_run (own_buf, status, signal);
1245 /* Otherwise we didn't know what packet it was. Say we didn't
1252 myresume (char *own_buf, int step, int *signalp, char *statusp)
1254 struct thread_resume resume_info[2];
1258 set_desired_inferior (0);
1260 if (step || sig || (cont_thread != 0 && cont_thread != -1))
1262 resume_info[0].thread
1263 = ((struct inferior_list_entry *) current_inferior)->id;
1264 resume_info[0].step = step;
1265 resume_info[0].sig = sig;
1266 resume_info[0].leave_stopped = 0;
1269 resume_info[n].thread = -1;
1270 resume_info[n].step = 0;
1271 resume_info[n].sig = 0;
1272 resume_info[n].leave_stopped = (cont_thread != 0 && cont_thread != -1);
1275 (*the_target->resume) (resume_info);
1276 *signalp = mywait (statusp, 1);
1277 prepare_resume_reply (own_buf, *statusp, *signalp);
1278 disable_async_io ();
1282 gdbserver_version (void)
1284 printf ("GNU gdbserver %s%s\n"
1285 "Copyright (C) 2009 Free Software Foundation, Inc.\n"
1286 "gdbserver is free software, covered by the GNU General Public License.\n"
1287 "This gdbserver was configured as \"%s\"\n",
1288 PKGVERSION, version, host_name);
1292 gdbserver_usage (FILE *stream)
1294 fprintf (stream, "Usage:\tgdbserver [OPTIONS] COMM PROG [ARGS ...]\n"
1295 "\tgdbserver [OPTIONS] --attach COMM PID\n"
1296 "\tgdbserver [OPTIONS] --multi COMM\n"
1298 "COMM may either be a tty device (for serial debugging), or \n"
1299 "HOST:PORT to listen for a TCP connection.\n"
1302 " --debug Enable general debugging output.\n"
1303 " --remote-debug Enable remote protocol debugging output.\n"
1304 " --version Display version information and exit.\n"
1305 " --wrapper WRAPPER -- Run WRAPPER to start new programs.\n");
1306 if (REPORT_BUGS_TO[0] && stream == stdout)
1307 fprintf (stream, "Report bugs to \"%s\".\n", REPORT_BUGS_TO);
1311 gdbserver_show_disableable (FILE *stream)
1313 fprintf (stream, "Disableable packets:\n"
1314 " vCont \tAll vCont packets\n"
1315 " qC \tQuerying the current thread\n"
1316 " qfThreadInfo\tThread listing\n"
1317 " Tthread \tPassing the thread specifier in the T stop reply packet\n"
1318 " threads \tAll of the above\n");
1322 #undef require_running
1323 #define require_running(BUF) \
1324 if (!target_running ()) \
1331 main (int argc, char *argv[])
1333 char ch, status, *own_buf;
1334 unsigned char *mem_buf;
1341 char *arg_end, *port;
1342 char **next_arg = &argv[1];
1347 while (*next_arg != NULL && **next_arg == '-')
1349 if (strcmp (*next_arg, "--version") == 0)
1351 gdbserver_version ();
1354 else if (strcmp (*next_arg, "--help") == 0)
1356 gdbserver_usage (stdout);
1359 else if (strcmp (*next_arg, "--attach") == 0)
1361 else if (strcmp (*next_arg, "--multi") == 0)
1363 else if (strcmp (*next_arg, "--wrapper") == 0)
1367 wrapper_argv = next_arg;
1368 while (*next_arg != NULL && strcmp (*next_arg, "--") != 0)
1371 if (next_arg == wrapper_argv || *next_arg == NULL)
1373 gdbserver_usage (stderr);
1377 /* Consume the "--". */
1380 else if (strcmp (*next_arg, "--debug") == 0)
1382 else if (strcmp (*next_arg, "--remote-debug") == 0)
1384 else if (strcmp (*next_arg, "--disable-packet") == 0)
1386 gdbserver_show_disableable (stdout);
1389 else if (strncmp (*next_arg,
1390 "--disable-packet=",
1391 sizeof ("--disable-packet=") - 1) == 0)
1393 char *packets, *tok;
1395 packets = *next_arg += sizeof ("--disable-packet=") - 1;
1396 for (tok = strtok (packets, ",");
1398 tok = strtok (NULL, ","))
1400 if (strcmp ("vCont", tok) == 0)
1401 disable_packet_vCont = 1;
1402 else if (strcmp ("Tthread", tok) == 0)
1403 disable_packet_Tthread = 1;
1404 else if (strcmp ("qC", tok) == 0)
1405 disable_packet_qC = 1;
1406 else if (strcmp ("qfThreadInfo", tok) == 0)
1407 disable_packet_qfThreadInfo = 1;
1408 else if (strcmp ("threads", tok) == 0)
1410 disable_packet_vCont = 1;
1411 disable_packet_Tthread = 1;
1412 disable_packet_qC = 1;
1413 disable_packet_qfThreadInfo = 1;
1417 fprintf (stderr, "Don't know how to disable \"%s\".\n\n",
1419 gdbserver_show_disableable (stderr);
1426 fprintf (stderr, "Unknown argument: %s\n", *next_arg);
1434 if (setjmp (toplevel))
1436 fprintf (stderr, "Exiting\n");
1442 if (port == NULL || (!attach && !multi_mode && *next_arg == NULL))
1444 gdbserver_usage (stderr);
1451 /* --attach used to come after PORT, so allow it there for
1453 if (*next_arg != NULL && strcmp (*next_arg, "--attach") == 0)
1460 && (*next_arg == NULL
1461 || (*next_arg)[0] == '\0'
1462 || (pid = strtoul (*next_arg, &arg_end, 0)) == 0
1464 || next_arg[1] != NULL))
1469 gdbserver_usage (stderr);
1473 initialize_async_io ();
1476 own_buf = xmalloc (PBUFSIZ + 1);
1477 mem_buf = xmalloc (PBUFSIZ);
1479 if (pid == 0 && *next_arg != NULL)
1483 n = argc - (next_arg - argv);
1484 program_argv = xmalloc (sizeof (char *) * (n + 1));
1485 for (i = 0; i < n; i++)
1486 program_argv[i] = xstrdup (next_arg[i]);
1487 program_argv[i] = NULL;
1489 /* Wait till we are at first instruction in program. */
1490 signal = start_inferior (program_argv, &status);
1492 /* We are now (hopefully) stopped at the first instruction of
1493 the target process. This assumes that the target process was
1494 successfully created. */
1498 if (attach_inferior (pid, &status, &signal) == -1)
1499 error ("Attaching not supported on this target");
1501 /* Otherwise succeeded. */
1509 /* Don't report shared library events on the initial connection,
1510 even if some libraries are preloaded. Avoids the "stopped by
1511 shared library event" notice on gdb side. */
1514 if (setjmp (toplevel))
1516 fprintf (stderr, "Killing inferior\n");
1521 if (status == 'W' || status == 'X')
1526 if (!was_running && !multi_mode)
1528 fprintf (stderr, "No program to debug. GDBserver exiting.\n");
1538 if (setjmp (toplevel) != 0)
1540 /* An error occurred. */
1541 if (response_needed)
1543 write_enn (own_buf);
1548 disable_async_io ();
1549 while (!exit_requested)
1553 int new_packet_len = -1;
1555 response_needed = 0;
1556 packet_len = getpkt (own_buf);
1557 if (packet_len <= 0)
1559 response_needed = 1;
1566 handle_query (own_buf, packet_len, &new_packet_len);
1569 handle_general_set (own_buf);
1572 require_running (own_buf);
1573 fprintf (stderr, "Detaching from inferior\n");
1574 if (detach_inferior () != 0)
1575 write_enn (own_buf);
1580 if (extended_protocol)
1582 /* Treat this like a normal program exit. */
1591 /* If we are attached, then we can exit. Otherwise, we
1592 need to hang around doing nothing, until the child
1602 extended_protocol = 1;
1606 prepare_resume_reply (own_buf, status, signal);
1609 if (own_buf[1] == 'c' || own_buf[1] == 'g' || own_buf[1] == 's')
1611 unsigned long gdb_id, thread_id;
1613 require_running (own_buf);
1614 gdb_id = strtoul (&own_buf[2], NULL, 16);
1615 if (gdb_id == 0 || gdb_id == -1)
1619 thread_id = gdb_id_to_thread_id (gdb_id);
1622 write_enn (own_buf);
1627 if (own_buf[1] == 'g')
1629 general_thread = thread_id;
1630 set_desired_inferior (1);
1632 else if (own_buf[1] == 'c')
1633 cont_thread = thread_id;
1634 else if (own_buf[1] == 's')
1635 step_thread = thread_id;
1641 /* Silently ignore it so that gdb can extend the protocol
1642 without compatibility headaches. */
1647 require_running (own_buf);
1648 set_desired_inferior (1);
1649 registers_to_string (own_buf);
1652 require_running (own_buf);
1653 set_desired_inferior (1);
1654 registers_from_string (&own_buf[1]);
1658 require_running (own_buf);
1659 decode_m_packet (&own_buf[1], &mem_addr, &len);
1660 if (read_inferior_memory (mem_addr, mem_buf, len) == 0)
1661 convert_int_to_ascii (mem_buf, own_buf, len);
1663 write_enn (own_buf);
1666 require_running (own_buf);
1667 decode_M_packet (&own_buf[1], &mem_addr, &len, mem_buf);
1668 if (write_inferior_memory (mem_addr, mem_buf, len) == 0)
1671 write_enn (own_buf);
1674 require_running (own_buf);
1675 if (decode_X_packet (&own_buf[1], packet_len - 1,
1676 &mem_addr, &len, mem_buf) < 0
1677 || write_inferior_memory (mem_addr, mem_buf, len) != 0)
1678 write_enn (own_buf);
1683 require_running (own_buf);
1684 convert_ascii_to_int (own_buf + 1, &sig, 1);
1685 if (target_signal_to_host_p (sig))
1686 signal = target_signal_to_host (sig);
1689 myresume (own_buf, 0, &signal, &status);
1692 require_running (own_buf);
1693 convert_ascii_to_int (own_buf + 1, &sig, 1);
1694 if (target_signal_to_host_p (sig))
1695 signal = target_signal_to_host (sig);
1698 myresume (own_buf, 1, &signal, &status);
1701 require_running (own_buf);
1703 myresume (own_buf, 0, &signal, &status);
1706 require_running (own_buf);
1708 myresume (own_buf, 1, &signal, &status);
1714 CORE_ADDR addr = strtoul (&own_buf[3], &lenptr, 16);
1715 int len = strtol (lenptr + 1, &dataptr, 16);
1716 char type = own_buf[1];
1718 if (the_target->insert_watchpoint == NULL
1719 || (type < '2' || type > '4'))
1721 /* No watchpoint support or not a watchpoint command;
1722 unrecognized either way. */
1729 require_running (own_buf);
1730 res = (*the_target->insert_watchpoint) (type, addr, len);
1737 write_enn (own_buf);
1745 CORE_ADDR addr = strtoul (&own_buf[3], &lenptr, 16);
1746 int len = strtol (lenptr + 1, &dataptr, 16);
1747 char type = own_buf[1];
1749 if (the_target->remove_watchpoint == NULL
1750 || (type < '2' || type > '4'))
1752 /* No watchpoint support or not a watchpoint command;
1753 unrecognized either way. */
1760 require_running (own_buf);
1761 res = (*the_target->remove_watchpoint) (type, addr, len);
1768 write_enn (own_buf);
1773 response_needed = 0;
1774 if (!target_running ())
1775 /* The packet we received doesn't make sense - but we
1776 can't reply to it, either. */
1779 fprintf (stderr, "Killing inferior\n");
1782 /* When using the extended protocol, we wait with no
1783 program running. The traditional protocol will exit
1785 if (extended_protocol)
1788 signal = TARGET_SIGNAL_KILL;
1799 unsigned long gdb_id, thread_id;
1801 require_running (own_buf);
1802 gdb_id = strtoul (&own_buf[1], NULL, 16);
1803 thread_id = gdb_id_to_thread_id (gdb_id);
1806 write_enn (own_buf);
1810 if (mythread_alive (thread_id))
1813 write_enn (own_buf);
1817 response_needed = 0;
1819 /* Restarting the inferior is only supported in the
1820 extended protocol. */
1821 if (extended_protocol)
1823 if (target_running ())
1825 fprintf (stderr, "GDBserver restarting\n");
1827 /* Wait till we are at 1st instruction in prog. */
1828 if (program_argv != NULL)
1829 signal = start_inferior (program_argv, &status);
1833 signal = TARGET_SIGNAL_KILL;
1839 /* It is a request we don't understand. Respond with an
1840 empty packet so that gdb knows that we don't support this
1846 /* Extended (long) request. */
1847 handle_v_requests (own_buf, &status, &signal,
1848 packet_len, &new_packet_len);
1852 /* It is a request we don't understand. Respond with an
1853 empty packet so that gdb knows that we don't support this
1859 if (new_packet_len != -1)
1860 putpkt_binary (own_buf, new_packet_len);
1864 response_needed = 0;
1866 if (was_running && (status == 'W' || status == 'X'))
1872 "\nChild exited with status %d\n", signal);
1874 fprintf (stderr, "\nChild terminated with signal = 0x%x (%s)\n",
1875 target_signal_to_host (signal),
1876 target_signal_to_name (signal));
1878 if (extended_protocol)
1882 fprintf (stderr, "GDBserver exiting\n");
1887 if (status != 'W' && status != 'X')
1891 /* If an exit was requested (using the "monitor exit" command),
1892 terminate now. The only other way to get here is for
1893 getpkt to fail; close the connection and reopen it at the
1899 if (attached && target_running ())
1901 else if (target_running ())
1907 fprintf (stderr, "Remote side has terminated connection. "
1908 "GDBserver will reopen the connection.\n");