decoder.hpp revision 2721:f08d439fab8c 
1/*
2 * Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation.
8 *
9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 * or visit www.oracle.com if you need additional information or have any
21 * questions.
22 *
23 */
24
25
26#ifndef __DECODER_HPP
27#define __DECODER_HPP
28
29#include "memory/allocation.hpp"
30
31#ifdef _WINDOWS
32#include <windows.h>
33#include <imagehlp.h>
34
35// functions needed for decoding symbols
36typedef DWORD (WINAPI *pfn_SymSetOptions)(DWORD);
37typedef BOOL  (WINAPI *pfn_SymInitialize)(HANDLE, PCTSTR, BOOL);
38typedef BOOL  (WINAPI *pfn_SymGetSymFromAddr64)(HANDLE, DWORD64, PDWORD64, PIMAGEHLP_SYMBOL64);
39typedef DWORD (WINAPI *pfn_UndecorateSymbolName)(const char*, char*, DWORD, DWORD);
40
41#elif defined(__APPLE__)
42
43#else
44
45class ElfFile;
46
47#endif // _WINDOWS
48
49
50class Decoder: public StackObj {
51
52 public:
53  // status code for decoding native C frame
54  enum decoder_status {
55         no_error,             // successfully decoded frames
56         out_of_memory,        // out of memory
57         file_invalid,         // invalid elf file
58         file_not_found,       // could not found symbol file (on windows), such as jvm.pdb or jvm.map
59         helper_not_found,     // could not load dbghelp.dll (Windows only)
60         helper_func_error,    // decoding functions not found (Windows only)
61         helper_init_error,    // SymInitialize failed (Windows only)
62         symbol_not_found      // could not find the symbol
63  };
64
65 public:
66  Decoder() { initialize(); };
67  ~Decoder() { uninitialize(); };
68
69  static bool can_decode_C_frame_in_vm();
70
71  static void initialize();
72  static void uninitialize();
73
74#ifdef _WINDOWS
75  static decoder_status    decode(address addr, char *buf, int buflen, int *offset);
76#else
77  static decoder_status    decode(address addr, const char* filepath, char *buf, int buflen, int *offset);
78#endif
79
80  static bool              demangle(const char* symbol, char *buf, int buflen);
81
82  static decoder_status    get_status() { return _decoder_status; };
83
84#if !defined(_WINDOWS) && !defined(__APPLE__)
85 private:
86  static ElfFile*         get_elf_file(const char* filepath);
87#endif // _WINDOWS
88
89
90 private:
91  static decoder_status     _decoder_status;
92  static bool               _initialized;
93
94#ifdef _WINDOWS
95  static HMODULE                   _dbghelp_handle;
96  static bool                      _can_decode_in_vm;
97  static pfn_SymGetSymFromAddr64   _pfnSymGetSymFromAddr64;
98  static pfn_UndecorateSymbolName  _pfnUndecorateSymbolName;
99#elif __APPLE__
100#else
101  static ElfFile*                  _opened_elf_files;
102#endif // _WINDOWS
103};
104
105#endif // __DECODER_HPP
106