kgdbts.c 31 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190
  1. /*
  2. * kgdbts is a test suite for kgdb for the sole purpose of validating
  3. * that key pieces of the kgdb internals are working properly such as
  4. * HW/SW breakpoints, single stepping, and NMI.
  5. *
  6. * Created by: Jason Wessel <jason.wessel@windriver.com>
  7. *
  8. * Copyright (c) 2008 Wind River Systems, Inc.
  9. *
  10. * This program is free software; you can redistribute it and/or modify
  11. * it under the terms of the GNU General Public License version 2 as
  12. * published by the Free Software Foundation.
  13. *
  14. * This program is distributed in the hope that it will be useful,
  15. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  17. * See the GNU General Public License for more details.
  18. *
  19. * You should have received a copy of the GNU General Public License
  20. * along with this program; if not, write to the Free Software
  21. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  22. */
  23. /* Information about the kgdb test suite.
  24. * -------------------------------------
  25. *
  26. * The kgdb test suite is designed as a KGDB I/O module which
  27. * simulates the communications that a debugger would have with kgdb.
  28. * The tests are broken up in to a line by line and referenced here as
  29. * a "get" which is kgdb requesting input and "put" which is kgdb
  30. * sending a response.
  31. *
  32. * The kgdb suite can be invoked from the kernel command line
  33. * arguments system or executed dynamically at run time. The test
  34. * suite uses the variable "kgdbts" to obtain the information about
  35. * which tests to run and to configure the verbosity level. The
  36. * following are the various characters you can use with the kgdbts=
  37. * line:
  38. *
  39. * When using the "kgdbts=" you only choose one of the following core
  40. * test types:
  41. * A = Run all the core tests silently
  42. * V1 = Run all the core tests with minimal output
  43. * V2 = Run all the core tests in debug mode
  44. *
  45. * You can also specify optional tests:
  46. * N## = Go to sleep with interrupts of for ## seconds
  47. * to test the HW NMI watchdog
  48. * F## = Break at do_fork for ## iterations
  49. * S## = Break at sys_open for ## iterations
  50. * I## = Run the single step test ## iterations
  51. *
  52. * NOTE: that the do_fork and sys_open tests are mutually exclusive.
  53. *
  54. * To invoke the kgdb test suite from boot you use a kernel start
  55. * argument as follows:
  56. * kgdbts=V1 kgdbwait
  57. * Or if you wanted to perform the NMI test for 6 seconds and do_fork
  58. * test for 100 forks, you could use:
  59. * kgdbts=V1N6F100 kgdbwait
  60. *
  61. * The test suite can also be invoked at run time with:
  62. * echo kgdbts=V1N6F100 > /sys/module/kgdbts/parameters/kgdbts
  63. * Or as another example:
  64. * echo kgdbts=V2 > /sys/module/kgdbts/parameters/kgdbts
  65. *
  66. * When developing a new kgdb arch specific implementation or
  67. * using these tests for the purpose of regression testing,
  68. * several invocations are required.
  69. *
  70. * 1) Boot with the test suite enabled by using the kernel arguments
  71. * "kgdbts=V1F100 kgdbwait"
  72. * ## If kgdb arch specific implementation has NMI use
  73. * "kgdbts=V1N6F100
  74. *
  75. * 2) After the system boot run the basic test.
  76. * echo kgdbts=V1 > /sys/module/kgdbts/parameters/kgdbts
  77. *
  78. * 3) Run the concurrency tests. It is best to use n+1
  79. * while loops where n is the number of cpus you have
  80. * in your system. The example below uses only two
  81. * loops.
  82. *
  83. * ## This tests break points on sys_open
  84. * while [ 1 ] ; do find / > /dev/null 2>&1 ; done &
  85. * while [ 1 ] ; do find / > /dev/null 2>&1 ; done &
  86. * echo kgdbts=V1S10000 > /sys/module/kgdbts/parameters/kgdbts
  87. * fg # and hit control-c
  88. * fg # and hit control-c
  89. * ## This tests break points on do_fork
  90. * while [ 1 ] ; do date > /dev/null ; done &
  91. * while [ 1 ] ; do date > /dev/null ; done &
  92. * echo kgdbts=V1F1000 > /sys/module/kgdbts/parameters/kgdbts
  93. * fg # and hit control-c
  94. *
  95. */
  96. #include <linux/kernel.h>
  97. #include <linux/kgdb.h>
  98. #include <linux/ctype.h>
  99. #include <linux/uaccess.h>
  100. #include <linux/syscalls.h>
  101. #include <linux/nmi.h>
  102. #include <linux/delay.h>
  103. #include <linux/kthread.h>
  104. #include <linux/module.h>
  105. #include <linux/sched/task.h>
  106. #include <asm/sections.h>
  107. #define v1printk(a...) do { \
  108. if (verbose) \
  109. printk(KERN_INFO a); \
  110. } while (0)
  111. #define v2printk(a...) do { \
  112. if (verbose > 1) { \
  113. printk(KERN_INFO a); \
  114. } \
  115. touch_nmi_watchdog(); \
  116. } while (0)
  117. #define eprintk(a...) do { \
  118. printk(KERN_ERR a); \
  119. WARN_ON(1); \
  120. } while (0)
  121. #define MAX_CONFIG_LEN 40
  122. static struct kgdb_io kgdbts_io_ops;
  123. static char get_buf[BUFMAX];
  124. static int get_buf_cnt;
  125. static char put_buf[BUFMAX];
  126. static int put_buf_cnt;
  127. static char scratch_buf[BUFMAX];
  128. static int verbose;
  129. static int repeat_test;
  130. static int test_complete;
  131. static int send_ack;
  132. static int final_ack;
  133. static int force_hwbrks;
  134. static int hwbreaks_ok;
  135. static int hw_break_val;
  136. static int hw_break_val2;
  137. static int cont_instead_of_sstep;
  138. static unsigned long cont_thread_id;
  139. static unsigned long sstep_thread_id;
  140. #if defined(CONFIG_ARM) || defined(CONFIG_MIPS) || defined(CONFIG_SPARC)
  141. static int arch_needs_sstep_emulation = 1;
  142. #else
  143. static int arch_needs_sstep_emulation;
  144. #endif
  145. static unsigned long cont_addr;
  146. static unsigned long sstep_addr;
  147. static int restart_from_top_after_write;
  148. static int sstep_state;
  149. /* Storage for the registers, in GDB format. */
  150. static unsigned long kgdbts_gdb_regs[(NUMREGBYTES +
  151. sizeof(unsigned long) - 1) /
  152. sizeof(unsigned long)];
  153. static struct pt_regs kgdbts_regs;
  154. /* -1 = init not run yet, 0 = unconfigured, 1 = configured. */
  155. static int configured = -1;
  156. #ifdef CONFIG_KGDB_TESTS_BOOT_STRING
  157. static char config[MAX_CONFIG_LEN] = CONFIG_KGDB_TESTS_BOOT_STRING;
  158. #else
  159. static char config[MAX_CONFIG_LEN];
  160. #endif
  161. static struct kparam_string kps = {
  162. .string = config,
  163. .maxlen = MAX_CONFIG_LEN,
  164. };
  165. static void fill_get_buf(char *buf);
  166. struct test_struct {
  167. char *get;
  168. char *put;
  169. void (*get_handler)(char *);
  170. int (*put_handler)(char *, char *);
  171. };
  172. struct test_state {
  173. char *name;
  174. struct test_struct *tst;
  175. int idx;
  176. int (*run_test) (int, int);
  177. int (*validate_put) (char *);
  178. };
  179. static struct test_state ts;
  180. static int kgdbts_unreg_thread(void *ptr)
  181. {
  182. /* Wait until the tests are complete and then ungresiter the I/O
  183. * driver.
  184. */
  185. while (!final_ack)
  186. msleep_interruptible(1500);
  187. /* Pause for any other threads to exit after final ack. */
  188. msleep_interruptible(1000);
  189. if (configured)
  190. kgdb_unregister_io_module(&kgdbts_io_ops);
  191. configured = 0;
  192. return 0;
  193. }
  194. /* This is noinline such that it can be used for a single location to
  195. * place a breakpoint
  196. */
  197. static noinline void kgdbts_break_test(void)
  198. {
  199. v2printk("kgdbts: breakpoint complete\n");
  200. }
  201. /* Lookup symbol info in the kernel */
  202. static unsigned long lookup_addr(char *arg)
  203. {
  204. unsigned long addr = 0;
  205. if (!strcmp(arg, "kgdbts_break_test"))
  206. addr = (unsigned long)kgdbts_break_test;
  207. else if (!strcmp(arg, "sys_open"))
  208. addr = (unsigned long)do_sys_open;
  209. else if (!strcmp(arg, "do_fork"))
  210. addr = (unsigned long)_do_fork;
  211. else if (!strcmp(arg, "hw_break_val"))
  212. addr = (unsigned long)&hw_break_val;
  213. addr = (unsigned long) dereference_function_descriptor((void *)addr);
  214. return addr;
  215. }
  216. static void break_helper(char *bp_type, char *arg, unsigned long vaddr)
  217. {
  218. unsigned long addr;
  219. if (arg)
  220. addr = lookup_addr(arg);
  221. else
  222. addr = vaddr;
  223. sprintf(scratch_buf, "%s,%lx,%i", bp_type, addr,
  224. BREAK_INSTR_SIZE);
  225. fill_get_buf(scratch_buf);
  226. }
  227. static void sw_break(char *arg)
  228. {
  229. break_helper(force_hwbrks ? "Z1" : "Z0", arg, 0);
  230. }
  231. static void sw_rem_break(char *arg)
  232. {
  233. break_helper(force_hwbrks ? "z1" : "z0", arg, 0);
  234. }
  235. static void hw_break(char *arg)
  236. {
  237. break_helper("Z1", arg, 0);
  238. }
  239. static void hw_rem_break(char *arg)
  240. {
  241. break_helper("z1", arg, 0);
  242. }
  243. static void hw_write_break(char *arg)
  244. {
  245. break_helper("Z2", arg, 0);
  246. }
  247. static void hw_rem_write_break(char *arg)
  248. {
  249. break_helper("z2", arg, 0);
  250. }
  251. static void hw_access_break(char *arg)
  252. {
  253. break_helper("Z4", arg, 0);
  254. }
  255. static void hw_rem_access_break(char *arg)
  256. {
  257. break_helper("z4", arg, 0);
  258. }
  259. static void hw_break_val_access(void)
  260. {
  261. hw_break_val2 = hw_break_val;
  262. }
  263. static void hw_break_val_write(void)
  264. {
  265. hw_break_val++;
  266. }
  267. static int get_thread_id_continue(char *put_str, char *arg)
  268. {
  269. char *ptr = &put_str[11];
  270. if (put_str[1] != 'T' || put_str[2] != '0')
  271. return 1;
  272. kgdb_hex2long(&ptr, &cont_thread_id);
  273. return 0;
  274. }
  275. static int check_and_rewind_pc(char *put_str, char *arg)
  276. {
  277. unsigned long addr = lookup_addr(arg);
  278. unsigned long ip;
  279. int offset = 0;
  280. kgdb_hex2mem(&put_str[1], (char *)kgdbts_gdb_regs,
  281. NUMREGBYTES);
  282. gdb_regs_to_pt_regs(kgdbts_gdb_regs, &kgdbts_regs);
  283. ip = instruction_pointer(&kgdbts_regs);
  284. v2printk("Stopped at IP: %lx\n", ip);
  285. #ifdef GDB_ADJUSTS_BREAK_OFFSET
  286. /* On some arches, a breakpoint stop requires it to be decremented */
  287. if (addr + BREAK_INSTR_SIZE == ip)
  288. offset = -BREAK_INSTR_SIZE;
  289. #endif
  290. if (arch_needs_sstep_emulation && sstep_addr &&
  291. ip + offset == sstep_addr &&
  292. ((!strcmp(arg, "sys_open") || !strcmp(arg, "do_fork")))) {
  293. /* This is special case for emulated single step */
  294. v2printk("Emul: rewind hit single step bp\n");
  295. restart_from_top_after_write = 1;
  296. } else if (strcmp(arg, "silent") && ip + offset != addr) {
  297. eprintk("kgdbts: BP mismatch %lx expected %lx\n",
  298. ip + offset, addr);
  299. return 1;
  300. }
  301. /* Readjust the instruction pointer if needed */
  302. ip += offset;
  303. cont_addr = ip;
  304. #ifdef GDB_ADJUSTS_BREAK_OFFSET
  305. instruction_pointer_set(&kgdbts_regs, ip);
  306. #endif
  307. return 0;
  308. }
  309. static int check_single_step(char *put_str, char *arg)
  310. {
  311. unsigned long addr = lookup_addr(arg);
  312. static int matched_id;
  313. /*
  314. * From an arch indepent point of view the instruction pointer
  315. * should be on a different instruction
  316. */
  317. kgdb_hex2mem(&put_str[1], (char *)kgdbts_gdb_regs,
  318. NUMREGBYTES);
  319. gdb_regs_to_pt_regs(kgdbts_gdb_regs, &kgdbts_regs);
  320. v2printk("Singlestep stopped at IP: %lx\n",
  321. instruction_pointer(&kgdbts_regs));
  322. if (sstep_thread_id != cont_thread_id) {
  323. /*
  324. * Ensure we stopped in the same thread id as before, else the
  325. * debugger should continue until the original thread that was
  326. * single stepped is scheduled again, emulating gdb's behavior.
  327. */
  328. v2printk("ThrID does not match: %lx\n", cont_thread_id);
  329. if (arch_needs_sstep_emulation) {
  330. if (matched_id &&
  331. instruction_pointer(&kgdbts_regs) != addr)
  332. goto continue_test;
  333. matched_id++;
  334. ts.idx -= 2;
  335. sstep_state = 0;
  336. return 0;
  337. }
  338. cont_instead_of_sstep = 1;
  339. ts.idx -= 4;
  340. return 0;
  341. }
  342. continue_test:
  343. matched_id = 0;
  344. if (instruction_pointer(&kgdbts_regs) == addr) {
  345. eprintk("kgdbts: SingleStep failed at %lx\n",
  346. instruction_pointer(&kgdbts_regs));
  347. return 1;
  348. }
  349. return 0;
  350. }
  351. static void write_regs(char *arg)
  352. {
  353. memset(scratch_buf, 0, sizeof(scratch_buf));
  354. scratch_buf[0] = 'G';
  355. pt_regs_to_gdb_regs(kgdbts_gdb_regs, &kgdbts_regs);
  356. kgdb_mem2hex((char *)kgdbts_gdb_regs, &scratch_buf[1], NUMREGBYTES);
  357. fill_get_buf(scratch_buf);
  358. }
  359. static void skip_back_repeat_test(char *arg)
  360. {
  361. int go_back = simple_strtol(arg, NULL, 10);
  362. repeat_test--;
  363. if (repeat_test <= 0)
  364. ts.idx++;
  365. else
  366. ts.idx -= go_back;
  367. fill_get_buf(ts.tst[ts.idx].get);
  368. }
  369. static int got_break(char *put_str, char *arg)
  370. {
  371. test_complete = 1;
  372. if (!strncmp(put_str+1, arg, 2)) {
  373. if (!strncmp(arg, "T0", 2))
  374. test_complete = 2;
  375. return 0;
  376. }
  377. return 1;
  378. }
  379. static void get_cont_catch(char *arg)
  380. {
  381. /* Always send detach because the test is completed at this point */
  382. fill_get_buf("D");
  383. }
  384. static int put_cont_catch(char *put_str, char *arg)
  385. {
  386. /* This is at the end of the test and we catch any and all input */
  387. v2printk("kgdbts: cleanup task: %lx\n", sstep_thread_id);
  388. ts.idx--;
  389. return 0;
  390. }
  391. static int emul_reset(char *put_str, char *arg)
  392. {
  393. if (strncmp(put_str, "$OK", 3))
  394. return 1;
  395. if (restart_from_top_after_write) {
  396. restart_from_top_after_write = 0;
  397. ts.idx = -1;
  398. }
  399. return 0;
  400. }
  401. static void emul_sstep_get(char *arg)
  402. {
  403. if (!arch_needs_sstep_emulation) {
  404. if (cont_instead_of_sstep) {
  405. cont_instead_of_sstep = 0;
  406. fill_get_buf("c");
  407. } else {
  408. fill_get_buf(arg);
  409. }
  410. return;
  411. }
  412. switch (sstep_state) {
  413. case 0:
  414. v2printk("Emulate single step\n");
  415. /* Start by looking at the current PC */
  416. fill_get_buf("g");
  417. break;
  418. case 1:
  419. /* set breakpoint */
  420. break_helper("Z0", NULL, sstep_addr);
  421. break;
  422. case 2:
  423. /* Continue */
  424. fill_get_buf("c");
  425. break;
  426. case 3:
  427. /* Clear breakpoint */
  428. break_helper("z0", NULL, sstep_addr);
  429. break;
  430. default:
  431. eprintk("kgdbts: ERROR failed sstep get emulation\n");
  432. }
  433. sstep_state++;
  434. }
  435. static int emul_sstep_put(char *put_str, char *arg)
  436. {
  437. if (!arch_needs_sstep_emulation) {
  438. char *ptr = &put_str[11];
  439. if (put_str[1] != 'T' || put_str[2] != '0')
  440. return 1;
  441. kgdb_hex2long(&ptr, &sstep_thread_id);
  442. return 0;
  443. }
  444. switch (sstep_state) {
  445. case 1:
  446. /* validate the "g" packet to get the IP */
  447. kgdb_hex2mem(&put_str[1], (char *)kgdbts_gdb_regs,
  448. NUMREGBYTES);
  449. gdb_regs_to_pt_regs(kgdbts_gdb_regs, &kgdbts_regs);
  450. v2printk("Stopped at IP: %lx\n",
  451. instruction_pointer(&kgdbts_regs));
  452. /* Want to stop at IP + break instruction size by default */
  453. sstep_addr = cont_addr + BREAK_INSTR_SIZE;
  454. break;
  455. case 2:
  456. if (strncmp(put_str, "$OK", 3)) {
  457. eprintk("kgdbts: failed sstep break set\n");
  458. return 1;
  459. }
  460. break;
  461. case 3:
  462. if (strncmp(put_str, "$T0", 3)) {
  463. eprintk("kgdbts: failed continue sstep\n");
  464. return 1;
  465. } else {
  466. char *ptr = &put_str[11];
  467. kgdb_hex2long(&ptr, &sstep_thread_id);
  468. }
  469. break;
  470. case 4:
  471. if (strncmp(put_str, "$OK", 3)) {
  472. eprintk("kgdbts: failed sstep break unset\n");
  473. return 1;
  474. }
  475. /* Single step is complete so continue on! */
  476. sstep_state = 0;
  477. return 0;
  478. default:
  479. eprintk("kgdbts: ERROR failed sstep put emulation\n");
  480. }
  481. /* Continue on the same test line until emulation is complete */
  482. ts.idx--;
  483. return 0;
  484. }
  485. static int final_ack_set(char *put_str, char *arg)
  486. {
  487. if (strncmp(put_str+1, arg, 2))
  488. return 1;
  489. final_ack = 1;
  490. return 0;
  491. }
  492. /*
  493. * Test to plant a breakpoint and detach, which should clear out the
  494. * breakpoint and restore the original instruction.
  495. */
  496. static struct test_struct plant_and_detach_test[] = {
  497. { "?", "S0*" }, /* Clear break points */
  498. { "kgdbts_break_test", "OK", sw_break, }, /* set sw breakpoint */
  499. { "D", "OK" }, /* Detach */
  500. { "", "" },
  501. };
  502. /*
  503. * Simple test to write in a software breakpoint, check for the
  504. * correct stop location and detach.
  505. */
  506. static struct test_struct sw_breakpoint_test[] = {
  507. { "?", "S0*" }, /* Clear break points */
  508. { "kgdbts_break_test", "OK", sw_break, }, /* set sw breakpoint */
  509. { "c", "T0*", }, /* Continue */
  510. { "g", "kgdbts_break_test", NULL, check_and_rewind_pc },
  511. { "write", "OK", write_regs },
  512. { "kgdbts_break_test", "OK", sw_rem_break }, /*remove breakpoint */
  513. { "D", "OK" }, /* Detach */
  514. { "D", "OK", NULL, got_break }, /* On success we made it here */
  515. { "", "" },
  516. };
  517. /*
  518. * Test a known bad memory read location to test the fault handler and
  519. * read bytes 1-8 at the bad address
  520. */
  521. static struct test_struct bad_read_test[] = {
  522. { "?", "S0*" }, /* Clear break points */
  523. { "m0,1", "E*" }, /* read 1 byte at address 1 */
  524. { "m0,2", "E*" }, /* read 1 byte at address 2 */
  525. { "m0,3", "E*" }, /* read 1 byte at address 3 */
  526. { "m0,4", "E*" }, /* read 1 byte at address 4 */
  527. { "m0,5", "E*" }, /* read 1 byte at address 5 */
  528. { "m0,6", "E*" }, /* read 1 byte at address 6 */
  529. { "m0,7", "E*" }, /* read 1 byte at address 7 */
  530. { "m0,8", "E*" }, /* read 1 byte at address 8 */
  531. { "D", "OK" }, /* Detach which removes all breakpoints and continues */
  532. { "", "" },
  533. };
  534. /*
  535. * Test for hitting a breakpoint, remove it, single step, plant it
  536. * again and detach.
  537. */
  538. static struct test_struct singlestep_break_test[] = {
  539. { "?", "S0*" }, /* Clear break points */
  540. { "kgdbts_break_test", "OK", sw_break, }, /* set sw breakpoint */
  541. { "c", "T0*", NULL, get_thread_id_continue }, /* Continue */
  542. { "kgdbts_break_test", "OK", sw_rem_break }, /*remove breakpoint */
  543. { "g", "kgdbts_break_test", NULL, check_and_rewind_pc },
  544. { "write", "OK", write_regs }, /* Write registers */
  545. { "s", "T0*", emul_sstep_get, emul_sstep_put }, /* Single step */
  546. { "g", "kgdbts_break_test", NULL, check_single_step },
  547. { "kgdbts_break_test", "OK", sw_break, }, /* set sw breakpoint */
  548. { "c", "T0*", }, /* Continue */
  549. { "g", "kgdbts_break_test", NULL, check_and_rewind_pc },
  550. { "write", "OK", write_regs }, /* Write registers */
  551. { "D", "OK" }, /* Remove all breakpoints and continues */
  552. { "", "" },
  553. };
  554. /*
  555. * Test for hitting a breakpoint at do_fork for what ever the number
  556. * of iterations required by the variable repeat_test.
  557. */
  558. static struct test_struct do_fork_test[] = {
  559. { "?", "S0*" }, /* Clear break points */
  560. { "do_fork", "OK", sw_break, }, /* set sw breakpoint */
  561. { "c", "T0*", NULL, get_thread_id_continue }, /* Continue */
  562. { "do_fork", "OK", sw_rem_break }, /*remove breakpoint */
  563. { "g", "do_fork", NULL, check_and_rewind_pc }, /* check location */
  564. { "write", "OK", write_regs, emul_reset }, /* Write registers */
  565. { "s", "T0*", emul_sstep_get, emul_sstep_put }, /* Single step */
  566. { "g", "do_fork", NULL, check_single_step },
  567. { "do_fork", "OK", sw_break, }, /* set sw breakpoint */
  568. { "7", "T0*", skip_back_repeat_test }, /* Loop based on repeat_test */
  569. { "D", "OK", NULL, final_ack_set }, /* detach and unregister I/O */
  570. { "", "", get_cont_catch, put_cont_catch },
  571. };
  572. /* Test for hitting a breakpoint at sys_open for what ever the number
  573. * of iterations required by the variable repeat_test.
  574. */
  575. static struct test_struct sys_open_test[] = {
  576. { "?", "S0*" }, /* Clear break points */
  577. { "sys_open", "OK", sw_break, }, /* set sw breakpoint */
  578. { "c", "T0*", NULL, get_thread_id_continue }, /* Continue */
  579. { "sys_open", "OK", sw_rem_break }, /*remove breakpoint */
  580. { "g", "sys_open", NULL, check_and_rewind_pc }, /* check location */
  581. { "write", "OK", write_regs, emul_reset }, /* Write registers */
  582. { "s", "T0*", emul_sstep_get, emul_sstep_put }, /* Single step */
  583. { "g", "sys_open", NULL, check_single_step },
  584. { "sys_open", "OK", sw_break, }, /* set sw breakpoint */
  585. { "7", "T0*", skip_back_repeat_test }, /* Loop based on repeat_test */
  586. { "D", "OK", NULL, final_ack_set }, /* detach and unregister I/O */
  587. { "", "", get_cont_catch, put_cont_catch },
  588. };
  589. /*
  590. * Test for hitting a simple hw breakpoint
  591. */
  592. static struct test_struct hw_breakpoint_test[] = {
  593. { "?", "S0*" }, /* Clear break points */
  594. { "kgdbts_break_test", "OK", hw_break, }, /* set hw breakpoint */
  595. { "c", "T0*", }, /* Continue */
  596. { "g", "kgdbts_break_test", NULL, check_and_rewind_pc },
  597. { "write", "OK", write_regs },
  598. { "kgdbts_break_test", "OK", hw_rem_break }, /*remove breakpoint */
  599. { "D", "OK" }, /* Detach */
  600. { "D", "OK", NULL, got_break }, /* On success we made it here */
  601. { "", "" },
  602. };
  603. /*
  604. * Test for hitting a hw write breakpoint
  605. */
  606. static struct test_struct hw_write_break_test[] = {
  607. { "?", "S0*" }, /* Clear break points */
  608. { "hw_break_val", "OK", hw_write_break, }, /* set hw breakpoint */
  609. { "c", "T0*", NULL, got_break }, /* Continue */
  610. { "g", "silent", NULL, check_and_rewind_pc },
  611. { "write", "OK", write_regs },
  612. { "hw_break_val", "OK", hw_rem_write_break }, /*remove breakpoint */
  613. { "D", "OK" }, /* Detach */
  614. { "D", "OK", NULL, got_break }, /* On success we made it here */
  615. { "", "" },
  616. };
  617. /*
  618. * Test for hitting a hw access breakpoint
  619. */
  620. static struct test_struct hw_access_break_test[] = {
  621. { "?", "S0*" }, /* Clear break points */
  622. { "hw_break_val", "OK", hw_access_break, }, /* set hw breakpoint */
  623. { "c", "T0*", NULL, got_break }, /* Continue */
  624. { "g", "silent", NULL, check_and_rewind_pc },
  625. { "write", "OK", write_regs },
  626. { "hw_break_val", "OK", hw_rem_access_break }, /*remove breakpoint */
  627. { "D", "OK" }, /* Detach */
  628. { "D", "OK", NULL, got_break }, /* On success we made it here */
  629. { "", "" },
  630. };
  631. /*
  632. * Test for hitting a hw access breakpoint
  633. */
  634. static struct test_struct nmi_sleep_test[] = {
  635. { "?", "S0*" }, /* Clear break points */
  636. { "c", "T0*", NULL, got_break }, /* Continue */
  637. { "D", "OK" }, /* Detach */
  638. { "D", "OK", NULL, got_break }, /* On success we made it here */
  639. { "", "" },
  640. };
  641. static void fill_get_buf(char *buf)
  642. {
  643. unsigned char checksum = 0;
  644. int count = 0;
  645. char ch;
  646. strcpy(get_buf, "$");
  647. strcat(get_buf, buf);
  648. while ((ch = buf[count])) {
  649. checksum += ch;
  650. count++;
  651. }
  652. strcat(get_buf, "#");
  653. get_buf[count + 2] = hex_asc_hi(checksum);
  654. get_buf[count + 3] = hex_asc_lo(checksum);
  655. get_buf[count + 4] = '\0';
  656. v2printk("get%i: %s\n", ts.idx, get_buf);
  657. }
  658. static int validate_simple_test(char *put_str)
  659. {
  660. char *chk_str;
  661. if (ts.tst[ts.idx].put_handler)
  662. return ts.tst[ts.idx].put_handler(put_str,
  663. ts.tst[ts.idx].put);
  664. chk_str = ts.tst[ts.idx].put;
  665. if (*put_str == '$')
  666. put_str++;
  667. while (*chk_str != '\0' && *put_str != '\0') {
  668. /* If someone does a * to match the rest of the string, allow
  669. * it, or stop if the received string is complete.
  670. */
  671. if (*put_str == '#' || *chk_str == '*')
  672. return 0;
  673. if (*put_str != *chk_str)
  674. return 1;
  675. chk_str++;
  676. put_str++;
  677. }
  678. if (*chk_str == '\0' && (*put_str == '\0' || *put_str == '#'))
  679. return 0;
  680. return 1;
  681. }
  682. static int run_simple_test(int is_get_char, int chr)
  683. {
  684. int ret = 0;
  685. if (is_get_char) {
  686. /* Send an ACK on the get if a prior put completed and set the
  687. * send ack variable
  688. */
  689. if (send_ack) {
  690. send_ack = 0;
  691. return '+';
  692. }
  693. /* On the first get char, fill the transmit buffer and then
  694. * take from the get_string.
  695. */
  696. if (get_buf_cnt == 0) {
  697. if (ts.tst[ts.idx].get_handler)
  698. ts.tst[ts.idx].get_handler(ts.tst[ts.idx].get);
  699. else
  700. fill_get_buf(ts.tst[ts.idx].get);
  701. }
  702. if (get_buf[get_buf_cnt] == '\0') {
  703. eprintk("kgdbts: ERROR GET: EOB on '%s' at %i\n",
  704. ts.name, ts.idx);
  705. get_buf_cnt = 0;
  706. fill_get_buf("D");
  707. }
  708. ret = get_buf[get_buf_cnt];
  709. get_buf_cnt++;
  710. return ret;
  711. }
  712. /* This callback is a put char which is when kgdb sends data to
  713. * this I/O module.
  714. */
  715. if (ts.tst[ts.idx].get[0] == '\0' && ts.tst[ts.idx].put[0] == '\0' &&
  716. !ts.tst[ts.idx].get_handler) {
  717. eprintk("kgdbts: ERROR: beyond end of test on"
  718. " '%s' line %i\n", ts.name, ts.idx);
  719. return 0;
  720. }
  721. if (put_buf_cnt >= BUFMAX) {
  722. eprintk("kgdbts: ERROR: put buffer overflow on"
  723. " '%s' line %i\n", ts.name, ts.idx);
  724. put_buf_cnt = 0;
  725. return 0;
  726. }
  727. /* Ignore everything until the first valid packet start '$' */
  728. if (put_buf_cnt == 0 && chr != '$')
  729. return 0;
  730. put_buf[put_buf_cnt] = chr;
  731. put_buf_cnt++;
  732. /* End of packet == #XX so look for the '#' */
  733. if (put_buf_cnt > 3 && put_buf[put_buf_cnt - 3] == '#') {
  734. if (put_buf_cnt >= BUFMAX) {
  735. eprintk("kgdbts: ERROR: put buffer overflow on"
  736. " '%s' line %i\n", ts.name, ts.idx);
  737. put_buf_cnt = 0;
  738. return 0;
  739. }
  740. put_buf[put_buf_cnt] = '\0';
  741. v2printk("put%i: %s\n", ts.idx, put_buf);
  742. /* Trigger check here */
  743. if (ts.validate_put && ts.validate_put(put_buf)) {
  744. eprintk("kgdbts: ERROR PUT: end of test "
  745. "buffer on '%s' line %i expected %s got %s\n",
  746. ts.name, ts.idx, ts.tst[ts.idx].put, put_buf);
  747. }
  748. ts.idx++;
  749. put_buf_cnt = 0;
  750. get_buf_cnt = 0;
  751. send_ack = 1;
  752. }
  753. return 0;
  754. }
  755. static void init_simple_test(void)
  756. {
  757. memset(&ts, 0, sizeof(ts));
  758. ts.run_test = run_simple_test;
  759. ts.validate_put = validate_simple_test;
  760. }
  761. static void run_plant_and_detach_test(int is_early)
  762. {
  763. char before[BREAK_INSTR_SIZE];
  764. char after[BREAK_INSTR_SIZE];
  765. probe_kernel_read(before, (char *)kgdbts_break_test,
  766. BREAK_INSTR_SIZE);
  767. init_simple_test();
  768. ts.tst = plant_and_detach_test;
  769. ts.name = "plant_and_detach_test";
  770. /* Activate test with initial breakpoint */
  771. if (!is_early)
  772. kgdb_breakpoint();
  773. probe_kernel_read(after, (char *)kgdbts_break_test,
  774. BREAK_INSTR_SIZE);
  775. if (memcmp(before, after, BREAK_INSTR_SIZE)) {
  776. printk(KERN_CRIT "kgdbts: ERROR kgdb corrupted memory\n");
  777. panic("kgdb memory corruption");
  778. }
  779. /* complete the detach test */
  780. if (!is_early)
  781. kgdbts_break_test();
  782. }
  783. static void run_breakpoint_test(int is_hw_breakpoint)
  784. {
  785. test_complete = 0;
  786. init_simple_test();
  787. if (is_hw_breakpoint) {
  788. ts.tst = hw_breakpoint_test;
  789. ts.name = "hw_breakpoint_test";
  790. } else {
  791. ts.tst = sw_breakpoint_test;
  792. ts.name = "sw_breakpoint_test";
  793. }
  794. /* Activate test with initial breakpoint */
  795. kgdb_breakpoint();
  796. /* run code with the break point in it */
  797. kgdbts_break_test();
  798. kgdb_breakpoint();
  799. if (test_complete)
  800. return;
  801. eprintk("kgdbts: ERROR %s test failed\n", ts.name);
  802. if (is_hw_breakpoint)
  803. hwbreaks_ok = 0;
  804. }
  805. static void run_hw_break_test(int is_write_test)
  806. {
  807. test_complete = 0;
  808. init_simple_test();
  809. if (is_write_test) {
  810. ts.tst = hw_write_break_test;
  811. ts.name = "hw_write_break_test";
  812. } else {
  813. ts.tst = hw_access_break_test;
  814. ts.name = "hw_access_break_test";
  815. }
  816. /* Activate test with initial breakpoint */
  817. kgdb_breakpoint();
  818. hw_break_val_access();
  819. if (is_write_test) {
  820. if (test_complete == 2) {
  821. eprintk("kgdbts: ERROR %s broke on access\n",
  822. ts.name);
  823. hwbreaks_ok = 0;
  824. }
  825. hw_break_val_write();
  826. }
  827. kgdb_breakpoint();
  828. if (test_complete == 1)
  829. return;
  830. eprintk("kgdbts: ERROR %s test failed\n", ts.name);
  831. hwbreaks_ok = 0;
  832. }
  833. static void run_nmi_sleep_test(int nmi_sleep)
  834. {
  835. unsigned long flags;
  836. init_simple_test();
  837. ts.tst = nmi_sleep_test;
  838. ts.name = "nmi_sleep_test";
  839. /* Activate test with initial breakpoint */
  840. kgdb_breakpoint();
  841. local_irq_save(flags);
  842. mdelay(nmi_sleep*1000);
  843. touch_nmi_watchdog();
  844. local_irq_restore(flags);
  845. if (test_complete != 2)
  846. eprintk("kgdbts: ERROR nmi_test did not hit nmi\n");
  847. kgdb_breakpoint();
  848. if (test_complete == 1)
  849. return;
  850. eprintk("kgdbts: ERROR %s test failed\n", ts.name);
  851. }
  852. static void run_bad_read_test(void)
  853. {
  854. init_simple_test();
  855. ts.tst = bad_read_test;
  856. ts.name = "bad_read_test";
  857. /* Activate test with initial breakpoint */
  858. kgdb_breakpoint();
  859. }
  860. static void run_do_fork_test(void)
  861. {
  862. init_simple_test();
  863. ts.tst = do_fork_test;
  864. ts.name = "do_fork_test";
  865. /* Activate test with initial breakpoint */
  866. kgdb_breakpoint();
  867. }
  868. static void run_sys_open_test(void)
  869. {
  870. init_simple_test();
  871. ts.tst = sys_open_test;
  872. ts.name = "sys_open_test";
  873. /* Activate test with initial breakpoint */
  874. kgdb_breakpoint();
  875. }
  876. static void run_singlestep_break_test(void)
  877. {
  878. init_simple_test();
  879. ts.tst = singlestep_break_test;
  880. ts.name = "singlestep_breakpoint_test";
  881. /* Activate test with initial breakpoint */
  882. kgdb_breakpoint();
  883. kgdbts_break_test();
  884. kgdbts_break_test();
  885. }
  886. static void kgdbts_run_tests(void)
  887. {
  888. char *ptr;
  889. int fork_test = 0;
  890. int do_sys_open_test = 0;
  891. int sstep_test = 1000;
  892. int nmi_sleep = 0;
  893. int i;
  894. verbose = 0;
  895. if (strstr(config, "V1"))
  896. verbose = 1;
  897. if (strstr(config, "V2"))
  898. verbose = 2;
  899. ptr = strchr(config, 'F');
  900. if (ptr)
  901. fork_test = simple_strtol(ptr + 1, NULL, 10);
  902. ptr = strchr(config, 'S');
  903. if (ptr)
  904. do_sys_open_test = simple_strtol(ptr + 1, NULL, 10);
  905. ptr = strchr(config, 'N');
  906. if (ptr)
  907. nmi_sleep = simple_strtol(ptr+1, NULL, 10);
  908. ptr = strchr(config, 'I');
  909. if (ptr)
  910. sstep_test = simple_strtol(ptr+1, NULL, 10);
  911. /* All HW break point tests */
  912. if (arch_kgdb_ops.flags & KGDB_HW_BREAKPOINT) {
  913. hwbreaks_ok = 1;
  914. v1printk("kgdbts:RUN hw breakpoint test\n");
  915. run_breakpoint_test(1);
  916. v1printk("kgdbts:RUN hw write breakpoint test\n");
  917. run_hw_break_test(1);
  918. v1printk("kgdbts:RUN access write breakpoint test\n");
  919. run_hw_break_test(0);
  920. }
  921. /* required internal KGDB tests */
  922. v1printk("kgdbts:RUN plant and detach test\n");
  923. run_plant_and_detach_test(0);
  924. v1printk("kgdbts:RUN sw breakpoint test\n");
  925. run_breakpoint_test(0);
  926. v1printk("kgdbts:RUN bad memory access test\n");
  927. run_bad_read_test();
  928. v1printk("kgdbts:RUN singlestep test %i iterations\n", sstep_test);
  929. for (i = 0; i < sstep_test; i++) {
  930. run_singlestep_break_test();
  931. if (i % 100 == 0)
  932. v1printk("kgdbts:RUN singlestep [%i/%i]\n",
  933. i, sstep_test);
  934. }
  935. /* ===Optional tests=== */
  936. if (nmi_sleep) {
  937. v1printk("kgdbts:RUN NMI sleep %i seconds test\n", nmi_sleep);
  938. run_nmi_sleep_test(nmi_sleep);
  939. }
  940. /* If the do_fork test is run it will be the last test that is
  941. * executed because a kernel thread will be spawned at the very
  942. * end to unregister the debug hooks.
  943. */
  944. if (fork_test) {
  945. repeat_test = fork_test;
  946. printk(KERN_INFO "kgdbts:RUN do_fork for %i breakpoints\n",
  947. repeat_test);
  948. kthread_run(kgdbts_unreg_thread, NULL, "kgdbts_unreg");
  949. run_do_fork_test();
  950. return;
  951. }
  952. /* If the sys_open test is run it will be the last test that is
  953. * executed because a kernel thread will be spawned at the very
  954. * end to unregister the debug hooks.
  955. */
  956. if (do_sys_open_test) {
  957. repeat_test = do_sys_open_test;
  958. printk(KERN_INFO "kgdbts:RUN sys_open for %i breakpoints\n",
  959. repeat_test);
  960. kthread_run(kgdbts_unreg_thread, NULL, "kgdbts_unreg");
  961. run_sys_open_test();
  962. return;
  963. }
  964. /* Shutdown and unregister */
  965. kgdb_unregister_io_module(&kgdbts_io_ops);
  966. configured = 0;
  967. }
  968. static int kgdbts_option_setup(char *opt)
  969. {
  970. if (strlen(opt) >= MAX_CONFIG_LEN) {
  971. printk(KERN_ERR "kgdbts: config string too long\n");
  972. return -ENOSPC;
  973. }
  974. strcpy(config, opt);
  975. return 0;
  976. }
  977. __setup("kgdbts=", kgdbts_option_setup);
  978. static int configure_kgdbts(void)
  979. {
  980. int err = 0;
  981. if (!strlen(config) || isspace(config[0]))
  982. goto noconfig;
  983. final_ack = 0;
  984. run_plant_and_detach_test(1);
  985. err = kgdb_register_io_module(&kgdbts_io_ops);
  986. if (err) {
  987. configured = 0;
  988. return err;
  989. }
  990. configured = 1;
  991. kgdbts_run_tests();
  992. return err;
  993. noconfig:
  994. config[0] = 0;
  995. configured = 0;
  996. return err;
  997. }
  998. static int __init init_kgdbts(void)
  999. {
  1000. /* Already configured? */
  1001. if (configured == 1)
  1002. return 0;
  1003. return configure_kgdbts();
  1004. }
  1005. device_initcall(init_kgdbts);
  1006. static int kgdbts_get_char(void)
  1007. {
  1008. int val = 0;
  1009. if (ts.run_test)
  1010. val = ts.run_test(1, 0);
  1011. return val;
  1012. }
  1013. static void kgdbts_put_char(u8 chr)
  1014. {
  1015. if (ts.run_test)
  1016. ts.run_test(0, chr);
  1017. }
  1018. static int param_set_kgdbts_var(const char *kmessage,
  1019. const struct kernel_param *kp)
  1020. {
  1021. size_t len = strlen(kmessage);
  1022. if (len >= MAX_CONFIG_LEN) {
  1023. printk(KERN_ERR "kgdbts: config string too long\n");
  1024. return -ENOSPC;
  1025. }
  1026. /* Only copy in the string if the init function has not run yet */
  1027. if (configured < 0) {
  1028. strcpy(config, kmessage);
  1029. return 0;
  1030. }
  1031. if (configured == 1) {
  1032. printk(KERN_ERR "kgdbts: ERROR: Already configured and running.\n");
  1033. return -EBUSY;
  1034. }
  1035. strcpy(config, kmessage);
  1036. /* Chop out \n char as a result of echo */
  1037. if (len && config[len - 1] == '\n')
  1038. config[len - 1] = '\0';
  1039. /* Go and configure with the new params. */
  1040. return configure_kgdbts();
  1041. }
  1042. static void kgdbts_pre_exp_handler(void)
  1043. {
  1044. /* Increment the module count when the debugger is active */
  1045. if (!kgdb_connected)
  1046. try_module_get(THIS_MODULE);
  1047. }
  1048. static void kgdbts_post_exp_handler(void)
  1049. {
  1050. /* decrement the module count when the debugger detaches */
  1051. if (!kgdb_connected)
  1052. module_put(THIS_MODULE);
  1053. }
  1054. static struct kgdb_io kgdbts_io_ops = {
  1055. .name = "kgdbts",
  1056. .read_char = kgdbts_get_char,
  1057. .write_char = kgdbts_put_char,
  1058. .pre_exception = kgdbts_pre_exp_handler,
  1059. .post_exception = kgdbts_post_exp_handler,
  1060. };
  1061. /*
  1062. * not really modular, but the easiest way to keep compat with existing
  1063. * bootargs behaviour is to continue using module_param here.
  1064. */
  1065. module_param_call(kgdbts, param_set_kgdbts_var, param_get_string, &kps, 0644);
  1066. MODULE_PARM_DESC(kgdbts, "<A|V1|V2>[F#|S#][N#]");