xref: /illumos-gate/usr/src/cmd/dis/dis_target.h (revision a386cc11a86ecb60f5a48078d22c1500e2ad003e)
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 #if !defined(__sparc)
58 off_t dis_tgt_next_symbol(dis_tgt_t *, uint64_t);
59 #endif
60 dis_tgt_t *dis_tgt_next(dis_tgt_t *);
61 
62 /*
63  * Section management
64  */
65 typedef void (*section_iter_f)(dis_tgt_t *, dis_scn_t *, void *);
66 void dis_tgt_section_iter(dis_tgt_t *, section_iter_f, void *);
67 
68 int dis_section_istext(dis_scn_t *);
69 void *dis_section_data(dis_scn_t *);
70 size_t dis_section_size(dis_scn_t *);
71 uint64_t dis_section_addr(dis_scn_t *);
72 const char *dis_section_name(dis_scn_t *);
73 dis_scn_t *dis_section_copy(dis_scn_t *);
74 void dis_section_free(dis_scn_t *);
75 
76 /*
77  * Function management
78  */
79 typedef void (*function_iter_f)(dis_tgt_t *, dis_func_t *, void *);
80 void dis_tgt_function_iter(dis_tgt_t *, function_iter_f, void *);
81 dis_func_t *dis_tgt_function_lookup(dis_tgt_t *, const char *);
82 
83 void *dis_function_data(dis_func_t *);
84 size_t dis_function_size(dis_func_t *);
85 uint64_t dis_function_addr(dis_func_t *);
86 const char *dis_function_name(dis_func_t *);
87 dis_func_t *dis_function_copy(dis_func_t *);
88 void dis_function_free(dis_func_t *);
89 
90 #ifdef __cplusplus
91 }
92 #endif
93 
94 #endif /* _DIS_TARGET_H */
95