Mercurial > jdk8-mips64-public > hotspot / file revision

 /*

  * 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_IMPL_H_

 #define _LIBPROC_IMPL_H_

 #include <unistd.h>

 #include <limits.h>

 #include "libproc.h"

 #include "symtab.h"

 #ifdef __APPLE__

 #include <inttypes.h>     // for PRIx64, 32, ...

 #include <pthread.h>

 #include <mach-o/loader.h>

 #include <mach-o/nlist.h>

 #include <mach-o/fat.h>

 #ifndef register_t

 #define register_t uint64_t

 #endif

 /*** registers copied from bsd/amd64 */

 typedef struct reg {

   register_t      r_r15;

   register_t      r_r14;

   register_t      r_r13;

   register_t      r_r12;

   register_t      r_r11;

   register_t      r_r10;

   register_t      r_r9;

   register_t      r_r8;

   register_t      r_rdi;

   register_t      r_rsi;

   register_t      r_rbp;

   register_t      r_rbx;

   register_t      r_rdx;

   register_t      r_rcx;

   register_t      r_rax;

   uint32_t        r_trapno;      // not used

   uint16_t        r_fs;

   uint16_t        r_gs;

   uint32_t        r_err;         // not used

   uint16_t        r_es;          // not used

   uint16_t        r_ds;          // not used

   register_t      r_rip;

   register_t      r_cs;

   register_t      r_rflags;

   register_t      r_rsp;

   register_t      r_ss;          // not used

 } reg;

 // convenient defs

 typedef struct mach_header_64 mach_header_64;

 typedef struct load_command load_command;

 typedef struct segment_command_64 segment_command_64;

 typedef struct thread_command thread_command;

 typedef struct dylib_command dylib_command;

 typedef struct symtab_command symtab_command;

 typedef struct nlist_64 nlist_64;

 #else

 #include <thread_db.h>

 #include "salibelf.h"

 #endif //  __APPLE__

 // data structures in this file mimic those of Solaris 8.0 - libproc's Pcontrol.h

 #define BUF_SIZE     (PATH_MAX + NAME_MAX + 1)

 // list of shared objects

 typedef struct lib_info {

   char             name[BUF_SIZE];

   uintptr_t        base;

   struct symtab*   symtab;

   int              fd;        // file descriptor for lib

   struct lib_info* next;

 } lib_info;

 // list of threads

 typedef struct sa_thread_info {

    lwpid_t                  lwp_id;     // same as pthread_t

    pthread_t                pthread_id; //

    struct reg               regs;       // not for process, core uses for caching regset

    struct sa_thread_info*   next;

 } sa_thread_info;

 // list of virtual memory maps

 typedef struct map_info {

    int              fd;       // file descriptor

    off_t            offset;   // file offset of this mapping

    uintptr_t        vaddr;    // starting virtual address

    size_t           memsz;    // size of the mapping

    struct map_info* next;

 } map_info;

 // vtable for ps_prochandle

 typedef struct ps_prochandle_ops {

    // "derived class" clean-up

    void (*release)(struct ps_prochandle* ph);

    // read from debuggee

    bool (*p_pread)(struct ps_prochandle *ph,

             uintptr_t addr, char *buf, size_t size);

    // write into debuggee

    bool (*p_pwrite)(struct ps_prochandle *ph,

             uintptr_t addr, const char *buf , size_t size);

    // get integer regset of a thread

    bool (*get_lwp_regs)(struct ps_prochandle* ph, lwpid_t lwp_id, struct reg* regs);

    // get info on thread

    bool (*get_lwp_info)(struct ps_prochandle *ph, lwpid_t lwp_id, void *linfo);

 } ps_prochandle_ops;

 // the ps_prochandle

 struct core_data {

    int                core_fd;   // file descriptor of core file

    int                exec_fd;   // file descriptor of exec file

    int                interp_fd; // file descriptor of interpreter (ld-elf.so.1)

    // part of the class sharing workaround

    int                classes_jsa_fd; // file descriptor of class share archive

    uintptr_t          dynamic_addr;  // address of dynamic section of a.out

    uintptr_t          ld_base_addr;  // base address of ld.so

    size_t             num_maps;  // number of maps.

    map_info*          maps;      // maps in a linked list

    // part of the class sharing workaround

    map_info*          class_share_maps;// class share maps in a linked list

    map_info**         map_array; // sorted (by vaddr) array of map_info pointers

    char               exec_path[4096];  // file name java

 };

 struct ps_prochandle {

    ps_prochandle_ops* ops;       // vtable ptr

    pid_t              pid;

    int                num_libs;

    lib_info*          libs;      // head of lib list

    lib_info*          lib_tail;  // tail of lib list - to append at the end

    int                num_threads;

    sa_thread_info*    threads;   // head of thread list

    struct core_data*  core;      // data only used for core dumps, NULL for process

 };

 int pathmap_open(const char* name);

 void print_debug(const char* format,...);

 void print_error(const char* format,...);

 bool is_debug();

 typedef bool (*thread_info_callback)(struct ps_prochandle* ph, pthread_t pid, lwpid_t lwpid);

 // reads thread info using libthread_db and calls above callback for each thread

 bool read_thread_info(struct ps_prochandle* ph, thread_info_callback cb);

 // adds a new shared object to lib list, returns NULL on failure

 lib_info* add_lib_info(struct ps_prochandle* ph, const char* libname, uintptr_t base);

 // adds a new shared object to lib list, supply open lib file descriptor as well

 lib_info* add_lib_info_fd(struct ps_prochandle* ph, const char* libname, int fd,

                           uintptr_t base);

 sa_thread_info* add_thread_info(struct ps_prochandle* ph, pthread_t pthread_id, lwpid_t lwp_id);

 // a test for ELF signature without using libelf

 #ifdef __APPLE__

 // a test for Mach-O signature

 bool is_macho_file(int fd);

 // skip fat head to get image start offset of cpu_type_t

 // return false if any error happens, else value in offset.

 bool get_arch_off(int fd, cpu_type_t cputype, off_t *offset);

 #else

 bool is_elf_file(int fd);

 #endif // __APPLE__

 lwpid_t get_lwp_id(struct ps_prochandle* ph, int index);

 bool set_lwp_id(struct ps_prochandle* ph, int index, lwpid_t lwpid);

 bool get_nth_lwp_regs(struct ps_prochandle* ph, int index, struct reg* regs);

 // ps_pglobal_lookup() looks up the symbol sym_name in the symbol table

 // of the load object object_name in the target process identified by ph.

 // It returns the symbol's value as an address in the target process in

 // *sym_addr.

 ps_err_e ps_pglobal_lookup(struct ps_prochandle *ph, const char *object_name,

                     const char *sym_name, psaddr_t *sym_addr);

 // read "size" bytes info "buf" from address "addr"

 ps_err_e ps_pread(struct ps_prochandle *ph, psaddr_t  addr,

                   void *buf, size_t size);

 // write "size" bytes of data to debuggee at address "addr"

 ps_err_e ps_pwrite(struct ps_prochandle *ph, psaddr_t addr,

                    const void *buf, size_t size);

 // fill in ptrace_lwpinfo for lid

 ps_err_e ps_linfo(struct ps_prochandle *ph, lwpid_t lwp_id, void *linfo);

 // needed for when libthread_db is compiled with TD_DEBUG defined

 void ps_plog (const char *format, ...);

 // untility, tells the position in file

 off_t ltell(int fd);

 #endif //_LIBPROC_IMPL_H_