Subversion Repositories HelenOS

Rev

Rev 4380 | Blame | Compare with Previous | Last modification | View Log | Download | RSS feed

  1. /*
  2.  * Copyright (c) 2008 Jiri Svoboda
  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 debug
  30.  * @{
  31.  */
  32. /** @file
  33.  */
  34.  
  35. #include <stdio.h>
  36. #include <stdlib.h>
  37. #include <unistd.h>
  38. #include <libarch/syscall.h>
  39. #include <ipc/ipc.h>
  40. #include <fibril.h>
  41. #include <loader/loader.h>
  42. #include <errno.h>
  43. #include <udebug.h>
  44. #include <async.h>
  45. #include <string.h>
  46.  
  47. #include "cmd.h"
  48. #include "cons.h"
  49. #include "dthread.h"
  50. #include "breakpoint.h"
  51. #include "include/arch.h"
  52. #include "main.h"
  53.  
  54. void thread_debug_start(thash_t thread_hash);
  55.  
  56. #define IN_BUF_SIZE 64
  57. static char in_buf[IN_BUF_SIZE];
  58.  
  59. #define MAX_ARGC 10
  60. int cmd_argc;
  61. char *cmd_argv[MAX_ARGC + 1];   /* need one spare field for cmd_split() */
  62.  
  63.  
  64. int next_thread_id;
  65.  
  66. int app_phone;
  67. volatile bool abort_debug;
  68.  
  69. volatile int paused;
  70.  
  71. static task_id_t task_id;
  72. static loader_t *task_ldr;
  73.  
  74. static int program_run_fibril(void *arg);
  75.  
  76. static void program_run(void)
  77. {
  78.     fid_t fid;
  79.  
  80.     fid = fibril_create(program_run_fibril, NULL);
  81.     if (fid == 0) {
  82.         printf("Error creating fibril\n");
  83.         exit(1);
  84.     }
  85.  
  86.     fibril_add_ready(fid);
  87. }
  88.  
  89. static int program_run_fibril(void *arg)
  90. {
  91.     int rc;
  92.  
  93.     /*
  94.      * This must be done in background as it will block until
  95.      * we let the task reply to this call.
  96.      */
  97.     rc = loader_run(task_ldr);
  98.     if (rc != 0) {
  99.         printf("Error running program\n");
  100.         exit(1);
  101.     }
  102.  
  103.     free(task_ldr);
  104.     task_ldr = NULL;
  105.  
  106.     return 0;
  107. }
  108.  
  109. static loader_t *preload_task(const char *path, char *const argv[],
  110.     task_id_t *task_id)
  111. {
  112.     loader_t *ldr;
  113.     int rc;
  114.  
  115.     /* Spawn a program loader */   
  116.     ldr = loader_connect();
  117.     if (ldr == NULL)
  118.         return 0;
  119.  
  120.     /* Get task ID. */
  121.     rc = loader_get_task_id(ldr, task_id);
  122.     if (rc != EOK)
  123.         goto error;
  124.  
  125.     /* Send program pathname */
  126.     rc = loader_set_pathname(ldr, path);
  127.     if (rc != EOK)
  128.         goto error;
  129.  
  130.     /* Send arguments */
  131.     rc = loader_set_args(ldr, argv);
  132.     if (rc != EOK)
  133.         goto error;
  134.  
  135.     /* Load the program. */
  136.     rc = loader_load_program(ldr);
  137.     if (rc != EOK)
  138.         goto error;
  139.  
  140.     /* Success */
  141.     return ldr;
  142.  
  143.     /* Error exit */
  144. error:
  145.     loader_abort(ldr);
  146.     free(ldr);
  147.     return NULL;
  148. }
  149.  
  150.  
  151. static void command_split(char *cmd_str)
  152. {
  153.     char *p = cmd_str;
  154.  
  155.     if (*p == '\0') {
  156.         cmd_argc = 0;
  157.         return;
  158.     }
  159.  
  160.     cmd_argc = 1;
  161.     cmd_argv[0] = p;
  162.  
  163.     while (*p != '\0') {
  164.         if (*p == ' ') {
  165.             cmd_argv[cmd_argc++] = p + 1;
  166.             *p = '\0';
  167.         }
  168.         ++p;
  169.     }
  170. }
  171.  
  172. static void command_run(void)
  173. {
  174.     int i;
  175.     int cmp_len;
  176.     int len;
  177.  
  178.     int idx_found;
  179.     int num_found;
  180.  
  181.     len = str_length(cmd_argv[0]);
  182.     cmp_len = 1;
  183.  
  184.     /* Silence warnings */
  185.     num_found = 0;
  186.     idx_found = 0;
  187.  
  188.     while (cmp_len <= len + 1) {
  189.  
  190.         num_found = 0;
  191.         i = 0;
  192.         while (cmd_table[i].name != NULL) {
  193.             if (str_lcmp(cmd_table[i].name, cmd_argv[0], cmp_len) == 0) {
  194.                 idx_found = i;
  195.                 ++num_found;
  196.             }
  197.             ++i;
  198.         }
  199.  
  200.         if (num_found < 2) break;
  201.  
  202.         ++cmp_len;
  203.     }
  204.  
  205.     if (num_found == 0) {
  206.         cons_printf("Unknown command. Try one of:\n");
  207.         cmd_help(0, NULL);
  208.         return;
  209.     }
  210.  
  211.     if (cmd_argc - 1 != cmd_table[idx_found].argc) {
  212.         cons_printf("Command '%s' expects %d arguments\n",
  213.         cmd_table[idx_found].name, cmd_table[idx_found].argc);
  214.         return;
  215.     }
  216.  
  217.     (*cmd_table[idx_found].proc)(cmd_argc, cmd_argv);
  218. }
  219.  
  220. static void thread_stop(void)
  221. {
  222.     dthread_t *dt;
  223.     uintptr_t pc;
  224.  
  225.     dt = dthread_get();
  226.     pc = dthread_get_pc(dt);
  227.     cons_printf("[thread %d] stopped at 0x%lx\n", dt->id, pc);
  228.     dthread_stop_me();
  229.     cons_printf("[thread %d] go\n", dt->id);
  230. }
  231.  
  232. /*
  233.  * Called by a fibril (from arch code) when a breakpoint is hit.
  234.  */
  235. void breakpoint_hit(breakpoint_t *b)
  236. {
  237.     dthread_t *dt;
  238.  
  239.     dt = dthread_get();
  240.     cons_printf("Thread %d hit breakpoint %d at 0x%lx\n",
  241.         dt->id, b->id, b->addr);
  242.     thread_stop();
  243. }
  244.  
  245. /*
  246.  * Called by a fibril (from arch code) when a single instruction
  247.  * in singlestep is executed
  248.  */
  249. void singlestep_hit(void)
  250. {
  251.     cons_printf("singlestep hit\n");
  252.     thread_stop();
  253. }
  254.  
  255. static int connect_task(task_id_t task_id)
  256. {
  257.     int rc;
  258.     unsigned evmask;
  259.  
  260.     cons_printf("ipc_connect_kbox(%;;d)... ", task_id);
  261.     rc = ipc_connect_kbox(task_id);
  262.     cons_printf("-> %d\n", rc);
  263.     app_phone = rc;
  264.     if (rc < 0) return rc;
  265.  
  266.     cons_printf("udebug_begin()... ");
  267.     rc = udebug_begin(app_phone);
  268.     cons_printf("-> %d\n", rc);
  269.     if (rc < 0) return rc;
  270.  
  271.     evmask = UDEBUG_EM_ALL & ~(UDEBUG_EM_SYSCALL_B | UDEBUG_EM_SYSCALL_E);
  272.     cons_printf("udebug_set_evmask(0x%x)... ", evmask);
  273.     rc = udebug_set_evmask(app_phone, evmask);
  274.     cons_printf("-> %d\n", rc);
  275.     if (rc < 0) return rc;
  276.  
  277.     return 0;
  278. }
  279.  
  280. #define THASH_BUF_INIT_LENGTH 32
  281.  
  282. static int get_thread_list(thash_t **thash_buf_ptr, int *n)
  283. {
  284.     int rc;
  285.     size_t tb_copied;
  286.     size_t tb_needed;
  287.     int i;
  288.     size_t tb_size;
  289.     thash_t *thash_buf;
  290.  
  291.     tb_size = THASH_BUF_INIT_LENGTH * sizeof(thash_t);
  292.     thash_buf = malloc(tb_size);
  293.  
  294.     rc = udebug_thread_read(app_phone, thash_buf,
  295.         tb_size, &tb_copied, &tb_needed);
  296.     if (rc < 0) return rc;
  297.  
  298.     if (tb_needed > tb_size) {
  299.         /* Larger buffer needed  */
  300.  
  301.         free(thash_buf);
  302.  
  303.         tb_size = tb_needed;
  304.         thash_buf = malloc(tb_size);
  305.  
  306.         if (!thash_buf) {
  307.             printf("malloc failed\n");
  308.             exit(1);
  309.         }
  310.  
  311.         /* Try again */
  312.        
  313.         rc = udebug_thread_read(app_phone, thash_buf,
  314.             tb_size, &tb_copied, &tb_needed);
  315.  
  316.         if (rc < 0) return rc;
  317.     }
  318.  
  319.     *n = tb_copied / sizeof(thash_t);
  320.  
  321.     cons_printf("thread hashes:");
  322.  
  323.     for (i = 0; i < *n; ++i) {
  324.         cons_printf("0x%lx\n", thash_buf[i]);
  325.     }
  326.  
  327.     cons_printf("Total of %u threads\n", *n);
  328.  
  329.     *thash_buf_ptr = thash_buf;
  330.  
  331.     return 0;
  332. }
  333.  
  334. static void event_thread_b(thash_t hash)
  335. {
  336.     async_serialize_start();
  337.     cons_printf("new thread, hash 0x%lx\n", hash);
  338.     async_serialize_end();
  339.  
  340.     thread_debug_start(hash);
  341. }
  342.  
  343. static void debug_event(thash_t thash, udebug_event_t ev_type, sysarg_t val0)
  344. {
  345.     switch (ev_type) {
  346.     case UDEBUG_EVENT_STOP:
  347.         cons_printf("stop event\n");
  348.         thread_stop();
  349.         break;
  350.     case UDEBUG_EVENT_THREAD_B:
  351.         event_thread_b(val0);
  352.         break;
  353.     case UDEBUG_EVENT_THREAD_E:
  354.         cons_printf("thread 0x%x exited\n", val0);
  355.         abort_debug = true;
  356.         break;
  357.     case UDEBUG_EVENT_BREAKPOINT:
  358.         arch_event_breakpoint(thash);
  359.         break;
  360.     case UDEBUG_EVENT_TRAP:
  361.         arch_event_trap(dthread_get());
  362.         break;
  363.     default:
  364.         cons_printf("unknown event type %d\n", ev_type);
  365.         break;
  366.     }
  367. }
  368.  
  369. static int debug_loop(void *dt_arg)
  370. {
  371.     int rc;
  372.     udebug_event_t ev_type;
  373.     sysarg_t val0, val1;
  374.     dthread_t *dt;
  375.  
  376.     dt = (dthread_t *)dt_arg;
  377.  
  378.     cons_printf("debug_loop(%d)\n", dt->id);
  379.  
  380.     while (!abort_debug) {
  381.         /* Run thread until an event occurs */
  382.         rc = udebug_go(app_phone, dt->hash, &ev_type, &val0, &val1);
  383.         if (rc < 0) {
  384.             cons_printf("Failed resuming thread (%d).\n", rc);
  385.             return rc;
  386.         }
  387.  
  388.         if (ev_type == UDEBUG_EVENT_FINISHED) {
  389.             cons_printf("thread %u debugging finished\n", dt->id);
  390.             break;
  391.         }
  392.         debug_event(dt->hash, ev_type, val0);
  393.     }
  394.  
  395.     cons_printf("debug_loop(%d) exiting\n", dt->id);
  396.     return 0;
  397. }
  398.  
  399. void thread_debug_start(thash_t thash)
  400. {
  401.     fid_t fid;
  402.     dthread_t *dt;
  403.  
  404.     dt = dthread_new(thash);
  405.  
  406.     fid = fibril_create(debug_loop, (void *)dt);
  407.     if (fid == 0) {
  408.         cons_printf("Warning: Failed creating fibril\n");
  409.     }
  410.     dt->fid = fid;
  411.  
  412.     fibril_add_ready(fid);
  413. }
  414.  
  415. static void debug_task(task_id_t task_id)
  416. {
  417.     int i;
  418.     int rc;
  419.  
  420.     thash_t *thash_buffer;
  421.     int n_threads;
  422.  
  423.     rc = get_thread_list(&thash_buffer, &n_threads);
  424.     if (rc < 0) {
  425.         cons_printf("Failed to get thread list\n", rc);
  426.         return;
  427.     }
  428.  
  429.     abort_debug = false;
  430.  
  431.     for (i = 0; i < n_threads; i++) {
  432.         thread_debug_start(thash_buffer[i]);
  433.     }
  434.  
  435.     while (!quit) {
  436.         cons_read_line(in_buf, IN_BUF_SIZE);
  437.         command_split(in_buf);
  438.         if (cmd_argc == 0) continue;
  439.  
  440.         command_run();
  441.     }
  442.  
  443.     cons_printf("terminate debugging session...\n");
  444.     abort_debug = true;
  445.     udebug_end(app_phone);
  446.     ipc_hangup(app_phone);
  447.  
  448.     cons_printf("done\n");
  449.     return;
  450. }
  451.  
  452. static void main_init(void)
  453. {
  454.     next_thread_id = 1;
  455.     paused = 0;
  456.    
  457.     list_initialize(&dthreads);
  458.     breakpoint_init();
  459.     cwt = NULL;
  460. }
  461.  
  462. static void print_syntax()
  463. {
  464.     printf("Syntax:\n");
  465.     printf("\tdebug <executable> [<arg1> [...]]\n");
  466.     printf("or\tdebug -t <task_id>\n");
  467. }
  468.  
  469. static int parse_args(int argc, char *argv[])
  470. {
  471.     char *arg;
  472.     char *err_p;
  473.  
  474.     task_id = 0;
  475.  
  476.     --argc; ++argv;
  477.  
  478.     while (argc > 0) {
  479.         arg = *argv;
  480.         if (arg[0] == '-') {
  481.             if (arg[1] == 't') {
  482.                 /* Trace an already running task */
  483.                 --argc; ++argv;
  484.                 task_id = strtol(*argv, &err_p, 10);
  485.                 task_ldr = NULL;
  486.                 if (*err_p) {
  487.                     printf("Task ID syntax error\n");
  488.                     print_syntax();
  489.                     return -1;
  490.                 }
  491.             } else {
  492.                 printf("Uknown option '%s'\n", arg[0]);
  493.                 print_syntax();
  494.                 return -1;
  495.             }
  496.         } else {
  497.             break;
  498.         }
  499.  
  500.         --argc; ++argv;
  501.     }
  502.  
  503.     if (task_id != 0) {
  504.         if (argc == 0) return 0;
  505.         printf("Extra arguments\n");
  506.         print_syntax();
  507.         return -1;
  508.     }
  509.  
  510.     if (argc < 1) {
  511.         printf("Missing argument\n");
  512.         print_syntax();
  513.         return -1;
  514.     }
  515.  
  516.     /* Preload the specified program file. */
  517.     printf("Spawning '%s' with arguments:\n", *argv);
  518.     {
  519.         char **cp = argv;
  520.         while (*cp) printf("'%s'\n", *cp++);
  521.     }
  522.     task_ldr = preload_task(*argv, argv, &task_id);
  523.  
  524.     return 0;
  525. }
  526.  
  527. int main(int argc, char *argv[])
  528. {
  529.     int rc;
  530.  
  531.     cons_printf("Breakpoint Debugger\n");
  532.  
  533.     main_init();
  534.  
  535.     if (parse_args(argc, argv) < 0)
  536.         return 1;
  537.  
  538.     rc = connect_task(task_id);
  539.     if (rc < 0) {
  540.         printf("Failed connecting to task %lld\n", task_id);
  541.         return 1;
  542.     }
  543.  
  544.     cons_printf("Connected to task %lld\n", task_id);
  545.  
  546.     if (task_ldr != NULL) {
  547.         program_run();
  548.     }
  549.  
  550.     debug_task(task_id);
  551.  
  552.     return 0;
  553. }
  554.  
  555. /** @}
  556.  */
  557.