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"
32 #include "time_support.h"
41 void command_print_help_line(command_context_t
* context
, struct command_s
*command
, int indent
);
43 int handle_sleep_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
44 int handle_time_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
46 int build_unique_lengths(command_context_t
*context
, command_t
*commands
)
50 /* iterate through all commands */
51 for (c
= commands
; c
; c
= c
->next
)
53 /* find out how many characters are required to uniquely identify a command */
54 for (c
->unique_len
= 1; c
->unique_len
<= strlen(c
->name
); c
->unique_len
++)
58 /* for every command, see if the current length is enough */
59 for (p
= commands
; p
; p
= p
->next
)
61 /* ignore the command itself */
65 /* compare commands up to the current length */
66 if (strncmp(p
->name
, c
->name
, c
->unique_len
) == 0)
70 /* when none of the commands matched, we've found the minimum length required */
75 /* if the current command has children, build the unique lengths for them */
77 build_unique_lengths(context
, c
->children
);
83 /* Avoid evaluating this each time we add a command. Reduces overhead from O(n^2) to O(n).
84 * Makes a difference on ARM7 types machines and is not observable on GHz machines.
86 static int unique_length_dirty
= 1;
88 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
)
91 unique_length_dirty
= 1;
93 if (!context
|| !name
)
96 c
= malloc(sizeof(command_t
));
98 c
->name
= strdup(name
);
101 c
->handler
= handler
;
104 c
->help
= strdup(help
);
110 /* place command in tree */
113 if (parent
->children
)
115 /* find last child */
116 for (p
= parent
->children
; p
&& p
->next
; p
= p
->next
);
122 parent
->children
= c
;
127 if (context
->commands
)
129 /* find last command */
130 for (p
= context
->commands
; p
&& p
->next
; p
= p
->next
);
136 context
->commands
= c
;
143 int unregister_command(command_context_t
*context
, char *name
)
145 command_t
*c
, *p
= NULL
, *c2
;
147 unique_length_dirty
= 1;
149 if ((!context
) || (!name
))
150 return ERROR_INVALID_ARGUMENTS
;
153 for (c
= context
->commands
; c
; c
= c
->next
)
155 if (strcmp(name
, c
->name
) == 0)
164 context
->commands
= c
->next
;
167 /* unregister children */
170 for (c2
= c
->children
; c2
; c2
= c2
->next
)
186 /* remember the last command for unlinking */
193 int parse_line(char *line
, char *words
[], int max_words
)
197 char *word_start
= line
;
200 while (nwords
< max_words
- 1)
202 /* check if we reached
204 * a matching closing quote character " or '
205 * we're inside a word but not a quote, and the current character is whitespace
207 if (!*p
|| *p
== inquote
|| (word_start
&& !inquote
&& isspace(*p
)))
209 /* we're inside a word or quote, and reached its end*/
215 /* This will handle extra whitespace within quotes */
216 while (isspace(*word_start
)&&(word_start
<word_end
))
218 while (isspace(*(word_end
-1))&&(word_start
<word_end
))
220 len
= word_end
- word_start
;
225 memcpy(words
[nwords
] = malloc(len
+ 1), word_start
, len
);
226 /* add terminating NUL */
227 words
[nwords
++][len
] = 0;
230 /* we're done parsing the line */
234 /* skip over trailing quote or whitespace*/
235 if (inquote
|| isspace(*p
))
243 else if (*p
== '"' || *p
== '\'')
245 /* we've reached the beginning of a quote */
251 /* we've reached the beginning of a new word */
255 /* normal character, skip */
263 void command_print_n(command_context_t
*context
, char *format
, ...)
268 va_start(ap
, format
);
270 string
= alloc_vprintf(format
, ap
);
273 context
->output_handler(context
, string
);
280 void command_print(command_context_t
*context
, char *format
, ...)
285 va_start(ap
, format
);
287 string
= alloc_vprintf(format
, ap
);
290 strcat(string
, "\n"); /* alloc_vprintf guaranteed the buffer to be at least one char longer */
291 context
->output_handler(context
, string
);
298 int find_and_run_command(command_context_t
*context
, command_t
*commands
, char *words
[], int num_words
, int start_word
)
301 int retval
= ERROR_COMMAND_SYNTAX_ERROR
;
303 if (unique_length_dirty
)
305 unique_length_dirty
= 0;
306 /* update unique lengths */
307 build_unique_lengths(context
, context
->commands
);
310 for (c
= commands
; c
; c
= c
->next
)
312 if (strncasecmp(c
->name
, words
[start_word
], c
->unique_len
))
315 if (strncasecmp(c
->name
, words
[start_word
], strlen(words
[start_word
])))
318 if ((context
->mode
== COMMAND_CONFIG
) || (c
->mode
== COMMAND_ANY
) || (c
->mode
== context
->mode
) )
324 command_print(context
, "No handler for command");
325 retval
= ERROR_COMMAND_SYNTAX_ERROR
;
330 int retval
= c
->handler(context
, c
->name
, words
+ start_word
+ 1, num_words
- start_word
- 1);
331 if (retval
== ERROR_COMMAND_SYNTAX_ERROR
)
333 command_print(context
, "Syntax error:");
334 command_print_help_line(context
, c
, 0);
335 } else if (retval
!= ERROR_OK
)
337 /* we do not print out an error message because the command *should*
338 * have printed out an error
340 LOG_DEBUG("Command failed with error code %d", retval
);
347 if (start_word
== num_words
- 1)
349 command_print(context
, "Incomplete command");
352 return find_and_run_command(context
, c
->children
, words
, num_words
, start_word
+ 1);
357 command_print(context
, "Command %s not found", words
[start_word
]);
361 int command_run_line(command_context_t
*context
, char *line
)
364 char *words
[128] = {0};
368 if ((!context
) || (!line
))
369 return ERROR_INVALID_ARGUMENTS
;
371 /* skip preceding whitespace */
372 while (isspace(*line
))
375 /* empty line, ignore */
379 /* ignore comments */
380 if (*line
&& (line
[0] == '#'))
383 LOG_DEBUG("%s", line
);
385 nwords
= parse_line(line
, words
, sizeof(words
) / sizeof(words
[0]));
388 retval
= find_and_run_command(context
, context
->commands
, words
, nwords
, 0);
390 return ERROR_INVALID_ARGUMENTS
;
392 for (i
= 0; i
< nwords
; i
++)
398 int command_run_file(command_context_t
*context
, FILE *file
, enum command_mode mode
)
400 int retval
= ERROR_OK
;
401 int old_command_mode
;
402 char *buffer
=malloc(4096);
405 return ERROR_INVALID_ARGUMENTS
;
408 old_command_mode
= context
->mode
;
409 context
->mode
= mode
;
411 while (fgets(buffer
, 4096, file
))
416 /* stop processing line after a comment (#, !) or a LF, CR were encountered */
417 if ((p
= strpbrk(buffer
, "#!\r\n")))
420 /* skip over leading whitespace */
422 while (isspace(*cmd
))
425 /* empty (all whitespace) line? */
429 /* search the end of the current line, ignore trailing whitespace */
430 for (p
= end
= cmd
; *p
; p
++)
436 if (strcasecmp(cmd
, "quit") == 0)
440 if ((retval
= command_run_line(context
, cmd
)) == ERROR_COMMAND_CLOSE_CONNECTION
)
444 context
->mode
= old_command_mode
;
452 void command_print_help_line(command_context_t
* context
, struct command_s
*command
, int indent
)
455 #ifdef HAVE_C_VARRAYS
456 char indent_text
[indent
+ 2];
458 char indent_text
[68];
460 char *help
= "no help available";
465 indent_text
[0] = ' ';
466 memset(indent_text
+ 1, '-', indent
);
467 indent_text
[indent
+ 1] = 0;
471 help
= command
->help
;
473 snprintf(name_buf
, 64, command
->name
);
476 strncat(name_buf
, indent_text
, 64);
478 command_print(context
, "%20s\t%s", name_buf
, help
, indent
);
480 if (command
->children
)
482 for (c
= command
->children
; c
; c
= c
->next
)
484 command_print_help_line(context
, c
, indent
+ 1);
489 int command_print_help_match(command_context_t
* context
, command_t
* c_first
, char* name
, char** args
, int argc
)
493 for (c
= c_first
; c
; c
= c
->next
)
497 if (strncasecmp(c
->name
, args
[0], c
->unique_len
))
500 if (strncasecmp(c
->name
, args
[0], strlen(args
[0])))
505 command_print_help_match(context
, c
->children
, name
, args
+ 1, argc
- 1);
510 command_print_help_line(context
, c
, 0);
516 int command_print_help(command_context_t
* context
, char* name
, char** args
, int argc
)
518 return command_print_help_match(context
, context
->commands
, name
, args
, argc
);
522 void command_set_output_handler(command_context_t
* context
, int (*output_handler
)(struct command_context_s
*context
, char* line
), void *priv
)
524 context
->output_handler
= output_handler
;
525 context
->output_handler_priv
= priv
;
528 command_context_t
* copy_command_context(command_context_t
* context
)
530 command_context_t
* copy_context
= malloc(sizeof(command_context_t
));
532 *copy_context
= *context
;
537 int command_done(command_context_t
*context
)
545 command_context_t
* command_init()
547 command_context_t
* context
= malloc(sizeof(command_context_t
));
549 context
->mode
= COMMAND_EXEC
;
550 context
->commands
= NULL
;
551 context
->current_target
= 0;
552 context
->output_handler
= NULL
;
553 context
->output_handler_priv
= NULL
;
555 register_command(context
, NULL
, "help", command_print_help
,
556 COMMAND_EXEC
, "display this help");
558 register_command(context
, NULL
, "sleep", handle_sleep_command
,
559 COMMAND_ANY
, "sleep for <n> milliseconds");
561 register_command(context
, NULL
, "time", handle_time_command
,
562 COMMAND_ANY
, "time <cmd + args> - execute <cmd + args> and print time it took");
567 /* sleep command sleeps for <n> miliseconds
568 * this is useful in target startup scripts
570 int handle_sleep_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
572 unsigned long duration
= 0;
576 duration
= strtoul(args
[0], NULL
, 0);
577 usleep(duration
* 1000);
583 int handle_time_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
591 return ERROR_COMMAND_SYNTAX_ERROR
;
593 duration_start_measure(&duration
);
595 retval
= find_and_run_command(cmd_ctx
, cmd_ctx
->commands
, args
, argc
, 0);
597 duration_stop_measure(&duration
, &duration_text
);
599 t
=duration
.duration
.tv_sec
;
600 t
+=((float)duration
.duration
.tv_usec
/ 1000000.0);
601 command_print(cmd_ctx
, "%s took %fs", args
[0], t
);
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)