Mercurial > hg > truffle
annotate agent/src/os/linux/libproc.h @ 17524:89152779163c
Merge with jdk8-b132
| author | Gilles Duboscq <duboscq@ssw.jku.at> |
|---|---|
| date | Wed, 15 Oct 2014 11:59:32 +0200 |
| parents | 4ca6dc0799b6 |
| children | 52b4284cb496 |
| rev | line source |
|---|---|
| 0 | 1 /* |
| 17524 | 2 * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. |
| 0 | 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 * | |
|
1552
c18cbe5936b8
6941466: Oracle rebranding changes for Hotspot repositories
trims
parents:
0
diff
changeset
|
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
|
c18cbe5936b8
6941466: Oracle rebranding changes for Hotspot repositories
trims
parents:
0
diff
changeset
|
20 * or visit www.oracle.com if you need additional information or have any |
|
c18cbe5936b8
6941466: Oracle rebranding changes for Hotspot repositories
trims
parents:
0
diff
changeset
|
21 * questions. |
| 0 | 22 * |
| 23 */ | |
| 24 | |
| 25 #ifndef _LIBPROC_H_ | |
| 26 #define _LIBPROC_H_ | |
| 27 | |
|
6641
a9fed06c01d2
7154641: Servicability agent should work on platforms other than x86, sparc
bpittore
parents:
1552
diff
changeset
|
28 #include <jni.h> |
| 0 | 29 #include <unistd.h> |
| 30 #include <stdint.h> | |
| 31 #include "proc_service.h" | |
| 32 | |
|
6641
a9fed06c01d2
7154641: Servicability agent should work on platforms other than x86, sparc
bpittore
parents:
1552
diff
changeset
|
33 #if defined(arm) || defined(ppc) |
|
a9fed06c01d2
7154641: Servicability agent should work on platforms other than x86, sparc
bpittore
parents:
1552
diff
changeset
|
34 #include "libproc_md.h" |
|
a9fed06c01d2
7154641: Servicability agent should work on platforms other than x86, sparc
bpittore
parents:
1552
diff
changeset
|
35 #endif |
|
a9fed06c01d2
7154641: Servicability agent should work on platforms other than x86, sparc
bpittore
parents:
1552
diff
changeset
|
36 |
| 0 | 37 #if defined(sparc) || defined(sparcv9) |
| 38 /* | |
| 39 If _LP64 is defined ptrace.h should be taken from /usr/include/asm-sparc64 | |
| 40 otherwise it should be from /usr/include/asm-sparc | |
| 41 These two files define pt_regs structure differently | |
| 42 */ | |
| 43 #ifdef _LP64 | |
| 44 #include "asm-sparc64/ptrace.h" | |
| 45 #else | |
| 46 #include "asm-sparc/ptrace.h" | |
| 47 #endif | |
| 48 | |
| 49 #endif //sparc or sparcv9 | |
| 50 | |
| 51 /************************************************************************************ | |
| 52 | |
| 53 0. This is very minimal subset of Solaris libproc just enough for current application. | |
| 54 Please note that the bulk of the functionality is from proc_service interface. This | |
| 55 adds Pgrab__ and some missing stuff. We hide the difference b/w live process and core | |
| 56 file by this interface. | |
| 57 | |
| 58 1. pthread_id unique in both NPTL & LinuxThreads. We store this in | |
| 59 OSThread::_pthread_id in JVM code. | |
| 60 | |
| 61 2. All threads see the same pid when they call getpid() under NPTL. | |
| 62 Threads receive different pid under LinuxThreads. We used to save the result of | |
| 63 ::getpid() call in OSThread::_thread_id. This way uniqueness of OSThread::_thread_id | |
| 64 was lost under NPTL. Now, we store the result of ::gettid() call in | |
| 65 OSThread::_thread_id. Because gettid returns actual pid of thread (lwp id), this is | |
| 66 unique again. We therefore use OSThread::_thread_id as unique identifier. | |
| 67 | |
| 68 3. There is a unique LWP id under both thread libraries. libthread_db maps pthread_id | |
| 69 to its underlying lwp_id under both the thread libraries. thread_info.lwp_id stores | |
| 70 lwp_id of the thread. The lwp id is nothing but the actual pid of clone'd processes. But | |
| 71 unfortunately libthread_db does not work very well for core dumps. So, we get pthread_id | |
| 72 only for processes. For core dumps, we don't use libthread_db at all (like gdb). | |
| 73 | |
| 74 4. ptrace operates on this LWP id under both the thread libraries. When we say 'pid' for | |
| 75 ptrace call, we refer to lwp_id of the thread. | |
| 76 | |
| 77 5. for core file, we parse ELF files and read data from them. For processes we use | |
| 78 combination of ptrace and /proc calls. | |
| 79 | |
| 80 *************************************************************************************/ | |
| 81 | |
| 82 | |
| 14909 | 83 #if defined(sparc) || defined(sparcv9) |
| 0 | 84 #define user_regs_struct pt_regs |
| 85 #endif | |
| 86 | |
| 87 // This C bool type must be int for compatibility with Linux calls and | |
| 88 // it would be a mistake to equivalence it to C++ bool on many platforms | |
| 89 | |
| 90 typedef int bool; | |
| 91 #define true 1 | |
| 92 #define false 0 | |
| 93 | |
| 94 struct ps_prochandle; | |
| 95 | |
| 96 // attach to a process | |
| 97 struct ps_prochandle* Pgrab(pid_t pid); | |
| 98 | |
| 99 // attach to a core dump | |
| 100 struct ps_prochandle* Pgrab_core(const char* execfile, const char* corefile); | |
| 101 | |
| 102 // release a process or core | |
| 103 void Prelease(struct ps_prochandle* ph); | |
| 104 | |
| 105 // functions not directly available in Solaris libproc | |
| 106 | |
| 107 // initialize libproc (call this only once per app) | |
| 108 // pass true to make library verbose | |
| 109 bool init_libproc(bool verbose); | |
| 110 | |
| 111 // get number of threads | |
| 112 int get_num_threads(struct ps_prochandle* ph); | |
| 113 | |
| 114 // get lwp_id of n'th thread | |
| 115 lwpid_t get_lwp_id(struct ps_prochandle* ph, int index); | |
| 116 | |
| 117 // get regs for a given lwp | |
| 118 bool get_lwp_regs(struct ps_prochandle* ph, lwpid_t lid, struct user_regs_struct* regs); | |
| 119 | |
| 120 // get number of shared objects | |
| 121 int get_num_libs(struct ps_prochandle* ph); | |
| 122 | |
| 123 // get name of n'th lib | |
| 124 const char* get_lib_name(struct ps_prochandle* ph, int index); | |
| 125 | |
| 126 // get base of lib | |
| 127 uintptr_t get_lib_base(struct ps_prochandle* ph, int index); | |
| 128 | |
| 129 // returns true if given library is found in lib list | |
| 130 bool find_lib(struct ps_prochandle* ph, const char *lib_name); | |
| 131 | |
| 132 // symbol lookup | |
| 133 uintptr_t lookup_symbol(struct ps_prochandle* ph, const char* object_name, | |
| 134 const char* sym_name); | |
| 135 | |
| 136 // address->nearest symbol lookup. return NULL for no symbol | |
| 137 const char* symbol_for_pc(struct ps_prochandle* ph, uintptr_t addr, uintptr_t* poffset); | |
| 138 | |
|
6641
a9fed06c01d2
7154641: Servicability agent should work on platforms other than x86, sparc
bpittore
parents:
1552
diff
changeset
|
139 struct ps_prochandle* get_proc_handle(JNIEnv* env, jobject this_obj); |
|
a9fed06c01d2
7154641: Servicability agent should work on platforms other than x86, sparc
bpittore
parents:
1552
diff
changeset
|
140 |
|
a9fed06c01d2
7154641: Servicability agent should work on platforms other than x86, sparc
bpittore
parents:
1552
diff
changeset
|
141 void throw_new_debugger_exception(JNIEnv* env, const char* errMsg); |
|
a9fed06c01d2
7154641: Servicability agent should work on platforms other than x86, sparc
bpittore
parents:
1552
diff
changeset
|
142 |
| 0 | 143 #endif //__LIBPROC_H_ |