debugreg.h 3.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990
  1. /* Copyright (C) 1998, 2000 Free Software Foundation, Inc.
  2. This file is part of the GNU C Library.
  3. The GNU C Library is free software; you can redistribute it and/or
  4. modify it under the terms of the GNU Lesser General Public
  5. License as published by the Free Software Foundation; either
  6. version 2.1 of the License, or (at your option) any later version.
  7. The GNU C Library is distributed in the hope that it will be useful,
  8. but WITHOUT ANY WARRANTY; without even the implied warranty of
  9. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  10. Lesser General Public License for more details.
  11. You should have received a copy of the GNU Lesser General Public
  12. License along with the GNU C Library; if not, see
  13. <http://www.gnu.org/licenses/>. */
  14. #ifndef _SYS_DEBUGREG_H
  15. #define _SYS_DEBUGREG_H 1
  16. /* Indicate the register numbers for a number of the specific
  17. debug registers. Registers 0-3 contain the addresses we wish to trap on */
  18. #define DR_FIRSTADDR 0 /* u_debugreg[DR_FIRSTADDR] */
  19. #define DR_LASTADDR 3 /* u_debugreg[DR_LASTADDR] */
  20. #define DR_STATUS 6 /* u_debugreg[DR_STATUS] */
  21. #define DR_CONTROL 7 /* u_debugreg[DR_CONTROL] */
  22. /* Define a few things for the status register. We can use this to determine
  23. which debugging register was responsible for the trap. The other bits
  24. are either reserved or not of interest to us. */
  25. #define DR_TRAP0 (0x1) /* db0 */
  26. #define DR_TRAP1 (0x2) /* db1 */
  27. #define DR_TRAP2 (0x4) /* db2 */
  28. #define DR_TRAP3 (0x8) /* db3 */
  29. #define DR_STEP (0x4000) /* single-step */
  30. #define DR_SWITCH (0x8000) /* task switch */
  31. /* Now define a bunch of things for manipulating the control register.
  32. The top two bytes of the control register consist of 4 fields of 4
  33. bits - each field corresponds to one of the four debug registers,
  34. and indicates what types of access we trap on, and how large the data
  35. field is that we are looking at */
  36. #define DR_CONTROL_SHIFT 16 /* Skip this many bits in ctl register */
  37. #define DR_CONTROL_SIZE 4 /* 4 control bits per register */
  38. #define DR_RW_EXECUTE (0x0) /* Settings for the access types to trap on */
  39. #define DR_RW_WRITE (0x1)
  40. #define DR_RW_READ (0x3)
  41. #define DR_LEN_1 (0x0) /* Settings for data length to trap on */
  42. #define DR_LEN_2 (0x4)
  43. #define DR_LEN_4 (0xC)
  44. /* The low byte to the control register determine which registers are
  45. enabled. There are 4 fields of two bits. One bit is "local", meaning
  46. that the processor will reset the bit after a task switch and the other
  47. is global meaning that we have to explicitly reset the bit. With linux,
  48. you can use either one, since we explicitly zero the register when we enter
  49. kernel mode. */
  50. #define DR_LOCAL_ENABLE_SHIFT 0 /* Extra shift to the local enable bit */
  51. #define DR_GLOBAL_ENABLE_SHIFT 1 /* Extra shift to the global enable bit */
  52. #define DR_ENABLE_SIZE 2 /* 2 enable bits per register */
  53. #define DR_LOCAL_ENABLE_MASK (0x55) /* Set local bits for all 4 regs */
  54. #define DR_GLOBAL_ENABLE_MASK (0xAA) /* Set global bits for all 4 regs */
  55. /* The second byte to the control register has a few special things.
  56. On the i386, you should set the DR_LOCAL_SLOWDOWN or
  57. DR_GLOBAL_SLOWDOWN bits if you want to know exactly which
  58. instruction triggered the watchpoint. Setting these bits causes
  59. the processor to run more slowly, but leaving them clear makes it
  60. treat watchpoint hits as imprecise exceptions, so you can't
  61. reliably determine which instruction caused the hit.
  62. The i486 and all later IA-32 processors ignore DR_LOCAL_SLOWDOWN
  63. and DR_GLOBAL_SLOWDOWN. They always report the exception
  64. precisely, except in some rare cases, which the user can't do
  65. anything about. */
  66. #define DR_CONTROL_RESERVED (0xFC00) /* Reserved by Intel */
  67. #define DR_LOCAL_SLOWDOWN (0x100) /* Local slow the pipeline */
  68. #define DR_GLOBAL_SLOWDOWN (0x200) /* Global slow the pipeline */
  69. #endif /* sys/debugreg.h */