blob: abe6e4dd66bc00371a8c717dae11f0783885d7ab [file] [log] [blame]
Nick Lewyckyfb643e42009-02-03 07:13:24 +00001//===-- gold-plugin.cpp - Plugin to gold for Link Time Optimization ------===//
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 is a gold plugin for LLVM. It provides an LLVM implementation of the
11// interface described in http://gcc.gnu.org/wiki/whopr/driver .
12//
13//===----------------------------------------------------------------------===//
14
Dylan Noblesmith9e5b1782011-12-22 23:04:07 +000015#include "llvm/Config/config.h" // plugin-api.h requires HAVE_STDINT_H
Rafael Espindolaf7ecb112014-08-22 23:26:10 +000016#include "llvm/ADT/DenseSet.h"
Chandler Carruth07baed52014-01-13 08:04:33 +000017#include "llvm/ADT/StringSet.h"
Rafael Espindola33466a72014-08-21 20:28:55 +000018#include "llvm/Bitcode/ReaderWriter.h"
19#include "llvm/CodeGen/Analysis.h"
Rafael Espindola6b244b12014-06-19 21:14:13 +000020#include "llvm/CodeGen/CommandFlags.h"
Rafael Espindola890db272014-09-09 20:08:22 +000021#include "llvm/IR/Constants.h"
Rafael Espindola33466a72014-08-21 20:28:55 +000022#include "llvm/IR/LLVMContext.h"
23#include "llvm/IR/Module.h"
24#include "llvm/IR/Verifier.h"
25#include "llvm/Linker/Linker.h"
26#include "llvm/MC/SubtargetFeature.h"
27#include "llvm/Object/IRObjectFile.h"
28#include "llvm/PassManager.h"
29#include "llvm/Support/FormattedStream.h"
30#include "llvm/Support/Host.h"
Chandler Carruth4d88a1c2012-12-04 10:44:52 +000031#include "llvm/Support/MemoryBuffer.h"
Rafael Espindola33466a72014-08-21 20:28:55 +000032#include "llvm/Support/TargetRegistry.h"
Rafael Espindola6b244b12014-06-19 21:14:13 +000033#include "llvm/Support/TargetSelect.h"
Rafael Espindola33466a72014-08-21 20:28:55 +000034#include "llvm/Target/TargetLibraryInfo.h"
35#include "llvm/Transforms/IPO.h"
36#include "llvm/Transforms/IPO/PassManagerBuilder.h"
37#include "llvm/Transforms/Utils/GlobalStatus.h"
38#include "llvm/Transforms/Utils/ModuleUtils.h"
Rafael Espindolaf7ecb112014-08-22 23:26:10 +000039#include "llvm/Transforms/Utils/ValueMapper.h"
Nick Lewyckyfb643e42009-02-03 07:13:24 +000040#include <list>
Chandler Carruth07baed52014-01-13 08:04:33 +000041#include <plugin-api.h>
Rafael Espindolaa6e9c3e2014-06-12 17:38:55 +000042#include <system_error>
Nick Lewyckyfb643e42009-02-03 07:13:24 +000043#include <vector>
44
Sylvestre Ledru53999792014-02-11 17:30:18 +000045#ifndef LDPO_PIE
46// FIXME: remove this declaration when we stop maintaining Ubuntu Quantal and
47// Precise and Debian Wheezy (binutils 2.23 is required)
48# define LDPO_PIE 3
49#endif
50
Nick Lewyckyfb643e42009-02-03 07:13:24 +000051using namespace llvm;
52
53namespace {
Rafael Espindolabfb8b912014-06-20 01:37:35 +000054struct claimed_file {
55 void *handle;
56 std::vector<ld_plugin_symbol> syms;
57};
Nick Lewyckyfb643e42009-02-03 07:13:24 +000058}
Rafael Espindolabfb8b912014-06-20 01:37:35 +000059
60static ld_plugin_status discard_message(int level, const char *format, ...) {
61 // Die loudly. Recent versions of Gold pass ld_plugin_message as the first
62 // callback in the transfer vector. This should never be called.
63 abort();
64}
65
Rafael Espindola33466a72014-08-21 20:28:55 +000066static ld_plugin_get_input_file get_input_file = nullptr;
67static ld_plugin_release_input_file release_input_file = nullptr;
Rafael Espindola176e6642014-07-29 21:46:05 +000068static ld_plugin_add_symbols add_symbols = nullptr;
69static ld_plugin_get_symbols get_symbols = nullptr;
70static ld_plugin_add_input_file add_input_file = nullptr;
71static ld_plugin_set_extra_library_path set_extra_library_path = nullptr;
72static ld_plugin_get_view get_view = nullptr;
Rafael Espindolabfb8b912014-06-20 01:37:35 +000073static ld_plugin_message message = discard_message;
Rafael Espindola33466a72014-08-21 20:28:55 +000074static Reloc::Model RelocationModel = Reloc::Default;
Rafael Espindolabfb8b912014-06-20 01:37:35 +000075static std::string output_name = "";
76static std::list<claimed_file> Modules;
77static std::vector<std::string> Cleanup;
Rafael Espindola6b244b12014-06-19 21:14:13 +000078static llvm::TargetOptions TargetOpts;
Nick Lewyckyfb643e42009-02-03 07:13:24 +000079
Viktor Kutuzovfd7ddd92009-10-28 18:55:55 +000080namespace options {
Rafael Espindola8fb957e2010-06-03 21:11:20 +000081 enum generate_bc { BC_NO, BC_ALSO, BC_ONLY };
Dan Gohmanebb4ae02010-04-16 00:42:57 +000082 static bool generate_api_file = false;
Rafael Espindola8fb957e2010-06-03 21:11:20 +000083 static generate_bc generate_bc_file = BC_NO;
Rafael Espindolaba3398b2010-05-13 13:39:31 +000084 static std::string bc_path;
Shuxin Yang1826ae22013-08-12 21:07:31 +000085 static std::string obj_path;
Rafael Espindolaef498152010-06-23 20:20:59 +000086 static std::string extra_library_path;
Rafael Espindola4ef89f52010-08-09 21:09:46 +000087 static std::string triple;
Rafael Espindolaccab1dd2010-08-11 00:15:13 +000088 static std::string mcpu;
Viktor Kutuzovfd7ddd92009-10-28 18:55:55 +000089 // Additional options to pass into the code generator.
Nick Lewycky0ac5e222010-06-03 17:10:17 +000090 // Note: This array will contain all plugin options which are not claimed
Viktor Kutuzovfd7ddd92009-10-28 18:55:55 +000091 // as plugin exclusive to pass to the code generator.
Nick Lewycky0ac5e222010-06-03 17:10:17 +000092 // For example, "generate-api-file" and "as"options are for the plugin
Viktor Kutuzovfd7ddd92009-10-28 18:55:55 +000093 // use only and will not be passed.
Rafael Espindola125b9242014-07-29 19:17:44 +000094 static std::vector<const char *> extra;
Viktor Kutuzovfd7ddd92009-10-28 18:55:55 +000095
Rafael Espindolac4dca3a2010-06-07 16:45:22 +000096 static void process_plugin_option(const char* opt_)
Viktor Kutuzovfd7ddd92009-10-28 18:55:55 +000097 {
Rafael Espindola176e6642014-07-29 21:46:05 +000098 if (opt_ == nullptr)
Viktor Kutuzovfd7ddd92009-10-28 18:55:55 +000099 return;
Rafael Espindolac4dca3a2010-06-07 16:45:22 +0000100 llvm::StringRef opt = opt_;
Viktor Kutuzovfd7ddd92009-10-28 18:55:55 +0000101
Rafael Espindolac4dca3a2010-06-07 16:45:22 +0000102 if (opt == "generate-api-file") {
Viktor Kutuzovfd7ddd92009-10-28 18:55:55 +0000103 generate_api_file = true;
Rafael Espindolaccab1dd2010-08-11 00:15:13 +0000104 } else if (opt.startswith("mcpu=")) {
105 mcpu = opt.substr(strlen("mcpu="));
Rafael Espindolaef498152010-06-23 20:20:59 +0000106 } else if (opt.startswith("extra-library-path=")) {
107 extra_library_path = opt.substr(strlen("extra_library_path="));
Rafael Espindola148c3282010-08-10 16:32:15 +0000108 } else if (opt.startswith("mtriple=")) {
Rafael Espindola4ef89f52010-08-09 21:09:46 +0000109 triple = opt.substr(strlen("mtriple="));
Shuxin Yang1826ae22013-08-12 21:07:31 +0000110 } else if (opt.startswith("obj-path=")) {
111 obj_path = opt.substr(strlen("obj-path="));
Rafael Espindolac4dca3a2010-06-07 16:45:22 +0000112 } else if (opt == "emit-llvm") {
Rafael Espindola8fb957e2010-06-03 21:11:20 +0000113 generate_bc_file = BC_ONLY;
Rafael Espindolac4dca3a2010-06-07 16:45:22 +0000114 } else if (opt == "also-emit-llvm") {
Rafael Espindola8fb957e2010-06-03 21:11:20 +0000115 generate_bc_file = BC_ALSO;
Rafael Espindolac4dca3a2010-06-07 16:45:22 +0000116 } else if (opt.startswith("also-emit-llvm=")) {
117 llvm::StringRef path = opt.substr(strlen("also-emit-llvm="));
Rafael Espindola8fb957e2010-06-03 21:11:20 +0000118 generate_bc_file = BC_ALSO;
Nick Lewyckyca4180c2010-06-03 17:13:23 +0000119 if (!bc_path.empty()) {
Rafael Espindola5ad21fa2014-07-30 00:38:58 +0000120 message(LDPL_WARNING, "Path to the output IL file specified twice. "
121 "Discarding %s",
122 opt_);
Rafael Espindolaba3398b2010-05-13 13:39:31 +0000123 } else {
124 bc_path = path;
125 }
Viktor Kutuzovfd7ddd92009-10-28 18:55:55 +0000126 } else {
127 // Save this option to pass to the code generator.
Rafael Espindola33466a72014-08-21 20:28:55 +0000128 // ParseCommandLineOptions() expects argv[0] to be program name. Lazily
129 // add that.
130 if (extra.empty())
131 extra.push_back("LLVMgold");
132
Rafael Espindola125b9242014-07-29 19:17:44 +0000133 extra.push_back(opt_);
Viktor Kutuzovfd7ddd92009-10-28 18:55:55 +0000134 }
135 }
136}
137
Dan Gohmanebb4ae02010-04-16 00:42:57 +0000138static ld_plugin_status claim_file_hook(const ld_plugin_input_file *file,
139 int *claimed);
140static ld_plugin_status all_symbols_read_hook(void);
141static ld_plugin_status cleanup_hook(void);
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000142
143extern "C" ld_plugin_status onload(ld_plugin_tv *tv);
144ld_plugin_status onload(ld_plugin_tv *tv) {
Peter Collingbourne1505c0a2014-07-03 23:28:03 +0000145 InitializeAllTargetInfos();
146 InitializeAllTargets();
147 InitializeAllTargetMCs();
148 InitializeAllAsmParsers();
149 InitializeAllAsmPrinters();
150
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000151 // We're given a pointer to the first transfer vector. We read through them
152 // until we find one where tv_tag == LDPT_NULL. The REGISTER_* tagged values
153 // contain pointers to functions that we need to call to register our own
154 // hooks. The others are addresses of functions we can use to call into gold
155 // for services.
156
157 bool registeredClaimFile = false;
Rafael Espindola6b244b12014-06-19 21:14:13 +0000158 bool RegisteredAllSymbolsRead = false;
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000159
160 for (; tv->tv_tag != LDPT_NULL; ++tv) {
161 switch (tv->tv_tag) {
Rafael Espindola8fb957e2010-06-03 21:11:20 +0000162 case LDPT_OUTPUT_NAME:
163 output_name = tv->tv_u.tv_string;
164 break;
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000165 case LDPT_LINKER_OUTPUT:
166 switch (tv->tv_u.tv_val) {
167 case LDPO_REL: // .o
168 case LDPO_DYN: // .so
Rafael Espindola76e376d2014-02-10 20:38:38 +0000169 case LDPO_PIE: // position independent executable
Rafael Espindola33466a72014-08-21 20:28:55 +0000170 RelocationModel = Reloc::PIC_;
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000171 break;
172 case LDPO_EXEC: // .exe
Rafael Espindola33466a72014-08-21 20:28:55 +0000173 RelocationModel = Reloc::Static;
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000174 break;
175 default:
Rafael Espindola5ad21fa2014-07-30 00:38:58 +0000176 message(LDPL_ERROR, "Unknown output file type %d", tv->tv_u.tv_val);
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000177 return LDPS_ERR;
178 }
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000179 break;
180 case LDPT_OPTION:
Viktor Kutuzovfd7ddd92009-10-28 18:55:55 +0000181 options::process_plugin_option(tv->tv_u.tv_string);
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000182 break;
183 case LDPT_REGISTER_CLAIM_FILE_HOOK: {
184 ld_plugin_register_claim_file callback;
185 callback = tv->tv_u.tv_register_claim_file;
186
Rafael Espindola54f82b72014-07-30 01:36:32 +0000187 if (callback(claim_file_hook) != LDPS_OK)
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000188 return LDPS_ERR;
189
190 registeredClaimFile = true;
191 } break;
192 case LDPT_REGISTER_ALL_SYMBOLS_READ_HOOK: {
193 ld_plugin_register_all_symbols_read callback;
194 callback = tv->tv_u.tv_register_all_symbols_read;
195
Rafael Espindola54f82b72014-07-30 01:36:32 +0000196 if (callback(all_symbols_read_hook) != LDPS_OK)
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000197 return LDPS_ERR;
Rafael Espindola9ef90d52011-02-20 18:28:29 +0000198
Rafael Espindola6b244b12014-06-19 21:14:13 +0000199 RegisteredAllSymbolsRead = true;
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000200 } break;
201 case LDPT_REGISTER_CLEANUP_HOOK: {
202 ld_plugin_register_cleanup callback;
203 callback = tv->tv_u.tv_register_cleanup;
204
Rafael Espindola54f82b72014-07-30 01:36:32 +0000205 if (callback(cleanup_hook) != LDPS_OK)
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000206 return LDPS_ERR;
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000207 } break;
Rafael Espindola33466a72014-08-21 20:28:55 +0000208 case LDPT_GET_INPUT_FILE:
209 get_input_file = tv->tv_u.tv_get_input_file;
210 break;
211 case LDPT_RELEASE_INPUT_FILE:
212 release_input_file = tv->tv_u.tv_release_input_file;
213 break;
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000214 case LDPT_ADD_SYMBOLS:
215 add_symbols = tv->tv_u.tv_add_symbols;
216 break;
Rafael Espindolacda29112013-10-03 18:29:09 +0000217 case LDPT_GET_SYMBOLS_V2:
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000218 get_symbols = tv->tv_u.tv_get_symbols;
219 break;
220 case LDPT_ADD_INPUT_FILE:
221 add_input_file = tv->tv_u.tv_add_input_file;
222 break;
Rafael Espindolaef498152010-06-23 20:20:59 +0000223 case LDPT_SET_EXTRA_LIBRARY_PATH:
224 set_extra_library_path = tv->tv_u.tv_set_extra_library_path;
225 break;
Rafael Espindolaece7c9c2011-04-07 21:11:00 +0000226 case LDPT_GET_VIEW:
227 get_view = tv->tv_u.tv_get_view;
228 break;
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000229 case LDPT_MESSAGE:
230 message = tv->tv_u.tv_message;
231 break;
232 default:
233 break;
234 }
235 }
236
Rafael Espindolae08484d2009-02-18 08:30:15 +0000237 if (!registeredClaimFile) {
Rafael Espindola5ad21fa2014-07-30 00:38:58 +0000238 message(LDPL_ERROR, "register_claim_file not passed to LLVMgold.");
Rafael Espindola6add6182009-02-18 17:49:06 +0000239 return LDPS_ERR;
240 }
Rafael Espindolae08484d2009-02-18 08:30:15 +0000241 if (!add_symbols) {
Rafael Espindola5ad21fa2014-07-30 00:38:58 +0000242 message(LDPL_ERROR, "add_symbols not passed to LLVMgold.");
Rafael Espindola6add6182009-02-18 17:49:06 +0000243 return LDPS_ERR;
244 }
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000245
Rafael Espindolaa0d30a92014-06-19 22:20:07 +0000246 if (!RegisteredAllSymbolsRead)
247 return LDPS_OK;
Rafael Espindola6b244b12014-06-19 21:14:13 +0000248
Rafael Espindola33466a72014-08-21 20:28:55 +0000249 if (!get_input_file) {
250 message(LDPL_ERROR, "get_input_file not passed to LLVMgold.");
251 return LDPS_ERR;
Rafael Espindolac273aac2014-06-19 22:54:47 +0000252 }
Rafael Espindola33466a72014-08-21 20:28:55 +0000253 if (!release_input_file) {
254 message(LDPL_ERROR, "relesase_input_file not passed to LLVMgold.");
255 return LDPS_ERR;
Tom Roederb5081192014-06-26 20:43:27 +0000256 }
257
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000258 return LDPS_OK;
259}
260
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000261static const GlobalObject *getBaseObject(const GlobalValue &GV) {
262 if (auto *GA = dyn_cast<GlobalAlias>(&GV))
263 return GA->getBaseObject();
264 return cast<GlobalObject>(&GV);
265}
266
Rafael Espindolae54d8212014-07-06 14:31:22 +0000267/// Called by gold to see whether this file is one that our plugin can handle.
268/// We'll try to open it and register all the symbols with add_symbol if
269/// possible.
Dan Gohmanebb4ae02010-04-16 00:42:57 +0000270static ld_plugin_status claim_file_hook(const ld_plugin_input_file *file,
271 int *claimed) {
Rafael Espindola33466a72014-08-21 20:28:55 +0000272 LLVMContext Context;
Rafael Espindolaeeec8e62014-08-27 20:25:55 +0000273 MemoryBufferRef BufferRef;
274 std::unique_ptr<MemoryBuffer> Buffer;
Rafael Espindolaece7c9c2011-04-07 21:11:00 +0000275 if (get_view) {
Rafael Espindola33466a72014-08-21 20:28:55 +0000276 const void *view;
Rafael Espindolaece7c9c2011-04-07 21:11:00 +0000277 if (get_view(file->handle, &view) != LDPS_OK) {
Rafael Espindola5ad21fa2014-07-30 00:38:58 +0000278 message(LDPL_ERROR, "Failed to get a view of %s", file->name);
Rafael Espindolaece7c9c2011-04-07 21:11:00 +0000279 return LDPS_ERR;
280 }
Rafael Espindolaeeec8e62014-08-27 20:25:55 +0000281 BufferRef = MemoryBufferRef(StringRef((char *)view, file->filesize), "");
Ivan Krasin5021af52011-09-12 21:47:50 +0000282 } else {
Ivan Krasin639222d2011-09-15 23:13:00 +0000283 int64_t offset = 0;
Nick Lewycky8691c472009-02-05 04:14:23 +0000284 // Gold has found what might be IR part-way inside of a file, such as
285 // an .a archive.
Ivan Krasin5021af52011-09-12 21:47:50 +0000286 if (file->offset) {
287 offset = file->offset;
288 }
Rafael Espindolaadf21f22014-07-06 17:43:13 +0000289 ErrorOr<std::unique_ptr<MemoryBuffer>> BufferOrErr =
290 MemoryBuffer::getOpenFileSlice(file->fd, file->name, file->filesize,
291 offset);
292 if (std::error_code EC = BufferOrErr.getError()) {
Rafael Espindola5ad21fa2014-07-30 00:38:58 +0000293 message(LDPL_ERROR, EC.message().c_str());
Ivan Krasin5021af52011-09-12 21:47:50 +0000294 return LDPS_ERR;
295 }
Rafael Espindolaeeec8e62014-08-27 20:25:55 +0000296 Buffer = std::move(BufferOrErr.get());
297 BufferRef = Buffer->getMemBufferRef();
Rafael Espindola56e41f72011-02-08 22:40:47 +0000298 }
Ivan Krasin5021af52011-09-12 21:47:50 +0000299
David Blaikie10a27df2014-09-03 17:59:23 +0000300 ErrorOr<std::unique_ptr<object::IRObjectFile>> ObjOrErr =
Rafael Espindolaeeec8e62014-08-27 20:25:55 +0000301 object::IRObjectFile::createIRObjectFile(BufferRef, Context);
Rafael Espindola33466a72014-08-21 20:28:55 +0000302 std::error_code EC = ObjOrErr.getError();
303 if (EC == BitcodeError::InvalidBitcodeSignature)
Ivan Krasin5021af52011-09-12 21:47:50 +0000304 return LDPS_OK;
305
Rafael Espindola6c472e52014-07-29 20:46:19 +0000306 *claimed = 1;
307
Rafael Espindola33466a72014-08-21 20:28:55 +0000308 if (EC) {
Rafael Espindola5ad21fa2014-07-30 00:38:58 +0000309 message(LDPL_ERROR, "LLVM gold plugin has failed to create LTO module: %s",
Rafael Espindola33466a72014-08-21 20:28:55 +0000310 EC.message().c_str());
Rafael Espindola6c472e52014-07-29 20:46:19 +0000311 return LDPS_ERR;
Ivan Krasind5f2d8c2011-09-09 00:14:04 +0000312 }
David Blaikie10a27df2014-09-03 17:59:23 +0000313 std::unique_ptr<object::IRObjectFile> Obj = std::move(*ObjOrErr);
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000314
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000315 Modules.resize(Modules.size() + 1);
316 claimed_file &cf = Modules.back();
Rafael Espindola4ef89f52010-08-09 21:09:46 +0000317
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000318 cf.handle = file->handle;
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000319
Rafael Espindola33466a72014-08-21 20:28:55 +0000320 for (auto &Sym : Obj->symbols()) {
321 uint32_t Symflags = Sym.getFlags();
322 if (!(Symflags & object::BasicSymbolRef::SF_Global))
323 continue;
324
325 if (Symflags & object::BasicSymbolRef::SF_FormatSpecific)
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000326 continue;
327
328 cf.syms.push_back(ld_plugin_symbol());
329 ld_plugin_symbol &sym = cf.syms.back();
Rafael Espindola176e6642014-07-29 21:46:05 +0000330 sym.version = nullptr;
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000331
Rafael Espindola33466a72014-08-21 20:28:55 +0000332 SmallString<64> Name;
333 {
334 raw_svector_ostream OS(Name);
335 Sym.printName(OS);
336 }
337 sym.name = strdup(Name.c_str());
338
339 const GlobalValue *GV = Obj->getSymbolGV(Sym.getRawDataRefImpl());
340
341 sym.visibility = LDPV_DEFAULT;
342 if (GV) {
343 switch (GV->getVisibility()) {
344 case GlobalValue::DefaultVisibility:
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000345 sym.visibility = LDPV_DEFAULT;
346 break;
Rafael Espindola33466a72014-08-21 20:28:55 +0000347 case GlobalValue::HiddenVisibility:
348 sym.visibility = LDPV_HIDDEN;
349 break;
350 case GlobalValue::ProtectedVisibility:
351 sym.visibility = LDPV_PROTECTED;
352 break;
353 }
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000354 }
355
Rafael Espindola33466a72014-08-21 20:28:55 +0000356 if (Symflags & object::BasicSymbolRef::SF_Undefined) {
357 sym.def = LDPK_UNDEF;
358 if (GV && GV->hasExternalWeakLinkage())
Rafael Espindola56548522009-04-24 16:55:21 +0000359 sym.def = LDPK_WEAKUNDEF;
Rafael Espindola33466a72014-08-21 20:28:55 +0000360 } else {
361 sym.def = LDPK_DEF;
362 if (GV) {
363 assert(!GV->hasExternalWeakLinkage() &&
364 !GV->hasAvailableExternallyLinkage() && "Not a declaration!");
365 if (GV->hasCommonLinkage())
366 sym.def = LDPK_COMMON;
367 else if (GV->isWeakForLinker())
368 sym.def = LDPK_WEAKDEF;
369 }
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000370 }
371
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000372 sym.size = 0;
Rafael Espindola33466a72014-08-21 20:28:55 +0000373 sym.comdat_key = nullptr;
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000374 if (GV) {
375 const GlobalObject *Base = getBaseObject(*GV);
376 if (!Base)
377 message(LDPL_FATAL, "Unable to determine comdat of alias!");
378 const Comdat *C = Base->getComdat();
379 if (C)
380 sym.comdat_key = strdup(C->getName().str().c_str());
381 else if (Base->hasWeakLinkage() || Base->hasLinkOnceLinkage())
382 sym.comdat_key = strdup(sym.name);
383 }
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000384
385 sym.resolution = LDPR_UNKNOWN;
386 }
387
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000388 if (!cf.syms.empty()) {
Rafael Espindola5ad21fa2014-07-30 00:38:58 +0000389 if (add_symbols(cf.handle, cf.syms.size(), &cf.syms[0]) != LDPS_OK) {
390 message(LDPL_ERROR, "Unable to add symbols!");
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000391 return LDPS_ERR;
392 }
393 }
394
395 return LDPS_OK;
396}
397
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000398static void keepGlobalValue(GlobalValue &GV,
399 std::vector<GlobalAlias *> &KeptAliases) {
Rafael Espindola33466a72014-08-21 20:28:55 +0000400 assert(!GV.hasLocalLinkage());
401
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000402 if (auto *GA = dyn_cast<GlobalAlias>(&GV))
403 KeptAliases.push_back(GA);
404
Rafael Espindola33466a72014-08-21 20:28:55 +0000405 switch (GV.getLinkage()) {
406 default:
407 break;
408 case GlobalValue::LinkOnceAnyLinkage:
409 GV.setLinkage(GlobalValue::WeakAnyLinkage);
410 break;
411 case GlobalValue::LinkOnceODRLinkage:
412 GV.setLinkage(GlobalValue::WeakODRLinkage);
413 break;
414 }
415
416 assert(!GV.isDiscardableIfUnused());
417}
418
419static bool isDeclaration(const GlobalValue &V) {
420 if (V.hasAvailableExternallyLinkage())
Rafael Espindola282a4702013-10-31 20:51:58 +0000421 return true;
Rafael Espindola33466a72014-08-21 20:28:55 +0000422
423 if (V.isMaterializable())
424 return false;
425
426 return V.isDeclaration();
427}
428
429static void internalize(GlobalValue &GV) {
430 if (isDeclaration(GV))
431 return; // We get here if there is a matching asm definition.
432 if (!GV.hasLocalLinkage())
433 GV.setLinkage(GlobalValue::InternalLinkage);
434}
435
436static void drop(GlobalValue &GV) {
437 if (auto *F = dyn_cast<Function>(&GV)) {
438 F->deleteBody();
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000439 F->setComdat(nullptr); // Should deleteBody do this?
Rafael Espindola33466a72014-08-21 20:28:55 +0000440 return;
441 }
442
443 if (auto *Var = dyn_cast<GlobalVariable>(&GV)) {
444 Var->setInitializer(nullptr);
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000445 Var->setLinkage(
446 GlobalValue::ExternalLinkage); // Should setInitializer do this?
447 Var->setComdat(nullptr); // and this?
Rafael Espindola33466a72014-08-21 20:28:55 +0000448 return;
449 }
450
451 auto &Alias = cast<GlobalAlias>(GV);
452 Module &M = *Alias.getParent();
453 PointerType &Ty = *cast<PointerType>(Alias.getType());
454 GlobalValue::LinkageTypes L = Alias.getLinkage();
455 auto *Var =
456 new GlobalVariable(M, Ty.getElementType(), /*isConstant*/ false, L,
457 /*Initializer*/ nullptr);
458 Var->takeName(&Alias);
459 Alias.replaceAllUsesWith(Var);
Rafael Espindola71143ed2014-09-10 19:39:41 +0000460 Alias.eraseFromParent();
Rafael Espindola33466a72014-08-21 20:28:55 +0000461}
462
463static const char *getResolutionName(ld_plugin_symbol_resolution R) {
464 switch (R) {
465 case LDPR_UNKNOWN:
466 return "UNKNOWN";
467 case LDPR_UNDEF:
468 return "UNDEF";
469 case LDPR_PREVAILING_DEF:
470 return "PREVAILING_DEF";
471 case LDPR_PREVAILING_DEF_IRONLY:
472 return "PREVAILING_DEF_IRONLY";
473 case LDPR_PREEMPTED_REG:
474 return "PREEMPTED_REG";
475 case LDPR_PREEMPTED_IR:
476 return "PREEMPTED_IR";
477 case LDPR_RESOLVED_IR:
478 return "RESOLVED_IR";
479 case LDPR_RESOLVED_EXEC:
480 return "RESOLVED_EXEC";
481 case LDPR_RESOLVED_DYN:
482 return "RESOLVED_DYN";
483 case LDPR_PREVAILING_DEF_IRONLY_EXP:
484 return "PREVAILING_DEF_IRONLY_EXP";
485 }
486}
487
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000488static GlobalObject *makeInternalReplacement(GlobalObject *GO) {
489 Module *M = GO->getParent();
490 GlobalObject *Ret;
491 if (auto *F = dyn_cast<Function>(GO)) {
492 auto *NewF = Function::Create(
493 F->getFunctionType(), GlobalValue::InternalLinkage, F->getName(), M);
494 NewF->getBasicBlockList().splice(NewF->end(), F->getBasicBlockList());
495 Ret = NewF;
496 F->deleteBody();
497 } else {
498 auto *Var = cast<GlobalVariable>(GO);
499 Ret = new GlobalVariable(
500 *M, Var->getType()->getElementType(), Var->isConstant(),
501 GlobalValue::InternalLinkage, Var->getInitializer(), Var->getName(),
502 nullptr, Var->getThreadLocalMode(), Var->getType()->getAddressSpace(),
503 Var->isExternallyInitialized());
504 Var->setInitializer(nullptr);
505 }
506 Ret->copyAttributesFrom(GO);
507 Ret->setComdat(GO->getComdat());
508
509 return Ret;
510}
511
512namespace {
513class LocalValueMaterializer : public ValueMaterializer {
514 DenseSet<GlobalValue *> &Dropped;
515
516public:
517 LocalValueMaterializer(DenseSet<GlobalValue *> &Dropped) : Dropped(Dropped) {}
518 Value *materializeValueFor(Value *V) override;
519};
520}
521
522Value *LocalValueMaterializer::materializeValueFor(Value *V) {
523 auto *GV = dyn_cast<GlobalValue>(V);
524 if (!GV)
525 return nullptr;
526 if (!Dropped.count(GV))
527 return nullptr;
528 assert(!isa<GlobalAlias>(GV) && "Found alias point to weak alias.");
529 return makeInternalReplacement(cast<GlobalObject>(GV));
530}
531
532static Constant *mapConstantToLocalCopy(Constant *C, ValueToValueMapTy &VM,
533 LocalValueMaterializer *Materializer) {
534 return MapValue(C, VM, RF_IgnoreMissingEntries, nullptr, Materializer);
535}
536
Rafael Espindola33466a72014-08-21 20:28:55 +0000537static std::unique_ptr<Module>
538getModuleForFile(LLVMContext &Context, claimed_file &F, raw_fd_ostream *ApiFile,
539 StringSet<> &Internalize, StringSet<> &Maybe) {
540 ld_plugin_input_file File;
541 if (get_input_file(F.handle, &File) != LDPS_OK)
542 message(LDPL_FATAL, "Failed to get file information");
543
544 if (get_symbols(F.handle, F.syms.size(), &F.syms[0]) != LDPS_OK)
545 message(LDPL_FATAL, "Failed to get symbol information");
546
547 const void *View;
548 if (get_view(F.handle, &View) != LDPS_OK)
549 message(LDPL_FATAL, "Failed to get a view of file");
550
David Blaikiedfbe3d62014-08-27 20:14:18 +0000551 std::unique_ptr<MemoryBuffer> Buffer = MemoryBuffer::getMemBuffer(
552 StringRef((char *)View, File.filesize), "", false);
Rafael Espindola33466a72014-08-21 20:28:55 +0000553
554 if (release_input_file(F.handle) != LDPS_OK)
555 message(LDPL_FATAL, "Failed to release file information");
556
Rafael Espindola68812152014-09-03 17:31:46 +0000557 ErrorOr<Module *> MOrErr = getLazyBitcodeModule(std::move(Buffer), Context);
Rafael Espindola33466a72014-08-21 20:28:55 +0000558
559 if (std::error_code EC = MOrErr.getError())
560 message(LDPL_FATAL, "Could not read bitcode from file : %s",
561 EC.message().c_str());
Rafael Espindola33466a72014-08-21 20:28:55 +0000562
563 std::unique_ptr<Module> M(MOrErr.get());
564
565 SmallPtrSet<GlobalValue *, 8> Used;
566 collectUsedGlobalVariables(*M, Used, /*CompilerUsed*/ false);
567
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000568 DenseSet<GlobalValue *> Drop;
569 std::vector<GlobalAlias *> KeptAliases;
Rafael Espindola33466a72014-08-21 20:28:55 +0000570 for (ld_plugin_symbol &Sym : F.syms) {
571 ld_plugin_symbol_resolution Resolution =
572 (ld_plugin_symbol_resolution)Sym.resolution;
573
574 if (options::generate_api_file)
575 *ApiFile << Sym.name << ' ' << getResolutionName(Resolution) << '\n';
576
577 GlobalValue *GV = M->getNamedValue(Sym.name);
578 if (!GV)
579 continue; // Asm symbol.
580
Rafael Espindola890db272014-09-09 20:08:22 +0000581 if (GV->hasCommonLinkage()) {
582 // Common linkage is special. There is no single symbol that wins the
583 // resolution. Instead we have to collect the maximum alignment and size.
584 // The IR linker does that for us if we just pass it every common GV.
585 continue;
586 }
587
Rafael Espindola33466a72014-08-21 20:28:55 +0000588 switch (Resolution) {
589 case LDPR_UNKNOWN:
590 llvm_unreachable("Unexpected resolution");
591
592 case LDPR_RESOLVED_IR:
593 case LDPR_RESOLVED_EXEC:
594 case LDPR_RESOLVED_DYN:
595 case LDPR_UNDEF:
596 assert(isDeclaration(*GV));
597 break;
598
599 case LDPR_PREVAILING_DEF_IRONLY: {
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000600 keepGlobalValue(*GV, KeptAliases);
Rafael Espindola33466a72014-08-21 20:28:55 +0000601 if (!Used.count(GV)) {
602 // Since we use the regular lib/Linker, we cannot just internalize GV
603 // now or it will not be copied to the merged module. Instead we force
604 // it to be copied and then internalize it.
Rafael Espindola33466a72014-08-21 20:28:55 +0000605 Internalize.insert(Sym.name);
606 }
607 break;
608 }
609
610 case LDPR_PREVAILING_DEF:
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000611 keepGlobalValue(*GV, KeptAliases);
Rafael Espindola33466a72014-08-21 20:28:55 +0000612 break;
613
614 case LDPR_PREEMPTED_REG:
615 case LDPR_PREEMPTED_IR:
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000616 Drop.insert(GV);
Rafael Espindola33466a72014-08-21 20:28:55 +0000617 break;
618
619 case LDPR_PREVAILING_DEF_IRONLY_EXP: {
620 // We can only check for address uses after we merge the modules. The
621 // reason is that this GV might have a copy in another module
622 // and in that module the address might be significant, but that
623 // copy will be LDPR_PREEMPTED_IR.
624 if (GV->hasLinkOnceODRLinkage())
625 Maybe.insert(Sym.name);
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000626 keepGlobalValue(*GV, KeptAliases);
Rafael Espindola33466a72014-08-21 20:28:55 +0000627 break;
628 }
629 }
630
631 free(Sym.name);
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000632 free(Sym.comdat_key);
Rafael Espindola33466a72014-08-21 20:28:55 +0000633 Sym.name = nullptr;
634 Sym.comdat_key = nullptr;
635 }
636
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000637 if (!Drop.empty())
Rafael Espindola33466a72014-08-21 20:28:55 +0000638 // This is horrible. Given how lazy loading is implemented, dropping
639 // the body while there is a materializer present doesn't work, the
640 // linker will just read the body back.
641 M->materializeAllPermanently();
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000642
643 ValueToValueMapTy VM;
644 LocalValueMaterializer Materializer(Drop);
645 for (GlobalAlias *GA : KeptAliases) {
646 // Gold told us to keep GA. It is possible that a GV usied in the aliasee
647 // expression is being dropped. If that is the case, that GV must be copied.
648 Constant *Aliasee = GA->getAliasee();
649 Constant *Replacement = mapConstantToLocalCopy(Aliasee, VM, &Materializer);
650 if (Aliasee != Replacement)
651 GA->setAliasee(Replacement);
Rafael Espindola33466a72014-08-21 20:28:55 +0000652 }
653
Rafael Espindolaf7ecb112014-08-22 23:26:10 +0000654 for (auto *GV : Drop)
655 drop(*GV);
656
Rafael Espindola33466a72014-08-21 20:28:55 +0000657 return M;
658}
659
660static void runLTOPasses(Module &M, TargetMachine &TM) {
661 PassManager passes;
662 PassManagerBuilder PMB;
663 PMB.LibraryInfo = new TargetLibraryInfo(Triple(TM.getTargetTriple()));
664 PMB.Inliner = createFunctionInliningPass();
665 PMB.VerifyInput = true;
666 PMB.VerifyOutput = true;
667 PMB.populateLTOPassManager(passes, &TM);
668 passes.run(M);
669}
670
671static void codegen(Module &M) {
672 const std::string &TripleStr = M.getTargetTriple();
673 Triple TheTriple(TripleStr);
674
675 std::string ErrMsg;
676 const Target *TheTarget = TargetRegistry::lookupTarget(TripleStr, ErrMsg);
677 if (!TheTarget)
678 message(LDPL_FATAL, "Target not found: %s", ErrMsg.c_str());
679
680 if (unsigned NumOpts = options::extra.size())
681 cl::ParseCommandLineOptions(NumOpts, &options::extra[0]);
682
683 SubtargetFeatures Features;
684 Features.getDefaultSubtargetFeatures(TheTriple);
685 for (const std::string &A : MAttrs)
686 Features.AddFeature(A);
687
688 TargetOptions Options = InitTargetOptionsFromCodeGenFlags();
689 std::unique_ptr<TargetMachine> TM(TheTarget->createTargetMachine(
690 TripleStr, options::mcpu, Features.getString(), Options, RelocationModel,
691 CodeModel::Default, CodeGenOpt::Aggressive));
692
693 runLTOPasses(M, *TM);
694
695 PassManager CodeGenPasses;
Rafael Espindolac435adc2014-09-10 21:27:43 +0000696 CodeGenPasses.add(new DataLayoutPass());
Rafael Espindola33466a72014-08-21 20:28:55 +0000697
698 SmallString<128> Filename;
699 int FD;
700 if (options::obj_path.empty()) {
701 std::error_code EC =
702 sys::fs::createTemporaryFile("lto-llvm", "o", FD, Filename);
703 if (EC)
704 message(LDPL_FATAL, "Could not create temorary file: %s",
705 EC.message().c_str());
706 } else {
707 Filename = options::obj_path;
708 std::error_code EC =
709 sys::fs::openFileForWrite(Filename.c_str(), FD, sys::fs::F_None);
710 if (EC)
711 message(LDPL_FATAL, "Could not open file: %s", EC.message().c_str());
712 }
713
714 {
715 raw_fd_ostream OS(FD, true);
716 formatted_raw_ostream FOS(OS);
717
718 if (TM->addPassesToEmitFile(CodeGenPasses, FOS,
719 TargetMachine::CGFT_ObjectFile))
720 message(LDPL_FATAL, "Failed to setup codegen");
721 CodeGenPasses.run(M);
722 }
723
724 if (add_input_file(Filename.c_str()) != LDPS_OK)
725 message(LDPL_FATAL,
726 "Unable to add .o file to the link. File left behind in: %s",
727 Filename.c_str());
728
729 if (options::obj_path.empty())
730 Cleanup.push_back(Filename.c_str());
Rafael Espindola282a4702013-10-31 20:51:58 +0000731}
732
Rafael Espindolab6393292014-07-30 01:23:45 +0000733/// gold informs us that all symbols have been read. At this point, we use
734/// get_symbols to see if any of our definitions have been overridden by a
735/// native object file. Then, perform optimization and codegen.
Rafael Espindola33466a72014-08-21 20:28:55 +0000736static ld_plugin_status allSymbolsReadHook(raw_fd_ostream *ApiFile) {
737 if (Modules.empty())
738 return LDPS_OK;
Rafael Espindola9ef90d52011-02-20 18:28:29 +0000739
Rafael Espindola33466a72014-08-21 20:28:55 +0000740 LLVMContext Context;
741 std::unique_ptr<Module> Combined(new Module("ld-temp.o", Context));
742 Linker L(Combined.get());
743
744 std::string DefaultTriple = sys::getDefaultTargetTriple();
745
746 StringSet<> Internalize;
747 StringSet<> Maybe;
Rafael Espindolad2aac572014-07-30 01:52:40 +0000748 for (claimed_file &F : Modules) {
Rafael Espindola33466a72014-08-21 20:28:55 +0000749 std::unique_ptr<Module> M =
750 getModuleForFile(Context, F, ApiFile, Internalize, Maybe);
751 if (!options::triple.empty())
752 M->setTargetTriple(options::triple.c_str());
753 else if (M->getTargetTriple().empty()) {
754 M->setTargetTriple(DefaultTriple);
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000755 }
Rafael Espindola33466a72014-08-21 20:28:55 +0000756
757 std::string ErrMsg;
758 if (L.linkInModule(M.get(), &ErrMsg))
759 message(LDPL_FATAL, "Failed to link module: %s", ErrMsg.c_str());
Rafael Espindola77b6d012010-06-14 21:20:52 +0000760 }
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000761
Rafael Espindola33466a72014-08-21 20:28:55 +0000762 for (const auto &Name : Internalize) {
763 GlobalValue *GV = Combined->getNamedValue(Name.first());
764 if (GV)
765 internalize(*GV);
766 }
767
768 for (const auto &Name : Maybe) {
769 GlobalValue *GV = Combined->getNamedValue(Name.first());
770 if (!GV)
771 continue;
772 GV->setLinkage(GlobalValue::LinkOnceODRLinkage);
773 if (canBeOmittedFromSymbolTable(GV))
774 internalize(*GV);
775 }
Rafael Espindolaccab1dd2010-08-11 00:15:13 +0000776
Rafael Espindola8fb957e2010-06-03 21:11:20 +0000777 if (options::generate_bc_file != options::BC_NO) {
778 std::string path;
779 if (options::generate_bc_file == options::BC_ONLY)
780 path = output_name;
781 else if (!options::bc_path.empty())
782 path = options::bc_path;
783 else
784 path = output_name + ".bc";
Rafael Espindola33466a72014-08-21 20:28:55 +0000785 {
Rafael Espindola3fd1e992014-08-25 18:16:47 +0000786 std::error_code EC;
787 raw_fd_ostream OS(path, EC, sys::fs::OpenFlags::F_None);
788 if (EC)
Rafael Espindola33466a72014-08-21 20:28:55 +0000789 message(LDPL_FATAL, "Failed to write the output file.");
790 WriteBitcodeToFile(L.getModule(), OS);
791 }
Rafael Espindola55b32542014-08-11 19:06:54 +0000792 if (options::generate_bc_file == options::BC_ONLY)
793 return LDPS_OK;
Rafael Espindolaba3398b2010-05-13 13:39:31 +0000794 }
Rafael Espindola143fc3b2013-10-16 12:47:04 +0000795
Rafael Espindola33466a72014-08-21 20:28:55 +0000796 codegen(*L.getModule());
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000797
Rafael Espindolaef498152010-06-23 20:20:59 +0000798 if (!options::extra_library_path.empty() &&
Rafael Espindola33466a72014-08-21 20:28:55 +0000799 set_extra_library_path(options::extra_library_path.c_str()) != LDPS_OK)
800 message(LDPL_FATAL, "Unable to set the extra library path.");
Shuxin Yang1826ae22013-08-12 21:07:31 +0000801
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000802 return LDPS_OK;
803}
804
Rafael Espindola55b32542014-08-11 19:06:54 +0000805static ld_plugin_status all_symbols_read_hook(void) {
806 ld_plugin_status Ret;
807 if (!options::generate_api_file) {
808 Ret = allSymbolsReadHook(nullptr);
809 } else {
Rafael Espindola3fd1e992014-08-25 18:16:47 +0000810 std::error_code EC;
811 raw_fd_ostream ApiFile("apifile.txt", EC, sys::fs::F_None);
812 if (EC)
Rafael Espindola55b32542014-08-11 19:06:54 +0000813 message(LDPL_FATAL, "Unable to open apifile.txt for writing: %s",
Rafael Espindola3fd1e992014-08-25 18:16:47 +0000814 EC.message().c_str());
Rafael Espindola33466a72014-08-21 20:28:55 +0000815 Ret = allSymbolsReadHook(&ApiFile);
Rafael Espindola55b32542014-08-11 19:06:54 +0000816 }
817
Rafael Espindola55b32542014-08-11 19:06:54 +0000818 if (options::generate_bc_file == options::BC_ONLY)
819 exit(0);
820
821 return Ret;
822}
823
Dan Gohmanebb4ae02010-04-16 00:42:57 +0000824static ld_plugin_status cleanup_hook(void) {
Rafael Espindolad2aac572014-07-30 01:52:40 +0000825 for (std::string &Name : Cleanup) {
826 std::error_code EC = sys::fs::remove(Name);
Rafael Espindola55ab87f2013-06-17 18:38:18 +0000827 if (EC)
Rafael Espindolad2aac572014-07-30 01:52:40 +0000828 message(LDPL_ERROR, "Failed to delete '%s': %s", Name.c_str(),
Rafael Espindola5ad21fa2014-07-30 00:38:58 +0000829 EC.message().c_str());
Rafael Espindola55ab87f2013-06-17 18:38:18 +0000830 }
Nick Lewyckyfb643e42009-02-03 07:13:24 +0000831
832 return LDPS_OK;
833}