unw_flush_cache.man 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
  1. '\" t
  2. .\" Manual page created with latex2man on Thu Aug 16 09:44:44 MDT 2007
  3. .\" NOTE: This file is generated, DO NOT EDIT.
  4. .de Vb
  5. .ft CW
  6. .nf
  7. ..
  8. .de Ve
  9. .ft R
  10. .fi
  11. ..
  12. .TH "UNW\\_FLUSH\\_CACHE" "3" "16 August 2007" "Programming Library " "Programming Library "
  13. .SH NAME
  14. unw_flush_cache
  15. \-\- flush cached info
  16. .PP
  17. .SH SYNOPSIS
  18. .PP
  19. #include <libunwind.h>
  20. .br
  21. .PP
  22. void
  23. unw_flush_cache(unw_addr_space_t
  24. as,
  25. unw_word_t
  26. lo,
  27. unw_word_t
  28. hi);
  29. .br
  30. .PP
  31. .SH DESCRIPTION
  32. .PP
  33. The unw_flush_cache()
  34. routine flushes all cached info as it
  35. relates to address\-range lo
  36. to hi
  37. (non\-inclusive) in the
  38. target address\-space as\&.
  39. In addition, all info cached for
  40. address\-space as
  41. that is not tied to a particular code\-range is
  42. also flushed. For example, the address of the dynamic registration
  43. list is not tied to a code\-range and its cached value (if any) is
  44. flushed by a call to this routine. The address range specified by
  45. lo
  46. and hi
  47. should be understood as a hint:
  48. unw_flush_cache()
  49. may flush more information than requested,
  50. but \fInever\fP
  51. less. In other words, unw_flush_cache()
  52. may
  53. overflush, but not underflush.
  54. .PP
  55. As a special case, if arguments lo
  56. and hi
  57. are both 0, all
  58. information cached on behalf of address space as
  59. is flushed.
  60. .PP
  61. .SH RETURN VALUE
  62. .PP
  63. The unw_flush_cache()
  64. routine cannot fail and does not
  65. return a value.
  66. .PP
  67. .SH THREAD AND SIGNAL SAFETY
  68. .PP
  69. The unw_flush_cache()
  70. routine is thread\-safe as well as safe to
  71. use from a signal handler.
  72. .PP
  73. .SH SEE ALSO
  74. .PP
  75. libunwind(3),
  76. unw_set_caching_policy(3)
  77. .PP
  78. .SH AUTHOR
  79. .PP
  80. David Mosberger\-Tang
  81. .br
  82. Email: \fBdmosberger@gmail.com\fP
  83. .br
  84. WWW: \fBhttp://www.nongnu.org/libunwind/\fP\&.
  85. .\" NOTE: This file is generated, DO NOT EDIT.