xref: /illumos-gate/usr/src/cmd/dis/dis_target.h (revision c5bab7026b8e0ac44b25ee08507ea360f177d844)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 
22 /*
23  * Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  *
26  * Copyright 2011 Jason King.  All rights reserved.
27  */
28 
29 #ifndef	_DIS_TARGET_H
30 #define	_DIS_TARGET_H
31 
32 #ifdef __cplusplus
33 extern "C" {
34 #endif
35 
36 #include <gelf.h>
37 #include <sys/types.h>
38 
39 /*
40  * Basic types
41  */
42 typedef struct dis_tgt dis_tgt_t;
43 typedef struct dis_func dis_func_t;
44 typedef struct dis_scn dis_scn_t;
45 
46 /*
47  * Target management
48  */
49 dis_tgt_t *dis_tgt_create(const char *);
50 void dis_tgt_destroy(dis_tgt_t *);
51 const char *dis_tgt_lookup(dis_tgt_t *, uint64_t, off_t *, int, size_t *,
52     int *);
53 const char *dis_find_section(dis_tgt_t *, uint64_t, off_t *);
54 const char *dis_tgt_name(dis_tgt_t *);
55 const char *dis_tgt_member(dis_tgt_t *);
56 void dis_tgt_ehdr(dis_tgt_t *, GElf_Ehdr *);
57 off_t dis_tgt_next_symbol(dis_tgt_t *, uint64_t);
58 dis_tgt_t *dis_tgt_next(dis_tgt_t *);
59 
60 /*
61  * Section management
62  */
63 typedef void (*section_iter_f)(dis_tgt_t *, dis_scn_t *, void *);
64 void dis_tgt_section_iter(dis_tgt_t *, section_iter_f, void *);
65 
66 int dis_section_istext(dis_scn_t *);
67 void *dis_section_data(dis_scn_t *);
68 size_t dis_section_size(dis_scn_t *);
69 uint64_t dis_section_addr(dis_scn_t *);
70 const char *dis_section_name(dis_scn_t *);
71 dis_scn_t *dis_section_copy(dis_scn_t *);
72 void dis_section_free(dis_scn_t *);
73 
74 /*
75  * Function management
76  */
77 typedef void (*function_iter_f)(dis_tgt_t *, dis_func_t *, void *);
78 void dis_tgt_function_iter(dis_tgt_t *, function_iter_f, void *);
79 dis_func_t *dis_tgt_function_lookup(dis_tgt_t *, const char *);
80 
81 void *dis_function_data(dis_func_t *);
82 size_t dis_function_size(dis_func_t *);
83 uint64_t dis_function_addr(dis_func_t *);
84 const char *dis_function_name(dis_func_t *);
85 dis_func_t *dis_function_copy(dis_func_t *);
86 void dis_function_free(dis_func_t *);
87 
88 #ifdef __cplusplus
89 }
90 #endif
91 
92 #endif /* _DIS_TARGET_H */
93