kgdbts.c 28 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100
  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/delay.h>
  105. #define v1printk(a...) do { \
  106. if (verbose) \
  107. printk(KERN_INFO a); \
  108. } while (0)
  109. #define v2printk(a...) do { \
  110. if (verbose > 1) \
  111. printk(KERN_INFO a); \
  112. touch_nmi_watchdog(); \
  113. } while (0)
  114. #define eprintk(a...) do { \
  115. printk(KERN_ERR a); \
  116. WARN_ON(1); \
  117. } while (0)
  118. #define MAX_CONFIG_LEN 40
  119. static struct kgdb_io kgdbts_io_ops;
  120. static char get_buf[BUFMAX];
  121. static int get_buf_cnt;
  122. static char put_buf[BUFMAX];
  123. static int put_buf_cnt;
  124. static char scratch_buf[BUFMAX];
  125. static int verbose;
  126. static int repeat_test;
  127. static int test_complete;
  128. static int send_ack;
  129. static int final_ack;
  130. static int hw_break_val;
  131. static int hw_break_val2;
  132. #if defined(CONFIG_ARM) || defined(CONFIG_MIPS) || defined(CONFIG_SPARC)
  133. static int arch_needs_sstep_emulation = 1;
  134. #else
  135. static int arch_needs_sstep_emulation;
  136. #endif
  137. static unsigned long sstep_addr;
  138. static int sstep_state;
  139. /* Storage for the registers, in GDB format. */
  140. static unsigned long kgdbts_gdb_regs[(NUMREGBYTES +
  141. sizeof(unsigned long) - 1) /
  142. sizeof(unsigned long)];
  143. static struct pt_regs kgdbts_regs;
  144. /* -1 = init not run yet, 0 = unconfigured, 1 = configured. */
  145. static int configured = -1;
  146. #ifdef CONFIG_KGDB_TESTS_BOOT_STRING
  147. static char config[MAX_CONFIG_LEN] = CONFIG_KGDB_TESTS_BOOT_STRING;
  148. #else
  149. static char config[MAX_CONFIG_LEN];
  150. #endif
  151. static struct kparam_string kps = {
  152. .string = config,
  153. .maxlen = MAX_CONFIG_LEN,
  154. };
  155. static void fill_get_buf(char *buf);
  156. struct test_struct {
  157. char *get;
  158. char *put;
  159. void (*get_handler)(char *);
  160. int (*put_handler)(char *, char *);
  161. };
  162. struct test_state {
  163. char *name;
  164. struct test_struct *tst;
  165. int idx;
  166. int (*run_test) (int, int);
  167. int (*validate_put) (char *);
  168. };
  169. static struct test_state ts;
  170. static int kgdbts_unreg_thread(void *ptr)
  171. {
  172. /* Wait until the tests are complete and then ungresiter the I/O
  173. * driver.
  174. */
  175. while (!final_ack)
  176. msleep_interruptible(1500);
  177. if (configured)
  178. kgdb_unregister_io_module(&kgdbts_io_ops);
  179. configured = 0;
  180. return 0;
  181. }
  182. /* This is noinline such that it can be used for a single location to
  183. * place a breakpoint
  184. */
  185. static noinline void kgdbts_break_test(void)
  186. {
  187. v2printk("kgdbts: breakpoint complete\n");
  188. }
  189. /* Lookup symbol info in the kernel */
  190. static unsigned long lookup_addr(char *arg)
  191. {
  192. unsigned long addr = 0;
  193. if (!strcmp(arg, "kgdbts_break_test"))
  194. addr = (unsigned long)kgdbts_break_test;
  195. else if (!strcmp(arg, "sys_open"))
  196. addr = (unsigned long)sys_open;
  197. else if (!strcmp(arg, "do_fork"))
  198. addr = (unsigned long)do_fork;
  199. else if (!strcmp(arg, "hw_break_val"))
  200. addr = (unsigned long)&hw_break_val;
  201. return addr;
  202. }
  203. static void break_helper(char *bp_type, char *arg, unsigned long vaddr)
  204. {
  205. unsigned long addr;
  206. if (arg)
  207. addr = lookup_addr(arg);
  208. else
  209. addr = vaddr;
  210. sprintf(scratch_buf, "%s,%lx,%i", bp_type, addr,
  211. BREAK_INSTR_SIZE);
  212. fill_get_buf(scratch_buf);
  213. }
  214. static void sw_break(char *arg)
  215. {
  216. break_helper("Z0", arg, 0);
  217. }
  218. static void sw_rem_break(char *arg)
  219. {
  220. break_helper("z0", arg, 0);
  221. }
  222. static void hw_break(char *arg)
  223. {
  224. break_helper("Z1", arg, 0);
  225. }
  226. static void hw_rem_break(char *arg)
  227. {
  228. break_helper("z1", arg, 0);
  229. }
  230. static void hw_write_break(char *arg)
  231. {
  232. break_helper("Z2", arg, 0);
  233. }
  234. static void hw_rem_write_break(char *arg)
  235. {
  236. break_helper("z2", arg, 0);
  237. }
  238. static void hw_access_break(char *arg)
  239. {
  240. break_helper("Z4", arg, 0);
  241. }
  242. static void hw_rem_access_break(char *arg)
  243. {
  244. break_helper("z4", arg, 0);
  245. }
  246. static void hw_break_val_access(void)
  247. {
  248. hw_break_val2 = hw_break_val;
  249. }
  250. static void hw_break_val_write(void)
  251. {
  252. hw_break_val++;
  253. }
  254. static int check_and_rewind_pc(char *put_str, char *arg)
  255. {
  256. unsigned long addr = lookup_addr(arg);
  257. int offset = 0;
  258. kgdb_hex2mem(&put_str[1], (char *)kgdbts_gdb_regs,
  259. NUMREGBYTES);
  260. gdb_regs_to_pt_regs(kgdbts_gdb_regs, &kgdbts_regs);
  261. v2printk("Stopped at IP: %lx\n", instruction_pointer(&kgdbts_regs));
  262. #ifdef CONFIG_X86
  263. /* On x86 a breakpoint stop requires it to be decremented */
  264. if (addr + 1 == kgdbts_regs.ip)
  265. offset = -1;
  266. #endif
  267. if (strcmp(arg, "silent") &&
  268. instruction_pointer(&kgdbts_regs) + offset != addr) {
  269. eprintk("kgdbts: BP mismatch %lx expected %lx\n",
  270. instruction_pointer(&kgdbts_regs) + offset, addr);
  271. return 1;
  272. }
  273. #ifdef CONFIG_X86
  274. /* On x86 adjust the instruction pointer if needed */
  275. kgdbts_regs.ip += offset;
  276. #endif
  277. return 0;
  278. }
  279. static int check_single_step(char *put_str, char *arg)
  280. {
  281. unsigned long addr = lookup_addr(arg);
  282. /*
  283. * From an arch indepent point of view the instruction pointer
  284. * should be on a different instruction
  285. */
  286. kgdb_hex2mem(&put_str[1], (char *)kgdbts_gdb_regs,
  287. NUMREGBYTES);
  288. gdb_regs_to_pt_regs(kgdbts_gdb_regs, &kgdbts_regs);
  289. v2printk("Singlestep stopped at IP: %lx\n",
  290. instruction_pointer(&kgdbts_regs));
  291. if (instruction_pointer(&kgdbts_regs) == addr) {
  292. eprintk("kgdbts: SingleStep failed at %lx\n",
  293. instruction_pointer(&kgdbts_regs));
  294. return 1;
  295. }
  296. return 0;
  297. }
  298. static void write_regs(char *arg)
  299. {
  300. memset(scratch_buf, 0, sizeof(scratch_buf));
  301. scratch_buf[0] = 'G';
  302. pt_regs_to_gdb_regs(kgdbts_gdb_regs, &kgdbts_regs);
  303. kgdb_mem2hex((char *)kgdbts_gdb_regs, &scratch_buf[1], NUMREGBYTES);
  304. fill_get_buf(scratch_buf);
  305. }
  306. static void skip_back_repeat_test(char *arg)
  307. {
  308. int go_back = simple_strtol(arg, NULL, 10);
  309. repeat_test--;
  310. if (repeat_test <= 0)
  311. ts.idx++;
  312. else
  313. ts.idx -= go_back;
  314. fill_get_buf(ts.tst[ts.idx].get);
  315. }
  316. static int got_break(char *put_str, char *arg)
  317. {
  318. test_complete = 1;
  319. if (!strncmp(put_str+1, arg, 2)) {
  320. if (!strncmp(arg, "T0", 2))
  321. test_complete = 2;
  322. return 0;
  323. }
  324. return 1;
  325. }
  326. static void emul_sstep_get(char *arg)
  327. {
  328. if (!arch_needs_sstep_emulation) {
  329. fill_get_buf(arg);
  330. return;
  331. }
  332. switch (sstep_state) {
  333. case 0:
  334. v2printk("Emulate single step\n");
  335. /* Start by looking at the current PC */
  336. fill_get_buf("g");
  337. break;
  338. case 1:
  339. /* set breakpoint */
  340. break_helper("Z0", NULL, sstep_addr);
  341. break;
  342. case 2:
  343. /* Continue */
  344. fill_get_buf("c");
  345. break;
  346. case 3:
  347. /* Clear breakpoint */
  348. break_helper("z0", NULL, sstep_addr);
  349. break;
  350. default:
  351. eprintk("kgdbts: ERROR failed sstep get emulation\n");
  352. }
  353. sstep_state++;
  354. }
  355. static int emul_sstep_put(char *put_str, char *arg)
  356. {
  357. if (!arch_needs_sstep_emulation) {
  358. if (!strncmp(put_str+1, arg, 2))
  359. return 0;
  360. return 1;
  361. }
  362. switch (sstep_state) {
  363. case 1:
  364. /* validate the "g" packet to get the IP */
  365. kgdb_hex2mem(&put_str[1], (char *)kgdbts_gdb_regs,
  366. NUMREGBYTES);
  367. gdb_regs_to_pt_regs(kgdbts_gdb_regs, &kgdbts_regs);
  368. v2printk("Stopped at IP: %lx\n",
  369. instruction_pointer(&kgdbts_regs));
  370. /* Want to stop at IP + break instruction size by default */
  371. sstep_addr = instruction_pointer(&kgdbts_regs) +
  372. BREAK_INSTR_SIZE;
  373. break;
  374. case 2:
  375. if (strncmp(put_str, "$OK", 3)) {
  376. eprintk("kgdbts: failed sstep break set\n");
  377. return 1;
  378. }
  379. break;
  380. case 3:
  381. if (strncmp(put_str, "$T0", 3)) {
  382. eprintk("kgdbts: failed continue sstep\n");
  383. return 1;
  384. }
  385. break;
  386. case 4:
  387. if (strncmp(put_str, "$OK", 3)) {
  388. eprintk("kgdbts: failed sstep break unset\n");
  389. return 1;
  390. }
  391. /* Single step is complete so continue on! */
  392. sstep_state = 0;
  393. return 0;
  394. default:
  395. eprintk("kgdbts: ERROR failed sstep put emulation\n");
  396. }
  397. /* Continue on the same test line until emulation is complete */
  398. ts.idx--;
  399. return 0;
  400. }
  401. static int final_ack_set(char *put_str, char *arg)
  402. {
  403. if (strncmp(put_str+1, arg, 2))
  404. return 1;
  405. final_ack = 1;
  406. return 0;
  407. }
  408. /*
  409. * Test to plant a breakpoint and detach, which should clear out the
  410. * breakpoint and restore the original instruction.
  411. */
  412. static struct test_struct plant_and_detach_test[] = {
  413. { "?", "S0*" }, /* Clear break points */
  414. { "kgdbts_break_test", "OK", sw_break, }, /* set sw breakpoint */
  415. { "D", "OK" }, /* Detach */
  416. { "", "" },
  417. };
  418. /*
  419. * Simple test to write in a software breakpoint, check for the
  420. * correct stop location and detach.
  421. */
  422. static struct test_struct sw_breakpoint_test[] = {
  423. { "?", "S0*" }, /* Clear break points */
  424. { "kgdbts_break_test", "OK", sw_break, }, /* set sw breakpoint */
  425. { "c", "T0*", }, /* Continue */
  426. { "g", "kgdbts_break_test", NULL, check_and_rewind_pc },
  427. { "write", "OK", write_regs },
  428. { "kgdbts_break_test", "OK", sw_rem_break }, /*remove breakpoint */
  429. { "D", "OK" }, /* Detach */
  430. { "D", "OK", NULL, got_break }, /* On success we made it here */
  431. { "", "" },
  432. };
  433. /*
  434. * Test a known bad memory read location to test the fault handler and
  435. * read bytes 1-8 at the bad address
  436. */
  437. static struct test_struct bad_read_test[] = {
  438. { "?", "S0*" }, /* Clear break points */
  439. { "m0,1", "E*" }, /* read 1 byte at address 1 */
  440. { "m0,2", "E*" }, /* read 1 byte at address 2 */
  441. { "m0,3", "E*" }, /* read 1 byte at address 3 */
  442. { "m0,4", "E*" }, /* read 1 byte at address 4 */
  443. { "m0,5", "E*" }, /* read 1 byte at address 5 */
  444. { "m0,6", "E*" }, /* read 1 byte at address 6 */
  445. { "m0,7", "E*" }, /* read 1 byte at address 7 */
  446. { "m0,8", "E*" }, /* read 1 byte at address 8 */
  447. { "D", "OK" }, /* Detach which removes all breakpoints and continues */
  448. { "", "" },
  449. };
  450. /*
  451. * Test for hitting a breakpoint, remove it, single step, plant it
  452. * again and detach.
  453. */
  454. static struct test_struct singlestep_break_test[] = {
  455. { "?", "S0*" }, /* Clear break points */
  456. { "kgdbts_break_test", "OK", sw_break, }, /* set sw breakpoint */
  457. { "c", "T0*", }, /* Continue */
  458. { "g", "kgdbts_break_test", NULL, check_and_rewind_pc },
  459. { "write", "OK", write_regs }, /* Write registers */
  460. { "kgdbts_break_test", "OK", sw_rem_break }, /*remove breakpoint */
  461. { "s", "T0*", emul_sstep_get, emul_sstep_put }, /* Single step */
  462. { "g", "kgdbts_break_test", NULL, check_single_step },
  463. { "kgdbts_break_test", "OK", sw_break, }, /* set sw breakpoint */
  464. { "c", "T0*", }, /* Continue */
  465. { "g", "kgdbts_break_test", NULL, check_and_rewind_pc },
  466. { "write", "OK", write_regs }, /* Write registers */
  467. { "D", "OK" }, /* Remove all breakpoints and continues */
  468. { "", "" },
  469. };
  470. /*
  471. * Test for hitting a breakpoint at do_fork for what ever the number
  472. * of iterations required by the variable repeat_test.
  473. */
  474. static struct test_struct do_fork_test[] = {
  475. { "?", "S0*" }, /* Clear break points */
  476. { "do_fork", "OK", sw_break, }, /* set sw breakpoint */
  477. { "c", "T0*", }, /* Continue */
  478. { "g", "do_fork", NULL, check_and_rewind_pc }, /* check location */
  479. { "write", "OK", write_regs }, /* Write registers */
  480. { "do_fork", "OK", sw_rem_break }, /*remove breakpoint */
  481. { "s", "T0*", emul_sstep_get, emul_sstep_put }, /* Single step */
  482. { "g", "do_fork", NULL, check_single_step },
  483. { "do_fork", "OK", sw_break, }, /* set sw breakpoint */
  484. { "7", "T0*", skip_back_repeat_test }, /* Loop based on repeat_test */
  485. { "D", "OK", NULL, final_ack_set }, /* detach and unregister I/O */
  486. { "", "" },
  487. };
  488. /* Test for hitting a breakpoint at sys_open for what ever the number
  489. * of iterations required by the variable repeat_test.
  490. */
  491. static struct test_struct sys_open_test[] = {
  492. { "?", "S0*" }, /* Clear break points */
  493. { "sys_open", "OK", sw_break, }, /* set sw breakpoint */
  494. { "c", "T0*", }, /* Continue */
  495. { "g", "sys_open", NULL, check_and_rewind_pc }, /* check location */
  496. { "write", "OK", write_regs }, /* Write registers */
  497. { "sys_open", "OK", sw_rem_break }, /*remove breakpoint */
  498. { "s", "T0*", emul_sstep_get, emul_sstep_put }, /* Single step */
  499. { "g", "sys_open", NULL, check_single_step },
  500. { "sys_open", "OK", sw_break, }, /* set sw breakpoint */
  501. { "7", "T0*", skip_back_repeat_test }, /* Loop based on repeat_test */
  502. { "D", "OK", NULL, final_ack_set }, /* detach and unregister I/O */
  503. { "", "" },
  504. };
  505. /*
  506. * Test for hitting a simple hw breakpoint
  507. */
  508. static struct test_struct hw_breakpoint_test[] = {
  509. { "?", "S0*" }, /* Clear break points */
  510. { "kgdbts_break_test", "OK", hw_break, }, /* set hw breakpoint */
  511. { "c", "T0*", }, /* Continue */
  512. { "g", "kgdbts_break_test", NULL, check_and_rewind_pc },
  513. { "write", "OK", write_regs },
  514. { "kgdbts_break_test", "OK", hw_rem_break }, /*remove breakpoint */
  515. { "D", "OK" }, /* Detach */
  516. { "D", "OK", NULL, got_break }, /* On success we made it here */
  517. { "", "" },
  518. };
  519. /*
  520. * Test for hitting a hw write breakpoint
  521. */
  522. static struct test_struct hw_write_break_test[] = {
  523. { "?", "S0*" }, /* Clear break points */
  524. { "hw_break_val", "OK", hw_write_break, }, /* set hw breakpoint */
  525. { "c", "T0*", NULL, got_break }, /* Continue */
  526. { "g", "silent", NULL, check_and_rewind_pc },
  527. { "write", "OK", write_regs },
  528. { "hw_break_val", "OK", hw_rem_write_break }, /*remove breakpoint */
  529. { "D", "OK" }, /* Detach */
  530. { "D", "OK", NULL, got_break }, /* On success we made it here */
  531. { "", "" },
  532. };
  533. /*
  534. * Test for hitting a hw access breakpoint
  535. */
  536. static struct test_struct hw_access_break_test[] = {
  537. { "?", "S0*" }, /* Clear break points */
  538. { "hw_break_val", "OK", hw_access_break, }, /* set hw breakpoint */
  539. { "c", "T0*", NULL, got_break }, /* Continue */
  540. { "g", "silent", NULL, check_and_rewind_pc },
  541. { "write", "OK", write_regs },
  542. { "hw_break_val", "OK", hw_rem_access_break }, /*remove breakpoint */
  543. { "D", "OK" }, /* Detach */
  544. { "D", "OK", NULL, got_break }, /* On success we made it here */
  545. { "", "" },
  546. };
  547. /*
  548. * Test for hitting a hw access breakpoint
  549. */
  550. static struct test_struct nmi_sleep_test[] = {
  551. { "?", "S0*" }, /* Clear break points */
  552. { "c", "T0*", NULL, got_break }, /* Continue */
  553. { "D", "OK" }, /* Detach */
  554. { "D", "OK", NULL, got_break }, /* On success we made it here */
  555. { "", "" },
  556. };
  557. static void fill_get_buf(char *buf)
  558. {
  559. unsigned char checksum = 0;
  560. int count = 0;
  561. char ch;
  562. strcpy(get_buf, "$");
  563. strcat(get_buf, buf);
  564. while ((ch = buf[count])) {
  565. checksum += ch;
  566. count++;
  567. }
  568. strcat(get_buf, "#");
  569. get_buf[count + 2] = hex_asc_hi(checksum);
  570. get_buf[count + 3] = hex_asc_lo(checksum);
  571. get_buf[count + 4] = '\0';
  572. v2printk("get%i: %s\n", ts.idx, get_buf);
  573. }
  574. static int validate_simple_test(char *put_str)
  575. {
  576. char *chk_str;
  577. if (ts.tst[ts.idx].put_handler)
  578. return ts.tst[ts.idx].put_handler(put_str,
  579. ts.tst[ts.idx].put);
  580. chk_str = ts.tst[ts.idx].put;
  581. if (*put_str == '$')
  582. put_str++;
  583. while (*chk_str != '\0' && *put_str != '\0') {
  584. /* If someone does a * to match the rest of the string, allow
  585. * it, or stop if the recieved string is complete.
  586. */
  587. if (*put_str == '#' || *chk_str == '*')
  588. return 0;
  589. if (*put_str != *chk_str)
  590. return 1;
  591. chk_str++;
  592. put_str++;
  593. }
  594. if (*chk_str == '\0' && (*put_str == '\0' || *put_str == '#'))
  595. return 0;
  596. return 1;
  597. }
  598. static int run_simple_test(int is_get_char, int chr)
  599. {
  600. int ret = 0;
  601. if (is_get_char) {
  602. /* Send an ACK on the get if a prior put completed and set the
  603. * send ack variable
  604. */
  605. if (send_ack) {
  606. send_ack = 0;
  607. return '+';
  608. }
  609. /* On the first get char, fill the transmit buffer and then
  610. * take from the get_string.
  611. */
  612. if (get_buf_cnt == 0) {
  613. if (ts.tst[ts.idx].get_handler)
  614. ts.tst[ts.idx].get_handler(ts.tst[ts.idx].get);
  615. else
  616. fill_get_buf(ts.tst[ts.idx].get);
  617. }
  618. if (get_buf[get_buf_cnt] == '\0') {
  619. eprintk("kgdbts: ERROR GET: EOB on '%s' at %i\n",
  620. ts.name, ts.idx);
  621. get_buf_cnt = 0;
  622. fill_get_buf("D");
  623. }
  624. ret = get_buf[get_buf_cnt];
  625. get_buf_cnt++;
  626. return ret;
  627. }
  628. /* This callback is a put char which is when kgdb sends data to
  629. * this I/O module.
  630. */
  631. if (ts.tst[ts.idx].get[0] == '\0' &&
  632. ts.tst[ts.idx].put[0] == '\0') {
  633. eprintk("kgdbts: ERROR: beyond end of test on"
  634. " '%s' line %i\n", ts.name, ts.idx);
  635. return 0;
  636. }
  637. if (put_buf_cnt >= BUFMAX) {
  638. eprintk("kgdbts: ERROR: put buffer overflow on"
  639. " '%s' line %i\n", ts.name, ts.idx);
  640. put_buf_cnt = 0;
  641. return 0;
  642. }
  643. /* Ignore everything until the first valid packet start '$' */
  644. if (put_buf_cnt == 0 && chr != '$')
  645. return 0;
  646. put_buf[put_buf_cnt] = chr;
  647. put_buf_cnt++;
  648. /* End of packet == #XX so look for the '#' */
  649. if (put_buf_cnt > 3 && put_buf[put_buf_cnt - 3] == '#') {
  650. put_buf[put_buf_cnt] = '\0';
  651. v2printk("put%i: %s\n", ts.idx, put_buf);
  652. /* Trigger check here */
  653. if (ts.validate_put && ts.validate_put(put_buf)) {
  654. eprintk("kgdbts: ERROR PUT: end of test "
  655. "buffer on '%s' line %i expected %s got %s\n",
  656. ts.name, ts.idx, ts.tst[ts.idx].put, put_buf);
  657. }
  658. ts.idx++;
  659. put_buf_cnt = 0;
  660. get_buf_cnt = 0;
  661. send_ack = 1;
  662. }
  663. return 0;
  664. }
  665. static void init_simple_test(void)
  666. {
  667. memset(&ts, 0, sizeof(ts));
  668. ts.run_test = run_simple_test;
  669. ts.validate_put = validate_simple_test;
  670. }
  671. static void run_plant_and_detach_test(int is_early)
  672. {
  673. char before[BREAK_INSTR_SIZE];
  674. char after[BREAK_INSTR_SIZE];
  675. probe_kernel_read(before, (char *)kgdbts_break_test,
  676. BREAK_INSTR_SIZE);
  677. init_simple_test();
  678. ts.tst = plant_and_detach_test;
  679. ts.name = "plant_and_detach_test";
  680. /* Activate test with initial breakpoint */
  681. if (!is_early)
  682. kgdb_breakpoint();
  683. probe_kernel_read(after, (char *)kgdbts_break_test,
  684. BREAK_INSTR_SIZE);
  685. if (memcmp(before, after, BREAK_INSTR_SIZE)) {
  686. printk(KERN_CRIT "kgdbts: ERROR kgdb corrupted memory\n");
  687. panic("kgdb memory corruption");
  688. }
  689. /* complete the detach test */
  690. if (!is_early)
  691. kgdbts_break_test();
  692. }
  693. static void run_breakpoint_test(int is_hw_breakpoint)
  694. {
  695. test_complete = 0;
  696. init_simple_test();
  697. if (is_hw_breakpoint) {
  698. ts.tst = hw_breakpoint_test;
  699. ts.name = "hw_breakpoint_test";
  700. } else {
  701. ts.tst = sw_breakpoint_test;
  702. ts.name = "sw_breakpoint_test";
  703. }
  704. /* Activate test with initial breakpoint */
  705. kgdb_breakpoint();
  706. /* run code with the break point in it */
  707. kgdbts_break_test();
  708. kgdb_breakpoint();
  709. if (test_complete)
  710. return;
  711. eprintk("kgdbts: ERROR %s test failed\n", ts.name);
  712. }
  713. static void run_hw_break_test(int is_write_test)
  714. {
  715. test_complete = 0;
  716. init_simple_test();
  717. if (is_write_test) {
  718. ts.tst = hw_write_break_test;
  719. ts.name = "hw_write_break_test";
  720. } else {
  721. ts.tst = hw_access_break_test;
  722. ts.name = "hw_access_break_test";
  723. }
  724. /* Activate test with initial breakpoint */
  725. kgdb_breakpoint();
  726. hw_break_val_access();
  727. if (is_write_test) {
  728. if (test_complete == 2)
  729. eprintk("kgdbts: ERROR %s broke on access\n",
  730. ts.name);
  731. hw_break_val_write();
  732. }
  733. kgdb_breakpoint();
  734. if (test_complete == 1)
  735. return;
  736. eprintk("kgdbts: ERROR %s test failed\n", ts.name);
  737. }
  738. static void run_nmi_sleep_test(int nmi_sleep)
  739. {
  740. unsigned long flags;
  741. init_simple_test();
  742. ts.tst = nmi_sleep_test;
  743. ts.name = "nmi_sleep_test";
  744. /* Activate test with initial breakpoint */
  745. kgdb_breakpoint();
  746. local_irq_save(flags);
  747. mdelay(nmi_sleep*1000);
  748. touch_nmi_watchdog();
  749. local_irq_restore(flags);
  750. if (test_complete != 2)
  751. eprintk("kgdbts: ERROR nmi_test did not hit nmi\n");
  752. kgdb_breakpoint();
  753. if (test_complete == 1)
  754. return;
  755. eprintk("kgdbts: ERROR %s test failed\n", ts.name);
  756. }
  757. static void run_bad_read_test(void)
  758. {
  759. init_simple_test();
  760. ts.tst = bad_read_test;
  761. ts.name = "bad_read_test";
  762. /* Activate test with initial breakpoint */
  763. kgdb_breakpoint();
  764. }
  765. static void run_do_fork_test(void)
  766. {
  767. init_simple_test();
  768. ts.tst = do_fork_test;
  769. ts.name = "do_fork_test";
  770. /* Activate test with initial breakpoint */
  771. kgdb_breakpoint();
  772. }
  773. static void run_sys_open_test(void)
  774. {
  775. init_simple_test();
  776. ts.tst = sys_open_test;
  777. ts.name = "sys_open_test";
  778. /* Activate test with initial breakpoint */
  779. kgdb_breakpoint();
  780. }
  781. static void run_singlestep_break_test(void)
  782. {
  783. init_simple_test();
  784. ts.tst = singlestep_break_test;
  785. ts.name = "singlestep_breakpoint_test";
  786. /* Activate test with initial breakpoint */
  787. kgdb_breakpoint();
  788. kgdbts_break_test();
  789. kgdbts_break_test();
  790. }
  791. static void kgdbts_run_tests(void)
  792. {
  793. char *ptr;
  794. int fork_test = 0;
  795. int do_sys_open_test = 0;
  796. int sstep_test = 1000;
  797. int nmi_sleep = 0;
  798. int i;
  799. ptr = strstr(config, "F");
  800. if (ptr)
  801. fork_test = simple_strtol(ptr + 1, NULL, 10);
  802. ptr = strstr(config, "S");
  803. if (ptr)
  804. do_sys_open_test = simple_strtol(ptr + 1, NULL, 10);
  805. ptr = strstr(config, "N");
  806. if (ptr)
  807. nmi_sleep = simple_strtol(ptr+1, NULL, 10);
  808. ptr = strstr(config, "I");
  809. if (ptr)
  810. sstep_test = simple_strtol(ptr+1, NULL, 10);
  811. /* required internal KGDB tests */
  812. v1printk("kgdbts:RUN plant and detach test\n");
  813. run_plant_and_detach_test(0);
  814. v1printk("kgdbts:RUN sw breakpoint test\n");
  815. run_breakpoint_test(0);
  816. v1printk("kgdbts:RUN bad memory access test\n");
  817. run_bad_read_test();
  818. v1printk("kgdbts:RUN singlestep test %i iterations\n", sstep_test);
  819. for (i = 0; i < sstep_test; i++) {
  820. run_singlestep_break_test();
  821. if (i % 100 == 0)
  822. v1printk("kgdbts:RUN singlestep [%i/%i]\n",
  823. i, sstep_test);
  824. }
  825. /* ===Optional tests=== */
  826. /* All HW break point tests */
  827. if (arch_kgdb_ops.flags & KGDB_HW_BREAKPOINT) {
  828. v1printk("kgdbts:RUN hw breakpoint test\n");
  829. run_breakpoint_test(1);
  830. v1printk("kgdbts:RUN hw write breakpoint test\n");
  831. run_hw_break_test(1);
  832. v1printk("kgdbts:RUN access write breakpoint test\n");
  833. run_hw_break_test(0);
  834. }
  835. if (nmi_sleep) {
  836. v1printk("kgdbts:RUN NMI sleep %i seconds test\n", nmi_sleep);
  837. run_nmi_sleep_test(nmi_sleep);
  838. }
  839. /* If the do_fork test is run it will be the last test that is
  840. * executed because a kernel thread will be spawned at the very
  841. * end to unregister the debug hooks.
  842. */
  843. if (fork_test) {
  844. repeat_test = fork_test;
  845. printk(KERN_INFO "kgdbts:RUN do_fork for %i breakpoints\n",
  846. repeat_test);
  847. kthread_run(kgdbts_unreg_thread, NULL, "kgdbts_unreg");
  848. run_do_fork_test();
  849. return;
  850. }
  851. /* If the sys_open test is run it will be the last test that is
  852. * executed because a kernel thread will be spawned at the very
  853. * end to unregister the debug hooks.
  854. */
  855. if (do_sys_open_test) {
  856. repeat_test = do_sys_open_test;
  857. printk(KERN_INFO "kgdbts:RUN sys_open for %i breakpoints\n",
  858. repeat_test);
  859. kthread_run(kgdbts_unreg_thread, NULL, "kgdbts_unreg");
  860. run_sys_open_test();
  861. return;
  862. }
  863. /* Shutdown and unregister */
  864. kgdb_unregister_io_module(&kgdbts_io_ops);
  865. configured = 0;
  866. }
  867. static int kgdbts_option_setup(char *opt)
  868. {
  869. if (strlen(opt) > MAX_CONFIG_LEN) {
  870. printk(KERN_ERR "kgdbts: config string too long\n");
  871. return -ENOSPC;
  872. }
  873. strcpy(config, opt);
  874. verbose = 0;
  875. if (strstr(config, "V1"))
  876. verbose = 1;
  877. if (strstr(config, "V2"))
  878. verbose = 2;
  879. return 0;
  880. }
  881. __setup("kgdbts=", kgdbts_option_setup);
  882. static int configure_kgdbts(void)
  883. {
  884. int err = 0;
  885. if (!strlen(config) || isspace(config[0]))
  886. goto noconfig;
  887. err = kgdbts_option_setup(config);
  888. if (err)
  889. goto noconfig;
  890. final_ack = 0;
  891. run_plant_and_detach_test(1);
  892. err = kgdb_register_io_module(&kgdbts_io_ops);
  893. if (err) {
  894. configured = 0;
  895. return err;
  896. }
  897. configured = 1;
  898. kgdbts_run_tests();
  899. return err;
  900. noconfig:
  901. config[0] = 0;
  902. configured = 0;
  903. return err;
  904. }
  905. static int __init init_kgdbts(void)
  906. {
  907. /* Already configured? */
  908. if (configured == 1)
  909. return 0;
  910. return configure_kgdbts();
  911. }
  912. static void cleanup_kgdbts(void)
  913. {
  914. if (configured == 1)
  915. kgdb_unregister_io_module(&kgdbts_io_ops);
  916. }
  917. static int kgdbts_get_char(void)
  918. {
  919. int val = 0;
  920. if (ts.run_test)
  921. val = ts.run_test(1, 0);
  922. return val;
  923. }
  924. static void kgdbts_put_char(u8 chr)
  925. {
  926. if (ts.run_test)
  927. ts.run_test(0, chr);
  928. }
  929. static int param_set_kgdbts_var(const char *kmessage, struct kernel_param *kp)
  930. {
  931. int len = strlen(kmessage);
  932. if (len >= MAX_CONFIG_LEN) {
  933. printk(KERN_ERR "kgdbts: config string too long\n");
  934. return -ENOSPC;
  935. }
  936. /* Only copy in the string if the init function has not run yet */
  937. if (configured < 0) {
  938. strcpy(config, kmessage);
  939. return 0;
  940. }
  941. if (kgdb_connected) {
  942. printk(KERN_ERR
  943. "kgdbts: Cannot reconfigure while KGDB is connected.\n");
  944. return -EBUSY;
  945. }
  946. strcpy(config, kmessage);
  947. /* Chop out \n char as a result of echo */
  948. if (config[len - 1] == '\n')
  949. config[len - 1] = '\0';
  950. if (configured == 1)
  951. cleanup_kgdbts();
  952. /* Go and configure with the new params. */
  953. return configure_kgdbts();
  954. }
  955. static void kgdbts_pre_exp_handler(void)
  956. {
  957. /* Increment the module count when the debugger is active */
  958. if (!kgdb_connected)
  959. try_module_get(THIS_MODULE);
  960. }
  961. static void kgdbts_post_exp_handler(void)
  962. {
  963. /* decrement the module count when the debugger detaches */
  964. if (!kgdb_connected)
  965. module_put(THIS_MODULE);
  966. }
  967. static struct kgdb_io kgdbts_io_ops = {
  968. .name = "kgdbts",
  969. .read_char = kgdbts_get_char,
  970. .write_char = kgdbts_put_char,
  971. .pre_exception = kgdbts_pre_exp_handler,
  972. .post_exception = kgdbts_post_exp_handler,
  973. };
  974. module_init(init_kgdbts);
  975. module_exit(cleanup_kgdbts);
  976. module_param_call(kgdbts, param_set_kgdbts_var, param_get_string, &kps, 0644);
  977. MODULE_PARM_DESC(kgdbts, "<A|V1|V2>[F#|S#][N#]");
  978. MODULE_DESCRIPTION("KGDB Test Suite");
  979. MODULE_LICENSE("GPL");
  980. MODULE_AUTHOR("Wind River Systems, Inc.");