xref: /illumos-gate/usr/src/cmd/dis/dis_target.h (revision f94c602698937f2fc025056c894e5a769f39d8fe)
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 
27 #ifndef	_DIS_TARGET_H
28 #define	_DIS_TARGET_H
29 
30 #pragma ident	"%Z%%M%	%I%	%E% SMI"
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_tgt_name(dis_tgt_t *);
54 const char *dis_tgt_member(dis_tgt_t *);
55 void dis_tgt_ehdr(dis_tgt_t *, GElf_Ehdr *);
56 off_t dis_tgt_next_symbol(dis_tgt_t *, uint64_t);
57 dis_tgt_t *dis_tgt_next(dis_tgt_t *);
58 
59 /*
60  * Section management
61  */
62 typedef void (*section_iter_f)(dis_tgt_t *, dis_scn_t *, void *);
63 void dis_tgt_section_iter(dis_tgt_t *, section_iter_f, void *);
64 
65 int dis_section_istext(dis_scn_t *);
66 void *dis_section_data(dis_scn_t *);
67 size_t dis_section_size(dis_scn_t *);
68 uint64_t dis_section_addr(dis_scn_t *);
69 const char *dis_section_name(dis_scn_t *);
70 dis_scn_t *dis_section_copy(dis_scn_t *);
71 void dis_section_free(dis_scn_t *);
72 
73 /*
74  * Function management
75  */
76 typedef void (*function_iter_f)(dis_tgt_t *, dis_func_t *, void *);
77 void dis_tgt_function_iter(dis_tgt_t *, function_iter_f, void *);
78 dis_func_t *dis_tgt_function_lookup(dis_tgt_t *, const char *);
79 
80 void *dis_function_data(dis_func_t *);
81 size_t dis_function_size(dis_func_t *);
82 uint64_t dis_function_addr(dis_func_t *);
83 const char *dis_function_name(dis_func_t *);
84 dis_func_t *dis_function_copy(dis_func_t *);
85 void dis_function_free(dis_func_t *);
86 
87 #ifdef __cplusplus
88 }
89 #endif
90 
91 #endif /* _DIS_TARGET_H */
92