blob: bcc16f364a2c9523b77d5243b24b9b59fc140468 [file] [log] [blame]
Duncan P. N. Exon Smith846a6272014-02-17 23:22:49 +00001//===- llvm-profdata.cpp - LLVM profile data tool -------------------------===//
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// llvm-profdata merges .profdata files.
11//
12//===----------------------------------------------------------------------===//
13
Nathan Slingerlandc21a44d2015-11-18 17:10:24 +000014#include "llvm/ADT/SmallSet.h"
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +000015#include "llvm/ADT/SmallVector.h"
Duncan P. N. Exon Smith846a6272014-02-17 23:22:49 +000016#include "llvm/ADT/StringRef.h"
Chandler Carruthd9903882015-01-14 11:23:27 +000017#include "llvm/IR/LLVMContext.h"
Justin Bognerf8d79192014-03-21 17:24:48 +000018#include "llvm/ProfileData/InstrProfReader.h"
Justin Bognerb9bd7f82014-03-21 17:46:22 +000019#include "llvm/ProfileData/InstrProfWriter.h"
Easwaran Ramand68aae22016-02-04 23:34:31 +000020#include "llvm/ProfileData/ProfileCommon.h"
Diego Novillod5336ae2014-11-01 00:56:55 +000021#include "llvm/ProfileData/SampleProfReader.h"
22#include "llvm/ProfileData/SampleProfWriter.h"
Duncan P. N. Exon Smith846a6272014-02-17 23:22:49 +000023#include "llvm/Support/CommandLine.h"
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +000024#include "llvm/Support/Errc.h"
Benjamin Kramerd59664f2014-04-29 23:26:49 +000025#include "llvm/Support/FileSystem.h"
Justin Bogner423380f2014-03-23 20:43:50 +000026#include "llvm/Support/Format.h"
Duncan P. N. Exon Smith846a6272014-02-17 23:22:49 +000027#include "llvm/Support/ManagedStatic.h"
28#include "llvm/Support/MemoryBuffer.h"
Benjamin Kramer16132e62015-03-23 18:07:13 +000029#include "llvm/Support/Path.h"
Duncan P. N. Exon Smith846a6272014-02-17 23:22:49 +000030#include "llvm/Support/PrettyStackTrace.h"
31#include "llvm/Support/Signals.h"
Vedant Kumare3a0bf52016-07-19 01:17:20 +000032#include "llvm/Support/ThreadPool.h"
Duncan P. N. Exon Smith846a6272014-02-17 23:22:49 +000033#include "llvm/Support/raw_ostream.h"
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +000034#include <algorithm>
Duncan P. N. Exon Smith846a6272014-02-17 23:22:49 +000035
36using namespace llvm;
37
Xinliang David Li6f7c19a2015-11-23 20:47:38 +000038enum ProfileFormat { PF_None = 0, PF_Text, PF_Binary, PF_GCC };
39
Diego Novillod3babdb2015-12-14 20:37:15 +000040static void exitWithError(const Twine &Message, StringRef Whence = "",
Nathan Slingerland4f823662015-11-13 03:47:58 +000041 StringRef Hint = "") {
Justin Bognerf8d79192014-03-21 17:24:48 +000042 errs() << "error: ";
43 if (!Whence.empty())
44 errs() << Whence << ": ";
45 errs() << Message << "\n";
Nathan Slingerland4f823662015-11-13 03:47:58 +000046 if (!Hint.empty())
47 errs() << Hint << "\n";
Duncan P. N. Exon Smith846a6272014-02-17 23:22:49 +000048 ::exit(1);
49}
50
Vedant Kumar9152fd12016-05-19 03:54:45 +000051static void exitWithError(Error E, StringRef Whence = "") {
52 if (E.isA<InstrProfError>()) {
53 handleAllErrors(std::move(E), [&](const InstrProfError &IPE) {
54 instrprof_error instrError = IPE.get();
55 StringRef Hint = "";
56 if (instrError == instrprof_error::unrecognized_format) {
57 // Hint for common error of forgetting -sample for sample profiles.
58 Hint = "Perhaps you forgot to use the -sample option?";
59 }
60 exitWithError(IPE.message(), Whence, Hint);
61 });
Nathan Slingerland4f823662015-11-13 03:47:58 +000062 }
Vedant Kumar9152fd12016-05-19 03:54:45 +000063
64 exitWithError(toString(std::move(E)), Whence);
65}
66
67static void exitWithErrorCode(std::error_code EC, StringRef Whence = "") {
68 exitWithError(EC.message(), Whence);
Nathan Slingerland4f823662015-11-13 03:47:58 +000069}
70
Duncan P. N. Exon Smith02b6fa92015-06-16 00:43:04 +000071namespace {
Diego Novillod3babdb2015-12-14 20:37:15 +000072enum ProfileKinds { instr, sample };
Duncan P. N. Exon Smith02b6fa92015-06-16 00:43:04 +000073}
Justin Bogner618bcea2014-03-19 02:20:46 +000074
Vedant Kumar9152fd12016-05-19 03:54:45 +000075static void handleMergeWriterError(Error E, StringRef WhenceFile = "",
Nathan Slingerlande6e30d52015-11-17 22:08:53 +000076 StringRef WhenceFunction = "",
Diego Novillod3babdb2015-12-14 20:37:15 +000077 bool ShowHint = true) {
Nathan Slingerlande6e30d52015-11-17 22:08:53 +000078 if (!WhenceFile.empty())
79 errs() << WhenceFile << ": ";
80 if (!WhenceFunction.empty())
81 errs() << WhenceFunction << ": ";
Vedant Kumar9152fd12016-05-19 03:54:45 +000082
83 auto IPE = instrprof_error::success;
84 E = handleErrors(std::move(E),
85 [&IPE](std::unique_ptr<InstrProfError> E) -> Error {
86 IPE = E->get();
87 return Error(std::move(E));
88 });
89 errs() << toString(std::move(E)) << "\n";
Nathan Slingerlande6e30d52015-11-17 22:08:53 +000090
91 if (ShowHint) {
92 StringRef Hint = "";
Vedant Kumar9152fd12016-05-19 03:54:45 +000093 if (IPE != instrprof_error::success) {
94 switch (IPE) {
Nathan Slingerland11c938d12015-11-17 23:37:09 +000095 case instrprof_error::hash_mismatch:
96 case instrprof_error::count_mismatch:
97 case instrprof_error::value_site_count_mismatch:
Diego Novillod3babdb2015-12-14 20:37:15 +000098 Hint = "Make sure that all profile data to be merged is generated "
Nathan Slingerlande6e30d52015-11-17 22:08:53 +000099 "from the same binary.";
Nathan Slingerland11c938d12015-11-17 23:37:09 +0000100 break;
Nathan Slingerlandb2d95f02015-11-18 00:52:45 +0000101 default:
102 break;
Nathan Slingerlande6e30d52015-11-17 22:08:53 +0000103 }
104 }
105
106 if (!Hint.empty())
107 errs() << Hint << "\n";
108 }
109}
110
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +0000111struct WeightedFile {
Xinliang David Li9a1bfcf2016-07-20 22:24:52 +0000112 std::string Filename;
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +0000113 uint64_t Weight;
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +0000114};
115typedef SmallVector<WeightedFile, 5> WeightedFileVector;
116
Vedant Kumare3a0bf52016-07-19 01:17:20 +0000117/// Keep track of merged data and reported errors.
118struct WriterContext {
119 std::mutex Lock;
120 InstrProfWriter Writer;
121 Error Err;
122 StringRef ErrWhence;
123 std::mutex &ErrLock;
124 SmallSet<instrprof_error, 4> &WriterErrorCodes;
125
126 WriterContext(bool IsSparse, std::mutex &ErrLock,
127 SmallSet<instrprof_error, 4> &WriterErrorCodes)
128 : Lock(), Writer(IsSparse), Err(Error::success()), ErrWhence(""),
129 ErrLock(ErrLock), WriterErrorCodes(WriterErrorCodes) {}
130};
131
132/// Load an input into a writer context.
133static void loadInput(const WeightedFile &Input, WriterContext *WC) {
134 std::unique_lock<std::mutex> CtxGuard{WC->Lock};
135
136 // If there's a pending hard error, don't do more work.
137 if (WC->Err)
138 return;
139
140 WC->ErrWhence = Input.Filename;
141
142 auto ReaderOrErr = InstrProfReader::create(Input.Filename);
Rong Xu2c684cf2016-10-19 22:51:17 +0000143 if (Error E = ReaderOrErr.takeError()) {
144 // Skip the empty profiles by returning sliently.
145 instrprof_error IPE = InstrProfError::take(std::move(E));
146 if (IPE != instrprof_error::empty_raw_profile)
147 WC->Err = make_error<InstrProfError>(IPE);
Vedant Kumare3a0bf52016-07-19 01:17:20 +0000148 return;
Rong Xu2c684cf2016-10-19 22:51:17 +0000149 }
Vedant Kumare3a0bf52016-07-19 01:17:20 +0000150
151 auto Reader = std::move(ReaderOrErr.get());
152 bool IsIRProfile = Reader->isIRLevelProfile();
153 if (WC->Writer.setIsIRLevelProfile(IsIRProfile)) {
154 WC->Err = make_error<StringError>(
155 "Merge IR generated profile with Clang generated profile.",
156 std::error_code());
157 return;
158 }
159
160 for (auto &I : *Reader) {
Rong Xufe90d862016-10-19 23:31:59 +0000161 const StringRef FuncName = I.Name;
Vedant Kumare3a0bf52016-07-19 01:17:20 +0000162 if (Error E = WC->Writer.addRecord(std::move(I), Input.Weight)) {
163 // Only show hint the first time an error occurs.
164 instrprof_error IPE = InstrProfError::take(std::move(E));
165 std::unique_lock<std::mutex> ErrGuard{WC->ErrLock};
166 bool firstTime = WC->WriterErrorCodes.insert(IPE).second;
167 handleMergeWriterError(make_error<InstrProfError>(IPE), Input.Filename,
Rong Xufe90d862016-10-19 23:31:59 +0000168 FuncName, firstTime);
Vedant Kumare3a0bf52016-07-19 01:17:20 +0000169 }
170 }
171 if (Reader->hasError())
172 WC->Err = Reader->getError();
173}
174
175/// Merge the \p Src writer context into \p Dst.
176static void mergeWriterContexts(WriterContext *Dst, WriterContext *Src) {
177 if (Error E = Dst->Writer.mergeRecordsFromWriter(std::move(Src->Writer)))
178 Dst->Err = std::move(E);
179}
180
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +0000181static void mergeInstrProfile(const WeightedFileVector &Inputs,
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000182 StringRef OutputFilename,
Vedant Kumare3a0bf52016-07-19 01:17:20 +0000183 ProfileFormat OutputFormat, bool OutputSparse,
184 unsigned NumThreads) {
Justin Bognerb7aa2632014-04-18 21:48:40 +0000185 if (OutputFilename.compare("-") == 0)
186 exitWithError("Cannot write indexed profdata format to stdout.");
Justin Bognerec49f982014-03-12 22:00:57 +0000187
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000188 if (OutputFormat != PF_Binary && OutputFormat != PF_Text)
189 exitWithError("Unknown format is specified.");
190
Rafael Espindola3fd1e992014-08-25 18:16:47 +0000191 std::error_code EC;
192 raw_fd_ostream Output(OutputFilename.data(), EC, sys::fs::F_None);
193 if (EC)
Nathan Slingerland4f823662015-11-13 03:47:58 +0000194 exitWithErrorCode(EC, OutputFilename);
Justin Bognerec49f982014-03-12 22:00:57 +0000195
Vedant Kumare3a0bf52016-07-19 01:17:20 +0000196 std::mutex ErrorLock;
Vedant Kumar9152fd12016-05-19 03:54:45 +0000197 SmallSet<instrprof_error, 4> WriterErrorCodes;
Justin Bognerf8d79192014-03-21 17:24:48 +0000198
Vedant Kumare3a0bf52016-07-19 01:17:20 +0000199 // If NumThreads is not specified, auto-detect a good default.
200 if (NumThreads == 0)
201 NumThreads = std::max(1U, std::min(std::thread::hardware_concurrency(),
202 unsigned(Inputs.size() / 2)));
Rong Xu33c76c02016-02-10 17:18:30 +0000203
Vedant Kumare3a0bf52016-07-19 01:17:20 +0000204 // Initialize the writer contexts.
205 SmallVector<std::unique_ptr<WriterContext>, 4> Contexts;
206 for (unsigned I = 0; I < NumThreads; ++I)
207 Contexts.emplace_back(llvm::make_unique<WriterContext>(
208 OutputSparse, ErrorLock, WriterErrorCodes));
209
210 if (NumThreads == 1) {
211 for (const auto &Input : Inputs)
212 loadInput(Input, Contexts[0].get());
213 } else {
214 ThreadPool Pool(NumThreads);
215
216 // Load the inputs in parallel (N/NumThreads serial steps).
217 unsigned Ctx = 0;
218 for (const auto &Input : Inputs) {
219 Pool.async(loadInput, Input, Contexts[Ctx].get());
220 Ctx = (Ctx + 1) % NumThreads;
Nathan Slingerlande6e30d52015-11-17 22:08:53 +0000221 }
Vedant Kumare3a0bf52016-07-19 01:17:20 +0000222 Pool.wait();
223
224 // Merge the writer contexts together (~ lg(NumThreads) serial steps).
225 unsigned Mid = Contexts.size() / 2;
226 unsigned End = Contexts.size();
227 assert(Mid > 0 && "Expected more than one context");
228 do {
229 for (unsigned I = 0; I < Mid; ++I)
230 Pool.async(mergeWriterContexts, Contexts[I].get(),
231 Contexts[I + Mid].get());
232 Pool.wait();
233 if (End & 1) {
234 Pool.async(mergeWriterContexts, Contexts[0].get(),
235 Contexts[End - 1].get());
236 Pool.wait();
237 }
238 End = Mid;
239 Mid /= 2;
240 } while (Mid > 0);
Justin Bognerbfee8d42014-03-12 20:14:17 +0000241 }
Vedant Kumare3a0bf52016-07-19 01:17:20 +0000242
243 // Handle deferred hard errors encountered during merging.
244 for (std::unique_ptr<WriterContext> &WC : Contexts)
245 if (WC->Err)
246 exitWithError(std::move(WC->Err), WC->ErrWhence);
247
248 InstrProfWriter &Writer = Contexts[0]->Writer;
Vedant Kumarb5794ca2017-06-20 01:38:56 +0000249 if (OutputFormat == PF_Text) {
250 if (Error E = Writer.writeText(Output))
251 exitWithError(std::move(E));
252 } else {
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000253 Writer.write(Output);
Vedant Kumarb5794ca2017-06-20 01:38:56 +0000254 }
Diego Novillod5336ae2014-11-01 00:56:55 +0000255}
256
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000257static sampleprof::SampleProfileFormat FormatMap[] = {
258 sampleprof::SPF_None, sampleprof::SPF_Text, sampleprof::SPF_Binary,
259 sampleprof::SPF_GCC};
260
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +0000261static void mergeSampleProfile(const WeightedFileVector &Inputs,
Benjamin Kramerf044d3f2015-03-09 16:23:46 +0000262 StringRef OutputFilename,
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000263 ProfileFormat OutputFormat) {
Diego Novillod5336ae2014-11-01 00:56:55 +0000264 using namespace sampleprof;
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000265 auto WriterOrErr =
266 SampleProfileWriter::create(OutputFilename, FormatMap[OutputFormat]);
Diego Novillofcd55602014-11-03 00:51:45 +0000267 if (std::error_code EC = WriterOrErr.getError())
Nathan Slingerland4f823662015-11-13 03:47:58 +0000268 exitWithErrorCode(EC, OutputFilename);
Diego Novillod5336ae2014-11-01 00:56:55 +0000269
Diego Novillofcd55602014-11-03 00:51:45 +0000270 auto Writer = std::move(WriterOrErr.get());
Diego Novillod5336ae2014-11-01 00:56:55 +0000271 StringMap<FunctionSamples> ProfileMap;
Diego Novilloaae1ed82015-10-08 19:40:37 +0000272 SmallVector<std::unique_ptr<sampleprof::SampleProfileReader>, 5> Readers;
Mehdi Amini03b42e42016-04-14 21:59:01 +0000273 LLVMContext Context;
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +0000274 for (const auto &Input : Inputs) {
Mehdi Amini03b42e42016-04-14 21:59:01 +0000275 auto ReaderOrErr = SampleProfileReader::create(Input.Filename, Context);
Diego Novillofcd55602014-11-03 00:51:45 +0000276 if (std::error_code EC = ReaderOrErr.getError())
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +0000277 exitWithErrorCode(EC, Input.Filename);
Diego Novillod5336ae2014-11-01 00:56:55 +0000278
Diego Novilloaae1ed82015-10-08 19:40:37 +0000279 // We need to keep the readers around until after all the files are
280 // read so that we do not lose the function names stored in each
281 // reader's memory. The function names are needed to write out the
282 // merged profile map.
283 Readers.push_back(std::move(ReaderOrErr.get()));
284 const auto Reader = Readers.back().get();
Diego Novillod5336ae2014-11-01 00:56:55 +0000285 if (std::error_code EC = Reader->read())
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +0000286 exitWithErrorCode(EC, Input.Filename);
Diego Novillod5336ae2014-11-01 00:56:55 +0000287
288 StringMap<FunctionSamples> &Profiles = Reader->getProfiles();
289 for (StringMap<FunctionSamples>::iterator I = Profiles.begin(),
290 E = Profiles.end();
291 I != E; ++I) {
292 StringRef FName = I->first();
293 FunctionSamples &Samples = I->second;
Nathan Slingerland48dd0802015-12-16 21:45:43 +0000294 sampleprof_error Result = ProfileMap[FName].merge(Samples, Input.Weight);
295 if (Result != sampleprof_error::success) {
296 std::error_code EC = make_error_code(Result);
Vedant Kumar9152fd12016-05-19 03:54:45 +0000297 handleMergeWriterError(errorCodeToError(EC), Input.Filename, FName);
Nathan Slingerland48dd0802015-12-16 21:45:43 +0000298 }
Diego Novillod5336ae2014-11-01 00:56:55 +0000299 }
300 }
301 Writer->write(ProfileMap);
302}
303
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +0000304static WeightedFile parseWeightedFile(const StringRef &WeightedFilename) {
Vedant Kumar8d0e8612016-06-06 23:43:56 +0000305 StringRef WeightStr, FileName;
306 std::tie(WeightStr, FileName) = WeightedFilename.split(',');
Diego Novillod5336ae2014-11-01 00:56:55 +0000307
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +0000308 uint64_t Weight;
309 if (WeightStr.getAsInteger(10, Weight) || Weight < 1)
310 exitWithError("Input weight must be a positive integer.");
311
Benjamin Kramer929e7db2016-07-21 14:29:11 +0000312 return {FileName, Weight};
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +0000313}
314
Vedant Kumarcef43602016-06-07 22:47:31 +0000315static std::unique_ptr<MemoryBuffer>
316getInputFilenamesFileBuf(const StringRef &InputFilenamesFile) {
317 if (InputFilenamesFile == "")
318 return {};
319
320 auto BufOrError = MemoryBuffer::getFileOrSTDIN(InputFilenamesFile);
321 if (!BufOrError)
322 exitWithErrorCode(BufOrError.getError(), InputFilenamesFile);
323
324 return std::move(*BufOrError);
325}
326
Xinliang David Li9a1bfcf2016-07-20 22:24:52 +0000327static void addWeightedInput(WeightedFileVector &WNI, const WeightedFile &WF) {
328 StringRef Filename = WF.Filename;
329 uint64_t Weight = WF.Weight;
Benjamin Kramera81f4722016-07-22 12:39:55 +0000330
331 // If it's STDIN just pass it on.
332 if (Filename == "-") {
333 WNI.push_back({Filename, Weight});
334 return;
335 }
336
Xinliang David Li9a1bfcf2016-07-20 22:24:52 +0000337 llvm::sys::fs::file_status Status;
338 llvm::sys::fs::status(Filename, Status);
339 if (!llvm::sys::fs::exists(Status))
340 exitWithErrorCode(make_error_code(errc::no_such_file_or_directory),
341 Filename);
342 // If it's a source file, collect it.
343 if (llvm::sys::fs::is_regular_file(Status)) {
Benjamin Kramer929e7db2016-07-21 14:29:11 +0000344 WNI.push_back({Filename, Weight});
Xinliang David Li9a1bfcf2016-07-20 22:24:52 +0000345 return;
346 }
347
348 if (llvm::sys::fs::is_directory(Status)) {
349 std::error_code EC;
350 for (llvm::sys::fs::recursive_directory_iterator F(Filename, EC), E;
351 F != E && !EC; F.increment(EC)) {
352 if (llvm::sys::fs::is_regular_file(F->path())) {
353 addWeightedInput(WNI, {F->path(), Weight});
354 }
355 }
356 if (EC)
357 exitWithErrorCode(EC, Filename);
358 }
359}
360
Vedant Kumarcef43602016-06-07 22:47:31 +0000361static void parseInputFilenamesFile(MemoryBuffer *Buffer,
362 WeightedFileVector &WFV) {
363 if (!Buffer)
364 return;
365
366 SmallVector<StringRef, 8> Entries;
367 StringRef Data = Buffer->getBuffer();
368 Data.split(Entries, '\n', /*MaxSplit=*/-1, /*KeepEmpty=*/false);
369 for (const StringRef &FileWeightEntry : Entries) {
370 StringRef SanitizedEntry = FileWeightEntry.trim(" \t\v\f\r");
371 // Skip comments.
372 if (SanitizedEntry.startswith("#"))
373 continue;
374 // If there's no comma, it's an unweighted profile.
375 else if (SanitizedEntry.find(',') == StringRef::npos)
Xinliang David Li9a1bfcf2016-07-20 22:24:52 +0000376 addWeightedInput(WFV, {SanitizedEntry, 1});
Vedant Kumarcef43602016-06-07 22:47:31 +0000377 else
Xinliang David Li9a1bfcf2016-07-20 22:24:52 +0000378 addWeightedInput(WFV, parseWeightedFile(SanitizedEntry));
Vedant Kumarcef43602016-06-07 22:47:31 +0000379 }
380}
381
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +0000382static int merge_main(int argc, const char *argv[]) {
383 cl::list<std::string> InputFilenames(cl::Positional,
384 cl::desc("<filename...>"));
385 cl::list<std::string> WeightedInputFilenames("weighted-input",
386 cl::desc("<weight>,<filename>"));
Vedant Kumarcef43602016-06-07 22:47:31 +0000387 cl::opt<std::string> InputFilenamesFile(
388 "input-files", cl::init(""),
389 cl::desc("Path to file containing newline-separated "
390 "[<weight>,]<filename> entries"));
391 cl::alias InputFilenamesFileA("f", cl::desc("Alias for --input-files"),
392 cl::aliasopt(InputFilenamesFile));
393 cl::opt<bool> DumpInputFileList(
394 "dump-input-file-list", cl::init(false), cl::Hidden,
395 cl::desc("Dump the list of input files and their weights, then exit"));
Diego Novillod5336ae2014-11-01 00:56:55 +0000396 cl::opt<std::string> OutputFilename("output", cl::value_desc("output"),
397 cl::init("-"), cl::Required,
398 cl::desc("Output file"));
399 cl::alias OutputFilenameA("o", cl::desc("Alias for --output"),
400 cl::aliasopt(OutputFilename));
401 cl::opt<ProfileKinds> ProfileKind(
402 cl::desc("Profile kind:"), cl::init(instr),
403 cl::values(clEnumVal(instr, "Instrumentation profile (default)"),
Mehdi Amini732afdd2016-10-08 19:41:06 +0000404 clEnumVal(sample, "Sample profile")));
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000405 cl::opt<ProfileFormat> OutputFormat(
406 cl::desc("Format of output profile"), cl::init(PF_Binary),
407 cl::values(clEnumValN(PF_Binary, "binary", "Binary encoding (default)"),
408 clEnumValN(PF_Text, "text", "Text encoding"),
409 clEnumValN(PF_GCC, "gcc",
Mehdi Amini732afdd2016-10-08 19:41:06 +0000410 "GCC encoding (only meaningful for -sample)")));
Vedant Kumar00dab222016-01-29 22:54:45 +0000411 cl::opt<bool> OutputSparse("sparse", cl::init(false),
412 cl::desc("Generate a sparse profile (only meaningful for -instr)"));
Vedant Kumare3a0bf52016-07-19 01:17:20 +0000413 cl::opt<unsigned> NumThreads(
414 "num-threads", cl::init(0),
415 cl::desc("Number of merge threads to use (default: autodetect)"));
416 cl::alias NumThreadsA("j", cl::desc("Alias for --num-threads"),
417 cl::aliasopt(NumThreads));
Vedant Kumar00dab222016-01-29 22:54:45 +0000418
Diego Novillod5336ae2014-11-01 00:56:55 +0000419 cl::ParseCommandLineOptions(argc, argv, "LLVM profile data merger\n");
420
Vedant Kumarcef43602016-06-07 22:47:31 +0000421 WeightedFileVector WeightedInputs;
422 for (StringRef Filename : InputFilenames)
Xinliang David Li9a1bfcf2016-07-20 22:24:52 +0000423 addWeightedInput(WeightedInputs, {Filename, 1});
Vedant Kumarcef43602016-06-07 22:47:31 +0000424 for (StringRef WeightedFilename : WeightedInputFilenames)
Xinliang David Li9a1bfcf2016-07-20 22:24:52 +0000425 addWeightedInput(WeightedInputs, parseWeightedFile(WeightedFilename));
Vedant Kumarcef43602016-06-07 22:47:31 +0000426
427 // Make sure that the file buffer stays alive for the duration of the
428 // weighted input vector's lifetime.
429 auto Buffer = getInputFilenamesFileBuf(InputFilenamesFile);
430 parseInputFilenamesFile(Buffer.get(), WeightedInputs);
431
432 if (WeightedInputs.empty())
Chandler Carruth0c30f892016-06-04 03:08:01 +0000433 exitWithError("No input files specified. See " +
434 sys::path::filename(argv[0]) + " -help");
435
Vedant Kumarcef43602016-06-07 22:47:31 +0000436 if (DumpInputFileList) {
437 for (auto &WF : WeightedInputs)
438 outs() << WF.Weight << "," << WF.Filename << "\n";
439 return 0;
440 }
Vedant Kumarf771a052016-06-04 00:36:28 +0000441
Diego Novillod5336ae2014-11-01 00:56:55 +0000442 if (ProfileKind == instr)
Vedant Kumar00dab222016-01-29 22:54:45 +0000443 mergeInstrProfile(WeightedInputs, OutputFilename, OutputFormat,
Vedant Kumare3a0bf52016-07-19 01:17:20 +0000444 OutputSparse, NumThreads);
Diego Novillod5336ae2014-11-01 00:56:55 +0000445 else
Nathan Slingerland7f5b47d2015-12-15 17:37:09 +0000446 mergeSampleProfile(WeightedInputs, OutputFilename, OutputFormat);
Justin Bognerbfee8d42014-03-12 20:14:17 +0000447
Justin Bognerec49f982014-03-12 22:00:57 +0000448 return 0;
Justin Bognerbfee8d42014-03-12 20:14:17 +0000449}
Justin Bogner618bcea2014-03-19 02:20:46 +0000450
Rong Xu0cf1f562017-03-09 19:03:57 +0000451typedef struct ValueSitesStats {
452 ValueSitesStats()
453 : TotalNumValueSites(0), TotalNumValueSitesWithValueProfile(0),
454 TotalNumValues(0) {}
455 uint64_t TotalNumValueSites;
456 uint64_t TotalNumValueSitesWithValueProfile;
457 uint64_t TotalNumValues;
458 std::vector<unsigned> ValueSitesHistogram;
459} ValueSitesStats;
460
461static void traverseAllValueSites(const InstrProfRecord &Func, uint32_t VK,
462 ValueSitesStats &Stats, raw_fd_ostream &OS,
Rong Xu60faea12017-03-16 21:15:48 +0000463 InstrProfSymtab *Symtab) {
Rong Xu0cf1f562017-03-09 19:03:57 +0000464 uint32_t NS = Func.getNumValueSites(VK);
465 Stats.TotalNumValueSites += NS;
466 for (size_t I = 0; I < NS; ++I) {
467 uint32_t NV = Func.getNumValueDataForSite(VK, I);
468 std::unique_ptr<InstrProfValueData[]> VD = Func.getValueForSite(VK, I);
469 Stats.TotalNumValues += NV;
470 if (NV) {
471 Stats.TotalNumValueSitesWithValueProfile++;
472 if (NV > Stats.ValueSitesHistogram.size())
473 Stats.ValueSitesHistogram.resize(NV, 0);
474 Stats.ValueSitesHistogram[NV - 1]++;
475 }
476 for (uint32_t V = 0; V < NV; V++) {
477 OS << "\t[ " << I << ", ";
Rong Xu60faea12017-03-16 21:15:48 +0000478 if (Symtab == nullptr)
479 OS << VD[V].Value;
480 else
481 OS << Symtab->getFuncName(VD[V].Value);
482 OS << ", " << VD[V].Count << " ]\n";
Rong Xu0cf1f562017-03-09 19:03:57 +0000483 }
484 }
485}
486
487static void showValueSitesStats(raw_fd_ostream &OS, uint32_t VK,
488 ValueSitesStats &Stats) {
489 OS << " Total number of sites: " << Stats.TotalNumValueSites << "\n";
490 OS << " Total number of sites with values: "
491 << Stats.TotalNumValueSitesWithValueProfile << "\n";
492 OS << " Total number of profiled values: " << Stats.TotalNumValues << "\n";
493
494 OS << " Value sites histogram:\n\tNumTargets, SiteCount\n";
495 for (unsigned I = 0; I < Stats.ValueSitesHistogram.size(); I++) {
496 if (Stats.ValueSitesHistogram[I] > 0)
497 OS << "\t" << I + 1 << ", " << Stats.ValueSitesHistogram[I] << "\n";
498 }
499}
500
Benjamin Kramer1afc1de2016-06-17 20:41:14 +0000501static int showInstrProfile(const std::string &Filename, bool ShowCounts,
Rong Xu60faea12017-03-16 21:15:48 +0000502 bool ShowIndirectCallTargets, bool ShowMemOPSizes,
Easwaran Raman183ebbe2016-01-13 21:44:36 +0000503 bool ShowDetailedSummary,
504 std::vector<uint32_t> DetailedSummaryCutoffs,
Benjamin Kramer1afc1de2016-06-17 20:41:14 +0000505 bool ShowAllFunctions,
506 const std::string &ShowFunction, bool TextFormat,
507 raw_fd_ostream &OS) {
Diego Novillofcd55602014-11-03 00:51:45 +0000508 auto ReaderOrErr = InstrProfReader::create(Filename);
Benjamin Kramer1afc1de2016-06-17 20:41:14 +0000509 std::vector<uint32_t> Cutoffs = std::move(DetailedSummaryCutoffs);
510 if (ShowDetailedSummary && Cutoffs.empty()) {
Easwaran Raman183ebbe2016-01-13 21:44:36 +0000511 Cutoffs = {800000, 900000, 950000, 990000, 999000, 999900, 999990};
512 }
Benjamin Kramer1afc1de2016-06-17 20:41:14 +0000513 InstrProfSummaryBuilder Builder(std::move(Cutoffs));
Vedant Kumar9152fd12016-05-19 03:54:45 +0000514 if (Error E = ReaderOrErr.takeError())
515 exitWithError(std::move(E), Filename);
Justin Bogner9af28ef2014-03-21 17:29:44 +0000516
Diego Novillofcd55602014-11-03 00:51:45 +0000517 auto Reader = std::move(ReaderOrErr.get());
Rong Xu33c76c02016-02-10 17:18:30 +0000518 bool IsIRInstr = Reader->isIRLevelProfile();
Easwaran Raman183ebbe2016-01-13 21:44:36 +0000519 size_t ShownFunctions = 0;
Rong Xu0cf1f562017-03-09 19:03:57 +0000520 int NumVPKind = IPVK_Last - IPVK_First + 1;
521 std::vector<ValueSitesStats> VPStats(NumVPKind);
Justin Bogner9af28ef2014-03-21 17:29:44 +0000522 for (const auto &Func : *Reader) {
Diego Novillod5336ae2014-11-01 00:56:55 +0000523 bool Show =
524 ShowAllFunctions || (!ShowFunction.empty() &&
525 Func.Name.find(ShowFunction) != Func.Name.npos);
Justin Bogner9af28ef2014-03-21 17:29:44 +0000526
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000527 bool doTextFormatDump = (Show && ShowCounts && TextFormat);
528
529 if (doTextFormatDump) {
Xinliang David Lia716cc52015-12-20 06:22:13 +0000530 InstrProfSymtab &Symtab = Reader->getSymtab();
David Blaikiecf9d52c2017-07-06 19:00:12 +0000531 InstrProfWriter::writeRecordInText(Func.Name, Func.Hash, Func, Symtab,
532 OS);
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000533 continue;
534 }
535
Justin Bognerb59d7c72014-04-25 02:45:33 +0000536 assert(Func.Counts.size() > 0 && "function missing entry counter");
Easwaran Ramane5a17e32016-05-19 21:07:12 +0000537 Builder.addRecord(Func);
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000538
Justin Bogner9af28ef2014-03-21 17:29:44 +0000539 if (Show) {
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000540
Justin Bogner9af28ef2014-03-21 17:29:44 +0000541 if (!ShownFunctions)
542 OS << "Counters:\n";
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000543
Justin Bogner9af28ef2014-03-21 17:29:44 +0000544 ++ShownFunctions;
545
546 OS << " " << Func.Name << ":\n"
Justin Bogner423380f2014-03-23 20:43:50 +0000547 << " Hash: " << format("0x%016" PRIx64, Func.Hash) << "\n"
Rong Xu33c76c02016-02-10 17:18:30 +0000548 << " Counters: " << Func.Counts.size() << "\n";
549 if (!IsIRInstr)
550 OS << " Function count: " << Func.Counts[0] << "\n";
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000551
Justin Bogner9e9a0572015-09-29 22:13:58 +0000552 if (ShowIndirectCallTargets)
Xinliang David Li2004f002015-11-02 05:08:23 +0000553 OS << " Indirect Call Site Count: "
554 << Func.getNumValueSites(IPVK_IndirectCallTarget) << "\n";
Justin Bogner9af28ef2014-03-21 17:29:44 +0000555
Rong Xu60faea12017-03-16 21:15:48 +0000556 uint32_t NumMemOPCalls = Func.getNumValueSites(IPVK_MemOPSize);
557 if (ShowMemOPSizes && NumMemOPCalls > 0)
558 OS << " Number of Memory Intrinsics Calls: " << NumMemOPCalls
559 << "\n";
560
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000561 if (ShowCounts) {
562 OS << " Block counts: [";
Rong Xu33c76c02016-02-10 17:18:30 +0000563 size_t Start = (IsIRInstr ? 0 : 1);
564 for (size_t I = Start, E = Func.Counts.size(); I < E; ++I) {
565 OS << (I == Start ? "" : ", ") << Func.Counts[I];
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000566 }
567 OS << "]\n";
568 }
Justin Bogner9e9a0572015-09-29 22:13:58 +0000569
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000570 if (ShowIndirectCallTargets) {
Rong Xu0cf1f562017-03-09 19:03:57 +0000571 OS << " Indirect Target Results:\n";
572 traverseAllValueSites(Func, IPVK_IndirectCallTarget,
573 VPStats[IPVK_IndirectCallTarget], OS,
Rong Xu60faea12017-03-16 21:15:48 +0000574 &(Reader->getSymtab()));
575 }
576
577 if (ShowMemOPSizes && NumMemOPCalls > 0) {
Teresa Johnsoncd2aa0d2017-05-24 17:55:25 +0000578 OS << " Memory Intrinsic Size Results:\n";
Rong Xu60faea12017-03-16 21:15:48 +0000579 traverseAllValueSites(Func, IPVK_MemOPSize, VPStats[IPVK_MemOPSize], OS,
580 nullptr);
Justin Bogner9e9a0572015-09-29 22:13:58 +0000581 }
582 }
Justin Bogner9af28ef2014-03-21 17:29:44 +0000583 }
Justin Bognerdb1225d2014-03-23 20:55:53 +0000584 if (Reader->hasError())
Vedant Kumar9152fd12016-05-19 03:54:45 +0000585 exitWithError(Reader->getError(), Filename);
Justin Bogner9af28ef2014-03-21 17:29:44 +0000586
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000587 if (ShowCounts && TextFormat)
588 return 0;
Easwaran Raman7cefdb82016-05-19 21:53:28 +0000589 std::unique_ptr<ProfileSummary> PS(Builder.getSummary());
Justin Bogner9af28ef2014-03-21 17:29:44 +0000590 if (ShowAllFunctions || !ShowFunction.empty())
591 OS << "Functions shown: " << ShownFunctions << "\n";
Easwaran Ramane5a17e32016-05-19 21:07:12 +0000592 OS << "Total functions: " << PS->getNumFunctions() << "\n";
593 OS << "Maximum function count: " << PS->getMaxFunctionCount() << "\n";
Easwaran Raman7cefdb82016-05-19 21:53:28 +0000594 OS << "Maximum internal block count: " << PS->getMaxInternalCount() << "\n";
Rong Xu60faea12017-03-16 21:15:48 +0000595
Xinliang David Li872362c2016-05-23 16:36:11 +0000596 if (ShownFunctions && ShowIndirectCallTargets) {
Rong Xu0cf1f562017-03-09 19:03:57 +0000597 OS << "Statistics for indirect call sites profile:\n";
598 showValueSitesStats(OS, IPVK_IndirectCallTarget,
599 VPStats[IPVK_IndirectCallTarget]);
Xinliang David Li872362c2016-05-23 16:36:11 +0000600 }
Easwaran Raman183ebbe2016-01-13 21:44:36 +0000601
Rong Xu60faea12017-03-16 21:15:48 +0000602 if (ShownFunctions && ShowMemOPSizes) {
603 OS << "Statistics for memory intrinsic calls sizes profile:\n";
604 showValueSitesStats(OS, IPVK_MemOPSize, VPStats[IPVK_MemOPSize]);
605 }
606
Easwaran Raman183ebbe2016-01-13 21:44:36 +0000607 if (ShowDetailedSummary) {
608 OS << "Detailed summary:\n";
Easwaran Raman7cefdb82016-05-19 21:53:28 +0000609 OS << "Total number of blocks: " << PS->getNumCounts() << "\n";
Easwaran Ramane5a17e32016-05-19 21:07:12 +0000610 OS << "Total count: " << PS->getTotalCount() << "\n";
611 for (auto Entry : PS->getDetailedSummary()) {
Easwaran Raman43095702016-02-17 18:18:47 +0000612 OS << Entry.NumCounts << " blocks with count >= " << Entry.MinCount
Easwaran Raman183ebbe2016-01-13 21:44:36 +0000613 << " account for "
614 << format("%0.6g", (float)Entry.Cutoff / ProfileSummary::Scale * 100)
615 << " percentage of the total counts.\n";
616 }
617 }
Justin Bogner9af28ef2014-03-21 17:29:44 +0000618 return 0;
619}
620
Benjamin Kramer1afc1de2016-06-17 20:41:14 +0000621static int showSampleProfile(const std::string &Filename, bool ShowCounts,
622 bool ShowAllFunctions,
623 const std::string &ShowFunction,
Benjamin Kramerf044d3f2015-03-09 16:23:46 +0000624 raw_fd_ostream &OS) {
Diego Novillod5336ae2014-11-01 00:56:55 +0000625 using namespace sampleprof;
Mehdi Amini03b42e42016-04-14 21:59:01 +0000626 LLVMContext Context;
627 auto ReaderOrErr = SampleProfileReader::create(Filename, Context);
Diego Novillofcd55602014-11-03 00:51:45 +0000628 if (std::error_code EC = ReaderOrErr.getError())
Nathan Slingerland4f823662015-11-13 03:47:58 +0000629 exitWithErrorCode(EC, Filename);
Diego Novillod5336ae2014-11-01 00:56:55 +0000630
Diego Novillofcd55602014-11-03 00:51:45 +0000631 auto Reader = std::move(ReaderOrErr.get());
Diego Novilloc6d032a2015-09-17 00:17:21 +0000632 if (std::error_code EC = Reader->read())
Nathan Slingerland4f823662015-11-13 03:47:58 +0000633 exitWithErrorCode(EC, Filename);
Diego Novilloc6d032a2015-09-17 00:17:21 +0000634
Diego Novillod5336ae2014-11-01 00:56:55 +0000635 if (ShowAllFunctions || ShowFunction.empty())
636 Reader->dump(OS);
637 else
638 Reader->dumpFunctionProfile(ShowFunction, OS);
639
640 return 0;
641}
642
Benjamin Kramerf044d3f2015-03-09 16:23:46 +0000643static int show_main(int argc, const char *argv[]) {
Diego Novillod5336ae2014-11-01 00:56:55 +0000644 cl::opt<std::string> Filename(cl::Positional, cl::Required,
645 cl::desc("<profdata-file>"));
646
647 cl::opt<bool> ShowCounts("counts", cl::init(false),
648 cl::desc("Show counter values for shown functions"));
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000649 cl::opt<bool> TextFormat(
650 "text", cl::init(false),
651 cl::desc("Show instr profile data in text dump format"));
Justin Bogner9e9a0572015-09-29 22:13:58 +0000652 cl::opt<bool> ShowIndirectCallTargets(
653 "ic-targets", cl::init(false),
654 cl::desc("Show indirect call site target values for shown functions"));
Rong Xu60faea12017-03-16 21:15:48 +0000655 cl::opt<bool> ShowMemOPSizes(
656 "memop-sizes", cl::init(false),
657 cl::desc("Show the profiled sizes of the memory intrinsic calls "
658 "for shown functions"));
Easwaran Raman183ebbe2016-01-13 21:44:36 +0000659 cl::opt<bool> ShowDetailedSummary("detailed-summary", cl::init(false),
660 cl::desc("Show detailed profile summary"));
661 cl::list<uint32_t> DetailedSummaryCutoffs(
662 cl::CommaSeparated, "detailed-summary-cutoffs",
663 cl::desc(
664 "Cutoff percentages (times 10000) for generating detailed summary"),
665 cl::value_desc("800000,901000,999999"));
Diego Novillod5336ae2014-11-01 00:56:55 +0000666 cl::opt<bool> ShowAllFunctions("all-functions", cl::init(false),
667 cl::desc("Details for every function"));
668 cl::opt<std::string> ShowFunction("function",
669 cl::desc("Details for matching functions"));
670
671 cl::opt<std::string> OutputFilename("output", cl::value_desc("output"),
672 cl::init("-"), cl::desc("Output file"));
673 cl::alias OutputFilenameA("o", cl::desc("Alias for --output"),
674 cl::aliasopt(OutputFilename));
675 cl::opt<ProfileKinds> ProfileKind(
676 cl::desc("Profile kind:"), cl::init(instr),
677 cl::values(clEnumVal(instr, "Instrumentation profile (default)"),
Mehdi Amini732afdd2016-10-08 19:41:06 +0000678 clEnumVal(sample, "Sample profile")));
Diego Novillod5336ae2014-11-01 00:56:55 +0000679
680 cl::ParseCommandLineOptions(argc, argv, "LLVM profile data summary\n");
681
682 if (OutputFilename.empty())
683 OutputFilename = "-";
684
685 std::error_code EC;
686 raw_fd_ostream OS(OutputFilename.data(), EC, sys::fs::F_Text);
687 if (EC)
Xinliang David Li6f7c19a2015-11-23 20:47:38 +0000688 exitWithErrorCode(EC, OutputFilename);
Diego Novillod5336ae2014-11-01 00:56:55 +0000689
690 if (ShowAllFunctions && !ShowFunction.empty())
691 errs() << "warning: -function argument ignored: showing all functions\n";
692
Easwaran Raman183ebbe2016-01-13 21:44:36 +0000693 std::vector<uint32_t> Cutoffs(DetailedSummaryCutoffs.begin(),
694 DetailedSummaryCutoffs.end());
Diego Novillod5336ae2014-11-01 00:56:55 +0000695 if (ProfileKind == instr)
Justin Bogner9e9a0572015-09-29 22:13:58 +0000696 return showInstrProfile(Filename, ShowCounts, ShowIndirectCallTargets,
Rong Xu60faea12017-03-16 21:15:48 +0000697 ShowMemOPSizes, ShowDetailedSummary,
698 DetailedSummaryCutoffs, ShowAllFunctions,
699 ShowFunction, TextFormat, OS);
Diego Novillod5336ae2014-11-01 00:56:55 +0000700 else
701 return showSampleProfile(Filename, ShowCounts, ShowAllFunctions,
702 ShowFunction, OS);
703}
704
Justin Bogner618bcea2014-03-19 02:20:46 +0000705int main(int argc, const char *argv[]) {
706 // Print a stack trace if we signal out.
Richard Smith2ad6d482016-06-09 00:53:21 +0000707 sys::PrintStackTraceOnErrorSignal(argv[0]);
Justin Bogner618bcea2014-03-19 02:20:46 +0000708 PrettyStackTraceProgram X(argc, argv);
709 llvm_shutdown_obj Y; // Call llvm_shutdown() on exit.
710
711 StringRef ProgName(sys::path::filename(argv[0]));
712 if (argc > 1) {
Craig Toppere6cb63e2014-04-25 04:24:47 +0000713 int (*func)(int, const char *[]) = nullptr;
Justin Bogner618bcea2014-03-19 02:20:46 +0000714
715 if (strcmp(argv[1], "merge") == 0)
716 func = merge_main;
Justin Bogner9af28ef2014-03-21 17:29:44 +0000717 else if (strcmp(argv[1], "show") == 0)
718 func = show_main;
Justin Bogner618bcea2014-03-19 02:20:46 +0000719
720 if (func) {
721 std::string Invocation(ProgName.str() + " " + argv[1]);
722 argv[1] = Invocation.c_str();
723 return func(argc - 1, argv + 1);
724 }
725
Diego Novillod3babdb2015-12-14 20:37:15 +0000726 if (strcmp(argv[1], "-h") == 0 || strcmp(argv[1], "-help") == 0 ||
Justin Bogner618bcea2014-03-19 02:20:46 +0000727 strcmp(argv[1], "--help") == 0) {
728
729 errs() << "OVERVIEW: LLVM profile data tools\n\n"
730 << "USAGE: " << ProgName << " <command> [args...]\n"
731 << "USAGE: " << ProgName << " <command> -help\n\n"
Justin Bogner253eb172016-08-03 23:10:51 +0000732 << "See each individual command --help for more details.\n"
Justin Bogner9af28ef2014-03-21 17:29:44 +0000733 << "Available commands: merge, show\n";
Justin Bogner618bcea2014-03-19 02:20:46 +0000734 return 0;
735 }
736 }
737
738 if (argc < 2)
739 errs() << ProgName << ": No command specified!\n";
740 else
741 errs() << ProgName << ": Unknown command!\n";
742
Justin Bogner9af28ef2014-03-21 17:29:44 +0000743 errs() << "USAGE: " << ProgName << " <merge|show> [args...]\n";
Justin Bogner618bcea2014-03-19 02:20:46 +0000744 return 1;
745}