drivers/tty/serial/kgdboc.c

   1 // SPDX-License-Identifier: GPL-2.0
   2 /*
   3  * Based on the same principle as kgdboe using the NETPOLL api, this
   4  * driver uses a console polling api to implement a gdb serial inteface
   5  * which is multiplexed on a console port.
   6  *
   7  * Maintainer: Jason Wessel <jason.wessel@windriver.com>
   8  *
   9  * 2007-2008 (c) Jason Wessel - Wind River Systems, Inc.
  10  */
  11 #include <linux/kernel.h>
  12 #include <linux/ctype.h>
  13 #include <linux/kgdb.h>
  14 #include <linux/kdb.h>
  15 #include <linux/tty.h>
  16 #include <linux/console.h>
  17 #include <linux/vt_kern.h>
  18 #include <linux/input.h>
  19 #include <linux/module.h>
  20
  21 #define MAX_CONFIG_LEN          40
  22
  23 static struct kgdb_io           kgdboc_io_ops;
  24
  25 /* -1 = init not run yet, 0 = unconfigured, 1 = configured. */
  26 static int configured           = -1;
  27
  28 static char config[MAX_CONFIG_LEN];
  29 static struct kparam_string kps = {
  30         .string                 = config,
  31         .maxlen                 = MAX_CONFIG_LEN,
  32 };
  33
  34 static int kgdboc_use_kms;  /* 1 if we use kernel mode switching */
  35 static struct tty_driver        *kgdb_tty_driver;
  36 static int                      kgdb_tty_line;
  37
  38 #ifdef CONFIG_KDB_KEYBOARD
  39 static int kgdboc_reset_connect(struct input_handler *handler,
  40                                 struct input_dev *dev,
  41                                 const struct input_device_id *id)
  42 {
  43         input_reset_device(dev);
  44
  45         /* Return an error - we do not want to bind, just to reset */
  46         return -ENODEV;
  47 }
  48
  49 static void kgdboc_reset_disconnect(struct input_handle *handle)
  50 {
  51         /* We do not expect anyone to actually bind to us */
  52         BUG();
  53 }
  54
  55 static const struct input_device_id kgdboc_reset_ids[] = {
  56         {
  57                 .flags = INPUT_DEVICE_ID_MATCH_EVBIT,
  58                 .evbit = { BIT_MASK(EV_KEY) },
  59         },
  60         { }
  61 };
  62
  63 static struct input_handler kgdboc_reset_handler = {
  64         .connect        = kgdboc_reset_connect,
  65         .disconnect     = kgdboc_reset_disconnect,
  66         .name           = "kgdboc_reset",
  67         .id_table       = kgdboc_reset_ids,
  68 };
  69
  70 static DEFINE_MUTEX(kgdboc_reset_mutex);
  71
  72 static void kgdboc_restore_input_helper(struct work_struct *dummy)
  73 {
  74         /*
  75          * We need to take a mutex to prevent several instances of
  76          * this work running on different CPUs so they don't try
  77          * to register again already registered handler.
  78          */
  79         mutex_lock(&kgdboc_reset_mutex);
  80
  81         if (input_register_handler(&kgdboc_reset_handler) == 0)
  82                 input_unregister_handler(&kgdboc_reset_handler);
  83
  84         mutex_unlock(&kgdboc_reset_mutex);
  85 }
  86
  87 static DECLARE_WORK(kgdboc_restore_input_work, kgdboc_restore_input_helper);
  88
  89 static void kgdboc_restore_input(void)
  90 {
  91         if (likely(system_state == SYSTEM_RUNNING))
  92                 schedule_work(&kgdboc_restore_input_work);
  93 }
  94
  95 static int kgdboc_register_kbd(char **cptr)
  96 {
  97         if (strncmp(*cptr, "kbd", 3) == 0 ||
  98                 strncmp(*cptr, "kdb", 3) == 0) {
  99                 if (kdb_poll_idx < KDB_POLL_FUNC_MAX) {
 100                         kdb_poll_funcs[kdb_poll_idx] = kdb_get_kbd_char;
 101                         kdb_poll_idx++;
 102                         if (cptr[0][3] == ',')
 103                                 *cptr += 4;
 104                         else
 105                                 return 1;
 106                 }
 107         }
 108         return 0;
 109 }
 110
 111 static void kgdboc_unregister_kbd(void)
 112 {
 113         int i;
 114
 115         for (i = 0; i < kdb_poll_idx; i++) {
 116                 if (kdb_poll_funcs[i] == kdb_get_kbd_char) {
 117                         kdb_poll_idx--;
 118                         kdb_poll_funcs[i] = kdb_poll_funcs[kdb_poll_idx];
 119                         kdb_poll_funcs[kdb_poll_idx] = NULL;
 120                         i--;
 121                 }
 122         }
 123         flush_work(&kgdboc_restore_input_work);
 124 }
 125 #else /* ! CONFIG_KDB_KEYBOARD */
 126 #define kgdboc_register_kbd(x) 0
 127 #define kgdboc_unregister_kbd()
 128 #define kgdboc_restore_input()
 129 #endif /* ! CONFIG_KDB_KEYBOARD */
 130
 131 static void cleanup_kgdboc(void)
 132 {
 133         if (kgdb_unregister_nmi_console())
 134                 return;
 135         kgdboc_unregister_kbd();
 136         if (configured == 1)
 137                 kgdb_unregister_io_module(&kgdboc_io_ops);
 138 }
 139
 140 static int configure_kgdboc(void)
 141 {
 142         struct tty_driver *p;
 143         int tty_line = 0;
 144         int err = -ENODEV;
 145         char *cptr = config;
 146         struct console *cons;
 147
 148         if (!strlen(config) || isspace(config[0])) {
 149                 err = 0;
 150                 goto noconfig;
 151         }
 152
 153         kgdboc_io_ops.is_console = 0;
 154         kgdb_tty_driver = NULL;
 155
 156         kgdboc_use_kms = 0;
 157         if (strncmp(cptr, "kms,", 4) == 0) {
 158                 cptr += 4;
 159                 kgdboc_use_kms = 1;
 160         }
 161
 162         if (kgdboc_register_kbd(&cptr))
 163                 goto do_register;
 164
 165         p = tty_find_polling_driver(cptr, &tty_line);
 166         if (!p)
 167                 goto noconfig;
 168
 169         cons = console_drivers;
 170         while (cons) {
 171                 int idx;
 172                 if (cons->device && cons->device(cons, &idx) == p &&
 173                     idx == tty_line) {
 174                         kgdboc_io_ops.is_console = 1;
 175                         break;
 176                 }
 177                 cons = cons->next;
 178         }
 179
 180         kgdb_tty_driver = p;
 181         kgdb_tty_line = tty_line;
 182
 183 do_register:
 184         err = kgdb_register_io_module(&kgdboc_io_ops);
 185         if (err)
 186                 goto noconfig;
 187
 188         err = kgdb_register_nmi_console();
 189         if (err)
 190                 goto nmi_con_failed;
 191
 192         configured = 1;
 193
 194         return 0;
 195
 196 nmi_con_failed:
 197         kgdb_unregister_io_module(&kgdboc_io_ops);
 198 noconfig:
 199         kgdboc_unregister_kbd();
 200         config[0] = 0;
 201         configured = 0;
 202         cleanup_kgdboc();
 203
 204         return err;
 205 }
 206
 207 static int __init init_kgdboc(void)
 208 {
 209         /* Already configured? */
 210         if (configured == 1)
 211                 return 0;
 212
 213         return configure_kgdboc();
 214 }
 215
 216 static int kgdboc_get_char(void)
 217 {
 218         if (!kgdb_tty_driver)
 219                 return -1;
 220         return kgdb_tty_driver->ops->poll_get_char(kgdb_tty_driver,
 221                                                 kgdb_tty_line);
 222 }
 223
 224 static void kgdboc_put_char(u8 chr)
 225 {
 226         if (!kgdb_tty_driver)
 227                 return;
 228         kgdb_tty_driver->ops->poll_put_char(kgdb_tty_driver,
 229                                         kgdb_tty_line, chr);
 230 }
 231
 232 static int param_set_kgdboc_var(const char *kmessage,
 233                                 const struct kernel_param *kp)
 234 {
 235         size_t len = strlen(kmessage);
 236
 237         if (len >= MAX_CONFIG_LEN) {
 238                 printk(KERN_ERR "kgdboc: config string too long\n");
 239                 return -ENOSPC;
 240         }
 241
 242         /* Only copy in the string if the init function has not run yet */
 243         if (configured < 0) {
 244                 strcpy(config, kmessage);
 245                 return 0;
 246         }
 247
 248         if (kgdb_connected) {
 249                 printk(KERN_ERR
 250                        "kgdboc: Cannot reconfigure while KGDB is connected.\n");
 251
 252                 return -EBUSY;
 253         }
 254
 255         strcpy(config, kmessage);
 256         /* Chop out \n char as a result of echo */
 257         if (len && config[len - 1] == '\n')
 258                 config[len - 1] = '\0';
 259
 260         if (configured == 1)
 261                 cleanup_kgdboc();
 262
 263         /* Go and configure with the new params. */
 264         return configure_kgdboc();
 265 }
 266
 267 static int dbg_restore_graphics;
 268
 269 static void kgdboc_pre_exp_handler(void)
 270 {
 271         if (!dbg_restore_graphics && kgdboc_use_kms) {
 272                 dbg_restore_graphics = 1;
 273                 con_debug_enter(vc_cons[fg_console].d);
 274         }
 275         /* Increment the module count when the debugger is active */
 276         if (!kgdb_connected)
 277                 try_module_get(THIS_MODULE);
 278 }
 279
 280 static void kgdboc_post_exp_handler(void)
 281 {
 282         /* decrement the module count when the debugger detaches */
 283         if (!kgdb_connected)
 284                 module_put(THIS_MODULE);
 285         if (kgdboc_use_kms && dbg_restore_graphics) {
 286                 dbg_restore_graphics = 0;
 287                 con_debug_leave();
 288         }
 289         kgdboc_restore_input();
 290 }
 291
 292 static struct kgdb_io kgdboc_io_ops = {
 293         .name                   = "kgdboc",
 294         .read_char              = kgdboc_get_char,
 295         .write_char             = kgdboc_put_char,
 296         .pre_exception          = kgdboc_pre_exp_handler,
 297         .post_exception         = kgdboc_post_exp_handler,
 298 };
 299
 300 #ifdef CONFIG_KGDB_SERIAL_CONSOLE
 301 static int kgdboc_option_setup(char *opt)
 302 {
 303         if (!opt) {
 304                 pr_err("config string not provided\n");
 305                 return -EINVAL;
 306         }
 307
 308         if (strlen(opt) >= MAX_CONFIG_LEN) {
 309                 pr_err("config string too long\n");
 310                 return -ENOSPC;
 311         }
 312         strcpy(config, opt);
 313
 314         return 0;
 315 }
 316
 317 __setup("kgdboc=", kgdboc_option_setup);
 318
 319
 320 /* This is only available if kgdboc is a built in for early debugging */
 321 static int __init kgdboc_early_init(char *opt)
 322 {
 323         /* save the first character of the config string because the
 324          * init routine can destroy it.
 325          */
 326         char save_ch;
 327
 328         kgdboc_option_setup(opt);
 329         save_ch = config[0];
 330         init_kgdboc();
 331         config[0] = save_ch;
 332         return 0;
 333 }
 334
 335 early_param("ekgdboc", kgdboc_early_init);
 336 #endif /* CONFIG_KGDB_SERIAL_CONSOLE */
 337
 338 module_init(init_kgdboc);
 339 module_exit(cleanup_kgdboc);
 340 module_param_call(kgdboc, param_set_kgdboc_var, param_get_string, &kps, 0644);
 341 MODULE_PARM_DESC(kgdboc, "<serial_device>[,baud]");
 342 MODULE_DESCRIPTION("KGDB Console TTY Driver");
 343 MODULE_LICENSE("GPL");