• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 //===- subzero/src/IceBrowserCompileServer.cpp - Browser compile server ---===//
2 //
3 //                        The Subzero Code Generator
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 ///
10 /// \file
11 /// \brief Defines the browser-based compile server.
12 ///
13 //===----------------------------------------------------------------------===//
14 
15 // Can only compile this with the NaCl compiler (needs irt.h, and the
16 // unsandboxed LLVM build using the trusted compiler does not have irt.h).
17 #include "IceBrowserCompileServer.h"
18 #include "IceRangeSpec.h"
19 
20 #if PNACL_BROWSER_TRANSLATOR
21 
22 // Headers which are not properly part of the SDK are included by their path in
23 // the NaCl tree.
24 #ifdef __pnacl__
25 #include "native_client/src/untrusted/nacl/pnacl.h"
26 #endif // __pnacl__
27 
28 #include "llvm/Support/QueueStreamer.h"
29 
30 #include <cstring>
31 #include <fstream>
32 #include <irt.h>
33 #include <irt_dev.h>
34 #include <pthread.h>
35 #include <thread>
36 
37 namespace Ice {
38 
39 // Create C wrappers around callback handlers for the IRT interface.
40 namespace {
41 
42 BrowserCompileServer *gCompileServer;
43 struct nacl_irt_private_pnacl_translator_compile gIRTFuncs;
44 
getIRTInterfaces()45 void getIRTInterfaces() {
46   size_t QueryResult =
47       nacl_interface_query(NACL_IRT_PRIVATE_PNACL_TRANSLATOR_COMPILE_v0_1,
48                            &gIRTFuncs, sizeof(gIRTFuncs));
49   if (QueryResult != sizeof(gIRTFuncs))
50     llvm::report_fatal_error("Failed to get translator compile IRT interface");
51 }
52 
53 // Allow pnacl-sz arguments to be supplied externally, instead of coming from
54 // the browser.  This is meant to be used for debugging.
55 //
56 // NOTE: This functionality is only enabled in non-MINIMAL Subzero builds, for
57 // security/safety reasons.
58 //
59 // If the SZARGFILE environment variable is set to a file name, arguments are
60 // read from that file, one argument per line.  This requires setting 3
61 // environment variables before starting the browser:
62 //
63 // NACL_ENV_PASSTHROUGH=NACL_DANGEROUS_ENABLE_FILE_ACCESS,NACLENV_SZARGFILE
64 // NACL_DANGEROUS_ENABLE_FILE_ACCESS=1
65 // NACLENV_SZARGFILE=/path/to/myargs.txt
66 //
67 // In addition, Chrome needs to be launched with the "--no-sandbox" argument.
68 //
69 // If the SZARGLIST environment variable is set, arguments are extracted from
70 // that variable's value, separated by the '|' character (being careful to
71 // escape/quote special shell characters).  This requires setting 2 environment
72 // variables before starting the browser:
73 //
74 // NACL_ENV_PASSTHROUGH=NACLENV_SZARGLIST
75 // NACLENV_SZARGLIST=arg
76 //
77 // This does not require the "--no-sandbox" argument, and is therefore much
78 // safer, but does require restarting the browser to change the arguments.
79 //
80 // If external arguments are supplied, the browser's NumThreads specification is
81 // ignored, to allow -threads to be specified as an external argument.  Note
82 // that the browser normally supplies the "-O2" argument, so externally supplied
83 // arguments might want to provide an explicit -O argument.
84 //
85 // See Chrome's src/components/nacl/zygote/nacl_fork_delegate_linux.cc for the
86 // NACL_ENV_PASSTHROUGH mechanism.
87 //
88 // See NaCl's src/trusted/service_runtime/env_cleanser.c for the NACLENV_
89 // mechanism.
getExternalArgs()90 std::vector<std::string> getExternalArgs() {
91   std::vector<std::string> ExternalArgs;
92   if (BuildDefs::minimal())
93     return ExternalArgs;
94   char ArgsFileVar[] = "SZARGFILE";
95   char ArgsListVar[] = "SZARGLIST";
96   if (const char *ArgsFilename = getenv(ArgsFileVar)) {
97     std::ifstream ArgsStream(ArgsFilename);
98     std::string Arg;
99     while (ArgsStream >> std::ws, std::getline(ArgsStream, Arg)) {
100       if (!Arg.empty() && Arg[0] == '#')
101         continue;
102       ExternalArgs.emplace_back(Arg);
103     }
104     if (ExternalArgs.empty()) {
105       llvm::report_fatal_error("Failed to read arguments from file '" +
106                                std::string(ArgsFilename) + "'");
107     }
108   } else if (const char *ArgsList = getenv(ArgsListVar)) {
109     // Leverage the RangeSpec tokenizer.
110     auto Args = RangeSpec::tokenize(ArgsList, '|');
111     ExternalArgs.insert(ExternalArgs.end(), Args.begin(), Args.end());
112   }
113   return ExternalArgs;
114 }
115 
onInitCallback(uint32_t NumThreads,int * ObjFileFDs,size_t ObjFileFDCount,char ** CLArgs,size_t CLArgsLen)116 char *onInitCallback(uint32_t NumThreads, int *ObjFileFDs,
117                      size_t ObjFileFDCount, char **CLArgs, size_t CLArgsLen) {
118   if (ObjFileFDCount < 1) {
119     std::string Buffer;
120     llvm::raw_string_ostream StrBuf(Buffer);
121     StrBuf << "Invalid number of FDs for onInitCallback " << ObjFileFDCount
122            << "\n";
123     return strdup(StrBuf.str().c_str());
124   }
125   int ObjFileFD = ObjFileFDs[0];
126   if (ObjFileFD < 0) {
127     std::string Buffer;
128     llvm::raw_string_ostream StrBuf(Buffer);
129     StrBuf << "Invalid FD given for onInitCallback " << ObjFileFD << "\n";
130     return strdup(StrBuf.str().c_str());
131   }
132   // CLArgs is almost an "argv", but is missing the argv[0] program name.
133   std::vector<const char *> Argv;
134   constexpr static char ProgramName[] = "pnacl-sz.nexe";
135   Argv.reserve(CLArgsLen + 1);
136   Argv.push_back(ProgramName);
137 
138   bool UseNumThreadsFromBrowser = true;
139   auto ExternalArgs = getExternalArgs();
140   if (ExternalArgs.empty()) {
141     for (size_t i = 0; i < CLArgsLen; ++i) {
142       Argv.push_back(CLArgs[i]);
143     }
144   } else {
145     for (auto &Arg : ExternalArgs) {
146       Argv.emplace_back(Arg.c_str());
147     }
148     UseNumThreadsFromBrowser = false;
149   }
150   // NOTE: strings pointed to by argv are owned by the caller, but we parse
151   // here before returning and don't store them.
152   gCompileServer->getParsedFlags(UseNumThreadsFromBrowser, NumThreads,
153                                  Argv.size(), Argv.data());
154   gCompileServer->startCompileThread(ObjFileFD);
155   return nullptr;
156 }
157 
onDataCallback(const void * Data,size_t NumBytes)158 int onDataCallback(const void *Data, size_t NumBytes) {
159   return gCompileServer->pushInputBytes(Data, NumBytes) ? 1 : 0;
160 }
161 
onEndCallback()162 char *onEndCallback() {
163   gCompileServer->endInputStream();
164   gCompileServer->waitForCompileThread();
165   // TODO(jvoung): Also return UMA data.
166   if (gCompileServer->getErrorCode().value()) {
167     const std::string Error = gCompileServer->getErrorStream().getContents();
168     return strdup(Error.empty() ? "Some error occurred" : Error.c_str());
169   }
170   return nullptr;
171 }
172 
173 struct nacl_irt_pnacl_compile_funcs SubzeroCallbacks {
174   &onInitCallback, &onDataCallback, &onEndCallback
175 };
176 
getOutputStream(int FD)177 std::unique_ptr<llvm::raw_fd_ostream> getOutputStream(int FD) {
178   if (FD <= 0)
179     llvm::report_fatal_error("Invalid output FD");
180   constexpr bool CloseOnDtor = true;
181   constexpr bool Unbuffered = false;
182   return std::unique_ptr<llvm::raw_fd_ostream>(
183       new llvm::raw_fd_ostream(FD, CloseOnDtor, Unbuffered));
184 }
185 
fatalErrorHandler(void * UserData,const std::string & Reason,bool GenCrashDialog)186 void fatalErrorHandler(void *UserData, const std::string &Reason,
187                        bool GenCrashDialog) {
188   (void)GenCrashDialog;
189   BrowserCompileServer *Server =
190       reinterpret_cast<BrowserCompileServer *>(UserData);
191   Server->setFatalError(Reason);
192   // Only kill the current thread instead of the whole process. We need the
193   // server thread to remain alive in order to respond with the error message.
194   // We could also try to pthread_kill all other worker threads, but
195   // pthread_kill / raising signals is not supported by NaCl. We'll have to
196   // assume that the worker/emitter threads will be well behaved after a fatal
197   // error in other threads, and either get stuck waiting on input from a
198   // previous stage, or also call report_fatal_error.
199   pthread_exit(0);
200 }
201 
202 /// Adapted from pnacl-llc's AddDefaultCPU() in srpc_main.cpp.
getTargetArch()203 TargetArch getTargetArch() {
204 #if defined(__pnacl__)
205   switch (__builtin_nacl_target_arch()) {
206   case PnaclTargetArchitectureX86_32:
207   case PnaclTargetArchitectureX86_32_NonSFI:
208     return Target_X8632;
209   case PnaclTargetArchitectureX86_64:
210     return Target_X8664;
211   case PnaclTargetArchitectureARM_32:
212   case PnaclTargetArchitectureARM_32_NonSFI:
213     return Target_ARM32;
214   case PnaclTargetArchitectureMips_32:
215     return Target_MIPS32;
216   default:
217     llvm::report_fatal_error("no target architecture match.");
218   }
219 #elif defined(__i386__)
220   return Target_X8632;
221 #elif defined(__x86_64__)
222   return Target_X8664;
223 #elif defined(__arm__)
224   return Target_ARM32;
225 #else
226 // TODO(stichnot): Add mips.
227 #error "Unknown architecture"
228 #endif
229 }
230 
231 } // end of anonymous namespace
232 
233 BrowserCompileServer::~BrowserCompileServer() = default;
234 
run()235 void BrowserCompileServer::run() {
236   gCompileServer = this;
237   getIRTInterfaces();
238   gIRTFuncs.serve_translate_request(&SubzeroCallbacks);
239 }
240 
getParsedFlags(bool UseNumThreadsFromBrowser,uint32_t NumThreads,int argc,const char * const * argv)241 void BrowserCompileServer::getParsedFlags(bool UseNumThreadsFromBrowser,
242                                           uint32_t NumThreads, int argc,
243                                           const char *const *argv) {
244   ClFlags::parseFlags(argc, argv);
245   ClFlags::getParsedClFlags(ClFlags::Flags);
246   // Set some defaults which aren't specified via the argv string.
247   if (UseNumThreadsFromBrowser)
248     ClFlags::Flags.setNumTranslationThreads(NumThreads);
249   ClFlags::Flags.setUseSandboxing(true);
250   ClFlags::Flags.setOutFileType(FT_Elf);
251   ClFlags::Flags.setTargetArch(getTargetArch());
252   ClFlags::Flags.setInputFileFormat(llvm::PNaClFormat);
253 }
254 
pushInputBytes(const void * Data,size_t NumBytes)255 bool BrowserCompileServer::pushInputBytes(const void *Data, size_t NumBytes) {
256   // If there was an earlier error, do not attempt to push bytes to the
257   // QueueStreamer. Otherwise the thread could become blocked.
258   if (HadError.load())
259     return true;
260   return InputStream->PutBytes(
261              const_cast<unsigned char *>(
262                  reinterpret_cast<const unsigned char *>(Data)),
263              NumBytes) != NumBytes;
264 }
265 
setFatalError(const std::string & Reason)266 void BrowserCompileServer::setFatalError(const std::string &Reason) {
267   HadError.store(true);
268   Ctx->getStrError() << Reason;
269   // Make sure that the QueueStreamer is not stuck by signaling an early end.
270   InputStream->SetDone();
271 }
272 
getErrorCode()273 ErrorCode &BrowserCompileServer::getErrorCode() {
274   if (HadError.load()) {
275     // HadError means report_fatal_error is called. Make sure that the
276     // LastError is not EC_None. We don't know the type of error so just pick
277     // some error category.
278     LastError.assign(EC_Translation);
279   }
280   return LastError;
281 }
282 
endInputStream()283 void BrowserCompileServer::endInputStream() { InputStream->SetDone(); }
284 
startCompileThread(int ObjFD)285 void BrowserCompileServer::startCompileThread(int ObjFD) {
286   InputStream = new llvm::QueueStreamer();
287   bool LogStreamFailure = false;
288   int LogFD = STDOUT_FILENO;
289   if (getFlags().getLogFilename() == "-") {
290     // Common case, do nothing.
291   } else if (getFlags().getLogFilename() == "/dev/stderr") {
292     LogFD = STDERR_FILENO;
293   } else {
294     LogStreamFailure = true;
295   }
296   LogStream = getOutputStream(LogFD);
297   LogStream->SetUnbuffered();
298   if (LogStreamFailure) {
299     *LogStream
300         << "Warning: Log file name must be either '-' or '/dev/stderr'\n";
301   }
302   EmitStream = getOutputStream(ObjFD);
303   EmitStream->SetBufferSize(1 << 14);
304   std::unique_ptr<StringStream> ErrStrm(new StringStream());
305   ErrorStream = std::move(ErrStrm);
306   ELFStream.reset(new ELFFileStreamer(*EmitStream.get()));
307   Ctx.reset(new GlobalContext(LogStream.get(), EmitStream.get(),
308                               &ErrorStream->getStream(), ELFStream.get()));
309   CompileThread = std::thread([this]() {
310     llvm::install_fatal_error_handler(fatalErrorHandler, this);
311     Ctx->initParserThread();
312     this->getCompiler().run(ClFlags::Flags, *Ctx.get(),
313                             // Retain original reference, but the compiler
314                             // (LLVM's MemoryObject) wants to handle deletion.
315                             std::unique_ptr<llvm::DataStreamer>(InputStream));
316   });
317 }
318 
319 } // end of namespace Ice
320 
321 #else // !PNACL_BROWSER_TRANSLATOR
322 
323 #include "llvm/Support/ErrorHandling.h"
324 
325 namespace Ice {
326 
~BrowserCompileServer()327 BrowserCompileServer::~BrowserCompileServer() {}
328 
run()329 void BrowserCompileServer::run() {
330   llvm::report_fatal_error("no browser hookups");
331 }
332 
getErrorCode()333 ErrorCode &BrowserCompileServer::getErrorCode() {
334   llvm::report_fatal_error("no browser hookups");
335 }
336 
337 } // end of namespace Ice
338 
339 #endif // PNACL_BROWSER_TRANSLATOR
340