Eric Christopher | e243fd9 | 2011-04-03 22:34:07 +0000 | [diff] [blame] | 1 | //===- Object.cpp - C bindings to the object file library--------*- C++ -*-===// |
| 2 | // |
| 3 | // The LLVM Compiler Infrastructure |
| 4 | // |
| 5 | // This file is distributed under the University of Illinois Open Source |
| 6 | // License. See LICENSE.TXT for details. |
| 7 | // |
| 8 | //===----------------------------------------------------------------------===// |
| 9 | // |
| 10 | // This file defines the C bindings to the file-format-independent object |
| 11 | // library. |
| 12 | // |
| 13 | //===----------------------------------------------------------------------===// |
| 14 | |
Eric Christopher | e243fd9 | 2011-04-03 22:34:07 +0000 | [diff] [blame] | 15 | #include "llvm-c/Object.h" |
Chandler Carruth | e3e43d9 | 2017-06-06 11:49:48 +0000 | [diff] [blame] | 16 | #include "llvm/ADT/SmallVector.h" |
Chandler Carruth | 974a445 | 2014-01-07 11:48:04 +0000 | [diff] [blame] | 17 | #include "llvm/Object/ObjectFile.h" |
Eric Christopher | e243fd9 | 2011-04-03 22:34:07 +0000 | [diff] [blame] | 18 | |
| 19 | using namespace llvm; |
| 20 | using namespace object; |
| 21 | |
Rafael Espindola | 548f2b6 | 2014-08-19 18:44:46 +0000 | [diff] [blame] | 22 | inline OwningBinary<ObjectFile> *unwrap(LLVMObjectFileRef OF) { |
| 23 | return reinterpret_cast<OwningBinary<ObjectFile> *>(OF); |
Eric Christopher | 3e39731 | 2013-04-22 22:47:22 +0000 | [diff] [blame] | 24 | } |
| 25 | |
Rafael Espindola | 548f2b6 | 2014-08-19 18:44:46 +0000 | [diff] [blame] | 26 | inline LLVMObjectFileRef wrap(const OwningBinary<ObjectFile> *OF) { |
| 27 | return reinterpret_cast<LLVMObjectFileRef>( |
| 28 | const_cast<OwningBinary<ObjectFile> *>(OF)); |
Eric Christopher | 3e39731 | 2013-04-22 22:47:22 +0000 | [diff] [blame] | 29 | } |
| 30 | |
| 31 | inline section_iterator *unwrap(LLVMSectionIteratorRef SI) { |
| 32 | return reinterpret_cast<section_iterator*>(SI); |
| 33 | } |
| 34 | |
| 35 | inline LLVMSectionIteratorRef |
| 36 | wrap(const section_iterator *SI) { |
| 37 | return reinterpret_cast<LLVMSectionIteratorRef> |
| 38 | (const_cast<section_iterator*>(SI)); |
| 39 | } |
| 40 | |
| 41 | inline symbol_iterator *unwrap(LLVMSymbolIteratorRef SI) { |
| 42 | return reinterpret_cast<symbol_iterator*>(SI); |
| 43 | } |
| 44 | |
| 45 | inline LLVMSymbolIteratorRef |
| 46 | wrap(const symbol_iterator *SI) { |
| 47 | return reinterpret_cast<LLVMSymbolIteratorRef> |
| 48 | (const_cast<symbol_iterator*>(SI)); |
| 49 | } |
| 50 | |
| 51 | inline relocation_iterator *unwrap(LLVMRelocationIteratorRef SI) { |
| 52 | return reinterpret_cast<relocation_iterator*>(SI); |
| 53 | } |
| 54 | |
| 55 | inline LLVMRelocationIteratorRef |
| 56 | wrap(const relocation_iterator *SI) { |
| 57 | return reinterpret_cast<LLVMRelocationIteratorRef> |
| 58 | (const_cast<relocation_iterator*>(SI)); |
| 59 | } |
| 60 | |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 61 | // ObjectFile creation |
Eric Christopher | e243fd9 | 2011-04-03 22:34:07 +0000 | [diff] [blame] | 62 | LLVMObjectFileRef LLVMCreateObjectFile(LLVMMemoryBufferRef MemBuf) { |
Rafael Espindola | b138cab | 2014-06-23 22:00:37 +0000 | [diff] [blame] | 63 | std::unique_ptr<MemoryBuffer> Buf(unwrap(MemBuf)); |
Kevin Enderby | c6bf9be | 2016-04-06 22:14:09 +0000 | [diff] [blame] | 64 | Expected<std::unique_ptr<ObjectFile>> ObjOrErr( |
Rafael Espindola | 548f2b6 | 2014-08-19 18:44:46 +0000 | [diff] [blame] | 65 | ObjectFile::createObjectFile(Buf->getMemBufferRef())); |
| 66 | std::unique_ptr<ObjectFile> Obj; |
Kevin Enderby | c6bf9be | 2016-04-06 22:14:09 +0000 | [diff] [blame] | 67 | if (!ObjOrErr) { |
| 68 | // TODO: Actually report errors helpfully. |
| 69 | consumeError(ObjOrErr.takeError()); |
Bjorn Steinbrink | ea38850 | 2014-09-05 21:22:09 +0000 | [diff] [blame] | 70 | return nullptr; |
Kevin Enderby | c6bf9be | 2016-04-06 22:14:09 +0000 | [diff] [blame] | 71 | } |
Bjorn Steinbrink | ea38850 | 2014-09-05 21:22:09 +0000 | [diff] [blame] | 72 | |
| 73 | auto *Ret = new OwningBinary<ObjectFile>(std::move(ObjOrErr.get()), std::move(Buf)); |
Rafael Espindola | 548f2b6 | 2014-08-19 18:44:46 +0000 | [diff] [blame] | 74 | return wrap(Ret); |
Eric Christopher | e243fd9 | 2011-04-03 22:34:07 +0000 | [diff] [blame] | 75 | } |
| 76 | |
| 77 | void LLVMDisposeObjectFile(LLVMObjectFileRef ObjectFile) { |
| 78 | delete unwrap(ObjectFile); |
| 79 | } |
| 80 | |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 81 | // ObjectFile Section iterators |
Rafael Espindola | 548f2b6 | 2014-08-19 18:44:46 +0000 | [diff] [blame] | 82 | LLVMSectionIteratorRef LLVMGetSections(LLVMObjectFileRef OF) { |
| 83 | OwningBinary<ObjectFile> *OB = unwrap(OF); |
| 84 | section_iterator SI = OB->getBinary()->section_begin(); |
Michael J. Spencer | 4344b1e | 2011-10-07 19:25:32 +0000 | [diff] [blame] | 85 | return wrap(new section_iterator(SI)); |
Eric Christopher | e243fd9 | 2011-04-03 22:34:07 +0000 | [diff] [blame] | 86 | } |
| 87 | |
| 88 | void LLVMDisposeSectionIterator(LLVMSectionIteratorRef SI) { |
| 89 | delete unwrap(SI); |
| 90 | } |
| 91 | |
Rafael Espindola | 548f2b6 | 2014-08-19 18:44:46 +0000 | [diff] [blame] | 92 | LLVMBool LLVMIsSectionIteratorAtEnd(LLVMObjectFileRef OF, |
| 93 | LLVMSectionIteratorRef SI) { |
| 94 | OwningBinary<ObjectFile> *OB = unwrap(OF); |
| 95 | return (*unwrap(SI) == OB->getBinary()->section_end()) ? 1 : 0; |
Eric Christopher | e243fd9 | 2011-04-03 22:34:07 +0000 | [diff] [blame] | 96 | } |
| 97 | |
| 98 | void LLVMMoveToNextSection(LLVMSectionIteratorRef SI) { |
Rafael Espindola | efdbec8 | 2014-01-30 02:49:50 +0000 | [diff] [blame] | 99 | ++(*unwrap(SI)); |
Eric Christopher | e243fd9 | 2011-04-03 22:34:07 +0000 | [diff] [blame] | 100 | } |
| 101 | |
Owen Anderson | e2fa64e | 2011-10-21 18:21:22 +0000 | [diff] [blame] | 102 | void LLVMMoveToContainingSection(LLVMSectionIteratorRef Sect, |
| 103 | LLVMSymbolIteratorRef Sym) { |
Kevin Enderby | a486dca | 2016-05-02 20:28:12 +0000 | [diff] [blame] | 104 | Expected<section_iterator> SecOrErr = (*unwrap(Sym))->getSection(); |
| 105 | if (!SecOrErr) { |
| 106 | std::string Buf; |
| 107 | raw_string_ostream OS(Buf); |
Jonas Devlieghere | 686dfe3 | 2018-11-11 01:46:03 +0000 | [diff] [blame] | 108 | logAllUnhandledErrors(SecOrErr.takeError(), OS); |
Kevin Enderby | a486dca | 2016-05-02 20:28:12 +0000 | [diff] [blame] | 109 | OS.flush(); |
| 110 | report_fatal_error(Buf); |
| 111 | } |
Rafael Espindola | e84d8c1 | 2015-08-07 23:27:14 +0000 | [diff] [blame] | 112 | *unwrap(Sect) = *SecOrErr; |
Owen Anderson | e2fa64e | 2011-10-21 18:21:22 +0000 | [diff] [blame] | 113 | } |
| 114 | |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 115 | // ObjectFile Symbol iterators |
Rafael Espindola | 548f2b6 | 2014-08-19 18:44:46 +0000 | [diff] [blame] | 116 | LLVMSymbolIteratorRef LLVMGetSymbols(LLVMObjectFileRef OF) { |
| 117 | OwningBinary<ObjectFile> *OB = unwrap(OF); |
| 118 | symbol_iterator SI = OB->getBinary()->symbol_begin(); |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 119 | return wrap(new symbol_iterator(SI)); |
| 120 | } |
| 121 | |
| 122 | void LLVMDisposeSymbolIterator(LLVMSymbolIteratorRef SI) { |
| 123 | delete unwrap(SI); |
| 124 | } |
| 125 | |
Rafael Espindola | 548f2b6 | 2014-08-19 18:44:46 +0000 | [diff] [blame] | 126 | LLVMBool LLVMIsSymbolIteratorAtEnd(LLVMObjectFileRef OF, |
| 127 | LLVMSymbolIteratorRef SI) { |
| 128 | OwningBinary<ObjectFile> *OB = unwrap(OF); |
| 129 | return (*unwrap(SI) == OB->getBinary()->symbol_end()) ? 1 : 0; |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 130 | } |
| 131 | |
| 132 | void LLVMMoveToNextSymbol(LLVMSymbolIteratorRef SI) { |
Rafael Espindola | efdbec8 | 2014-01-30 02:49:50 +0000 | [diff] [blame] | 133 | ++(*unwrap(SI)); |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 134 | } |
| 135 | |
| 136 | // SectionRef accessors |
Eric Christopher | e243fd9 | 2011-04-03 22:34:07 +0000 | [diff] [blame] | 137 | const char *LLVMGetSectionName(LLVMSectionIteratorRef SI) { |
Michael J. Spencer | 25b1577 | 2011-06-25 17:55:23 +0000 | [diff] [blame] | 138 | StringRef ret; |
Rafael Espindola | 4e2b922 | 2014-06-13 02:24:39 +0000 | [diff] [blame] | 139 | if (std::error_code ec = (*unwrap(SI))->getName(ret)) |
Michael J. Spencer | 25b1577 | 2011-06-25 17:55:23 +0000 | [diff] [blame] | 140 | report_fatal_error(ec.message()); |
| 141 | return ret.data(); |
Eric Christopher | e243fd9 | 2011-04-03 22:34:07 +0000 | [diff] [blame] | 142 | } |
| 143 | |
| 144 | uint64_t LLVMGetSectionSize(LLVMSectionIteratorRef SI) { |
Rafael Espindola | 8175be5 | 2014-10-08 15:28:58 +0000 | [diff] [blame] | 145 | return (*unwrap(SI))->getSize(); |
Eric Christopher | e243fd9 | 2011-04-03 22:34:07 +0000 | [diff] [blame] | 146 | } |
| 147 | |
| 148 | const char *LLVMGetSectionContents(LLVMSectionIteratorRef SI) { |
Michael J. Spencer | 25b1577 | 2011-06-25 17:55:23 +0000 | [diff] [blame] | 149 | StringRef ret; |
Rafael Espindola | 4e2b922 | 2014-06-13 02:24:39 +0000 | [diff] [blame] | 150 | if (std::error_code ec = (*unwrap(SI))->getContents(ret)) |
Michael J. Spencer | 25b1577 | 2011-06-25 17:55:23 +0000 | [diff] [blame] | 151 | report_fatal_error(ec.message()); |
| 152 | return ret.data(); |
Eric Christopher | e243fd9 | 2011-04-03 22:34:07 +0000 | [diff] [blame] | 153 | } |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 154 | |
| 155 | uint64_t LLVMGetSectionAddress(LLVMSectionIteratorRef SI) { |
Rafael Espindola | 8175be5 | 2014-10-08 15:28:58 +0000 | [diff] [blame] | 156 | return (*unwrap(SI))->getAddress(); |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 157 | } |
| 158 | |
Owen Anderson | ca7eb3e | 2011-10-21 20:35:58 +0000 | [diff] [blame] | 159 | LLVMBool LLVMGetSectionContainsSymbol(LLVMSectionIteratorRef SI, |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 160 | LLVMSymbolIteratorRef Sym) { |
Rafael Espindola | 8175be5 | 2014-10-08 15:28:58 +0000 | [diff] [blame] | 161 | return (*unwrap(SI))->containsSymbol(**unwrap(Sym)); |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 162 | } |
| 163 | |
Owen Anderson | d8b0b91 | 2011-10-27 17:15:47 +0000 | [diff] [blame] | 164 | // Section Relocation iterators |
| 165 | LLVMRelocationIteratorRef LLVMGetRelocations(LLVMSectionIteratorRef Section) { |
Rafael Espindola | a40b352 | 2014-02-10 20:24:04 +0000 | [diff] [blame] | 166 | relocation_iterator SI = (*unwrap(Section))->relocation_begin(); |
Owen Anderson | d8b0b91 | 2011-10-27 17:15:47 +0000 | [diff] [blame] | 167 | return wrap(new relocation_iterator(SI)); |
| 168 | } |
| 169 | |
| 170 | void LLVMDisposeRelocationIterator(LLVMRelocationIteratorRef SI) { |
| 171 | delete unwrap(SI); |
| 172 | } |
| 173 | |
| 174 | LLVMBool LLVMIsRelocationIteratorAtEnd(LLVMSectionIteratorRef Section, |
| 175 | LLVMRelocationIteratorRef SI) { |
Rafael Espindola | a40b352 | 2014-02-10 20:24:04 +0000 | [diff] [blame] | 176 | return (*unwrap(SI) == (*unwrap(Section))->relocation_end()) ? 1 : 0; |
Owen Anderson | d8b0b91 | 2011-10-27 17:15:47 +0000 | [diff] [blame] | 177 | } |
| 178 | |
| 179 | void LLVMMoveToNextRelocation(LLVMRelocationIteratorRef SI) { |
Rafael Espindola | efdbec8 | 2014-01-30 02:49:50 +0000 | [diff] [blame] | 180 | ++(*unwrap(SI)); |
Owen Anderson | d8b0b91 | 2011-10-27 17:15:47 +0000 | [diff] [blame] | 181 | } |
| 182 | |
| 183 | |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 184 | // SymbolRef accessors |
| 185 | const char *LLVMGetSymbolName(LLVMSymbolIteratorRef SI) { |
Kevin Enderby | 813e0cf | 2016-04-20 21:24:34 +0000 | [diff] [blame] | 186 | Expected<StringRef> Ret = (*unwrap(SI))->getName(); |
| 187 | if (!Ret) { |
| 188 | std::string Buf; |
| 189 | raw_string_ostream OS(Buf); |
Jonas Devlieghere | 686dfe3 | 2018-11-11 01:46:03 +0000 | [diff] [blame] | 190 | logAllUnhandledErrors(Ret.takeError(), OS); |
Kevin Enderby | 813e0cf | 2016-04-20 21:24:34 +0000 | [diff] [blame] | 191 | OS.flush(); |
| 192 | report_fatal_error(Buf); |
| 193 | } |
Rafael Espindola | 8a80641 | 2015-07-02 20:55:21 +0000 | [diff] [blame] | 194 | return Ret->data(); |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 195 | } |
| 196 | |
| 197 | uint64_t LLVMGetSymbolAddress(LLVMSymbolIteratorRef SI) { |
Kevin Enderby | 317de7c | 2016-06-24 18:24:42 +0000 | [diff] [blame] | 198 | Expected<uint64_t> Ret = (*unwrap(SI))->getAddress(); |
| 199 | if (!Ret) { |
| 200 | std::string Buf; |
| 201 | raw_string_ostream OS(Buf); |
Jonas Devlieghere | 686dfe3 | 2018-11-11 01:46:03 +0000 | [diff] [blame] | 202 | logAllUnhandledErrors(Ret.takeError(), OS); |
Kevin Enderby | 317de7c | 2016-06-24 18:24:42 +0000 | [diff] [blame] | 203 | OS.flush(); |
| 204 | report_fatal_error(Buf); |
| 205 | } |
Rafael Espindola | 5954faa | 2015-07-03 18:19:00 +0000 | [diff] [blame] | 206 | return *Ret; |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 207 | } |
| 208 | |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 209 | uint64_t LLVMGetSymbolSize(LLVMSymbolIteratorRef SI) { |
Rafael Espindola | 821b06f | 2015-06-24 10:20:30 +0000 | [diff] [blame] | 210 | return (*unwrap(SI))->getCommonSize(); |
Owen Anderson | 3cb0567 | 2011-10-21 17:50:59 +0000 | [diff] [blame] | 211 | } |
| 212 | |
Owen Anderson | 3529c53 | 2011-10-27 17:32:36 +0000 | [diff] [blame] | 213 | // RelocationRef accessors |
Danil Malyshev | b0436a7 | 2011-11-29 17:40:10 +0000 | [diff] [blame] | 214 | uint64_t LLVMGetRelocationOffset(LLVMRelocationIteratorRef RI) { |
Rafael Espindola | ff67629 | 2015-06-29 23:29:12 +0000 | [diff] [blame] | 215 | return (*unwrap(RI))->getOffset(); |
Danil Malyshev | b0436a7 | 2011-11-29 17:40:10 +0000 | [diff] [blame] | 216 | } |
| 217 | |
Owen Anderson | 3529c53 | 2011-10-27 17:32:36 +0000 | [diff] [blame] | 218 | LLVMSymbolIteratorRef LLVMGetRelocationSymbol(LLVMRelocationIteratorRef RI) { |
Rafael Espindola | 6c1202c | 2013-06-05 01:33:53 +0000 | [diff] [blame] | 219 | symbol_iterator ret = (*unwrap(RI))->getSymbol(); |
Owen Anderson | 3529c53 | 2011-10-27 17:32:36 +0000 | [diff] [blame] | 220 | return wrap(new symbol_iterator(ret)); |
| 221 | } |
| 222 | |
| 223 | uint64_t LLVMGetRelocationType(LLVMRelocationIteratorRef RI) { |
Rafael Espindola | 7ede964 | 2015-06-30 01:53:01 +0000 | [diff] [blame] | 224 | return (*unwrap(RI))->getType(); |
Owen Anderson | 3529c53 | 2011-10-27 17:32:36 +0000 | [diff] [blame] | 225 | } |
| 226 | |
| 227 | // NOTE: Caller takes ownership of returned string. |
| 228 | const char *LLVMGetRelocationTypeName(LLVMRelocationIteratorRef RI) { |
| 229 | SmallVector<char, 0> ret; |
Rafael Espindola | f8a35ff | 2015-06-30 04:08:37 +0000 | [diff] [blame] | 230 | (*unwrap(RI))->getTypeName(ret); |
Serge Pavlov | 06c71d8 | 2018-02-20 05:41:26 +0000 | [diff] [blame] | 231 | char *str = static_cast<char*>(safe_malloc(ret.size())); |
Fangrui Song | 53a6224 | 2018-11-17 01:44:25 +0000 | [diff] [blame] | 232 | llvm::copy(ret, str); |
Owen Anderson | 3529c53 | 2011-10-27 17:32:36 +0000 | [diff] [blame] | 233 | return str; |
| 234 | } |
| 235 | |
| 236 | // NOTE: Caller takes ownership of returned string. |
| 237 | const char *LLVMGetRelocationValueString(LLVMRelocationIteratorRef RI) { |
Rafael Espindola | 8c7a0fd | 2015-06-03 04:48:06 +0000 | [diff] [blame] | 238 | return strdup(""); |
Owen Anderson | 3529c53 | 2011-10-27 17:32:36 +0000 | [diff] [blame] | 239 | } |
| 240 | |