gdbserver: gdb cmds returning failure on success
[fw/openocd] / src / server / gdb_server.c
1 /***************************************************************************
2  *   Copyright (C) 2005 by Dominic Rath                                    *
3  *   Dominic.Rath@gmx.de                                                   *
4  *                                                                         *
5  *   Copyright (C) 2007-2010 Ã˜yvind Harboe                                 *
6  *   oyvind.harboe@zylin.com                                               *
7  *                                                                         *
8  *   Copyright (C) 2008 by Spencer Oliver                                  *
9  *   spen@spen-soft.co.uk                                                  *
10  *                                                                         *
11  *   This program is free software; you can redistribute it and/or modify  *
12  *   it under the terms of the GNU General Public License as published by  *
13  *   the Free Software Foundation; either version 2 of the License, or     *
14  *   (at your option) any later version.                                   *
15  *                                                                         *
16  *   This program is distributed in the hope that it will be useful,       *
17  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
18  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
19  *   GNU General Public License for more details.                          *
20  *                                                                         *
21  *   You should have received a copy of the GNU General Public License     *
22  *   along with this program; if not, write to the                         *
23  *   Free Software Foundation, Inc.,                                       *
24  *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
25  ***************************************************************************/
26 #ifdef HAVE_CONFIG_H
27 #include "config.h"
28 #endif
29
30 #include <target/breakpoints.h>
31 #include <target/target_request.h>
32 #include <target/register.h>
33 #include "server.h"
34 #include <flash/nor/core.h>
35 #include "gdb_server.h"
36 #include <target/image.h>
37 #include <jtag/jtag.h>
38
39
40 /**
41  * @file
42  * GDB server implementation.
43  *
44  * This implements the GDB Remote Serial Protocol, over TCP connections,
45  * giving GDB access to the JTAG or other hardware debugging facilities
46  * found in most modern embedded processors.
47  */
48
49 /* private connection data for GDB */
50 struct gdb_connection
51 {
52         char buffer[GDB_BUFFER_SIZE];
53         char *buf_p;
54         int buf_cnt;
55         int ctrl_c;
56         enum target_state frontend_state;
57         struct image *vflash_image;
58         int closed;
59         int busy;
60         int noack_mode;
61         bool sync;      /* set flag to true if you want the next stepi to return immediately.
62                        allowing GDB to pick up a fresh set of register values from the target
63                        without modifying the target state. */
64         /* We delay reporting memory write errors until next step/continue or memory
65          * write. This improves performance of gdb load significantly as the GDB packet
66          * can be replied immediately and a new GDB packet will be ready without delay
67          * (ca. 10% or so...).
68          */
69         bool mem_write_error;
70 };
71
72
73 #if 0
74 #define _DEBUG_GDB_IO_
75 #endif
76
77 static struct gdb_connection *current_gdb_connection;
78
79 static int gdb_breakpoint_override;
80 static enum breakpoint_type gdb_breakpoint_override_type;
81
82 static int gdb_error(struct connection *connection, int retval);
83 static unsigned short gdb_port = 3333;
84 static unsigned short gdb_port_next = 0;
85 static const char DIGITS[16] = "0123456789abcdef";
86
87 static void gdb_log_callback(void *priv, const char *file, unsigned line,
88                 const char *function, const char *string);
89
90 /* number of gdb connections, mainly to suppress gdb related debugging spam
91  * in helper/log.c when no gdb connections are actually active */
92 int gdb_actual_connections;
93
94 /* set if we are sending a memory map to gdb
95  * via qXfer:memory-map:read packet */
96 /* enabled by default*/
97 static int gdb_use_memory_map = 1;
98 /* enabled by default*/
99 static int gdb_flash_program = 1;
100
101 /* if set, data aborts cause an error to be reported in memory read packets
102  * see the code in gdb_read_memory_packet() for further explanations.
103  * Disabled by default.
104  */
105 static int gdb_report_data_abort;
106
107 static int gdb_last_signal(struct target *target)
108 {
109         switch (target->debug_reason)
110         {
111                 case DBG_REASON_DBGRQ:
112                         return 0x2; /* SIGINT */
113                 case DBG_REASON_BREAKPOINT:
114                 case DBG_REASON_WATCHPOINT:
115                 case DBG_REASON_WPTANDBKPT:
116                         return 0x05; /* SIGTRAP */
117                 case DBG_REASON_SINGLESTEP:
118                         return 0x05; /* SIGTRAP */
119                 case DBG_REASON_NOTHALTED:
120                         return 0x0; /* no signal... shouldn't happen */
121                 default:
122                         LOG_USER("undefined debug reason %d - target needs reset", target->debug_reason);
123                         return 0x0;
124         }
125 }
126
127 static int check_pending(struct connection *connection,
128                 int timeout_s, int *got_data)
129 {
130         /* a non-blocking socket will block if there is 0 bytes available on the socket,
131          * but return with as many bytes as are available immediately
132          */
133         struct timeval tv;
134         fd_set read_fds;
135         struct gdb_connection *gdb_con = connection->priv;
136         int t;
137         if (got_data == NULL)
138                 got_data=&t;
139         *got_data = 0;
140
141         if (gdb_con->buf_cnt > 0)
142         {
143                 *got_data = 1;
144                 return ERROR_OK;
145         }
146
147         FD_ZERO(&read_fds);
148         FD_SET(connection->fd, &read_fds);
149
150         tv.tv_sec = timeout_s;
151         tv.tv_usec = 0;
152         if (socket_select(connection->fd + 1, &read_fds, NULL, NULL, &tv) == 0)
153         {
154                 /* This can typically be because a "monitor" command took too long
155                  * before printing any progress messages
156                  */
157                 if (timeout_s > 0)
158                 {
159                         return ERROR_GDB_TIMEOUT;
160                 } else
161                 {
162                         return ERROR_OK;
163                 }
164         }
165         *got_data = FD_ISSET(connection->fd, &read_fds) != 0;
166         return ERROR_OK;
167 }
168
169 static int gdb_get_char_inner(struct connection *connection, int* next_char)
170 {
171         struct gdb_connection *gdb_con = connection->priv;
172         int retval = ERROR_OK;
173
174 #ifdef _DEBUG_GDB_IO_
175         char *debug_buffer;
176 #endif
177         for (;;)
178         {
179                 if (connection->service->type == CONNECTION_PIPE)
180                 {
181                         gdb_con->buf_cnt = read(connection->fd, gdb_con->buffer, GDB_BUFFER_SIZE);
182                 }
183                 else
184                 {
185                         retval = check_pending(connection, 1, NULL);
186                         if (retval != ERROR_OK)
187                                 return retval;
188                         gdb_con->buf_cnt = read_socket(connection->fd, gdb_con->buffer, GDB_BUFFER_SIZE);
189                 }
190
191                 if (gdb_con->buf_cnt > 0)
192                 {
193                         break;
194                 }
195                 if (gdb_con->buf_cnt == 0)
196                 {
197                         gdb_con->closed = 1;
198                         return ERROR_SERVER_REMOTE_CLOSED;
199                 }
200
201 #ifdef _WIN32
202                 errno = WSAGetLastError();
203
204                 switch (errno)
205                 {
206                         case WSAEWOULDBLOCK:
207                                 usleep(1000);
208                                 break;
209                         case WSAECONNABORTED:
210                                 gdb_con->closed = 1;
211                                 return ERROR_SERVER_REMOTE_CLOSED;
212                         case WSAECONNRESET:
213                                 gdb_con->closed = 1;
214                                 return ERROR_SERVER_REMOTE_CLOSED;
215                         default:
216                                 LOG_ERROR("read: %d", errno);
217                                 exit(-1);
218                 }
219 #else
220                 switch (errno)
221                 {
222                         case EAGAIN:
223                                 usleep(1000);
224                                 break;
225                         case ECONNABORTED:
226                                 gdb_con->closed = 1;
227                                 return ERROR_SERVER_REMOTE_CLOSED;
228                         case ECONNRESET:
229                                 gdb_con->closed = 1;
230                                 return ERROR_SERVER_REMOTE_CLOSED;
231                         default:
232                                 LOG_ERROR("read: %s", strerror(errno));
233                                 gdb_con->closed = 1;
234                                 return ERROR_SERVER_REMOTE_CLOSED;
235                 }
236 #endif
237         }
238
239 #ifdef _DEBUG_GDB_IO_
240         debug_buffer = malloc(gdb_con->buf_cnt + 1);
241         memcpy(debug_buffer, gdb_con->buffer, gdb_con->buf_cnt);
242         debug_buffer[gdb_con->buf_cnt] = 0;
243         LOG_DEBUG("received '%s'", debug_buffer);
244         free(debug_buffer);
245 #endif
246
247         gdb_con->buf_p = gdb_con->buffer;
248         gdb_con->buf_cnt--;
249         *next_char = *(gdb_con->buf_p++);
250         if (gdb_con->buf_cnt > 0)
251                 connection->input_pending = 1;
252         else
253                 connection->input_pending = 0;
254 #ifdef _DEBUG_GDB_IO_
255         LOG_DEBUG("returned char '%c' (0x%2.2x)", *next_char, *next_char);
256 #endif
257
258         return retval;
259 }
260
261 /**
262  * The cool thing about this fn is that it allows buf_p and buf_cnt to be
263  * held in registers in the inner loop.
264  *
265  * For small caches and embedded systems this is important!
266  */
267 static inline int gdb_get_char_fast(struct connection *connection, int* next_char, char **buf_p, int *buf_cnt)
268 {
269         int retval = ERROR_OK;
270
271         if ((*buf_cnt)-- > 0)
272         {
273                 *next_char = **buf_p;
274                 (*buf_p)++;
275                 if (*buf_cnt > 0)
276                         connection->input_pending = 1;
277                 else
278                         connection->input_pending = 0;
279
280 #ifdef _DEBUG_GDB_IO_
281                 LOG_DEBUG("returned char '%c' (0x%2.2x)", *next_char, *next_char);
282 #endif
283
284                 return ERROR_OK;
285         }
286
287         struct gdb_connection *gdb_con = connection->priv;
288         gdb_con->buf_p = *buf_p;
289         gdb_con->buf_cnt = *buf_cnt;
290         retval = gdb_get_char_inner(connection, next_char);
291         *buf_p = gdb_con->buf_p;
292         *buf_cnt = gdb_con->buf_cnt;
293
294         return retval;
295 }
296
297
298 static int gdb_get_char(struct connection *connection, int* next_char)
299 {
300         struct gdb_connection *gdb_con = connection->priv;
301         return gdb_get_char_fast(connection, next_char, &gdb_con->buf_p, &gdb_con->buf_cnt);
302 }
303
304
305 static int gdb_putback_char(struct connection *connection, int last_char)
306 {
307         struct gdb_connection *gdb_con = connection->priv;
308
309         if (gdb_con->buf_p > gdb_con->buffer)
310         {
311                 *(--gdb_con->buf_p) = last_char;
312                 gdb_con->buf_cnt++;
313         }
314         else
315         {
316                 LOG_ERROR("BUG: couldn't put character back");
317         }
318
319         return ERROR_OK;
320 }
321
322 /* The only way we can detect that the socket is closed is the first time
323  * we write to it, we will fail. Subsequent write operations will
324  * succeed. Shudder! */
325 static int gdb_write(struct connection *connection, void *data, int len)
326 {
327         struct gdb_connection *gdb_con = connection->priv;
328         if (gdb_con->closed)
329                 return ERROR_SERVER_REMOTE_CLOSED;
330
331         if (connection->service->type == CONNECTION_PIPE)
332         {
333                 /* write to stdout */
334                 if (write(STDOUT_FILENO, data, len) == len)
335                 {
336                         return ERROR_OK;
337                 }
338         }
339         else
340         {
341                 if (write_socket(connection->fd, data, len) == len)
342                 {
343                         return ERROR_OK;
344                 }
345         }
346         gdb_con->closed = 1;
347         return ERROR_SERVER_REMOTE_CLOSED;
348 }
349
350 static int gdb_put_packet_inner(struct connection *connection,
351                 char *buffer, int len)
352 {
353         int i;
354         unsigned char my_checksum = 0;
355 #ifdef _DEBUG_GDB_IO_
356         char *debug_buffer;
357 #endif
358         int reply;
359         int retval;
360         struct gdb_connection *gdb_con = connection->priv;
361
362         for (i = 0; i < len; i++)
363                 my_checksum += buffer[i];
364
365 #ifdef _DEBUG_GDB_IO_
366         /*
367          * At this point we should have nothing in the input queue from GDB,
368          * however sometimes '-' is sent even though we've already received
369          * an ACK (+) for everything we've sent off.
370          */
371         int gotdata;
372         for (;;)
373         {
374                 retval = check_pending(connection, 0, &gotdata);
375                 if (retval != ERROR_OK)
376                         return retval;
377                 if (!gotdata)
378                         break;
379                 if ((retval = gdb_get_char(connection, &reply)) != ERROR_OK)
380                         return retval;
381                 if (reply == '$') {
382                         /* fix a problem with some IAR tools */
383                         gdb_putback_char(connection, reply);
384                         LOG_DEBUG("Unexpected start of new packet");
385                         break;
386                 }
387
388                 LOG_WARNING("Discard unexpected char %c", reply);
389         }
390 #endif
391
392         while (1)
393         {
394 #ifdef _DEBUG_GDB_IO_
395                 debug_buffer = malloc(len + 1);
396                 memcpy(debug_buffer, buffer, len);
397                 debug_buffer[len] = 0;
398                 LOG_DEBUG("sending packet '$%s#%2.2x'", debug_buffer, my_checksum);
399                 free(debug_buffer);
400 #endif
401
402                 char local_buffer[1024];
403                 local_buffer[0] = '$';
404                 if ((size_t)len + 4 <= sizeof(local_buffer))
405                 {
406                         /* performance gain on smaller packets by only a single call to gdb_write() */
407                         memcpy(local_buffer + 1, buffer, len++);
408                         local_buffer[len++] = '#';
409                         local_buffer[len++] = DIGITS[(my_checksum >> 4) & 0xf];
410                         local_buffer[len++] = DIGITS[my_checksum & 0xf];
411                         if ((retval = gdb_write(connection, local_buffer, len)) != ERROR_OK)
412                         {
413                                 return retval;
414                         }
415                 }
416                 else
417                 {
418                         /* larger packets are transmitted directly from caller supplied buffer
419                            by several calls to gdb_write() to avoid dynamic allocation */
420                         local_buffer[1] = '#';
421                         local_buffer[2] = DIGITS[(my_checksum >> 4) & 0xf];
422                         local_buffer[3] = DIGITS[my_checksum & 0xf];
423                         if ((retval = gdb_write(connection, local_buffer, 1)) != ERROR_OK)
424                         {
425                                 return retval;
426                         }
427                         if ((retval = gdb_write(connection, buffer, len)) != ERROR_OK)
428                         {
429                                 return retval;
430                         }
431                         if ((retval = gdb_write(connection, local_buffer + 1, 3)) != ERROR_OK)
432                         {
433                                 return retval;
434                         }
435                 }
436
437                 if (gdb_con->noack_mode)
438                         break;
439
440                 if ((retval = gdb_get_char(connection, &reply)) != ERROR_OK)
441                         return retval;
442
443                 if (reply == '+')
444                         break;
445                 else if (reply == '-')
446                 {
447                         /* Stop sending output packets for now */
448                         log_remove_callback(gdb_log_callback, connection);
449                         LOG_WARNING("negative reply, retrying");
450                 }
451                 else if (reply == 0x3)
452                 {
453                         gdb_con->ctrl_c = 1;
454                         if ((retval = gdb_get_char(connection, &reply)) != ERROR_OK)
455                                 return retval;
456                         if (reply == '+')
457                                 break;
458                         else if (reply == '-')
459                         {
460                                 /* Stop sending output packets for now */
461                                 log_remove_callback(gdb_log_callback, connection);
462                                 LOG_WARNING("negative reply, retrying");
463                         }
464                         else if (reply == '$') {
465                                 LOG_ERROR("GDB missing ack(1) - assumed good");
466                                 gdb_putback_char(connection, reply);
467                                 return ERROR_OK;
468                         } else {
469
470                                 LOG_ERROR("unknown character(1) 0x%2.2x in reply, dropping connection", reply);
471                                 gdb_con->closed = 1;
472                                 return ERROR_SERVER_REMOTE_CLOSED;
473                         }
474                 }
475                 else if (reply == '$') {
476                         LOG_ERROR("GDB missing ack(2) - assumed good");
477                         gdb_putback_char(connection, reply);
478                         return ERROR_OK;
479                 }
480                 else
481                 {
482                         LOG_ERROR("unknown character(2) 0x%2.2x in reply, dropping connection", reply);
483                         gdb_con->closed = 1;
484                         return ERROR_SERVER_REMOTE_CLOSED;
485                 }
486         }
487         if (gdb_con->closed)
488                 return ERROR_SERVER_REMOTE_CLOSED;
489
490         return ERROR_OK;
491 }
492
493 static int gdb_put_packet(struct connection *connection, char *buffer, int len)
494 {
495         struct gdb_connection *gdb_con = connection->priv;
496         gdb_con->busy = 1;
497         int retval = gdb_put_packet_inner(connection, buffer, len);
498         gdb_con->busy = 0;
499
500         /* we sent some data, reset timer for keep alive messages */
501         kept_alive();
502
503         return retval;
504 }
505
506 static __inline__ int fetch_packet(struct connection *connection, int *checksum_ok, int noack, int *len, char *buffer)
507 {
508         unsigned char my_checksum = 0;
509         char checksum[3];
510         int character;
511         int retval = ERROR_OK;
512
513         struct gdb_connection *gdb_con = connection->priv;
514         my_checksum = 0;
515         int count = 0;
516         count = 0;
517
518         /* move this over into local variables to use registers and give the
519          * more freedom to optimize */
520         char *buf_p = gdb_con->buf_p;
521         int buf_cnt = gdb_con->buf_cnt;
522
523         for (;;)
524         {
525                 /* The common case is that we have an entire packet with no escape chars.
526                  * We need to leave at least 2 bytes in the buffer to have
527                  * gdb_get_char() update various bits and bobs correctly.
528                  */
529                 if ((buf_cnt > 2) && ((buf_cnt + count) < *len))
530                 {
531                         /* The compiler will struggle a bit with constant propagation and
532                          * aliasing, so we help it by showing that these values do not
533                          * change inside the loop
534                          */
535                         int i;
536                         char *buf = buf_p;
537                         int run = buf_cnt - 2;
538                         i = 0;
539                         int done = 0;
540                         while (i < run)
541                         {
542                                 character = *buf++;
543                                 i++;
544                                 if (character == '#')
545                                 {
546                                         /* Danger! character can be '#' when esc is
547                                          * used so we need an explicit boolean for done here.
548                                          */
549                                         done = 1;
550                                         break;
551                                 }
552
553                                 if (character == '}')
554                                 {
555                                         /* data transmitted in binary mode (X packet)
556                                          * uses 0x7d as escape character */
557                                         my_checksum += character & 0xff;
558                                         character = *buf++;
559                                         i++;
560                                         my_checksum += character & 0xff;
561                                         buffer[count++] = (character ^ 0x20) & 0xff;
562                                 }
563                                 else
564                                 {
565                                         my_checksum += character & 0xff;
566                                         buffer[count++] = character & 0xff;
567                                 }
568                         }
569                         buf_p += i;
570                         buf_cnt -= i;
571                         if (done)
572                                 break;
573                 }
574                 if (count > *len)
575                 {
576                         LOG_ERROR("packet buffer too small");
577                         retval = ERROR_GDB_BUFFER_TOO_SMALL;
578                         break;
579                 }
580
581                 retval = gdb_get_char_fast(connection, &character, &buf_p, &buf_cnt);
582                 if (retval != ERROR_OK)
583                         break;
584
585                 if (character == '#')
586                         break;
587
588                 if (character == '}')
589                 {
590                         /* data transmitted in binary mode (X packet)
591                          * uses 0x7d as escape character */
592                         my_checksum += character & 0xff;
593
594                         retval = gdb_get_char_fast(connection, &character, &buf_p, &buf_cnt);
595                         if (retval != ERROR_OK)
596                                 break;
597
598                         my_checksum += character & 0xff;
599                         buffer[count++] = (character ^ 0x20) & 0xff;
600                 }
601                 else
602                 {
603                         my_checksum += character & 0xff;
604                         buffer[count++] = character & 0xff;
605                 }
606         }
607
608         gdb_con->buf_p = buf_p;
609         gdb_con->buf_cnt = buf_cnt;
610
611         if (retval != ERROR_OK)
612                 return retval;
613
614         *len = count;
615
616         if ((retval = gdb_get_char(connection, &character)) != ERROR_OK)
617                 return retval;
618         checksum[0] = character;
619         if ((retval = gdb_get_char(connection, &character)) != ERROR_OK)
620                 return retval;
621         checksum[1] = character;
622         checksum[2] = 0;
623
624         if (!noack)
625         {
626                 *checksum_ok = (my_checksum == strtoul(checksum, NULL, 16));
627         }
628
629         return ERROR_OK;
630 }
631
632 static int gdb_get_packet_inner(struct connection *connection,
633                 char *buffer, int *len)
634 {
635         int character;
636         int retval;
637         struct gdb_connection *gdb_con = connection->priv;
638
639         while (1)
640         {
641                 do
642                 {
643                         if ((retval = gdb_get_char(connection, &character)) != ERROR_OK)
644                                 return retval;
645
646 #ifdef _DEBUG_GDB_IO_
647                         LOG_DEBUG("character: '%c'", character);
648 #endif
649
650                         switch (character)
651                         {
652                                 case '$':
653                                         break;
654                                 case '+':
655                                         /* gdb sends a dummy ack '+' at every remote connect - see remote_start_remote (remote.c)
656                                          * in case anyone tries to debug why they receive this warning every time */
657                                         LOG_WARNING("acknowledgment received, but no packet pending");
658                                         break;
659                                 case '-':
660                                         LOG_WARNING("negative acknowledgment, but no packet pending");
661                                         break;
662                                 case 0x3:
663                                         gdb_con->ctrl_c = 1;
664                                         *len = 0;
665                                         return ERROR_OK;
666                                 default:
667                                         LOG_WARNING("ignoring character 0x%x", character);
668                                         break;
669                         }
670                 } while (character != '$');
671
672
673
674                 int checksum_ok = 0;
675                 /* explicit code expansion here to get faster inlined code in -O3 by not
676                  * calculating checksum
677                  */
678                 if (gdb_con->noack_mode)
679                 {
680                         if ((retval = fetch_packet(connection, &checksum_ok, 1, len, buffer)) != ERROR_OK)
681                                 return retval;
682                 } else
683                 {
684                         if ((retval = fetch_packet(connection, &checksum_ok, 0, len, buffer)) != ERROR_OK)
685                                 return retval;
686                 }
687
688                 if (gdb_con->noack_mode)
689                 {
690                         /* checksum is not checked in noack mode */
691                         break;
692                 }
693                 if (checksum_ok)
694                 {
695                         if ((retval = gdb_write(connection, "+", 1)) != ERROR_OK)
696                         {
697                                 return retval;
698                         }
699                         break;
700                 }
701         }
702         if (gdb_con->closed)
703                 return ERROR_SERVER_REMOTE_CLOSED;
704
705         return ERROR_OK;
706 }
707
708 static int gdb_get_packet(struct connection *connection, char *buffer, int *len)
709 {
710         struct gdb_connection *gdb_con = connection->priv;
711         gdb_con->busy = 1;
712         int retval = gdb_get_packet_inner(connection, buffer, len);
713         gdb_con->busy = 0;
714         return retval;
715 }
716
717 static int gdb_output_con(struct connection *connection, const char* line)
718 {
719         char *hex_buffer;
720         int i, bin_size;
721
722         bin_size = strlen(line);
723
724         hex_buffer = malloc(bin_size*2 + 2);
725         if (hex_buffer == NULL)
726                 return ERROR_GDB_BUFFER_TOO_SMALL;
727
728         hex_buffer[0] = 'O';
729         for (i = 0; i < bin_size; i++)
730                 snprintf(hex_buffer + 1 + i*2, 3, "%2.2x", line[i]);
731         hex_buffer[bin_size*2 + 1] = 0;
732
733         int retval = gdb_put_packet(connection, hex_buffer, bin_size*2 + 1);
734
735         free(hex_buffer);
736         return retval;
737 }
738
739 static int gdb_output(struct command_context *context, const char* line)
740 {
741         /* this will be dumped to the log and also sent as an O packet if possible */
742         LOG_USER_N("%s", line);
743         return ERROR_OK;
744 }
745
746
747 static void gdb_frontend_halted(struct target *target, struct connection *connection)
748 {
749         struct gdb_connection *gdb_connection = connection->priv;
750
751         /* In the GDB protocol when we are stepping or continuing execution,
752          * we have a lingering reply. Upon receiving a halted event
753          * when we have that lingering packet, we reply to the original
754          * step or continue packet.
755          *
756          * Executing monitor commands can bring the target in and
757          * out of the running state so we'll see lots of TARGET_EVENT_XXX
758          * that are to be ignored.
759          */
760         if (gdb_connection->frontend_state == TARGET_RUNNING)
761         {
762                 char sig_reply[4];
763                 int signal;
764
765                 /* stop forwarding log packets! */
766                 log_remove_callback(gdb_log_callback, connection);
767
768                 if (gdb_connection->ctrl_c)
769                 {
770                         signal = 0x2;
771                         gdb_connection->ctrl_c = 0;
772                 }
773                 else
774                 {
775                         signal = gdb_last_signal(target);
776                 }
777
778                 snprintf(sig_reply, 4, "T%2.2x", signal);
779                 gdb_put_packet(connection, sig_reply, 3);
780                 gdb_connection->frontend_state = TARGET_HALTED;
781         }
782 }
783
784 static int gdb_target_callback_event_handler(struct target *target,
785                 enum target_event event, void *priv)
786 {
787         int retval;
788         struct connection *connection = priv;
789
790         target_handle_event(target, event);
791         switch (event)
792         {
793                 case TARGET_EVENT_GDB_HALT:
794                         gdb_frontend_halted(target, connection);
795                         break;
796                 case TARGET_EVENT_HALTED:
797                         target_call_event_callbacks(target, TARGET_EVENT_GDB_END);
798                         break;
799                 case TARGET_EVENT_GDB_FLASH_ERASE_START:
800                         target_handle_event(target, TARGET_EVENT_OLD_gdb_program_config);
801                         if ((retval = jtag_execute_queue()) != ERROR_OK)
802                         {
803                                 return retval;
804                         }
805                         break;
806                 default:
807                         break;
808         }
809
810         return ERROR_OK;
811 }
812
813 static int gdb_new_connection(struct connection *connection)
814 {
815         struct gdb_connection *gdb_connection = malloc(sizeof(struct gdb_connection));
816         struct gdb_service *gdb_service = connection->service->priv;
817         int retval;
818         int initial_ack;
819
820         connection->priv = gdb_connection;
821
822         /* initialize gdb connection information */
823         gdb_connection->buf_p = gdb_connection->buffer;
824         gdb_connection->buf_cnt = 0;
825         gdb_connection->ctrl_c = 0;
826         gdb_connection->frontend_state = TARGET_HALTED;
827         gdb_connection->vflash_image = NULL;
828         gdb_connection->closed = 0;
829         gdb_connection->busy = 0;
830         gdb_connection->noack_mode = 0;
831         gdb_connection->sync = true;
832         gdb_connection->mem_write_error = false;
833
834         /* send ACK to GDB for debug request */
835         gdb_write(connection, "+", 1);
836
837         /* output goes through gdb connection */
838         command_set_output_handler(connection->cmd_ctx, gdb_output, connection);
839
840         /* we must remove all breakpoints registered to the target as a previous
841          * GDB session could leave dangling breakpoints if e.g. communication
842          * timed out.
843          */
844         breakpoint_clear_target(gdb_service->target);
845         watchpoint_clear_target(gdb_service->target);
846
847         /* register callback to be informed about target events */
848         target_register_event_callback(gdb_target_callback_event_handler, connection);
849
850         /* remove the initial ACK from the incoming buffer */
851         if ((retval = gdb_get_char(connection, &initial_ack)) != ERROR_OK)
852                 return retval;
853
854         /* FIX!!!??? would we actually ever receive a + here???
855          * Not observed.
856          */
857         if (initial_ack != '+')
858                 gdb_putback_char(connection, initial_ack);
859         target_call_event_callbacks(gdb_service->target, TARGET_EVENT_GDB_ATTACH);
860
861         if (gdb_use_memory_map)
862         {
863                 /* Connect must fail if the memory map can't be set up correctly.
864                  *
865                  * This will cause an auto_probe to be invoked, which is either
866                  * a no-op or it will fail when the target isn't ready(e.g. not halted).
867                  */
868                 int i;
869                 for (i = 0; i < flash_get_bank_count(); i++)
870                 {
871                         struct flash_bank *p;
872                         retval = get_flash_bank_by_num(i, &p);
873                         if (retval != ERROR_OK)
874                         {
875                                 LOG_ERROR("Connect failed. Consider setting up a gdb-attach event for the target to prepare target for GDB connect.");
876                                 return retval;
877                         }
878                 }
879         }
880
881         gdb_actual_connections++;
882         LOG_DEBUG("New GDB Connection: %d, Target %s, state: %s",
883                   gdb_actual_connections,
884                   target_name(gdb_service->target),
885                   target_state_name(gdb_service->target));
886
887         return ERROR_OK;
888 }
889
890 static int gdb_connection_closed(struct connection *connection)
891 {
892         struct gdb_service *gdb_service = connection->service->priv;
893         struct gdb_connection *gdb_connection = connection->priv;
894
895         /* we're done forwarding messages. Tear down callback before
896          * cleaning up connection.
897          */
898         log_remove_callback(gdb_log_callback, connection);
899
900         gdb_actual_connections--;
901         LOG_DEBUG("GDB Close, Target: %s, state: %s, gdb_actual_connections=%d",
902                   target_name(gdb_service->target),
903                   target_state_name(gdb_service->target),
904                   gdb_actual_connections);
905
906         /* see if an image built with vFlash commands is left */
907         if (gdb_connection->vflash_image)
908         {
909                 image_close(gdb_connection->vflash_image);
910                 free(gdb_connection->vflash_image);
911                 gdb_connection->vflash_image = NULL;
912         }
913
914         /* if this connection registered a debug-message receiver delete it */
915         delete_debug_msg_receiver(connection->cmd_ctx, gdb_service->target);
916
917         if (connection->priv)
918         {
919                 free(connection->priv);
920                 connection->priv = NULL;
921         }
922         else
923         {
924                 LOG_ERROR("BUG: connection->priv == NULL");
925         }
926
927
928         target_unregister_event_callback(gdb_target_callback_event_handler, connection);
929
930         target_call_event_callbacks(gdb_service->target, TARGET_EVENT_GDB_END);
931
932         target_call_event_callbacks(gdb_service->target, TARGET_EVENT_GDB_DETACH);
933
934         return ERROR_OK;
935 }
936
937 static void gdb_send_error(struct connection *connection, uint8_t the_error)
938 {
939         char err[4];
940         snprintf(err, 4, "E%2.2X", the_error);
941         gdb_put_packet(connection, err, 3);
942 }
943
944 static int gdb_last_signal_packet(struct connection *connection,
945                 struct target *target, char* packet, int packet_size)
946 {
947         char sig_reply[4];
948         int signal;
949
950         signal = gdb_last_signal(target);
951
952         snprintf(sig_reply, 4, "S%2.2x", signal);
953         gdb_put_packet(connection, sig_reply, 3);
954
955         return ERROR_OK;
956 }
957
958 static int gdb_reg_pos(struct target *target, int pos, int len)
959 {
960         if (target->endianness == TARGET_LITTLE_ENDIAN)
961                 return pos;
962         else
963                 return len - 1 - pos;
964 }
965
966 /* Convert register to string of bytes. NB! The # of bits in the
967  * register might be non-divisible by 8(a byte), in which
968  * case an entire byte is shown.
969  *
970  * NB! the format on the wire is the target endianness
971  *
972  * The format of reg->value is little endian
973  *
974  */
975 static void gdb_str_to_target(struct target *target,
976                 char *tstr, struct reg *reg)
977 {
978         int i;
979
980         uint8_t *buf;
981         int buf_len;
982         buf = reg->value;
983         buf_len = DIV_ROUND_UP(reg->size, 8);
984
985         for (i = 0; i < buf_len; i++)
986         {
987                 int j = gdb_reg_pos(target, i, buf_len);
988                 tstr[i*2]   = DIGITS[(buf[j]>>4) & 0xf];
989                 tstr[i*2 + 1] = DIGITS[buf[j]&0xf];
990         }
991 }
992
993 static int hextoint(int c)
994 {
995         if (c>='0'&&c<='9')
996         {
997                 return c-'0';
998         }
999         c = toupper(c);
1000         if (c>='A'&&c<='F')
1001         {
1002                 return c-'A'+10;
1003         }
1004         LOG_ERROR("BUG: invalid register value %08x", c);
1005         return 0;
1006 }
1007
1008 /* copy over in register buffer */
1009 static void gdb_target_to_reg(struct target *target,
1010                 char *tstr, int str_len, uint8_t *bin)
1011 {
1012         if (str_len % 2)
1013         {
1014                 LOG_ERROR("BUG: gdb value with uneven number of characters encountered");
1015                 exit(-1);
1016         }
1017
1018         int i;
1019         for (i = 0; i < str_len; i += 2)
1020         {
1021                 uint8_t t = hextoint(tstr[i]) << 4;
1022                 t |= hextoint(tstr[i + 1]);
1023
1024                 int j = gdb_reg_pos(target, i/2, str_len/2);
1025                 bin[j] = t;
1026         }
1027 }
1028
1029 static int gdb_get_registers_packet(struct connection *connection,
1030                 struct target *target, char* packet, int packet_size)
1031 {
1032         struct reg **reg_list;
1033         int reg_list_size;
1034         int retval;
1035         int reg_packet_size = 0;
1036         char *reg_packet;
1037         char *reg_packet_p;
1038         int i;
1039
1040 #ifdef _DEBUG_GDB_IO_
1041         LOG_DEBUG("-");
1042 #endif
1043
1044         if ((retval = target_get_gdb_reg_list(target, &reg_list, &reg_list_size)) != ERROR_OK)
1045         {
1046                 return gdb_error(connection, retval);
1047         }
1048
1049         for (i = 0; i < reg_list_size; i++)
1050         {
1051                 reg_packet_size += reg_list[i]->size;
1052         }
1053
1054         reg_packet = malloc(DIV_ROUND_UP(reg_packet_size, 8) * 2);
1055         reg_packet_p = reg_packet;
1056
1057         for (i = 0; i < reg_list_size; i++)
1058         {
1059                 gdb_str_to_target(target, reg_packet_p, reg_list[i]);
1060                 reg_packet_p += DIV_ROUND_UP(reg_list[i]->size, 8) * 2;
1061         }
1062
1063 #ifdef _DEBUG_GDB_IO_
1064         {
1065                 char *reg_packet_p;
1066                 reg_packet_p = strndup(reg_packet, DIV_ROUND_UP(reg_packet_size, 8) * 2);
1067                 LOG_DEBUG("reg_packet: %s", reg_packet_p);
1068                 free(reg_packet_p);
1069         }
1070 #endif
1071
1072         gdb_put_packet(connection, reg_packet, DIV_ROUND_UP(reg_packet_size, 8) * 2);
1073         free(reg_packet);
1074
1075         free(reg_list);
1076
1077         return ERROR_OK;
1078 }
1079
1080 static int gdb_set_registers_packet(struct connection *connection,
1081                 struct target *target, char *packet, int packet_size)
1082 {
1083         int i;
1084         struct reg **reg_list;
1085         int reg_list_size;
1086         int retval;
1087         char *packet_p;
1088
1089 #ifdef _DEBUG_GDB_IO_
1090         LOG_DEBUG("-");
1091 #endif
1092
1093         /* skip command character */
1094         packet++;
1095         packet_size--;
1096
1097         if (packet_size % 2)
1098         {
1099                 LOG_WARNING("GDB set_registers packet with uneven characters received, dropping connection");
1100                 return ERROR_SERVER_REMOTE_CLOSED;
1101         }
1102
1103         if ((retval = target_get_gdb_reg_list(target, &reg_list, &reg_list_size)) != ERROR_OK)
1104         {
1105                 return gdb_error(connection, retval);
1106         }
1107
1108         packet_p = packet;
1109         for (i = 0; i < reg_list_size; i++)
1110         {
1111                 uint8_t *bin_buf;
1112                 int chars = (DIV_ROUND_UP(reg_list[i]->size, 8) * 2);
1113
1114                 if (packet_p + chars > packet + packet_size)
1115                 {
1116                         LOG_ERROR("BUG: register packet is too small for registers");
1117                 }
1118
1119                 bin_buf = malloc(DIV_ROUND_UP(reg_list[i]->size, 8));
1120                 gdb_target_to_reg(target, packet_p, chars, bin_buf);
1121
1122                 reg_list[i]->type->set(reg_list[i], bin_buf);
1123
1124                 /* advance packet pointer */
1125                 packet_p += chars;
1126
1127
1128                 free(bin_buf);
1129         }
1130
1131         /* free struct reg *reg_list[] array allocated by get_gdb_reg_list */
1132         free(reg_list);
1133
1134         gdb_put_packet(connection, "OK", 2);
1135
1136         return ERROR_OK;
1137 }
1138
1139 static int gdb_get_register_packet(struct connection *connection,
1140                 struct target *target, char *packet, int packet_size)
1141 {
1142         char *reg_packet;
1143         int reg_num = strtoul(packet + 1, NULL, 16);
1144         struct reg **reg_list;
1145         int reg_list_size;
1146         int retval;
1147
1148 #ifdef _DEBUG_GDB_IO_
1149         LOG_DEBUG("-");
1150 #endif
1151
1152         if ((retval = target_get_gdb_reg_list(target, &reg_list, &reg_list_size)) != ERROR_OK)
1153         {
1154                 return gdb_error(connection, retval);
1155         }
1156
1157         if (reg_list_size <= reg_num)
1158         {
1159                 LOG_ERROR("gdb requested a non-existing register");
1160                 exit(-1);
1161         }
1162
1163         reg_packet = malloc(DIV_ROUND_UP(reg_list[reg_num]->size, 8) * 2);
1164
1165         gdb_str_to_target(target, reg_packet, reg_list[reg_num]);
1166
1167         gdb_put_packet(connection, reg_packet, DIV_ROUND_UP(reg_list[reg_num]->size, 8) * 2);
1168
1169         free(reg_list);
1170         free(reg_packet);
1171
1172         return ERROR_OK;
1173 }
1174
1175 static int gdb_set_register_packet(struct connection *connection,
1176                 struct target *target, char *packet, int packet_size)
1177 {
1178         char *separator;
1179         uint8_t *bin_buf;
1180         int reg_num = strtoul(packet + 1, &separator, 16);
1181         struct reg **reg_list;
1182         int reg_list_size;
1183         int retval;
1184
1185         LOG_DEBUG("-");
1186
1187         if ((retval = target_get_gdb_reg_list(target, &reg_list, &reg_list_size)) != ERROR_OK)
1188         {
1189                 return gdb_error(connection, retval);
1190         }
1191
1192         if (reg_list_size < reg_num)
1193         {
1194                 LOG_ERROR("gdb requested a non-existing register");
1195                 return ERROR_SERVER_REMOTE_CLOSED;
1196         }
1197
1198         if (*separator != '=')
1199         {
1200                 LOG_ERROR("GDB 'set register packet', but no '=' following the register number");
1201                 return ERROR_SERVER_REMOTE_CLOSED;
1202         }
1203
1204         /* convert from GDB-string (target-endian) to hex-string (big-endian) */
1205         bin_buf = malloc(DIV_ROUND_UP(reg_list[reg_num]->size, 8));
1206         int chars = (DIV_ROUND_UP(reg_list[reg_num]->size, 8) * 2);
1207
1208         /* fix!!! add some sanity checks on packet size here */
1209
1210         gdb_target_to_reg(target, separator + 1, chars, bin_buf);
1211
1212         reg_list[reg_num]->type->set(reg_list[reg_num], bin_buf);
1213
1214         gdb_put_packet(connection, "OK", 2);
1215
1216         free(bin_buf);
1217         free(reg_list);
1218
1219         return ERROR_OK;
1220 }
1221
1222 static int gdb_error(struct connection *connection, int retval)
1223 {
1224         switch (retval)
1225         {
1226                 case ERROR_TARGET_DATA_ABORT:
1227                         gdb_send_error(connection, EIO);
1228                         break;
1229                 case ERROR_TARGET_TRANSLATION_FAULT:
1230                         gdb_send_error(connection, EFAULT);
1231                         break;
1232                 case ERROR_TARGET_UNALIGNED_ACCESS:
1233                         gdb_send_error(connection, EFAULT);
1234                         break;
1235                 case ERROR_TARGET_NOT_HALTED:
1236                         gdb_send_error(connection, EFAULT);
1237                         break;
1238                 default:
1239                         /* This could be that the target reset itself. */
1240                         LOG_ERROR("unexpected error %i", retval);
1241                         gdb_send_error(connection, EFAULT);
1242                         break;
1243         }
1244
1245         return ERROR_OK;
1246 }
1247
1248 /* We don't have to worry about the default 2 second timeout for GDB packets,
1249  * because GDB breaks up large memory reads into smaller reads.
1250  *
1251  * 8191 bytes by the looks of it. Why 8191 bytes instead of 8192?????
1252  */
1253 static int gdb_read_memory_packet(struct connection *connection,
1254                 struct target *target, char *packet, int packet_size)
1255 {
1256         char *separator;
1257         uint32_t addr = 0;
1258         uint32_t len = 0;
1259
1260         uint8_t *buffer;
1261         char *hex_buffer;
1262
1263         int retval = ERROR_OK;
1264
1265         /* skip command character */
1266         packet++;
1267
1268         addr = strtoul(packet, &separator, 16);
1269
1270         if (*separator != ',')
1271         {
1272                 LOG_ERROR("incomplete read memory packet received, dropping connection");
1273                 return ERROR_SERVER_REMOTE_CLOSED;
1274         }
1275
1276         len = strtoul(separator + 1, NULL, 16);
1277
1278         buffer = malloc(len);
1279
1280         LOG_DEBUG("addr: 0x%8.8" PRIx32 ", len: 0x%8.8" PRIx32 "", addr, len);
1281
1282         retval = target_read_buffer(target, addr, len, buffer);
1283
1284         if ((retval != ERROR_OK)&&!gdb_report_data_abort)
1285         {
1286                 /* TODO : Here we have to lie and send back all zero's lest stack traces won't work.
1287                  * At some point this might be fixed in GDB, in which case this code can be removed.
1288                  *
1289                  * OpenOCD developers are acutely aware of this problem, but there is nothing
1290                  * gained by involving the user in this problem that hopefully will get resolved
1291                  * eventually
1292                  *
1293                  * http://sourceware.org/cgi-bin/gnatsweb.pl?cmd = view%20audit-trail&database = gdb&pr = 2395
1294                  *
1295                  * For now, the default is to fix up things to make current GDB versions work.
1296                  * This can be overwritten using the gdb_report_data_abort <'enable'|'disable'> command.
1297                  */
1298                 memset(buffer, 0, len);
1299                 retval = ERROR_OK;
1300         }
1301
1302         if (retval == ERROR_OK)
1303         {
1304                 hex_buffer = malloc(len * 2 + 1);
1305
1306                 uint32_t i;
1307                 for (i = 0; i < len; i++)
1308                 {
1309                         uint8_t t = buffer[i];
1310                         hex_buffer[2 * i] = DIGITS[(t >> 4) & 0xf];
1311                         hex_buffer[2 * i + 1] = DIGITS[t & 0xf];
1312                 }
1313
1314                 gdb_put_packet(connection, hex_buffer, len * 2);
1315
1316                 free(hex_buffer);
1317         }
1318         else
1319         {
1320                 retval = gdb_error(connection, retval);
1321         }
1322
1323         free(buffer);
1324
1325         return retval;
1326 }
1327
1328 static int gdb_write_memory_packet(struct connection *connection,
1329                 struct target *target, char *packet, int packet_size)
1330 {
1331         char *separator;
1332         uint32_t addr = 0;
1333         uint32_t len = 0;
1334
1335         uint8_t *buffer;
1336
1337         uint32_t i;
1338         int retval;
1339
1340         /* skip command character */
1341         packet++;
1342
1343         addr = strtoul(packet, &separator, 16);
1344
1345         if (*separator != ',')
1346         {
1347                 LOG_ERROR("incomplete write memory packet received, dropping connection");
1348                 return ERROR_SERVER_REMOTE_CLOSED;
1349         }
1350
1351         len = strtoul(separator + 1, &separator, 16);
1352
1353         if (*(separator++) != ':')
1354         {
1355                 LOG_ERROR("incomplete write memory packet received, dropping connection");
1356                 return ERROR_SERVER_REMOTE_CLOSED;
1357         }
1358
1359         buffer = malloc(len);
1360
1361         LOG_DEBUG("addr: 0x%8.8" PRIx32 ", len: 0x%8.8" PRIx32 "", addr, len);
1362
1363         for (i = 0; i < len; i++)
1364         {
1365                 uint32_t tmp;
1366                 sscanf(separator + 2*i, "%2" SCNx32 , &tmp);
1367                 buffer[i] = tmp;
1368         }
1369
1370         retval = target_write_buffer(target, addr, len, buffer);
1371
1372         if (retval == ERROR_OK)
1373         {
1374                 gdb_put_packet(connection, "OK", 2);
1375         }
1376         else
1377         {
1378                 retval = gdb_error(connection, retval);
1379         }
1380
1381         free(buffer);
1382
1383         return retval;
1384 }
1385
1386 static int gdb_write_memory_binary_packet(struct connection *connection,
1387                 struct target *target, char *packet, int packet_size)
1388 {
1389         char *separator;
1390         uint32_t addr = 0;
1391         uint32_t len = 0;
1392
1393         int retval = ERROR_OK;
1394
1395         /* skip command character */
1396         packet++;
1397
1398         addr = strtoul(packet, &separator, 16);
1399
1400         if (*separator != ',')
1401         {
1402                 LOG_ERROR("incomplete write memory binary packet received, dropping connection");
1403                 return ERROR_SERVER_REMOTE_CLOSED;
1404         }
1405
1406         len = strtoul(separator + 1, &separator, 16);
1407
1408         if (*(separator++) != ':')
1409         {
1410                 LOG_ERROR("incomplete write memory binary packet received, dropping connection");
1411                 return ERROR_SERVER_REMOTE_CLOSED;
1412         }
1413
1414         struct gdb_connection *gdb_connection = connection->priv;
1415
1416         if (gdb_connection->mem_write_error)
1417         {
1418                 retval = ERROR_FAIL;
1419                 /* now that we have reported the memory write error, we can clear the condition */
1420                 gdb_connection->mem_write_error = false;
1421         }
1422
1423         /* By replying the packet *immediately* GDB will send us a new packet
1424          * while we write the last one to the target.
1425          */
1426         if (retval == ERROR_OK)
1427         {
1428                 gdb_put_packet(connection, "OK", 2);
1429         }
1430         else
1431         {
1432                 if ((retval = gdb_error(connection, retval)) != ERROR_OK)
1433                         return retval;
1434         }
1435
1436         if (len)
1437         {
1438                 LOG_DEBUG("addr: 0x%8.8" PRIx32 ", len: 0x%8.8" PRIx32 "", addr, len);
1439
1440                 retval = target_write_buffer(target, addr, len, (uint8_t*)separator);
1441                 if (retval != ERROR_OK)
1442                 {
1443                         gdb_connection->mem_write_error = true;
1444                 }
1445         }
1446
1447         return ERROR_OK;
1448 }
1449
1450 static int gdb_step_continue_packet(struct connection *connection,
1451                 struct target *target, char *packet, int packet_size)
1452 {
1453         int current = 0;
1454         uint32_t address = 0x0;
1455         int retval = ERROR_OK;
1456
1457         LOG_DEBUG("-");
1458
1459         if (packet_size > 1)
1460         {
1461                 packet[packet_size] = 0;
1462                 address = strtoul(packet + 1, NULL, 16);
1463         }
1464         else
1465         {
1466                 current = 1;
1467         }
1468
1469         if (packet[0] == 'c')
1470         {
1471                 LOG_DEBUG("continue");
1472                 target_handle_event(target, TARGET_EVENT_OLD_pre_resume);
1473                 retval = target_resume(target, current, address, 0, 0); /* resume at current address, don't handle breakpoints, not debugging */
1474         }
1475         else if (packet[0] == 's')
1476         {
1477                 LOG_DEBUG("step");
1478                 /* step at current or address, don't handle breakpoints */
1479                 retval = target_step(target, current, address, 0);
1480         }
1481         return retval;
1482 }
1483
1484 static int gdb_breakpoint_watchpoint_packet(struct connection *connection,
1485                 struct target *target, char *packet, int packet_size)
1486 {
1487         int type;
1488         enum breakpoint_type bp_type = BKPT_SOFT /* dummy init to avoid warning */;
1489         enum watchpoint_rw wp_type = WPT_READ /* dummy init to avoid warning */;
1490         uint32_t address;
1491         uint32_t size;
1492         char *separator;
1493         int retval;
1494
1495         LOG_DEBUG("-");
1496
1497         type = strtoul(packet + 1, &separator, 16);
1498
1499         if (type == 0)  /* memory breakpoint */
1500                 bp_type = BKPT_SOFT;
1501         else if (type == 1) /* hardware breakpoint */
1502                 bp_type = BKPT_HARD;
1503         else if (type == 2) /* write watchpoint */
1504                 wp_type = WPT_WRITE;
1505         else if (type == 3) /* read watchpoint */
1506                 wp_type = WPT_READ;
1507         else if (type == 4) /* access watchpoint */
1508                 wp_type = WPT_ACCESS;
1509         else
1510         {
1511                 LOG_ERROR("invalid gdb watch/breakpoint type(%d), dropping connection", type);
1512                 return ERROR_SERVER_REMOTE_CLOSED;
1513         }
1514
1515
1516         if (gdb_breakpoint_override && ((bp_type == BKPT_SOFT)||(bp_type == BKPT_HARD)))
1517         {
1518                 bp_type = gdb_breakpoint_override_type;
1519         }
1520
1521         if (*separator != ',')
1522         {
1523                 LOG_ERROR("incomplete breakpoint/watchpoint packet received, dropping connection");
1524                 return ERROR_SERVER_REMOTE_CLOSED;
1525         }
1526
1527         address = strtoul(separator + 1, &separator, 16);
1528
1529         if (*separator != ',')
1530         {
1531                 LOG_ERROR("incomplete breakpoint/watchpoint packet received, dropping connection");
1532                 return ERROR_SERVER_REMOTE_CLOSED;
1533         }
1534
1535         size = strtoul(separator + 1, &separator, 16);
1536
1537         switch (type)
1538         {
1539                 case 0:
1540                 case 1:
1541                         if (packet[0] == 'Z')
1542                         {
1543                                 if ((retval = breakpoint_add(target, address, size, bp_type)) != ERROR_OK)
1544                                 {
1545                                         if ((retval = gdb_error(connection, retval)) != ERROR_OK)
1546                                                 return retval;
1547                                 }
1548                                 else
1549                                 {
1550                                         gdb_put_packet(connection, "OK", 2);
1551                                 }
1552                         }
1553                         else
1554                         {
1555                                 breakpoint_remove(target, address);
1556                                 gdb_put_packet(connection, "OK", 2);
1557                         }
1558                         break;
1559                 case 2:
1560                 case 3:
1561                 case 4:
1562                 {
1563                         if (packet[0] == 'Z')
1564                         {
1565                                 if ((retval = watchpoint_add(target, address, size, wp_type, 0, 0xffffffffu)) != ERROR_OK)
1566                                 {
1567                                         if ((retval = gdb_error(connection, retval)) != ERROR_OK)
1568                                                 return retval;
1569                                 }
1570                                 else
1571                                 {
1572                                         gdb_put_packet(connection, "OK", 2);
1573                                 }
1574                         }
1575                         else
1576                         {
1577                                 watchpoint_remove(target, address);
1578                                 gdb_put_packet(connection, "OK", 2);
1579                         }
1580                         break;
1581                 }
1582                 default:
1583                         break;
1584         }
1585
1586         return ERROR_OK;
1587 }
1588
1589 /* print out a string and allocate more space as needed,
1590  * mainly used for XML at this point
1591  */
1592 static void xml_printf(int *retval, char **xml, int *pos, int *size,
1593                 const char *fmt, ...)
1594 {
1595         if (*retval != ERROR_OK)
1596         {
1597                 return;
1598         }
1599         int first = 1;
1600
1601         for (;;)
1602         {
1603                 if ((*xml == NULL) || (!first))
1604                 {
1605                         /* start by 0 to exercise all the code paths.
1606                          * Need minimum 2 bytes to fit 1 char and 0 terminator. */
1607
1608                         *size = *size * 2 + 2;
1609                         char *t = *xml;
1610                         *xml = realloc(*xml, *size);
1611                         if (*xml == NULL)
1612                         {
1613                                 if (t)
1614                                         free(t);
1615                                 *retval = ERROR_SERVER_REMOTE_CLOSED;
1616                                 return;
1617                         }
1618                 }
1619
1620                 va_list ap;
1621                 int ret;
1622                 va_start(ap, fmt);
1623                 ret = vsnprintf(*xml + *pos, *size - *pos, fmt, ap);
1624                 va_end(ap);
1625                 if ((ret > 0) && ((ret + 1) < *size - *pos))
1626                 {
1627                         *pos += ret;
1628                         return;
1629                 }
1630                 /* there was just enough or not enough space, allocate more. */
1631                 first = 0;
1632         }
1633 }
1634
1635 static int decode_xfer_read(char *buf, char **annex, int *ofs, unsigned int *len)
1636 {
1637         char *separator;
1638
1639         /* Extract and NUL-terminate the annex. */
1640         *annex = buf;
1641         while (*buf && *buf != ':')
1642                 buf++;
1643         if (*buf == '\0')
1644                 return -1;
1645         *buf++ = 0;
1646
1647         /* After the read marker and annex, qXfer looks like a
1648          * traditional 'm' packet. */
1649
1650         *ofs = strtoul(buf, &separator, 16);
1651
1652         if (*separator != ',')
1653                 return -1;
1654
1655         *len = strtoul(separator + 1, NULL, 16);
1656
1657         return 0;
1658 }
1659
1660 static int compare_bank (const void * a, const void * b)
1661 {
1662         struct flash_bank *b1, *b2;
1663         b1=*((struct flash_bank **)a);
1664         b2=*((struct flash_bank **)b);
1665
1666         if (b1->base == b2->base)
1667         {
1668                 return 0;
1669         } else if (b1->base > b2->base)
1670         {
1671                 return 1;
1672         } else
1673         {
1674                 return -1;
1675         }
1676 }
1677
1678 static int gdb_memory_map(struct connection *connection,
1679                 struct target *target, char *packet, int packet_size)
1680 {
1681         /* We get away with only specifying flash here. Regions that are not
1682          * specified are treated as if we provided no memory map(if not we
1683          * could detect the holes and mark them as RAM).
1684          * Normally we only execute this code once, but no big deal if we
1685          * have to regenerate it a couple of times.
1686          */
1687
1688         struct flash_bank *p;
1689         char *xml = NULL;
1690         int size = 0;
1691         int pos = 0;
1692         int retval = ERROR_OK;
1693         struct flash_bank **banks;
1694         int offset;
1695         int length;
1696         char *separator;
1697         uint32_t ram_start = 0;
1698         int i;
1699
1700         /* skip command character */
1701         packet += 23;
1702
1703         offset = strtoul(packet, &separator, 16);
1704         length = strtoul(separator + 1, &separator, 16);
1705
1706         xml_printf(&retval, &xml, &pos, &size, "<memory-map>\n");
1707
1708         /* Sort banks in ascending order.  We need to report non-flash
1709          * memory as ram (or rather read/write) by default for GDB, since
1710          * it has no concept of non-cacheable read/write memory (i/o etc).
1711          *
1712          * FIXME Most non-flash addresses are *NOT* RAM!  Don't lie.
1713          * Current versions of GDB assume unlisted addresses are RAM...
1714          */
1715         banks = malloc(sizeof(struct flash_bank *)*flash_get_bank_count());
1716
1717         for (i = 0; i < flash_get_bank_count(); i++) {
1718                 retval = get_flash_bank_by_num(i, &p);
1719                 if (retval != ERROR_OK)
1720                 {
1721                         free(banks);
1722                         gdb_send_error(connection, retval);
1723                         return retval;
1724                 }
1725                 banks[i] = p;
1726         }
1727
1728         qsort(banks, flash_get_bank_count(), sizeof(struct flash_bank *),
1729                         compare_bank);
1730
1731         for (i = 0; i < flash_get_bank_count(); i++) {
1732                 int j;
1733                 unsigned sector_size = 0;
1734                 uint32_t start, end;
1735
1736                 p = banks[i];
1737                 start = p->base;
1738                 end = p->base + p->size;
1739
1740                 if (ram_start < p->base)
1741                         xml_printf(&retval, &xml, &pos, &size,
1742                                 "<memory type=\"ram\" start=\"0x%x\" "
1743                                         "length=\"0x%x\"/>\n",
1744                                 ram_start, p->base - ram_start);
1745
1746                 /* Report adjacent groups of same-size sectors.  So for
1747                  * example top boot CFI flash will list an initial region
1748                  * with several large sectors (maybe 128KB) and several
1749                  * smaller ones at the end (maybe 32KB).  STR7 will have
1750                  * regions with 8KB, 32KB, and 64KB sectors; etc.
1751                  */
1752                 for (j = 0; j < p->num_sectors; j++) {
1753                         unsigned group_len;
1754
1755                         /* Maybe start a new group of sectors. */
1756                         if (sector_size == 0) {
1757                                 start = p->base + p->sectors[j].offset;
1758                                 xml_printf(&retval, &xml, &pos, &size,
1759                                         "<memory type=\"flash\" "
1760                                                 "start=\"0x%x\" ",
1761                                         start);
1762                                 sector_size = p->sectors[j].size;
1763                         }
1764
1765                         /* Does this finish a group of sectors?
1766                          * If not, continue an already-started group.
1767                          */
1768                         if (j == p->num_sectors -1)
1769                                 group_len = (p->base + p->size) - start;
1770                         else if (p->sectors[j + 1].size != sector_size)
1771                                 group_len = p->base + p->sectors[j + 1].offset
1772                                                 - start;
1773                         else
1774                                 continue;
1775
1776                         xml_printf(&retval, &xml, &pos, &size,
1777                                 "length=\"0x%x\">\n"
1778                                 "<property name=\"blocksize\">"
1779                                         "0x%x</property>\n"
1780                                 "</memory>\n",
1781                                 group_len,
1782                                 sector_size);
1783                         sector_size = 0;
1784                 }
1785
1786                 ram_start = p->base + p->size;
1787         }
1788
1789         if (ram_start != 0)
1790                 xml_printf(&retval, &xml, &pos, &size,
1791                         "<memory type=\"ram\" start=\"0x%x\" "
1792                                 "length=\"0x%x\"/>\n",
1793                         ram_start, 0-ram_start);
1794         /* ELSE a flash chip could be at the very end of the 32 bit address
1795          * space, in which case ram_start will be precisely 0
1796          */
1797
1798         free(banks);
1799         banks = NULL;
1800
1801         xml_printf(&retval, &xml, &pos, &size, "</memory-map>\n");
1802
1803         if (retval != ERROR_OK) {
1804                 gdb_send_error(connection, retval);
1805                 return retval;
1806         }
1807
1808         if (offset + length > pos)
1809                 length = pos - offset;
1810
1811         char *t = malloc(length + 1);
1812         t[0] = 'l';
1813         memcpy(t + 1, xml + offset, length);
1814         gdb_put_packet(connection, t, length + 1);
1815
1816         free(t);
1817         free(xml);
1818         return ERROR_OK;
1819 }
1820
1821 static int gdb_query_packet(struct connection *connection,
1822         struct target *target, char *packet, int packet_size)
1823 {
1824         struct command_context *cmd_ctx = connection->cmd_ctx;
1825         struct gdb_connection *gdb_connection = connection->priv;
1826
1827         if (strstr(packet, "qRcmd,"))
1828         {
1829                 if (packet_size > 6)
1830                 {
1831                         char *cmd;
1832                         int i;
1833                         cmd = malloc((packet_size - 6)/2 + 1);
1834                         for (i = 0; i < (packet_size - 6)/2; i++)
1835                         {
1836                                 uint32_t tmp;
1837                                 sscanf(packet + 6 + 2*i, "%2" SCNx32 , &tmp);
1838                                 cmd[i] = tmp;
1839                         }
1840                         cmd[(packet_size - 6)/2] = 0x0;
1841
1842                         /* We want to print all debug output to GDB connection */
1843                         log_add_callback(gdb_log_callback, connection);
1844                         target_call_timer_callbacks_now();
1845                         /* some commands need to know the GDB connection, make note of current
1846                          * GDB connection. */
1847                         current_gdb_connection = gdb_connection;
1848                         command_run_line(cmd_ctx, cmd);
1849                         current_gdb_connection = NULL;
1850                         target_call_timer_callbacks_now();
1851                         log_remove_callback(gdb_log_callback, connection);
1852                         free(cmd);
1853                 }
1854                 gdb_put_packet(connection, "OK", 2);
1855                 return ERROR_OK;
1856         }
1857         else if (strstr(packet, "qCRC:"))
1858         {
1859                 if (packet_size > 5)
1860                 {
1861                         int retval;
1862                         char gdb_reply[10];
1863                         char *separator;
1864                         uint32_t checksum;
1865                         uint32_t addr = 0;
1866                         uint32_t len = 0;
1867
1868                         /* skip command character */
1869                         packet += 5;
1870
1871                         addr = strtoul(packet, &separator, 16);
1872
1873                         if (*separator != ',')
1874                         {
1875                                 LOG_ERROR("incomplete read memory packet received, dropping connection");
1876                                 return ERROR_SERVER_REMOTE_CLOSED;
1877                         }
1878
1879                         len = strtoul(separator + 1, NULL, 16);
1880
1881                         retval = target_checksum_memory(target, addr, len, &checksum);
1882
1883                         if (retval == ERROR_OK)
1884                         {
1885                                 snprintf(gdb_reply, 10, "C%8.8" PRIx32 "", checksum);
1886                                 gdb_put_packet(connection, gdb_reply, 9);
1887                         }
1888                         else
1889                         {
1890                                 if ((retval = gdb_error(connection, retval)) != ERROR_OK)
1891                                         return retval;
1892                         }
1893
1894                         return ERROR_OK;
1895                 }
1896         }
1897         else if (strstr(packet, "qSupported"))
1898         {
1899                 /* we currently support packet size and qXfer:memory-map:read (if enabled)
1900                  * disable qXfer:features:read for the moment */
1901                 int retval = ERROR_OK;
1902                 char *buffer = NULL;
1903                 int pos = 0;
1904                 int size = 0;
1905
1906                 xml_printf(&retval, &buffer, &pos, &size,
1907                                 "PacketSize=%x;qXfer:memory-map:read%c;qXfer:features:read-;QStartNoAckMode+",
1908                                 (GDB_BUFFER_SIZE - 1), ((gdb_use_memory_map == 1) && (flash_get_bank_count() > 0)) ? '+' : '-');
1909
1910                 if (retval != ERROR_OK)
1911                 {
1912                         gdb_send_error(connection, 01);
1913                         return ERROR_OK;
1914                 }
1915
1916                 gdb_put_packet(connection, buffer, strlen(buffer));
1917                 free(buffer);
1918
1919                 return ERROR_OK;
1920         }
1921         else if (strstr(packet, "qXfer:memory-map:read::")
1922                         && (flash_get_bank_count() > 0))
1923                 return gdb_memory_map(connection, target, packet, packet_size);
1924         else if (strstr(packet, "qXfer:features:read:"))
1925         {
1926                 char *xml = NULL;
1927                 int size = 0;
1928                 int pos = 0;
1929                 int retval = ERROR_OK;
1930
1931                 int offset;
1932                 unsigned int length;
1933                 char *annex;
1934
1935                 /* skip command character */
1936                 packet += 20;
1937
1938                 if (decode_xfer_read(packet, &annex, &offset, &length) < 0)
1939                 {
1940                         gdb_send_error(connection, 01);
1941                         return ERROR_OK;
1942                 }
1943
1944                 if (strcmp(annex, "target.xml") != 0)
1945                 {
1946                         gdb_send_error(connection, 01);
1947                         return ERROR_OK;
1948                 }
1949
1950                 xml_printf(&retval, &xml, &pos, &size, \
1951                         "l < target version=\"1.0\">\n < architecture > arm</architecture>\n</target>\n");
1952
1953                 if (retval != ERROR_OK)
1954                 {
1955                         gdb_send_error(connection, retval);
1956                         return retval;
1957                 }
1958
1959                 gdb_put_packet(connection, xml, strlen(xml));
1960
1961                 free(xml);
1962                 return ERROR_OK;
1963         }
1964         else if (strstr(packet, "QStartNoAckMode"))
1965         {
1966                 gdb_connection->noack_mode = 1;
1967                 gdb_put_packet(connection, "OK", 2);
1968                 return ERROR_OK;
1969         }
1970
1971         gdb_put_packet(connection, "", 0);
1972         return ERROR_OK;
1973 }
1974
1975 static int gdb_v_packet(struct connection *connection,
1976                 struct target *target, char *packet, int packet_size)
1977 {
1978         struct gdb_connection *gdb_connection = connection->priv;
1979         struct gdb_service *gdb_service = connection->service->priv;
1980         int result;
1981
1982         /* if flash programming disabled - send a empty reply */
1983
1984         if (gdb_flash_program == 0)
1985         {
1986                 gdb_put_packet(connection, "", 0);
1987                 return ERROR_OK;
1988         }
1989
1990         if (strstr(packet, "vFlashErase:"))
1991         {
1992                 unsigned long addr;
1993                 unsigned long length;
1994
1995                 char *parse = packet + 12;
1996                 if (*parse == '\0')
1997                 {
1998                         LOG_ERROR("incomplete vFlashErase packet received, dropping connection");
1999                         return ERROR_SERVER_REMOTE_CLOSED;
2000                 }
2001
2002                 addr = strtoul(parse, &parse, 16);
2003
2004                 if (*(parse++) != ',' || *parse == '\0')
2005                 {
2006                         LOG_ERROR("incomplete vFlashErase packet received, dropping connection");
2007                         return ERROR_SERVER_REMOTE_CLOSED;
2008                 }
2009
2010                 length = strtoul(parse, &parse, 16);
2011
2012                 if (*parse != '\0')
2013                 {
2014                         LOG_ERROR("incomplete vFlashErase packet received, dropping connection");
2015                         return ERROR_SERVER_REMOTE_CLOSED;
2016                 }
2017
2018                 /* assume all sectors need erasing - stops any problems
2019                  * when flash_write is called multiple times */
2020                 flash_set_dirty();
2021
2022                 /* perform any target specific operations before the erase */
2023                 target_call_event_callbacks(gdb_service->target,
2024                                 TARGET_EVENT_GDB_FLASH_ERASE_START);
2025
2026                 /* vFlashErase:addr,length messages require region start and
2027                  * end to be "block" aligned ... if padding is ever needed,
2028                  * GDB will have become dangerously confused.
2029                  */
2030                 result = flash_erase_address_range(gdb_service->target,
2031                                 false, addr, length);
2032
2033                 /* perform any target specific operations after the erase */
2034                 target_call_event_callbacks(gdb_service->target,
2035                                 TARGET_EVENT_GDB_FLASH_ERASE_END);
2036
2037                 /* perform erase */
2038                 if (result != ERROR_OK)
2039                 {
2040                         /* GDB doesn't evaluate the actual error number returned,
2041                          * treat a failed erase as an I/O error
2042                          */
2043                         gdb_send_error(connection, EIO);
2044                         LOG_ERROR("flash_erase returned %i", result);
2045                 }
2046                 else
2047                         gdb_put_packet(connection, "OK", 2);
2048
2049                 return ERROR_OK;
2050         }
2051
2052         if (strstr(packet, "vFlashWrite:"))
2053         {
2054                 int retval;
2055                 unsigned long addr;
2056                 unsigned long length;
2057                 char *parse = packet + 12;
2058
2059                 if (*parse == '\0')
2060                 {
2061                         LOG_ERROR("incomplete vFlashErase packet received, dropping connection");
2062                         return ERROR_SERVER_REMOTE_CLOSED;
2063                 }
2064                 addr = strtoul(parse, &parse, 16);
2065                 if (*(parse++) != ':')
2066                 {
2067                         LOG_ERROR("incomplete vFlashErase packet received, dropping connection");
2068                         return ERROR_SERVER_REMOTE_CLOSED;
2069                 }
2070                 length = packet_size - (parse - packet);
2071
2072                 /* create a new image if there isn't already one */
2073                 if (gdb_connection->vflash_image == NULL)
2074                 {
2075                         gdb_connection->vflash_image = malloc(sizeof(struct image));
2076                         image_open(gdb_connection->vflash_image, "", "build");
2077                 }
2078
2079                 /* create new section with content from packet buffer */
2080                 if ((retval = image_add_section(gdb_connection->vflash_image, addr, length, 0x0, (uint8_t*)parse)) != ERROR_OK)
2081                 {
2082                         return retval;
2083                 }
2084
2085                 gdb_put_packet(connection, "OK", 2);
2086
2087                 return ERROR_OK;
2088         }
2089
2090         if (!strcmp(packet, "vFlashDone"))
2091         {
2092                 uint32_t written;
2093
2094                 /* process the flashing buffer. No need to erase as GDB
2095                  * always issues a vFlashErase first. */
2096                 target_call_event_callbacks(gdb_service->target, TARGET_EVENT_GDB_FLASH_WRITE_START);
2097                 result = flash_write(gdb_service->target, gdb_connection->vflash_image, &written, 0);
2098                 target_call_event_callbacks(gdb_service->target, TARGET_EVENT_GDB_FLASH_WRITE_END);
2099                 if (result != ERROR_OK)
2100                 {
2101                         if (result == ERROR_FLASH_DST_OUT_OF_BANK)
2102                                 gdb_put_packet(connection, "E.memtype", 9);
2103                         else
2104                                 gdb_send_error(connection, EIO);
2105                         }
2106                 else
2107                 {
2108                         LOG_DEBUG("wrote %u bytes from vFlash image to flash", (unsigned)written);
2109                         gdb_put_packet(connection, "OK", 2);
2110                 }
2111
2112                 image_close(gdb_connection->vflash_image);
2113                 free(gdb_connection->vflash_image);
2114                 gdb_connection->vflash_image = NULL;
2115
2116                 return ERROR_OK;
2117         }
2118
2119         gdb_put_packet(connection, "", 0);
2120         return ERROR_OK;
2121 }
2122
2123 static int gdb_detach(struct connection *connection, struct target *target)
2124 {
2125         struct gdb_service *gdb_service = connection->service->priv;
2126
2127         target_call_event_callbacks(gdb_service->target,
2128                         TARGET_EVENT_GDB_DETACH);
2129
2130         return gdb_put_packet(connection, "OK", 2);
2131 }
2132
2133 static void gdb_log_callback(void *priv, const char *file, unsigned line,
2134                 const char *function, const char *string)
2135 {
2136         struct connection *connection = priv;
2137         struct gdb_connection *gdb_con = connection->priv;
2138
2139         if (gdb_con->busy)
2140         {
2141                 /* do not reply this using the O packet */
2142                 return;
2143         }
2144
2145         gdb_output_con(connection, string);
2146 }
2147
2148 static void gdb_sig_halted(struct connection *connection)
2149 {
2150         char sig_reply[4];
2151         snprintf(sig_reply, 4, "T%2.2x", 2);
2152         gdb_put_packet(connection, sig_reply, 3);
2153
2154 }
2155
2156 static int gdb_input_inner(struct connection *connection)
2157 {
2158         /* Do not allocate this on the stack */
2159         static char gdb_packet_buffer[GDB_BUFFER_SIZE];
2160
2161         struct gdb_service *gdb_service = connection->service->priv;
2162         struct target *target = gdb_service->target;
2163         char *packet = gdb_packet_buffer;
2164         int packet_size;
2165         int retval;
2166         struct gdb_connection *gdb_con = connection->priv;
2167         static int extended_protocol = 0;
2168
2169         /* drain input buffer */
2170         do
2171         {
2172                 packet_size = GDB_BUFFER_SIZE-1;
2173                 retval = gdb_get_packet(connection, packet, &packet_size);
2174                 if (retval != ERROR_OK)
2175                         return retval;
2176
2177                 /* terminate with zero */
2178                 packet[packet_size] = 0;
2179
2180                 if (LOG_LEVEL_IS(LOG_LVL_DEBUG)) {
2181                         if (packet[0] == 'X') {
2182                                 // binary packets spew junk into the debug log stream
2183                                 char buf[ 50 ];
2184                                 int x;
2185                                 for (x = 0 ; (x < 49) && (packet[x] != ':') ; x++) {
2186                                         buf[x] = packet[x];
2187                                 }
2188                                 buf[x] = 0;
2189                                 LOG_DEBUG("received packet: '%s:<binary-data>'", buf);
2190                         } else {
2191                                 LOG_DEBUG("received packet: '%s'", packet);
2192                         }
2193                 }
2194
2195                 if (packet_size > 0)
2196                 {
2197                         retval = ERROR_OK;
2198                         switch (packet[0])
2199                         {
2200                                 case 'H':
2201                                         /* Hct... -- set thread
2202                                          * we don't have threads, send empty reply */
2203                                         gdb_put_packet(connection, NULL, 0);
2204                                         break;
2205                                 case 'q':
2206                                 case 'Q':
2207                                         retval = gdb_query_packet(connection,
2208                                                         target, packet,
2209                                                         packet_size);
2210                                         break;
2211                                 case 'g':
2212                                         retval = gdb_get_registers_packet(
2213                                                         connection, target,
2214                                                         packet, packet_size);
2215                                         break;
2216                                 case 'G':
2217                                         retval = gdb_set_registers_packet(
2218                                                         connection, target,
2219                                                         packet, packet_size);
2220                                         break;
2221                                 case 'p':
2222                                         retval = gdb_get_register_packet(
2223                                                         connection, target,
2224                                                         packet, packet_size);
2225                                         break;
2226                                 case 'P':
2227                                         retval = gdb_set_register_packet(
2228                                                         connection, target,
2229                                                         packet, packet_size);
2230                                         break;
2231                                 case 'm':
2232                                         retval = gdb_read_memory_packet(
2233                                                         connection, target,
2234                                                         packet, packet_size);
2235                                         break;
2236                                 case 'M':
2237                                         retval = gdb_write_memory_packet(
2238                                                         connection, target,
2239                                                         packet, packet_size);
2240                                         break;
2241                                 case 'z':
2242                                 case 'Z':
2243                                         retval = gdb_breakpoint_watchpoint_packet(connection, target, packet, packet_size);
2244                                         break;
2245                                 case '?':
2246                                         gdb_last_signal_packet(
2247                                                         connection, target,
2248                                                         packet, packet_size);
2249                                         break;
2250                                 case 'c':
2251                                 case 's':
2252                                         {
2253                                                 int retval = ERROR_OK;
2254
2255                                                 struct gdb_connection *gdb_con = connection->priv;
2256                                                 log_add_callback(gdb_log_callback, connection);
2257
2258                                                 if (gdb_con->mem_write_error)
2259                                                 {
2260                                                         LOG_ERROR("Memory write failure!");
2261
2262                                                         /* now that we have reported the memory write error, we can clear the condition */
2263                                                         gdb_con->mem_write_error = false;
2264                                                 }
2265
2266                                                 bool nostep = false;
2267                                                 bool already_running = false;
2268                                                 if (target->state == TARGET_RUNNING)
2269                                                 {
2270                                                         LOG_WARNING("WARNING! The target is already running. "
2271                                                                         "All changes GDB did to registers will be discarded! "
2272                                                                         "Waiting for target to halt.");
2273                                                         already_running = true;
2274                                                 } else if (target->state != TARGET_HALTED)
2275                                                 {
2276                                                         LOG_WARNING("The target is not in the halted nor running stated, stepi/continue ignored.");
2277                                                         nostep = true;
2278                                                 } else if ((packet[0] == 's') && gdb_con->sync)
2279                                                 {
2280                                                         /* Hmm..... when you issue a continue in GDB, then a "stepi" is
2281                                                          * sent by GDB first to OpenOCD, thus defeating the check to
2282                                                          * make only the single stepping have the sync feature...
2283                                                          */
2284                                                         nostep = true;
2285                                                         LOG_WARNING("stepi ignored. GDB will now fetch the register state from the target.");
2286                                                 }
2287                                                 gdb_con->sync = false;
2288
2289                                                 if ((retval!=ERROR_OK) || (!already_running && nostep))
2290                                                 {
2291                                                         /* Either the target isn't in the halted state, then we can't
2292                                                          * step/continue. This might be early setup, etc.
2293                                                          *
2294                                                          * Or we want to allow GDB to pick up a fresh set of
2295                                                          * register values without modifying the target state.
2296                                                          *
2297                                                          */
2298                                                         gdb_sig_halted(connection);
2299
2300                                                         /* stop forwarding log packets! */
2301                                                         log_remove_callback(gdb_log_callback, connection);
2302                                                 } else
2303                                                 {
2304                                                         /* We're running/stepping, in which case we can
2305                                                          * forward log output until the target is halted
2306                                                          */
2307                                                         gdb_con->frontend_state = TARGET_RUNNING;
2308                                                         target_call_event_callbacks(target, TARGET_EVENT_GDB_START);
2309
2310                                                         if (!already_running)
2311                                                         {
2312                                                                 int retval = gdb_step_continue_packet(connection, target, packet, packet_size);
2313                                                                 if (retval != ERROR_OK)
2314                                                                 {
2315                                                                         /* we'll never receive a halted condition... issue a false one.. */
2316                                                                         gdb_frontend_halted(target, connection);
2317                                                                 }
2318                                                         }
2319                                                 }
2320                                         }
2321                                         break;
2322                                 case 'v':
2323                                         retval = gdb_v_packet(
2324                                                         connection, target,
2325                                                         packet, packet_size);
2326                                         break;
2327                                 case 'D':
2328                                         retval = gdb_detach(connection, target);
2329                                         extended_protocol = 0;
2330                                         break;
2331                                 case 'X':
2332                                         retval = gdb_write_memory_binary_packet(
2333                                                         connection, target,
2334                                                         packet, packet_size);
2335                                         if (retval != ERROR_OK)
2336                                                 return retval;
2337                                         break;
2338                                 case 'k':
2339                                         if (extended_protocol != 0)
2340                                                 break;
2341                                         gdb_put_packet(connection, "OK", 2);
2342                                         return ERROR_SERVER_REMOTE_CLOSED;
2343                                 case '!':
2344                                         /* handle extended remote protocol */
2345                                         extended_protocol = 1;
2346                                         gdb_put_packet(connection, "OK", 2);
2347                                         break;
2348                                 case 'R':
2349                                         /* handle extended restart packet */
2350                                         breakpoint_clear_target(gdb_service->target);
2351                                         watchpoint_clear_target(gdb_service->target);
2352                                         command_run_linef(connection->cmd_ctx,
2353                                                         "ocd_gdb_restart %s",
2354                                                         target_name(target));
2355                                         break;
2356                                 default:
2357                                         /* ignore unknown packets */
2358                                         LOG_DEBUG("ignoring 0x%2.2x packet", packet[0]);
2359                                         gdb_put_packet(connection, NULL, 0);
2360                                         break;
2361                         }
2362
2363                         /* if a packet handler returned an error, exit input loop */
2364                         if (retval != ERROR_OK)
2365                                 return retval;
2366                 }
2367
2368                 if (gdb_con->ctrl_c)
2369                 {
2370                         if (target->state == TARGET_RUNNING)
2371                         {
2372                                 retval = target_halt(target);
2373                                 if (retval != ERROR_OK)
2374                                 {
2375                                         target_call_event_callbacks(target, TARGET_EVENT_GDB_HALT);
2376                                 }
2377                                 gdb_con->ctrl_c = 0;
2378                         } else
2379                         {
2380                                 LOG_INFO("The target is not running when halt was requested, stopping GDB.");
2381                                 target_call_event_callbacks(target, TARGET_EVENT_GDB_HALT);
2382                         }
2383                 }
2384
2385         } while (gdb_con->buf_cnt > 0);
2386
2387         return ERROR_OK;
2388 }
2389
2390 static int gdb_input(struct connection *connection)
2391 {
2392         int retval = gdb_input_inner(connection);
2393         struct gdb_connection *gdb_con = connection->priv;
2394         if (retval == ERROR_SERVER_REMOTE_CLOSED)
2395                 return retval;
2396
2397         /* logging does not propagate the error, yet can set the gdb_con->closed flag */
2398         if (gdb_con->closed)
2399                 return ERROR_SERVER_REMOTE_CLOSED;
2400
2401         /* we'll recover from any other errors(e.g. temporary timeouts, etc.) */
2402         return ERROR_OK;
2403 }
2404
2405 static int gdb_target_start(struct target *target, uint16_t port)
2406 {
2407         bool use_pipes = 0 == port;
2408         struct gdb_service *gdb_service = malloc(sizeof(struct gdb_service));
2409         if (NULL == gdb_service)
2410                 return -ENOMEM;
2411
2412         gdb_service->target = target;
2413
2414         add_service("gdb", use_pipes ? CONNECTION_PIPE : CONNECTION_TCP,
2415                         port, 1, &gdb_new_connection, &gdb_input,
2416                         &gdb_connection_closed, gdb_service);
2417
2418         const char *name = target_name(target);
2419         if (use_pipes)
2420                 LOG_DEBUG("gdb service for target '%s' using pipes", name);
2421         else
2422                 LOG_DEBUG("gdb service for target '%s' on TCP port %u", name, port);
2423         return ERROR_OK;
2424 }
2425
2426 static int gdb_target_add_one(struct target *target)
2427 {
2428         if (gdb_port == 0 && server_use_pipes == 0)
2429         {
2430                 LOG_INFO("gdb port disabled");
2431                 return ERROR_OK;
2432         }
2433         if (0 == gdb_port_next)
2434                 gdb_port_next = gdb_port;
2435
2436         bool use_pipes = server_use_pipes;
2437         static bool server_started_with_pipes = false;
2438         if (server_started_with_pipes)
2439         {
2440                 LOG_WARNING("gdb service permits one target when using pipes");
2441                 if (0 == gdb_port)
2442                         return ERROR_OK;
2443
2444                 use_pipes = false;
2445         }
2446
2447         int e = gdb_target_start(target, use_pipes ? 0 : gdb_port_next);
2448         if (ERROR_OK == e)
2449         {
2450                 server_started_with_pipes |= use_pipes;
2451                 gdb_port_next++;
2452         }
2453         return e;
2454 }
2455
2456 int gdb_target_add_all(struct target *target)
2457 {
2458         if (NULL == target)
2459         {
2460                 LOG_WARNING("gdb services need one or more targets defined");
2461                 return ERROR_OK;
2462         }
2463
2464         while (NULL != target)
2465         {
2466                 int retval = gdb_target_add_one(target);
2467                 if (ERROR_OK != retval)
2468                         return retval;
2469
2470                 target = target->next;
2471         }
2472
2473         return ERROR_OK;
2474 }
2475
2476 COMMAND_HANDLER(handle_gdb_sync_command)
2477 {
2478         if (CMD_ARGC != 0)
2479         {
2480                 return ERROR_COMMAND_SYNTAX_ERROR;
2481         }
2482
2483         if (current_gdb_connection == NULL)
2484         {
2485                 command_print(CMD_CTX,
2486                                 "gdb_sync command can only be run from within gdb using \"monitor gdb_sync\"");
2487                 return ERROR_FAIL;
2488         }
2489
2490         current_gdb_connection->sync = true;
2491
2492         return ERROR_OK;
2493 }
2494
2495 /* daemon configuration command gdb_port */
2496 COMMAND_HANDLER(handle_gdb_port_command)
2497 {
2498         int retval = CALL_COMMAND_HANDLER(server_port_command, &gdb_port);
2499         if (ERROR_OK == retval)
2500                 gdb_port_next = gdb_port;
2501         return retval;
2502 }
2503
2504 COMMAND_HANDLER(handle_gdb_memory_map_command)
2505 {
2506         if (CMD_ARGC != 1)
2507                 return ERROR_COMMAND_SYNTAX_ERROR;
2508
2509         COMMAND_PARSE_ENABLE(CMD_ARGV[0], gdb_use_memory_map);
2510         return ERROR_OK;
2511 }
2512
2513 COMMAND_HANDLER(handle_gdb_flash_program_command)
2514 {
2515         if (CMD_ARGC != 1)
2516                 return ERROR_COMMAND_SYNTAX_ERROR;
2517
2518         COMMAND_PARSE_ENABLE(CMD_ARGV[0], gdb_flash_program);
2519         return ERROR_OK;
2520 }
2521
2522 COMMAND_HANDLER(handle_gdb_report_data_abort_command)
2523 {
2524         if (CMD_ARGC != 1)
2525                 return ERROR_COMMAND_SYNTAX_ERROR;
2526
2527         COMMAND_PARSE_ENABLE(CMD_ARGV[0], gdb_report_data_abort);
2528         return ERROR_OK;
2529 }
2530
2531 /* gdb_breakpoint_override */
2532 COMMAND_HANDLER(handle_gdb_breakpoint_override_command)
2533 {
2534         if (CMD_ARGC == 0)
2535         {
2536
2537         } else if (CMD_ARGC == 1)
2538         {
2539                 gdb_breakpoint_override = 1;
2540                 if (strcmp(CMD_ARGV[0], "hard") == 0)
2541                 {
2542                         gdb_breakpoint_override_type = BKPT_HARD;
2543                 } else if (strcmp(CMD_ARGV[0], "soft") == 0)
2544                 {
2545                         gdb_breakpoint_override_type = BKPT_SOFT;
2546                 } else if (strcmp(CMD_ARGV[0], "disable") == 0)
2547                 {
2548                         gdb_breakpoint_override = 0;
2549                 }
2550         } else
2551         {
2552                 return ERROR_COMMAND_SYNTAX_ERROR;
2553         }
2554         if (gdb_breakpoint_override)
2555         {
2556                 LOG_USER("force %s breakpoints", (gdb_breakpoint_override_type == BKPT_HARD)?"hard":"soft");
2557         } else
2558         {
2559                 LOG_USER("breakpoint type is not overridden");
2560         }
2561
2562         return ERROR_OK;
2563 }
2564
2565 static const struct command_registration gdb_command_handlers[] = {
2566         {
2567                 .name = "gdb_sync",
2568                 .handler = handle_gdb_sync_command,
2569                 .mode = COMMAND_ANY,
2570                 .help = "next stepi will return immediately allowing "
2571                         "GDB to fetch register state without affecting "
2572                         "target state",
2573         },
2574         {
2575                 .name = "gdb_port",
2576                 .handler = handle_gdb_port_command,
2577                 .mode = COMMAND_ANY,
2578                 .help = "Display or specify base port on which to listen "
2579                         "for incoming GDB connections.  "
2580                         "No arguments reports GDB port; zero disables.",
2581                 .usage = "[port_num]",
2582         },
2583         {
2584                 .name = "gdb_memory_map",
2585                 .handler = handle_gdb_memory_map_command,
2586                 .mode = COMMAND_CONFIG,
2587                 .help = "enable or disable memory map",
2588                 .usage = "('enable'|'disable')"
2589         },
2590         {
2591                 .name = "gdb_flash_program",
2592                 .handler = handle_gdb_flash_program_command,
2593                 .mode = COMMAND_CONFIG,
2594                 .help = "enable or disable flash program",
2595                 .usage = "('enable'|'disable')"
2596         },
2597         {
2598                 .name = "gdb_report_data_abort",
2599                 .handler = handle_gdb_report_data_abort_command,
2600                 .mode = COMMAND_CONFIG,
2601                 .help = "enable or disable reporting data aborts",
2602                 .usage = "('enable'|'disable')"
2603         },
2604         {
2605                 .name = "gdb_breakpoint_override",
2606                 .handler = handle_gdb_breakpoint_override_command,
2607                 .mode = COMMAND_ANY,
2608                 .help = "Display or specify type of breakpoint "
2609                         "to be used by gdb 'break' commands.",
2610                 .usage = "('hard'|'soft'|'disable')"
2611         },
2612         COMMAND_REGISTRATION_DONE
2613 };
2614
2615 int gdb_register_commands(struct command_context *cmd_ctx)
2616 {
2617         return register_commands(cmd_ctx, NULL, gdb_command_handlers);
2618 }