1/*
2 * Copyright (c) 2004 Apple Computer, Inc. All rights reserved.
3 *
4 * @APPLE_LICENSE_HEADER_START@
5 *
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. Please obtain a copy of the License at
10 * http://www.opensource.apple.com/apsl/ and read it before using this
11 * file.
12 *
13 * The Original Code and all software distributed under the License are
14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 * Please see the License for the specific language governing rights and
19 * limitations under the License.
20 *
21 * @APPLE_LICENSE_HEADER_END@
22 */
23#ifndef _MACH_O_GETSECT_H_
24#define _MACH_O_GETSECT_H_
25
26#include <stdint.h>
27#include <mach-o/loader.h>
28#include <Availability.h>
29#include <TargetConditionals.h>
30
31#ifndef __CCTOOLS_DEPRECATED
32 #define __CCTOOLS_DEPRECATED __API_DEPRECATED("No longer supported", macos(10.0, 13.0), ios(1.0, 16.0), watchos(1.0, 8.0), tvos(1.0, 16.0))
33 #define __CCTOOLS_DEPRECATED_MSG(_msg) __API_DEPRECATED_WITH_REPLACEMENT(_msg, macos(10.0, 13.0), ios(1.0, 16.0), watchos(1.0, 8.0), tvos(1.0, 16.0))
34#endif
35
36
37#ifdef __cplusplus
38extern "C" {
39#endif /* __cplusplus */
40
41/*
42 * Runtime interfaces for Mach-O programs. For both 32-bit and 64-bit programs,
43 * where the sizes returned will be 32-bit or 64-bit based on the size of
44 * 'unsigned long'.
45 */
46extern char *getsectdata(
47 const char *segname,
48 const char *sectname,
49 unsigned long *size) __CCTOOLS_DEPRECATED_MSG("use getsectiondata()");
50
51extern char *getsectdatafromFramework(
52 const char *FrameworkName,
53 const char *segname,
54 const char *sectname,
55 unsigned long *size) __CCTOOLS_DEPRECATED;
56
57extern unsigned long get_end(void) __CCTOOLS_DEPRECATED;
58extern unsigned long get_etext(void) __CCTOOLS_DEPRECATED;
59extern unsigned long get_edata(void) __CCTOOLS_DEPRECATED;
60
61#ifndef __LP64__
62/*
63 * Runtime interfaces for 32-bit Mach-O programs.
64 */
65extern const struct section *getsectbyname(
66 const char *segname,
67 const char *sectname) __CCTOOLS_DEPRECATED_MSG("use getsectiondata(&__dso_handle,)");
68
69extern uint8_t *getsectiondata(
70 const struct mach_header *mhp,
71 const char *segname,
72 const char *sectname,
73 unsigned long *size);
74
75extern const struct segment_command *getsegbyname(
76 const char *segname) __CCTOOLS_DEPRECATED;
77
78extern uint8_t *getsegmentdata(
79 const struct mach_header *mhp,
80 const char *segname,
81 unsigned long *size);
82
83#else /* defined(__LP64__) */
84/*
85 * Runtime interfaces for 64-bit Mach-O programs.
86 */
87extern const struct section_64 *getsectbyname(
88 const char *segname,
89 const char *sectname);
90
91extern uint8_t *getsectiondata(
92 const struct mach_header_64 *mhp,
93 const char *segname,
94 const char *sectname,
95 unsigned long *size);
96
97extern const struct segment_command_64 *getsegbyname(
98 const char *segname) __CCTOOLS_DEPRECATED;
99
100extern uint8_t *getsegmentdata(
101 const struct mach_header_64 *mhp,
102 const char *segname,
103 unsigned long *size);
104
105#endif /* defined(__LP64__) */
106
107/*
108 * Interfaces for tools working with 32-bit Mach-O files.
109 */
110extern char *getsectdatafromheader(
111 const struct mach_header *mhp,
112 const char *segname,
113 const char *sectname,
114 uint32_t *size) __CCTOOLS_DEPRECATED_MSG("use getsectiondata()");
115
116extern const struct section *getsectbynamefromheader(
117 const struct mach_header *mhp,
118 const char *segname,
119 const char *sectname) __CCTOOLS_DEPRECATED_MSG("use getsectiondata()");
120
121extern const struct section *getsectbynamefromheaderwithswap(
122 struct mach_header *mhp,
123 const char *segname,
124 const char *sectname,
125 int fSwap) __CCTOOLS_DEPRECATED_MSG("use getsectiondata()");
126
127/*
128 * Interfaces for tools working with 64-bit Mach-O files.
129 */
130extern char *getsectdatafromheader_64(
131 const struct mach_header_64 *mhp,
132 const char *segname,
133 const char *sectname,
134 uint64_t *size) __CCTOOLS_DEPRECATED_MSG("use getsectiondata()");
135
136extern const struct section_64 *getsectbynamefromheader_64(
137 const struct mach_header_64 *mhp,
138 const char *segname,
139 const char *sectname) __CCTOOLS_DEPRECATED_MSG("use getsectiondata()");
140
141extern const struct section *getsectbynamefromheaderwithswap_64(
142 struct mach_header_64 *mhp,
143 const char *segname,
144 const char *sectname,
145 int fSwap) __CCTOOLS_DEPRECATED_MSG("use getsectiondata()");
146
147#ifdef __cplusplus
148}
149#endif /* __cplusplus */
150
151#endif /* _MACH_O_GETSECT_H_ */