1 /***************************************************************************
2 * Copyright (C) 2005 by Dominic Rath *
3 * Dominic.Rath@gmx.de *
5 * part of this file is taken from libcli (libcli.sourceforge.net) *
6 * Copyright (C) David Parrish (david@dparrish.com) *
8 * This program is free software; you can redistribute it and/or modify *
9 * it under the terms of the GNU General Public License as published by *
10 * the Free Software Foundation; either version 2 of the License, or *
11 * (at your option) any later version. *
13 * This program is distributed in the hope that it will be useful, *
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
16 * GNU General Public License for more details. *
18 * You should have received a copy of the GNU General Public License *
19 * along with this program; if not, write to the *
20 * Free Software Foundation, Inc., *
21 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
22 ***************************************************************************/
27 #include "replacements.h"
40 int handle_sleep_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
42 int build_unique_lengths(command_context_t
*context
, command_t
*commands
)
46 /* iterate through all commands */
47 for (c
= commands
; c
; c
= c
->next
)
49 /* find out how many characters are required to uniquely identify a command */
50 for (c
->unique_len
= 1; c
->unique_len
<= strlen(c
->name
); c
->unique_len
++)
54 /* for every command, see if the current length is enough */
55 for (p
= commands
; p
; p
= p
->next
)
57 /* ignore the command itself */
61 /* compare commands up to the current length */
62 if (strncmp(p
->name
, c
->name
, c
->unique_len
) == 0)
66 /* when none of the commands matched, we've found the minimum length required */
71 /* if the current command has children, build the unique lengths for them */
73 build_unique_lengths(context
, c
->children
);
79 command_t
* register_command(command_context_t
*context
, command_t
*parent
, char *name
, int (*handler
)(struct command_context_s
*context
, char* name
, char** args
, int argc
), enum command_mode mode
, char *help
)
83 if (!context
|| !name
)
86 c
= malloc(sizeof(command_t
));
88 c
->name
= strdup(name
);
94 c
->help
= strdup(help
);
100 /* place command in tree */
103 if (parent
->children
)
105 /* find last child */
106 for (p
= parent
->children
; p
&& p
->next
; p
= p
->next
);
112 parent
->children
= c
;
117 if (context
->commands
)
119 /* find last command */
120 for (p
= context
->commands
; p
&& p
->next
; p
= p
->next
);
126 context
->commands
= c
;
130 /* update unique lengths */
131 build_unique_lengths(context
, (parent
) ? parent
: context
->commands
);
136 int unregister_command(command_context_t
*context
, char *name
)
138 command_t
*c
, *p
= NULL
, *c2
;
140 if ((!context
) || (!name
))
141 return ERROR_INVALID_ARGUMENTS
;
144 for (c
= context
->commands
; c
; c
= c
->next
)
146 if (strcmp(name
, c
->name
) == 0)
155 context
->commands
= c
->next
;
158 /* unregister children */
161 for (c2
= c
->children
; c2
; c2
= c2
->next
)
177 /* remember the last command for unlinking */
184 int parse_line(char *line
, char *words
[], int max_words
)
188 char *word_start
= line
;
191 while (nwords
< max_words
- 1)
193 /* check if we reached
195 * a matching closing quote character " or '
196 * we're inside a word but not a quote, and the current character is whitespace
198 if (!*p
|| *p
== inquote
|| (word_start
&& !inquote
&& isspace(*p
)))
200 /* we're inside a word or quote, and reached its end*/
206 /* This will handle extra whitespace within quotes */
207 while (isspace(*word_start
)&&(word_start
<word_end
))
209 while (isspace(*(word_end
-1))&&(word_start
<word_end
))
211 len
= word_end
- word_start
;
216 memcpy(words
[nwords
] = malloc(len
+ 1), word_start
, len
);
217 /* add terminating NUL */
218 words
[nwords
++][len
] = 0;
221 /* we're done parsing the line */
225 /* skip over trailing quote or whitespace*/
226 if (inquote
|| isspace(*p
))
234 else if (*p
== '"' || *p
== '\'')
236 /* we've reached the beginning of a quote */
242 /* we've reached the beginning of a new word */
246 /* normal character, skip */
254 void command_print(command_context_t
*context
, char *format
, ...)
261 va_start(ap
, format
);
263 /* process format string */
264 /* TODO: possible bug. va_list is undefined after the first call to vsnprintf */
265 while (!buffer
|| (n
= vsnprintf(buffer
, size
, format
, ap
)) >= size
)
267 /* increase buffer until it fits the whole string */
268 if (!(p
= realloc(buffer
, size
+= 4096)))
279 /* vsnprintf failed */
289 /* process lines in buffer */
291 char *next
= strchr(p
, '\n');
296 if (context
->output_handler
)
297 context
->output_handler(context
, p
);
308 int find_and_run_command(command_context_t
*context
, command_t
*commands
, char *words
[], int num_words
, int start_word
)
312 for (c
= commands
; c
; c
= c
->next
)
314 if (strncasecmp(c
->name
, words
[start_word
], c
->unique_len
))
317 if (strncasecmp(c
->name
, words
[start_word
], strlen(words
[start_word
])))
320 if ((c
->mode
== context
->mode
) || (c
->mode
== COMMAND_ANY
))
326 command_print(context
, "No handler for command");
331 return c
->handler(context
, c
->name
, words
+ start_word
+ 1, num_words
- start_word
- 1);
336 if (start_word
== num_words
- 1)
338 command_print(context
, "Incomplete command");
341 return find_and_run_command(context
, c
->children
, words
, num_words
, start_word
+ 1);
346 command_print(context
, "Command %s not found", words
[start_word
]);
350 int command_run_line(command_context_t
*context
, char *line
)
353 char *words
[128] = {0};
357 if ((!context
) || (!line
))
358 return ERROR_INVALID_ARGUMENTS
;
360 /* skip preceding whitespace */
361 while (isspace(*line
))
364 /* empty line, ignore */
368 /* ignore comments */
369 if (*line
&& (line
[0] == '#'))
374 command_print(context
, "%s", line
);
377 nwords
= parse_line(line
, words
, sizeof(words
) / sizeof(words
[0]));
380 retval
= find_and_run_command(context
, context
->commands
, words
, nwords
, 0);
382 return ERROR_INVALID_ARGUMENTS
;
384 for (i
= 0; i
< nwords
; i
++)
390 int command_run_file(command_context_t
*context
, FILE *file
, enum command_mode mode
)
392 int retval
= ERROR_OK
;
393 int old_command_mode
;
394 char *buffer
=malloc(4096);
397 return ERROR_INVALID_ARGUMENTS
;
400 old_command_mode
= context
->mode
;
401 context
->mode
= mode
;
403 while (fgets(buffer
, 4096, file
))
408 /* stop processing line after a comment (#, !) or a LF, CR were encountered */
409 if ((p
= strpbrk(buffer
, "#!\r\n")))
412 /* skip over leading whitespace */
414 while (isspace(*cmd
))
417 /* empty (all whitespace) line? */
421 /* search the end of the current line, ignore trailing whitespace */
422 for (p
= end
= cmd
; *p
; p
++)
428 if (strcasecmp(cmd
, "quit") == 0)
432 if ((retval
= command_run_line(context
, cmd
)) == ERROR_COMMAND_CLOSE_CONNECTION
)
436 context
->mode
= old_command_mode
;
444 void command_print_help_line(command_context_t
* context
, struct command_s
*command
, int indent
)
447 char indents
[32] = {0};
448 char *help
= "no help available";
452 for (i
= 0; i
< indent
; i
+=2)
455 indents
[i
*2+1] = '-';
459 if ((command
->mode
== COMMAND_EXEC
) || (command
->mode
== COMMAND_ANY
))
462 help
= command
->help
;
464 snprintf(name_buf
, 64, command
->name
);
465 strncat(name_buf
, indents
, 64);
466 command_print(context
, "%20s\t%s", name_buf
, help
);
469 if (command
->children
)
471 for (c
= command
->children
; c
; c
= c
->next
)
473 command_print_help_line(context
, c
, indent
+ 1);
478 int command_print_help(command_context_t
* context
, char* name
, char** args
, int argc
)
482 for (c
= context
->commands
; c
; c
= c
->next
)
486 if (strncasecmp(c
->name
, args
[0], c
->unique_len
))
489 if (strncasecmp(c
->name
, args
[0], strlen(args
[0])))
493 command_print_help_line(context
, c
, 0);
499 void command_set_output_handler(command_context_t
* context
, int (*output_handler
)(struct command_context_s
*context
, char* line
), void *priv
)
501 context
->output_handler
= output_handler
;
502 context
->output_handler_priv
= priv
;
505 command_context_t
* copy_command_context(command_context_t
* context
)
507 command_context_t
* copy_context
= malloc(sizeof(command_context_t
));
509 *copy_context
= *context
;
514 int command_done(command_context_t
*context
)
522 command_context_t
* command_init()
524 command_context_t
* context
= malloc(sizeof(command_context_t
));
526 context
->mode
= COMMAND_EXEC
;
527 context
->commands
= NULL
;
528 context
->current_target
= 0;
530 context
->output_handler
= NULL
;
531 context
->output_handler_priv
= NULL
;
533 register_command(context
, NULL
, "help", command_print_help
,
534 COMMAND_EXEC
, "display this help");
536 register_command(context
, NULL
, "sleep", handle_sleep_command
,
537 COMMAND_ANY
, "sleep for <n> milliseconds");
542 /* sleep command sleeps for <n> miliseconds
543 * this is useful in target startup scripts
545 int handle_sleep_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
547 unsigned long duration
= 0;
551 duration
= strtoul(args
[0], NULL
, 0);
552 usleep(duration
* 1000);
Linking to existing account procedure
If you already have an account and want to add another login method
you
MUST first sign in with your existing account and
then change URL to read
https://review.openocd.org/login/?link
to get to this page again but this time it'll work for linking. Thank you.
SSH host keys fingerprints
1024 SHA256:YKx8b7u5ZWdcbp7/4AeXNaqElP49m6QrwfXaqQGJAOk gerrit-code-review@openocd.zylin.com (DSA)
384 SHA256:jHIbSQa4REvwCFG4cq5LBlBLxmxSqelQPem/EXIrxjk gerrit-code-review@openocd.org (ECDSA)
521 SHA256:UAOPYkU9Fjtcao0Ul/Rrlnj/OsQvt+pgdYSZ4jOYdgs gerrit-code-review@openocd.org (ECDSA)
256 SHA256:A13M5QlnozFOvTllybRZH6vm7iSt0XLxbA48yfc2yfY gerrit-code-review@openocd.org (ECDSA)
256 SHA256:spYMBqEYoAOtK7yZBrcwE8ZpYt6b68Cfh9yEVetvbXg gerrit-code-review@openocd.org (ED25519)
+--[ED25519 256]--+
|=.. |
|+o.. . |
|*.o . . |
|+B . . . |
|Bo. = o S |
|Oo.+ + = |
|oB=.* = . o |
| =+=.+ + E |
|. .=o . o |
+----[SHA256]-----+
2048 SHA256:0Onrb7/PHjpo6iVZ7xQX2riKN83FJ3KGU0TvI0TaFG4 gerrit-code-review@openocd.zylin.com (RSA)