| /* |
| * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. |
| * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
| * |
| * This code is free software; you can redistribute it and/or modify it |
| * under the terms of the GNU General Public License version 2 only, as |
| * published by the Free Software Foundation. |
| * |
| * This code is distributed in the hope that it will be useful, but WITHOUT |
| * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| * version 2 for more details (a copy is included in the LICENSE file that |
| * accompanied this code). |
| * |
| * You should have received a copy of the GNU General Public License version |
| * 2 along with this work; if not, write to the Free Software Foundation, |
| * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
| * |
| * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
| * or visit www.oracle.com if you need additional information or have any |
| * questions. |
| * |
| */ |
| |
| #ifndef _LIBPROC_H_ |
| #define _LIBPROC_H_ |
| |
| #include <unistd.h> |
| #include <stdint.h> |
| #include <stdarg.h> |
| #include <stdio.h> |
| #include <stdlib.h> |
| #include <string.h> |
| #include <fcntl.h> |
| |
| #ifdef __APPLE__ |
| typedef enum ps_err_e { |
| PS_OK, PS_ERR, PS_BADPID, PS_BADLID, |
| PS_BADADDR, PS_NOSYM, PS_NOFREGS |
| } ps_err_e; |
| |
| #ifndef psaddr_t |
| #define psaddr_t uintptr_t |
| #endif |
| |
| #ifndef bool |
| typedef int bool; |
| #define true 1 |
| #define false 0 |
| #endif // bool |
| |
| #ifndef lwpid_t |
| #define lwpid_t uintptr_t |
| #endif |
| |
| #include <mach/thread_status.h> |
| #else // __APPLE__ |
| #include <elf.h> |
| #include <link.h> |
| #include <machine/reg.h> |
| #include <proc_service.h> |
| #if defined(sparc) || defined(sparcv9) |
| /* |
| If _LP64 is defined ptrace.h should be taken from /usr/include/asm-sparc64 |
| otherwise it should be from /usr/include/asm-sparc |
| These two files define pt_regs structure differently |
| */ |
| #ifdef _LP64 |
| #include "asm-sparc64/ptrace.h" |
| #else |
| #include "asm-sparc/ptrace.h" |
| #endif |
| |
| #endif //sparc or sparcv9 |
| |
| // This C bool type must be int for compatibility with BSD calls and |
| // it would be a mistake to equivalence it to C++ bool on many platforms |
| typedef int bool; |
| #define true 1 |
| #define false 0 |
| |
| #endif // __APPLE__ |
| |
| /************************************************************************************ |
| |
| 0. This is very minimal subset of Solaris libproc just enough for current application. |
| Please note that the bulk of the functionality is from proc_service interface. This |
| adds Pgrab__ and some missing stuff. We hide the difference b/w live process and core |
| file by this interface. |
| |
| 1. pthread_id is unique. We store this in OSThread::_pthread_id in JVM code. |
| |
| 2. All threads see the same pid when they call getpid(). |
| We used to save the result of ::getpid() call in OSThread::_thread_id. |
| Because gettid returns actual pid of thread (lwp id), this is |
| unique again. We therefore use OSThread::_thread_id as unique identifier. |
| |
| 3. There is a unique LWP id under both thread libraries. libthread_db maps pthread_id |
| to its underlying lwp_id under both the thread libraries. thread_info.lwp_id stores |
| lwp_id of the thread. The lwp id is nothing but the actual pid of clone'd processes. But |
| unfortunately libthread_db does not work very well for core dumps. So, we get pthread_id |
| only for processes. For core dumps, we don't use libthread_db at all (like gdb). |
| |
| 4. ptrace operates on this LWP id under both the thread libraries. When we say 'pid' for |
| ptrace call, we refer to lwp_id of the thread. |
| |
| 5. for core file, we parse ELF files and read data from them. For processes we use |
| combination of ptrace and /proc calls. |
| |
| *************************************************************************************/ |
| |
| struct reg; |
| struct ps_prochandle; |
| |
| // attach to a process |
| struct ps_prochandle* Pgrab(pid_t pid); |
| |
| // attach to a core dump |
| struct ps_prochandle* Pgrab_core(const char* execfile, const char* corefile); |
| |
| // release a process or core |
| void Prelease(struct ps_prochandle* ph); |
| |
| // functions not directly available in Solaris libproc |
| |
| // initialize libproc (call this only once per app) |
| // pass true to make library verbose |
| bool init_libproc(bool verbose); |
| |
| // get number of threads |
| int get_num_threads(struct ps_prochandle* ph); |
| |
| // get lwp_id of n'th thread |
| lwpid_t get_lwp_id(struct ps_prochandle* ph, int index); |
| |
| // get regs for a given lwp |
| bool get_lwp_regs(struct ps_prochandle* ph, lwpid_t lid, struct reg* regs); |
| |
| // get number of shared objects |
| int get_num_libs(struct ps_prochandle* ph); |
| |
| // get name of n'th lib |
| const char* get_lib_name(struct ps_prochandle* ph, int index); |
| |
| // get base of lib |
| uintptr_t get_lib_base(struct ps_prochandle* ph, int index); |
| |
| // returns true if given library is found in lib list |
| bool find_lib(struct ps_prochandle* ph, const char *lib_name); |
| |
| // symbol lookup |
| uintptr_t lookup_symbol(struct ps_prochandle* ph, const char* object_name, |
| const char* sym_name); |
| |
| // address->nearest symbol lookup. return NULL for no symbol |
| const char* symbol_for_pc(struct ps_prochandle* ph, uintptr_t addr, uintptr_t* poffset); |
| |
| #endif //__LIBPROC_H_ |