source: mainline/kernel/generic/src/console/cmd.c@ cb3d641a

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since cb3d641a was cb3d641a, checked in by Jiri Svoboda <jiri@…>, 16 years ago

Fix cmd_kill doc.

  • Property mode set to 100644
File size: 24.9 KB
Line 
1/*
2 * Copyright (c) 2005 Jakub Jermar
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29/** @addtogroup genericconsole
30 * @{
31 */
32
33/**
34 * @file cmd.c
35 * @brief Kernel console command wrappers.
36 *
37 * This file is meant to contain all wrapper functions for
38 * all kconsole commands. The point is in separating
39 * kconsole specific wrappers from kconsole-unaware functions
40 * from other subsystems.
41 */
42
43#include <console/cmd.h>
44#include <console/console.h>
45#include <console/kconsole.h>
46#include <print.h>
47#include <panic.h>
48#include <arch/types.h>
49#include <adt/list.h>
50#include <arch.h>
51#include <config.h>
52#include <func.h>
53#include <string.h>
54#include <macros.h>
55#include <debug.h>
56#include <cpu.h>
57#include <mm/tlb.h>
58#include <arch/mm/tlb.h>
59#include <mm/frame.h>
60#include <main/version.h>
61#include <mm/slab.h>
62#include <proc/scheduler.h>
63#include <proc/thread.h>
64#include <proc/task.h>
65#include <ipc/ipc.h>
66#include <ipc/irq.h>
67#include <ipc/event.h>
68#include <symtab.h>
69#include <errno.h>
70
71#ifdef CONFIG_TEST
72#include <test.h>
73#endif
74
75/* Data and methods for 'help' command. */
76static int cmd_help(cmd_arg_t *argv);
77static cmd_info_t help_info = {
78 .name = "help",
79 .description = "List of supported commands.",
80 .func = cmd_help,
81 .argc = 0
82};
83
84static int cmd_reboot(cmd_arg_t *argv);
85static cmd_info_t reboot_info = {
86 .name = "reboot",
87 .description = "Reboot.",
88 .func = cmd_reboot,
89 .argc = 0
90};
91
92static int cmd_uptime(cmd_arg_t *argv);
93static cmd_info_t uptime_info = {
94 .name = "uptime",
95 .description = "Print uptime information.",
96 .func = cmd_uptime,
97 .argc = 0
98};
99
100static int cmd_continue(cmd_arg_t *argv);
101static cmd_info_t continue_info = {
102 .name = "continue",
103 .description = "Return console back to userspace.",
104 .func = cmd_continue,
105 .argc = 0
106};
107
108#ifdef CONFIG_TEST
109static int cmd_tests(cmd_arg_t *argv);
110static cmd_info_t tests_info = {
111 .name = "tests",
112 .description = "Print available kernel tests.",
113 .func = cmd_tests,
114 .argc = 0
115};
116
117static char test_buf[MAX_CMDLINE + 1];
118static int cmd_test(cmd_arg_t *argv);
119static cmd_arg_t test_argv[] = {
120 {
121 .type = ARG_TYPE_STRING,
122 .buffer = test_buf,
123 .len = sizeof(test_buf)
124 }
125};
126static cmd_info_t test_info = {
127 .name = "test",
128 .description = "Run kernel test.",
129 .func = cmd_test,
130 .argc = 1,
131 .argv = test_argv
132};
133
134static int cmd_bench(cmd_arg_t *argv);
135static cmd_arg_t bench_argv[] = {
136 {
137 .type = ARG_TYPE_STRING,
138 .buffer = test_buf,
139 .len = sizeof(test_buf)
140 },
141 {
142 .type = ARG_TYPE_INT,
143 }
144};
145static cmd_info_t bench_info = {
146 .name = "bench",
147 .description = "Run kernel test as benchmark.",
148 .func = cmd_bench,
149 .argc = 2,
150 .argv = bench_argv
151};
152#endif
153
154/* Data and methods for 'description' command. */
155static int cmd_desc(cmd_arg_t *argv);
156static void desc_help(void);
157static char desc_buf[MAX_CMDLINE+1];
158static cmd_arg_t desc_argv = {
159 .type = ARG_TYPE_STRING,
160 .buffer = desc_buf,
161 .len = sizeof(desc_buf)
162};
163static cmd_info_t desc_info = {
164 .name = "describe",
165 .description = "Describe specified command.",
166 .help = desc_help,
167 .func = cmd_desc,
168 .argc = 1,
169 .argv = &desc_argv
170};
171
172/* Data and methods for 'symaddr' command. */
173static int cmd_symaddr(cmd_arg_t *argv);
174static char symaddr_buf[MAX_CMDLINE+1];
175static cmd_arg_t symaddr_argv = {
176 .type = ARG_TYPE_STRING,
177 .buffer = symaddr_buf,
178 .len = sizeof(symaddr_buf)
179};
180static cmd_info_t symaddr_info = {
181 .name = "symaddr",
182 .description = "Return symbol address.",
183 .func = cmd_symaddr,
184 .argc = 1,
185 .argv = &symaddr_argv
186};
187
188static char set_buf[MAX_CMDLINE+1];
189static int cmd_set4(cmd_arg_t *argv);
190static cmd_arg_t set4_argv[] = {
191 {
192 .type = ARG_TYPE_STRING,
193 .buffer = set_buf,
194 .len = sizeof(set_buf)
195 },
196 {
197 .type = ARG_TYPE_INT
198 }
199};
200static cmd_info_t set4_info = {
201 .name = "set4",
202 .description = "set <dest_addr> <value> - 4byte version",
203 .func = cmd_set4,
204 .argc = 2,
205 .argv = set4_argv
206};
207
208/* Data and methods for 'call0' command. */
209static char call0_buf[MAX_CMDLINE + 1];
210static char carg1_buf[MAX_CMDLINE + 1];
211static char carg2_buf[MAX_CMDLINE + 1];
212static char carg3_buf[MAX_CMDLINE + 1];
213
214static int cmd_call0(cmd_arg_t *argv);
215static cmd_arg_t call0_argv = {
216 .type = ARG_TYPE_STRING,
217 .buffer = call0_buf,
218 .len = sizeof(call0_buf)
219};
220static cmd_info_t call0_info = {
221 .name = "call0",
222 .description = "call0 <function> -> call function().",
223 .func = cmd_call0,
224 .argc = 1,
225 .argv = &call0_argv
226};
227
228/* Data and methods for 'mcall0' command. */
229static int cmd_mcall0(cmd_arg_t *argv);
230static cmd_arg_t mcall0_argv = {
231 .type = ARG_TYPE_STRING,
232 .buffer = call0_buf,
233 .len = sizeof(call0_buf)
234};
235static cmd_info_t mcall0_info = {
236 .name = "mcall0",
237 .description = "mcall0 <function> -> call function() on each CPU.",
238 .func = cmd_mcall0,
239 .argc = 1,
240 .argv = &mcall0_argv
241};
242
243/* Data and methods for 'call1' command. */
244static int cmd_call1(cmd_arg_t *argv);
245static cmd_arg_t call1_argv[] = {
246 {
247 .type = ARG_TYPE_STRING,
248 .buffer = call0_buf,
249 .len = sizeof(call0_buf)
250 },
251 {
252 .type = ARG_TYPE_VAR,
253 .buffer = carg1_buf,
254 .len = sizeof(carg1_buf)
255 }
256};
257static cmd_info_t call1_info = {
258 .name = "call1",
259 .description = "call1 <function> <arg1> -> call function(arg1).",
260 .func = cmd_call1,
261 .argc = 2,
262 .argv = call1_argv
263};
264
265/* Data and methods for 'call2' command. */
266static int cmd_call2(cmd_arg_t *argv);
267static cmd_arg_t call2_argv[] = {
268 {
269 .type = ARG_TYPE_STRING,
270 .buffer = call0_buf,
271 .len = sizeof(call0_buf)
272 },
273 {
274 .type = ARG_TYPE_VAR,
275 .buffer = carg1_buf,
276 .len = sizeof(carg1_buf)
277 },
278 {
279 .type = ARG_TYPE_VAR,
280 .buffer = carg2_buf,
281 .len = sizeof(carg2_buf)
282 }
283};
284static cmd_info_t call2_info = {
285 .name = "call2",
286 .description = "call2 <function> <arg1> <arg2> -> call function(arg1,arg2).",
287 .func = cmd_call2,
288 .argc = 3,
289 .argv = call2_argv
290};
291
292/* Data and methods for 'call3' command. */
293static int cmd_call3(cmd_arg_t *argv);
294static cmd_arg_t call3_argv[] = {
295 {
296 .type = ARG_TYPE_STRING,
297 .buffer = call0_buf,
298 .len = sizeof(call0_buf)
299 },
300 {
301 .type = ARG_TYPE_VAR,
302 .buffer = carg1_buf,
303 .len = sizeof(carg1_buf)
304 },
305 {
306 .type = ARG_TYPE_VAR,
307 .buffer = carg2_buf,
308 .len = sizeof(carg2_buf)
309 },
310 {
311 .type = ARG_TYPE_VAR,
312 .buffer = carg3_buf,
313 .len = sizeof(carg3_buf)
314 }
315
316};
317static cmd_info_t call3_info = {
318 .name = "call3",
319 .description = "call3 <function> <arg1> <arg2> <arg3> -> call function(arg1,arg2,arg3).",
320 .func = cmd_call3,
321 .argc = 4,
322 .argv = call3_argv
323};
324
325/* Data and methods for 'halt' command. */
326static int cmd_halt(cmd_arg_t *argv);
327static cmd_info_t halt_info = {
328 .name = "halt",
329 .description = "Halt the kernel.",
330 .func = cmd_halt,
331 .argc = 0
332};
333
334/* Data and methods for 'physmem' command. */
335static int cmd_physmem(cmd_arg_t *argv);
336cmd_info_t physmem_info = {
337 .name = "physmem",
338 .description = "Print physical memory configuration.",
339 .help = NULL,
340 .func = cmd_physmem,
341 .argc = 0,
342 .argv = NULL
343};
344
345/* Data and methods for 'tlb' command. */
346static int cmd_tlb(cmd_arg_t *argv);
347cmd_info_t tlb_info = {
348 .name = "tlb",
349 .description = "Print TLB of current processor.",
350 .help = NULL,
351 .func = cmd_tlb,
352 .argc = 0,
353 .argv = NULL
354};
355
356static int cmd_threads(cmd_arg_t *argv);
357static cmd_info_t threads_info = {
358 .name = "threads",
359 .description = "List all threads.",
360 .func = cmd_threads,
361 .argc = 0
362};
363
364static int cmd_tasks(cmd_arg_t *argv);
365static cmd_info_t tasks_info = {
366 .name = "tasks",
367 .description = "List all tasks.",
368 .func = cmd_tasks,
369 .argc = 0
370};
371
372
373static int cmd_sched(cmd_arg_t *argv);
374static cmd_info_t sched_info = {
375 .name = "scheduler",
376 .description = "List all scheduler information.",
377 .func = cmd_sched,
378 .argc = 0
379};
380
381static int cmd_slabs(cmd_arg_t *argv);
382static cmd_info_t slabs_info = {
383 .name = "slabs",
384 .description = "List slab caches.",
385 .func = cmd_slabs,
386 .argc = 0
387};
388
389/* Data and methods for 'zones' command */
390static int cmd_zones(cmd_arg_t *argv);
391static cmd_info_t zones_info = {
392 .name = "zones",
393 .description = "List of memory zones.",
394 .func = cmd_zones,
395 .argc = 0
396};
397
398/* Data and methods for 'ipc' command */
399static int cmd_ipc(cmd_arg_t *argv);
400static cmd_arg_t ipc_argv = {
401 .type = ARG_TYPE_INT,
402};
403static cmd_info_t ipc_info = {
404 .name = "ipc",
405 .description = "ipc <taskid> Show IPC information of given task.",
406 .func = cmd_ipc,
407 .argc = 1,
408 .argv = &ipc_argv
409};
410
411/* Data and methods for 'kill' command */
412static int cmd_kill(cmd_arg_t *argv);
413static cmd_arg_t kill_argv = {
414 .type = ARG_TYPE_INT,
415};
416static cmd_info_t kill_info = {
417 .name = "kill",
418 .description = "kill <taskid> Kill a task.",
419 .func = cmd_kill,
420 .argc = 1,
421 .argv = &kill_argv
422};
423
424/* Data and methods for 'zone' command */
425static int cmd_zone(cmd_arg_t *argv);
426static cmd_arg_t zone_argv = {
427 .type = ARG_TYPE_INT,
428};
429
430static cmd_info_t zone_info = {
431 .name = "zone",
432 .description = "Show memory zone structure.",
433 .func = cmd_zone,
434 .argc = 1,
435 .argv = &zone_argv
436};
437
438/* Data and methods for 'cpus' command. */
439static int cmd_cpus(cmd_arg_t *argv);
440cmd_info_t cpus_info = {
441 .name = "cpus",
442 .description = "List all processors.",
443 .help = NULL,
444 .func = cmd_cpus,
445 .argc = 0,
446 .argv = NULL
447};
448
449/* Data and methods for 'version' command. */
450static int cmd_version(cmd_arg_t *argv);
451cmd_info_t version_info = {
452 .name = "version",
453 .description = "Print version information.",
454 .help = NULL,
455 .func = cmd_version,
456 .argc = 0,
457 .argv = NULL
458};
459
460static cmd_info_t *basic_commands[] = {
461 &call0_info,
462 &mcall0_info,
463 &call1_info,
464 &call2_info,
465 &call3_info,
466 &continue_info,
467 &cpus_info,
468 &desc_info,
469 &reboot_info,
470 &uptime_info,
471 &halt_info,
472 &help_info,
473 &ipc_info,
474 &kill_info,
475 &set4_info,
476 &slabs_info,
477 &symaddr_info,
478 &sched_info,
479 &threads_info,
480 &tasks_info,
481 &physmem_info,
482 &tlb_info,
483 &version_info,
484 &zones_info,
485 &zone_info,
486#ifdef CONFIG_TEST
487 &tests_info,
488 &test_info,
489 &bench_info,
490#endif
491 NULL
492};
493
494
495/** Initialize command info structure.
496 *
497 * @param cmd Command info structure.
498 *
499 */
500void cmd_initialize(cmd_info_t *cmd)
501{
502 spinlock_initialize(&cmd->lock, "cmd");
503 link_initialize(&cmd->link);
504}
505
506/** Initialize and register commands. */
507void cmd_init(void)
508{
509 unsigned int i;
510
511 for (i = 0; basic_commands[i]; i++) {
512 cmd_initialize(basic_commands[i]);
513 if (!cmd_register(basic_commands[i]))
514 printf("Cannot register command %s\n", basic_commands[i]->name);
515 }
516}
517
518
519/** List supported commands.
520 *
521 * @param argv Argument vector.
522 *
523 * @return 0 on failure, 1 on success.
524 */
525int cmd_help(cmd_arg_t *argv)
526{
527 spinlock_lock(&cmd_lock);
528
529 link_t *cur;
530 size_t len = 0;
531 for (cur = cmd_head.next; cur != &cmd_head; cur = cur->next) {
532 cmd_info_t *hlp;
533 hlp = list_get_instance(cur, cmd_info_t, link);
534
535 spinlock_lock(&hlp->lock);
536 if (str_length(hlp->name) > len)
537 len = str_length(hlp->name);
538 spinlock_unlock(&hlp->lock);
539 }
540
541 for (cur = cmd_head.next; cur != &cmd_head; cur = cur->next) {
542 cmd_info_t *hlp;
543 hlp = list_get_instance(cur, cmd_info_t, link);
544
545 spinlock_lock(&hlp->lock);
546 printf("%-*s %s\n", len, hlp->name, hlp->description);
547 spinlock_unlock(&hlp->lock);
548 }
549
550 spinlock_unlock(&cmd_lock);
551
552 return 1;
553}
554
555
556/** Reboot the system.
557 *
558 * @param argv Argument vector.
559 *
560 * @return 0 on failure, 1 on success.
561 */
562int cmd_reboot(cmd_arg_t *argv)
563{
564 reboot();
565
566 /* Not reached */
567 return 1;
568}
569
570
571/** Print system uptime information.
572 *
573 * @param argv Argument vector.
574 *
575 * @return 0 on failure, 1 on success.
576 */
577int cmd_uptime(cmd_arg_t *argv)
578{
579 ASSERT(uptime);
580
581 /* This doesn't have to be very accurate */
582 unative_t sec = uptime->seconds1;
583
584 printf("Up %" PRIun " days, %" PRIun " hours, %" PRIun " minutes, %" PRIun " seconds\n",
585 sec / 86400, (sec % 86400) / 3600, (sec % 3600) / 60, sec % 60);
586
587 return 1;
588}
589
590/** Describe specified command.
591 *
592 * @param argv Argument vector.
593 *
594 * @return 0 on failure, 1 on success.
595 */
596int cmd_desc(cmd_arg_t *argv)
597{
598 link_t *cur;
599
600 spinlock_lock(&cmd_lock);
601
602 for (cur = cmd_head.next; cur != &cmd_head; cur = cur->next) {
603 cmd_info_t *hlp;
604
605 hlp = list_get_instance(cur, cmd_info_t, link);
606 spinlock_lock(&hlp->lock);
607
608 if (str_lcmp(hlp->name, (const char *) argv->buffer, str_length(hlp->name)) == 0) {
609 printf("%s - %s\n", hlp->name, hlp->description);
610 if (hlp->help)
611 hlp->help();
612 spinlock_unlock(&hlp->lock);
613 break;
614 }
615
616 spinlock_unlock(&hlp->lock);
617 }
618
619 spinlock_unlock(&cmd_lock);
620
621 return 1;
622}
623
624/** Search symbol table */
625int cmd_symaddr(cmd_arg_t *argv)
626{
627 symtab_print_search((char *) argv->buffer);
628
629 return 1;
630}
631
632/** Call function with zero parameters */
633int cmd_call0(cmd_arg_t *argv)
634{
635 uintptr_t symaddr;
636 char *symbol;
637 unative_t (*fnc)(void);
638 fncptr_t fptr;
639 int rc;
640
641 symbol = (char *) argv->buffer;
642 rc = symtab_addr_lookup(symbol, &symaddr);
643
644 if (rc == ENOENT)
645 printf("Symbol %s not found.\n", symbol);
646 else if (rc == EOVERFLOW) {
647 symtab_print_search(symbol);
648 printf("Duplicate symbol, be more specific.\n");
649 } else if (rc == EOK) {
650 fnc = (unative_t (*)(void)) arch_construct_function(&fptr,
651 (void *) symaddr, (void *) cmd_call0);
652 printf("Calling %s() (%p)\n", symbol, symaddr);
653 printf("Result: %#" PRIxn "\n", fnc());
654 } else {
655 printf("No symbol information available.\n");
656 }
657 return 1;
658}
659
660/** Call function with zero parameters on each CPU */
661int cmd_mcall0(cmd_arg_t *argv)
662{
663 /*
664 * For each CPU, create a thread which will
665 * call the function.
666 */
667
668 size_t i;
669 for (i = 0; i < config.cpu_count; i++) {
670 if (!cpus[i].active)
671 continue;
672
673 thread_t *t;
674 if ((t = thread_create((void (*)(void *)) cmd_call0, (void *) argv, TASK, THREAD_FLAG_WIRED, "call0", false))) {
675 spinlock_lock(&t->lock);
676 t->cpu = &cpus[i];
677 spinlock_unlock(&t->lock);
678 printf("cpu%u: ", i);
679 thread_ready(t);
680 thread_join(t);
681 thread_detach(t);
682 } else
683 printf("Unable to create thread for cpu%u\n", i);
684 }
685
686 return 1;
687}
688
689/** Call function with one parameter */
690int cmd_call1(cmd_arg_t *argv)
691{
692 uintptr_t symaddr;
693 char *symbol;
694 unative_t (*fnc)(unative_t, ...);
695 unative_t arg1 = argv[1].intval;
696 fncptr_t fptr;
697 int rc;
698
699 symbol = (char *) argv->buffer;
700 rc = symtab_addr_lookup(symbol, &symaddr);
701
702 if (rc == ENOENT) {
703 printf("Symbol %s not found.\n", symbol);
704 } else if (rc == EOVERFLOW) {
705 symtab_print_search(symbol);
706 printf("Duplicate symbol, be more specific.\n");
707 } else if (rc == EOK) {
708 fnc = (unative_t (*)(unative_t, ...)) arch_construct_function(&fptr, (void *) symaddr, (void *) cmd_call1);
709 printf("Calling f(%#" PRIxn "): %p: %s\n", arg1, symaddr, symbol);
710 printf("Result: %#" PRIxn "\n", fnc(arg1));
711 } else {
712 printf("No symbol information available.\n");
713 }
714
715 return 1;
716}
717
718/** Call function with two parameters */
719int cmd_call2(cmd_arg_t *argv)
720{
721 uintptr_t symaddr;
722 char *symbol;
723 unative_t (*fnc)(unative_t, unative_t, ...);
724 unative_t arg1 = argv[1].intval;
725 unative_t arg2 = argv[2].intval;
726 fncptr_t fptr;
727 int rc;
728
729 symbol = (char *) argv->buffer;
730 rc = symtab_addr_lookup(symbol, &symaddr);
731
732 if (rc == ENOENT) {
733 printf("Symbol %s not found.\n", symbol);
734 } else if (rc == EOVERFLOW) {
735 symtab_print_search(symbol);
736 printf("Duplicate symbol, be more specific.\n");
737 } else if (rc == EOK) {
738 fnc = (unative_t (*)(unative_t, unative_t, ...)) arch_construct_function(&fptr, (void *) symaddr, (void *) cmd_call2);
739 printf("Calling f(%#" PRIxn ", %#" PRIxn "): %p: %s\n",
740 arg1, arg2, symaddr, symbol);
741 printf("Result: %#" PRIxn "\n", fnc(arg1, arg2));
742 } else {
743 printf("No symbol information available.\n");
744 }
745 return 1;
746}
747
748/** Call function with three parameters */
749int cmd_call3(cmd_arg_t *argv)
750{
751 uintptr_t symaddr;
752 char *symbol;
753 unative_t (*fnc)(unative_t, unative_t, unative_t, ...);
754 unative_t arg1 = argv[1].intval;
755 unative_t arg2 = argv[2].intval;
756 unative_t arg3 = argv[3].intval;
757 fncptr_t fptr;
758 int rc;
759
760 symbol = (char *) argv->buffer;
761 rc = symtab_addr_lookup(symbol, &symaddr);
762
763 if (rc == ENOENT) {
764 printf("Symbol %s not found.\n", symbol);
765 } else if (rc == EOVERFLOW) {
766 symtab_print_search(symbol);
767 printf("Duplicate symbol, be more specific.\n");
768 } else if (rc == EOK) {
769 fnc = (unative_t (*)(unative_t, unative_t, unative_t, ...)) arch_construct_function(&fptr, (void *) symaddr, (void *) cmd_call3);
770 printf("Calling f(%#" PRIxn ",%#" PRIxn ", %#" PRIxn "): %p: %s\n",
771 arg1, arg2, arg3, symaddr, symbol);
772 printf("Result: %#" PRIxn "\n", fnc(arg1, arg2, arg3));
773 } else {
774 printf("No symbol information available.\n");
775 }
776 return 1;
777}
778
779
780/** Print detailed description of 'describe' command. */
781void desc_help(void)
782{
783 printf("Syntax: describe command_name\n");
784}
785
786/** Halt the kernel.
787 *
788 * @param argv Argument vector (ignored).
789 *
790 * @return 0 on failure, 1 on success (never returns).
791 */
792int cmd_halt(cmd_arg_t *argv)
793{
794 halt();
795 return 1;
796}
797
798/** Command for printing TLB contents.
799 *
800 * @param argv Not used.
801 *
802 * @return Always returns 1.
803 */
804int cmd_tlb(cmd_arg_t *argv)
805{
806 tlb_print();
807 return 1;
808}
809
810/** Command for printing physical memory configuration.
811 *
812 * @param argv Not used.
813 *
814 * @return Always returns 1.
815 */
816int cmd_physmem(cmd_arg_t *argv)
817{
818 physmem_print();
819 return 1;
820}
821
822/** Write 4 byte value to address */
823int cmd_set4(cmd_arg_t *argv)
824{
825 uintptr_t addr;
826 uint32_t arg1 = argv[1].intval;
827 bool pointer = false;
828 int rc;
829
830 if (((char *)argv->buffer)[0] == '*') {
831 rc = symtab_addr_lookup((char *) argv->buffer + 1, &addr);
832 pointer = true;
833 } else if (((char *) argv->buffer)[0] >= '0' &&
834 ((char *)argv->buffer)[0] <= '9') {
835 rc = EOK;
836 addr = atoi((char *)argv->buffer);
837 } else {
838 rc = symtab_addr_lookup((char *) argv->buffer, &addr);
839 }
840
841 if (rc == ENOENT)
842 printf("Symbol %s not found.\n", argv->buffer);
843 else if (rc == EOVERFLOW) {
844 symtab_print_search((char *) argv->buffer);
845 printf("Duplicate symbol, be more specific.\n");
846 } else if (rc == EOK) {
847 if (pointer)
848 addr = *(uintptr_t *) addr;
849 printf("Writing %#" PRIx64 " -> %p\n", arg1, addr);
850 *(uint32_t *) addr = arg1;
851 } else {
852 printf("No symbol information available.\n");
853 }
854
855 return 1;
856}
857
858/** Command for listings SLAB caches
859 *
860 * @param argv Ignores
861 *
862 * @return Always 1
863 */
864int cmd_slabs(cmd_arg_t * argv)
865{
866 slab_print_list();
867 return 1;
868}
869
870
871/** Command for listings Thread information
872 *
873 * @param argv Ignores
874 *
875 * @return Always 1
876 */
877int cmd_threads(cmd_arg_t * argv)
878{
879 thread_print_list();
880 return 1;
881}
882
883/** Command for listings Task information
884 *
885 * @param argv Ignores
886 *
887 * @return Always 1
888 */
889int cmd_tasks(cmd_arg_t * argv)
890{
891 task_print_list();
892 return 1;
893}
894
895/** Command for listings Thread information
896 *
897 * @param argv Ignores
898 *
899 * @return Always 1
900 */
901int cmd_sched(cmd_arg_t * argv)
902{
903 sched_print_list();
904 return 1;
905}
906
907/** Command for listing memory zones
908 *
909 * @param argv Ignored
910 *
911 * return Always 1
912 */
913int cmd_zones(cmd_arg_t * argv)
914{
915 zone_print_list();
916 return 1;
917}
918
919/** Command for memory zone details
920 *
921 * @param argv Integer argument from cmdline expected
922 *
923 * return Always 1
924 */
925int cmd_zone(cmd_arg_t * argv)
926{
927 zone_print_one(argv[0].intval);
928 return 1;
929}
930
931/** Command for printing task ipc details
932 *
933 * @param argv Integer argument from cmdline expected
934 *
935 * return Always 1
936 */
937int cmd_ipc(cmd_arg_t * argv)
938{
939 ipc_print_task(argv[0].intval);
940 return 1;
941}
942
943/** Command for killing a task
944 *
945 * @param argv Integer argument from cmdline expected
946 *
947 * return 0 on failure, 1 on success.
948 */
949int cmd_kill(cmd_arg_t * argv)
950{
951 if (task_kill(argv[0].intval) != EOK)
952 return 0;
953
954 return 1;
955}
956
957/** Command for listing processors.
958 *
959 * @param argv Ignored.
960 *
961 * return Always 1.
962 */
963int cmd_cpus(cmd_arg_t *argv)
964{
965 cpu_list();
966 return 1;
967}
968
969/** Command for printing kernel version.
970 *
971 * @param argv Ignored.
972 *
973 * return Always 1.
974 */
975int cmd_version(cmd_arg_t *argv)
976{
977 version_print();
978 return 1;
979}
980
981/** Command for returning console back to userspace.
982 *
983 * @param argv Ignored.
984 *
985 * return Always 1.
986 */
987int cmd_continue(cmd_arg_t *argv)
988{
989 printf("The kernel will now relinquish the console.\n");
990 release_console();
991
992 event_notify_0(EVENT_KCONSOLE);
993 indev_pop_character(stdin);
994
995 return 1;
996}
997
998#ifdef CONFIG_TEST
999/** Command for printing kernel tests list.
1000 *
1001 * @param argv Ignored.
1002 *
1003 * return Always 1.
1004 */
1005int cmd_tests(cmd_arg_t *argv)
1006{
1007 size_t len = 0;
1008 test_t *test;
1009 for (test = tests; test->name != NULL; test++) {
1010 if (str_length(test->name) > len)
1011 len = str_length(test->name);
1012 }
1013
1014 for (test = tests; test->name != NULL; test++)
1015 printf("%-*s %s%s\n", len, test->name, test->desc, (test->safe ? "" : " (unsafe)"));
1016
1017 printf("%-*s Run all safe tests\n", len, "*");
1018 return 1;
1019}
1020
1021static bool run_test(const test_t *test)
1022{
1023 printf("%s (%s)\n", test->name, test->desc);
1024
1025 /* Update and read thread accounting
1026 for benchmarking */
1027 ipl_t ipl = interrupts_disable();
1028 spinlock_lock(&TASK->lock);
1029 uint64_t t0 = task_get_accounting(TASK);
1030 spinlock_unlock(&TASK->lock);
1031 interrupts_restore(ipl);
1032
1033 /* Execute the test */
1034 test_quiet = false;
1035 char *ret = test->entry();
1036
1037 /* Update and read thread accounting */
1038 ipl = interrupts_disable();
1039 spinlock_lock(&TASK->lock);
1040 uint64_t dt = task_get_accounting(TASK) - t0;
1041 spinlock_unlock(&TASK->lock);
1042 interrupts_restore(ipl);
1043
1044 uint64_t cycles;
1045 char suffix;
1046 order(dt, &cycles, &suffix);
1047
1048 printf("Time: %" PRIu64 "%c cycles\n", cycles, suffix);
1049
1050 if (ret == NULL) {
1051 printf("Test passed\n");
1052 return true;
1053 }
1054
1055 printf("%s\n", ret);
1056 return false;
1057}
1058
1059static bool run_bench(const test_t *test, const uint32_t cnt)
1060{
1061 uint32_t i;
1062 bool ret = true;
1063 uint64_t cycles;
1064 char suffix;
1065
1066 if (cnt < 1)
1067 return true;
1068
1069 uint64_t *data = (uint64_t *) malloc(sizeof(uint64_t) * cnt, 0);
1070 if (data == NULL) {
1071 printf("Error allocating memory for statistics\n");
1072 return false;
1073 }
1074
1075 for (i = 0; i < cnt; i++) {
1076 printf("%s (%u/%u) ... ", test->name, i + 1, cnt);
1077
1078 /* Update and read thread accounting
1079 for benchmarking */
1080 ipl_t ipl = interrupts_disable();
1081 spinlock_lock(&TASK->lock);
1082 uint64_t t0 = task_get_accounting(TASK);
1083 spinlock_unlock(&TASK->lock);
1084 interrupts_restore(ipl);
1085
1086 /* Execute the test */
1087 test_quiet = true;
1088 char * ret = test->entry();
1089
1090 /* Update and read thread accounting */
1091 ipl = interrupts_disable();
1092 spinlock_lock(&TASK->lock);
1093 uint64_t dt = task_get_accounting(TASK) - t0;
1094 spinlock_unlock(&TASK->lock);
1095 interrupts_restore(ipl);
1096
1097 if (ret != NULL) {
1098 printf("%s\n", ret);
1099 ret = false;
1100 break;
1101 }
1102
1103 data[i] = dt;
1104 order(dt, &cycles, &suffix);
1105 printf("OK (%" PRIu64 "%c cycles)\n", cycles, suffix);
1106 }
1107
1108 if (ret) {
1109 printf("\n");
1110
1111 uint64_t sum = 0;
1112
1113 for (i = 0; i < cnt; i++) {
1114 sum += data[i];
1115 }
1116
1117 order(sum / (uint64_t) cnt, &cycles, &suffix);
1118 printf("Average\t\t%" PRIu64 "%c\n", cycles, suffix);
1119 }
1120
1121 free(data);
1122
1123 return ret;
1124}
1125
1126/** Command for returning kernel tests
1127 *
1128 * @param argv Argument vector.
1129 *
1130 * return Always 1.
1131 */
1132int cmd_test(cmd_arg_t *argv)
1133{
1134 test_t *test;
1135
1136 if (str_cmp((char *) argv->buffer, "*") == 0) {
1137 for (test = tests; test->name != NULL; test++) {
1138 if (test->safe) {
1139 printf("\n");
1140 if (!run_test(test))
1141 break;
1142 }
1143 }
1144 } else {
1145 bool fnd = false;
1146
1147 for (test = tests; test->name != NULL; test++) {
1148 if (str_cmp(test->name, (char *) argv->buffer) == 0) {
1149 fnd = true;
1150 run_test(test);
1151 break;
1152 }
1153 }
1154
1155 if (!fnd)
1156 printf("Unknown test\n");
1157 }
1158
1159 return 1;
1160}
1161
1162/** Command for returning kernel tests as benchmarks
1163 *
1164 * @param argv Argument vector.
1165 *
1166 * return Always 1.
1167 */
1168int cmd_bench(cmd_arg_t *argv)
1169{
1170 test_t *test;
1171 uint32_t cnt = argv[1].intval;
1172
1173 if (str_cmp((char *) argv->buffer, "*") == 0) {
1174 for (test = tests; test->name != NULL; test++) {
1175 if (test->safe) {
1176 if (!run_bench(test, cnt))
1177 break;
1178 }
1179 }
1180 } else {
1181 bool fnd = false;
1182
1183 for (test = tests; test->name != NULL; test++) {
1184 if (str_cmp(test->name, (char *) argv->buffer) == 0) {
1185 fnd = true;
1186
1187 if (test->safe)
1188 run_bench(test, cnt);
1189 else
1190 printf("Unsafe test\n");
1191
1192 break;
1193 }
1194 }
1195
1196 if (!fnd)
1197 printf("Unknown test\n");
1198 }
1199
1200 return 1;
1201}
1202
1203#endif
1204
1205/** @}
1206 */
Note: See TracBrowser for help on using the repository browser.