1 /*
2 * Copyright (c) 2003, 2018, 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 *
29 #include <limits.h>
30 #include "libproc.h"
31 #include "symtab.h"
32
33 // data structures in this file mimic those of Solaris 8.0 - libproc's Pcontrol.h
34
35 #define BUF_SIZE (PATH_MAX + NAME_MAX + 1)
36
37 // list of shared objects
38 typedef struct lib_info {
39 char name[BUF_SIZE];
40 uintptr_t base;
41 struct symtab* symtab;
42 int fd; // file descriptor for lib
43 struct lib_info* next;
44 } lib_info;
45
46 // list of threads
47 typedef struct thread_info {
48 lwpid_t lwp_id;
49 pthread_t pthread_id; // not used cores, always -1
50 struct user_regs_struct regs; // not for process, core uses for caching regset
51 struct thread_info* next;
52 } thread_info;
53
54 // list of virtual memory maps
55 typedef struct map_info {
56 int fd; // file descriptor
57 off_t offset; // file offset of this mapping
58 uintptr_t vaddr; // starting virtual address
59 size_t memsz; // size of the mapping
60 struct map_info* next;
61 } map_info;
62
63 // vtable for ps_prochandle
64 typedef struct ps_prochandle_ops {
65 // "derived class" clean-up
66 void (*release)(struct ps_prochandle* ph);
67 // read from debuggee
68 bool (*p_pread)(struct ps_prochandle *ph,
69 uintptr_t addr, char *buf, size_t size);
91 map_info** map_array; // sorted (by vaddr) array of map_info pointers
92 };
93
94 struct ps_prochandle {
95 ps_prochandle_ops* ops; // vtable ptr
96 pid_t pid;
97 int num_libs;
98 lib_info* libs; // head of lib list
99 lib_info* lib_tail; // tail of lib list - to append at the end
100 int num_threads;
101 thread_info* threads; // head of thread list
102 struct core_data* core; // data only used for core dumps, NULL for process
103 };
104
105 int pathmap_open(const char* name);
106
107 void print_debug(const char* format,...);
108 void print_error(const char* format,...);
109 bool is_debug();
110
111 typedef bool (*thread_info_callback)(struct ps_prochandle* ph, pthread_t pid, lwpid_t lwpid);
112
113 // reads thread info using libthread_db and calls above callback for each thread
114 bool read_thread_info(struct ps_prochandle* ph, thread_info_callback cb);
115
116 // deletes a thread from the thread list
117 void delete_thread_info(struct ps_prochandle* ph, thread_info* thr);
118
119 // adds a new shared object to lib list, returns NULL on failure
120 lib_info* add_lib_info(struct ps_prochandle* ph, const char* libname, uintptr_t base);
121
122 // adds a new shared object to lib list, supply open lib file descriptor as well
123 lib_info* add_lib_info_fd(struct ps_prochandle* ph, const char* libname, int fd,
124 uintptr_t base);
125
126 // adds a new thread to threads list, returns NULL on failure
127 thread_info* add_thread_info(struct ps_prochandle* ph, pthread_t pthread_id, lwpid_t lwp_id);
128
129 // a test for ELF signature without using libelf
130 bool is_elf_file(int fd);
131
132 #endif //_LIBPROC_IMPL_H_
|
1 /*
2 * Copyright (c) 2003, 2019, 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 *
29 #include <limits.h>
30 #include "libproc.h"
31 #include "symtab.h"
32
33 // data structures in this file mimic those of Solaris 8.0 - libproc's Pcontrol.h
34
35 #define BUF_SIZE (PATH_MAX + NAME_MAX + 1)
36
37 // list of shared objects
38 typedef struct lib_info {
39 char name[BUF_SIZE];
40 uintptr_t base;
41 struct symtab* symtab;
42 int fd; // file descriptor for lib
43 struct lib_info* next;
44 } lib_info;
45
46 // list of threads
47 typedef struct thread_info {
48 lwpid_t lwp_id;
49 struct user_regs_struct regs; // not for process, core uses for caching regset
50 struct thread_info* next;
51 } thread_info;
52
53 // list of virtual memory maps
54 typedef struct map_info {
55 int fd; // file descriptor
56 off_t offset; // file offset of this mapping
57 uintptr_t vaddr; // starting virtual address
58 size_t memsz; // size of the mapping
59 struct map_info* next;
60 } map_info;
61
62 // vtable for ps_prochandle
63 typedef struct ps_prochandle_ops {
64 // "derived class" clean-up
65 void (*release)(struct ps_prochandle* ph);
66 // read from debuggee
67 bool (*p_pread)(struct ps_prochandle *ph,
68 uintptr_t addr, char *buf, size_t size);
90 map_info** map_array; // sorted (by vaddr) array of map_info pointers
91 };
92
93 struct ps_prochandle {
94 ps_prochandle_ops* ops; // vtable ptr
95 pid_t pid;
96 int num_libs;
97 lib_info* libs; // head of lib list
98 lib_info* lib_tail; // tail of lib list - to append at the end
99 int num_threads;
100 thread_info* threads; // head of thread list
101 struct core_data* core; // data only used for core dumps, NULL for process
102 };
103
104 int pathmap_open(const char* name);
105
106 void print_debug(const char* format,...);
107 void print_error(const char* format,...);
108 bool is_debug();
109
110 // deletes a thread from the thread list
111 void delete_thread_info(struct ps_prochandle* ph, thread_info* thr);
112
113 // adds a new shared object to lib list, returns NULL on failure
114 lib_info* add_lib_info(struct ps_prochandle* ph, const char* libname, uintptr_t base);
115
116 // adds a new shared object to lib list, supply open lib file descriptor as well
117 lib_info* add_lib_info_fd(struct ps_prochandle* ph, const char* libname, int fd,
118 uintptr_t base);
119
120 // adds a new thread to threads list, returns NULL on failure
121 thread_info* add_thread_info(struct ps_prochandle* ph, lwpid_t lwp_id);
122
123 // a test for ELF signature without using libelf
124 bool is_elf_file(int fd);
125
126 #endif //_LIBPROC_IMPL_H_
|