/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ /* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ /***************************************************************************** * * nsProcess is used to execute new processes and specify if you want to * wait (blocking) or continue (non-blocking). * ***************************************************************************** */ #include "mozilla/ArrayUtils.h" #include "nsCOMPtr.h" #include "nsAutoPtr.h" #include "nsMemory.h" #include "nsProcess.h" #include "prio.h" #include "prenv.h" #include "nsCRT.h" #include "nsThreadUtils.h" #include "nsIObserverService.h" #include "mozilla/Services.h" #include #if defined(PROCESSMODEL_WINAPI) #include "prmem.h" #include "nsString.h" #include "nsLiteralString.h" #include "nsReadableUtils.h" #else #ifdef XP_MACOSX #include #include #include #endif #include #include #endif using namespace mozilla; #ifdef XP_MACOSX cpu_type_t pref_cpu_types[2] = { #if defined(__i386__) CPU_TYPE_X86, #elif defined(__x86_64__) CPU_TYPE_X86_64, #elif defined(__ppc__) CPU_TYPE_POWERPC, #endif CPU_TYPE_ANY }; #endif //-------------------------------------------------------------------// // nsIProcess implementation //-------------------------------------------------------------------// NS_IMPL_ISUPPORTS2(nsProcess, nsIProcess, nsIObserver) //Constructor nsProcess::nsProcess() : mThread(nullptr) , mLock("nsProcess.mLock") , mShutdown(false) , mBlocking(false) , mPid(-1) , mObserver(nullptr) , mWeakObserver(nullptr) , mExitValue(-1) #if !defined(XP_MACOSX) , mProcess(nullptr) #endif { } //Destructor nsProcess::~nsProcess() { } NS_IMETHODIMP nsProcess::Init(nsIFile* executable) { if (mExecutable) return NS_ERROR_ALREADY_INITIALIZED; if (NS_WARN_IF(!executable)) return NS_ERROR_INVALID_ARG; bool isFile; //First make sure the file exists nsresult rv = executable->IsFile(&isFile); if (NS_FAILED(rv)) return rv; if (!isFile) return NS_ERROR_FAILURE; //Store the nsIFile in mExecutable mExecutable = executable; //Get the path because it is needed by the NSPR process creation #ifdef XP_WIN rv = mExecutable->GetTarget(mTargetPath); if (NS_FAILED(rv) || mTargetPath.IsEmpty() ) #endif rv = mExecutable->GetPath(mTargetPath); return rv; } #if defined(XP_WIN) // Out param `wideCmdLine` must be PR_Freed by the caller. static int assembleCmdLine(char *const *argv, wchar_t **wideCmdLine, UINT codePage) { char *const *arg; char *p, *q, *cmdLine; int cmdLineSize; int numBackslashes; int i; int argNeedQuotes; /* * Find out how large the command line buffer should be. */ cmdLineSize = 0; for (arg = argv; *arg; arg++) { /* * \ and " need to be escaped by a \. In the worst case, * every character is a \ or ", so the string of length * may double. If we quote an argument, that needs two ". * Finally, we need a space between arguments, and * a null byte at the end of command line. */ cmdLineSize += 2 * strlen(*arg) /* \ and " need to be escaped */ + 2 /* we quote every argument */ + 1; /* space in between, or final null */ } p = cmdLine = (char *) PR_MALLOC(cmdLineSize*sizeof(char)); if (p == nullptr) { return -1; } for (arg = argv; *arg; arg++) { /* Add a space to separates the arguments */ if (arg != argv) { *p++ = ' '; } q = *arg; numBackslashes = 0; argNeedQuotes = 0; /* If the argument contains white space, it needs to be quoted. */ if (strpbrk(*arg, " \f\n\r\t\v")) { argNeedQuotes = 1; } if (argNeedQuotes) { *p++ = '"'; } while (*q) { if (*q == '\\') { numBackslashes++; q++; } else if (*q == '"') { if (numBackslashes) { /* * Double the backslashes since they are followed * by a quote */ for (i = 0; i < 2 * numBackslashes; i++) { *p++ = '\\'; } numBackslashes = 0; } /* To escape the quote */ *p++ = '\\'; *p++ = *q++; } else { if (numBackslashes) { /* * Backslashes are not followed by a quote, so * don't need to double the backslashes. */ for (i = 0; i < numBackslashes; i++) { *p++ = '\\'; } numBackslashes = 0; } *p++ = *q++; } } /* Now we are at the end of this argument */ if (numBackslashes) { /* * Double the backslashes if we have a quote string * delimiter at the end. */ if (argNeedQuotes) { numBackslashes *= 2; } for (i = 0; i < numBackslashes; i++) { *p++ = '\\'; } } if (argNeedQuotes) { *p++ = '"'; } } *p = '\0'; int32_t numChars = MultiByteToWideChar(codePage, 0, cmdLine, -1, nullptr, 0); *wideCmdLine = (wchar_t *) PR_MALLOC(numChars*sizeof(wchar_t)); MultiByteToWideChar(codePage, 0, cmdLine, -1, *wideCmdLine, numChars); PR_Free(cmdLine); return 0; } #endif void nsProcess::Monitor(void *arg) { nsRefPtr process = dont_AddRef(static_cast(arg)); if (!process->mBlocking) PR_SetCurrentThreadName("RunProcess"); #if defined(PROCESSMODEL_WINAPI) DWORD dwRetVal; unsigned long exitCode = -1; dwRetVal = WaitForSingleObject(process->mProcess, INFINITE); if (dwRetVal != WAIT_FAILED) { if (GetExitCodeProcess(process->mProcess, &exitCode) == FALSE) exitCode = -1; } // Lock in case Kill or GetExitCode are called during this { MutexAutoLock lock(process->mLock); CloseHandle(process->mProcess); process->mProcess = nullptr; process->mExitValue = exitCode; if (process->mShutdown) return; } #else #ifdef XP_MACOSX int exitCode = -1; int status = 0; if (waitpid(process->mPid, &status, 0) == process->mPid) { if (WIFEXITED(status)) { exitCode = WEXITSTATUS(status); } else if(WIFSIGNALED(status)) { exitCode = 256; // match NSPR's signal exit status } } #else int32_t exitCode = -1; if (PR_WaitProcess(process->mProcess, &exitCode) != PR_SUCCESS) exitCode = -1; #endif // Lock in case Kill or GetExitCode are called during this { MutexAutoLock lock(process->mLock); #if !defined(XP_MACOSX) process->mProcess = nullptr; #endif process->mExitValue = exitCode; if (process->mShutdown) return; } #endif // If we ran a background thread for the monitor then notify on the main // thread if (NS_IsMainThread()) { process->ProcessComplete(); } else { nsCOMPtr event = NS_NewRunnableMethod(process, &nsProcess::ProcessComplete); NS_DispatchToMainThread(event); } } void nsProcess::ProcessComplete() { if (mThread) { nsCOMPtr os = mozilla::services::GetObserverService(); if (os) os->RemoveObserver(this, "xpcom-shutdown"); PR_JoinThread(mThread); mThread = nullptr; } const char* topic; if (mExitValue < 0) topic = "process-failed"; else topic = "process-finished"; mPid = -1; nsCOMPtr observer; if (mWeakObserver) observer = do_QueryReferent(mWeakObserver); else if (mObserver) observer = mObserver; mObserver = nullptr; mWeakObserver = nullptr; if (observer) observer->Observe(NS_ISUPPORTS_CAST(nsIProcess*, this), topic, nullptr); } // XXXldb |args| has the wrong const-ness NS_IMETHODIMP nsProcess::Run(bool blocking, const char **args, uint32_t count) { return CopyArgsAndRunProcess(blocking, args, count, nullptr, false); } // XXXldb |args| has the wrong const-ness NS_IMETHODIMP nsProcess::RunAsync(const char **args, uint32_t count, nsIObserver* observer, bool holdWeak) { return CopyArgsAndRunProcess(false, args, count, observer, holdWeak); } nsresult nsProcess::CopyArgsAndRunProcess(bool blocking, const char** args, uint32_t count, nsIObserver* observer, bool holdWeak) { // Add one to the count for the program name and one for null termination. char **my_argv = nullptr; my_argv = (char**)NS_Alloc(sizeof(char*) * (count + 2)); if (!my_argv) { return NS_ERROR_OUT_OF_MEMORY; } my_argv[0] = ToNewUTF8String(mTargetPath); for (uint32_t i = 0; i < count; i++) { my_argv[i + 1] = const_cast(args[i]); } my_argv[count + 1] = nullptr; nsresult rv = RunProcess(blocking, my_argv, observer, holdWeak, false); NS_Free(my_argv[0]); NS_Free(my_argv); return rv; } // XXXldb |args| has the wrong const-ness NS_IMETHODIMP nsProcess::Runw(bool blocking, const char16_t **args, uint32_t count) { return CopyArgsAndRunProcessw(blocking, args, count, nullptr, false); } // XXXldb |args| has the wrong const-ness NS_IMETHODIMP nsProcess::RunwAsync(const char16_t **args, uint32_t count, nsIObserver* observer, bool holdWeak) { return CopyArgsAndRunProcessw(false, args, count, observer, holdWeak); } nsresult nsProcess::CopyArgsAndRunProcessw(bool blocking, const char16_t** args, uint32_t count, nsIObserver* observer, bool holdWeak) { // Add one to the count for the program name and one for null termination. char **my_argv = nullptr; my_argv = (char**)NS_Alloc(sizeof(char*) * (count + 2)); if (!my_argv) { return NS_ERROR_OUT_OF_MEMORY; } my_argv[0] = ToNewUTF8String(mTargetPath); for (uint32_t i = 0; i < count; i++) { my_argv[i + 1] = ToNewUTF8String(nsDependentString(args[i])); } my_argv[count + 1] = nullptr; nsresult rv = RunProcess(blocking, my_argv, observer, holdWeak, true); for (uint32_t i = 0; i <= count; i++) { NS_Free(my_argv[i]); } NS_Free(my_argv); return rv; } nsresult nsProcess::RunProcess(bool blocking, char **my_argv, nsIObserver* observer, bool holdWeak, bool argsUTF8) { if (NS_WARN_IF(!mExecutable)) return NS_ERROR_NOT_INITIALIZED; if (NS_WARN_IF(mThread)) return NS_ERROR_ALREADY_INITIALIZED; if (observer) { if (holdWeak) { mWeakObserver = do_GetWeakReference(observer); if (!mWeakObserver) return NS_NOINTERFACE; } else { mObserver = observer; } } mExitValue = -1; mPid = -1; #if defined(PROCESSMODEL_WINAPI) BOOL retVal; wchar_t *cmdLine = nullptr; // The 'argv' array is null-terminated and always starts with the program path. // If the second slot is non-null then arguments are being passed. if (my_argv[1] != nullptr && assembleCmdLine(my_argv + 1, &cmdLine, argsUTF8 ? CP_UTF8 : CP_ACP) == -1) { return NS_ERROR_FILE_EXECUTION_FAILED; } /* The SEE_MASK_NO_CONSOLE flag is important to prevent console windows * from appearing. This makes behavior the same on all platforms. The flag * will not have any effect on non-console applications. */ // The program name in my_argv[0] is always UTF-8 NS_ConvertUTF8toUTF16 wideFile(my_argv[0]); SHELLEXECUTEINFOW sinfo; memset(&sinfo, 0, sizeof(SHELLEXECUTEINFOW)); sinfo.cbSize = sizeof(SHELLEXECUTEINFOW); sinfo.hwnd = nullptr; sinfo.lpFile = wideFile.get(); sinfo.nShow = SW_SHOWNORMAL; sinfo.fMask = SEE_MASK_FLAG_DDEWAIT | SEE_MASK_NO_CONSOLE | SEE_MASK_NOCLOSEPROCESS; if (cmdLine) sinfo.lpParameters = cmdLine; retVal = ShellExecuteExW(&sinfo); if (!retVal) { return NS_ERROR_FILE_EXECUTION_FAILED; } mProcess = sinfo.hProcess; if (cmdLine) PR_Free(cmdLine); mPid = GetProcessId(mProcess); #elif defined(XP_MACOSX) // Initialize spawn attributes. posix_spawnattr_t spawnattr; if (posix_spawnattr_init(&spawnattr) != 0) { return NS_ERROR_FAILURE; } // Set spawn attributes. size_t attr_count = ArrayLength(pref_cpu_types); size_t attr_ocount = 0; if (posix_spawnattr_setbinpref_np(&spawnattr, attr_count, pref_cpu_types, &attr_ocount) != 0 || attr_ocount != attr_count) { posix_spawnattr_destroy(&spawnattr); return NS_ERROR_FAILURE; } // Note that the 'argv' array is already null-terminated, which 'posix_spawnp' requires. pid_t newPid = 0; int result = posix_spawnp(&newPid, my_argv[0], nullptr, &spawnattr, my_argv, *_NSGetEnviron()); mPid = static_cast(newPid); posix_spawnattr_destroy(&spawnattr); if (result != 0) { return NS_ERROR_FAILURE; } #else mProcess = PR_CreateProcess(my_argv[0], my_argv, nullptr, nullptr); if (!mProcess) return NS_ERROR_FAILURE; struct MYProcess { uint32_t pid; }; MYProcess* ptrProc = (MYProcess *) mProcess; mPid = ptrProc->pid; #endif NS_ADDREF_THIS(); mBlocking = blocking; if (blocking) { Monitor(this); if (mExitValue < 0) return NS_ERROR_FILE_EXECUTION_FAILED; } else { mThread = PR_CreateThread(PR_SYSTEM_THREAD, Monitor, this, PR_PRIORITY_NORMAL, PR_LOCAL_THREAD, PR_JOINABLE_THREAD, 0); if (!mThread) { NS_RELEASE_THIS(); return NS_ERROR_FAILURE; } // It isn't a failure if we just can't watch for shutdown nsCOMPtr os = mozilla::services::GetObserverService(); if (os) os->AddObserver(this, "xpcom-shutdown", false); } return NS_OK; } NS_IMETHODIMP nsProcess::GetIsRunning(bool *aIsRunning) { if (mThread) *aIsRunning = true; else *aIsRunning = false; return NS_OK; } NS_IMETHODIMP nsProcess::GetPid(uint32_t *aPid) { if (!mThread) return NS_ERROR_FAILURE; if (mPid < 0) return NS_ERROR_NOT_IMPLEMENTED; *aPid = mPid; return NS_OK; } NS_IMETHODIMP nsProcess::Kill() { if (!mThread) return NS_ERROR_FAILURE; { MutexAutoLock lock(mLock); #if defined(PROCESSMODEL_WINAPI) if (TerminateProcess(mProcess, 0) == 0) return NS_ERROR_FAILURE; #elif defined(XP_MACOSX) if (kill(mPid, SIGKILL) != 0) return NS_ERROR_FAILURE; #else if (!mProcess || (PR_KillProcess(mProcess) != PR_SUCCESS)) return NS_ERROR_FAILURE; #endif } // We must null out mThread if we want IsRunning to return false immediately // after this call. nsCOMPtr os = mozilla::services::GetObserverService(); if (os) os->RemoveObserver(this, "xpcom-shutdown"); PR_JoinThread(mThread); mThread = nullptr; return NS_OK; } NS_IMETHODIMP nsProcess::GetExitValue(int32_t *aExitValue) { MutexAutoLock lock(mLock); *aExitValue = mExitValue; return NS_OK; } NS_IMETHODIMP nsProcess::Observe(nsISupports* subject, const char* topic, const char16_t* data) { // Shutting down, drop all references if (mThread) { nsCOMPtr os = mozilla::services::GetObserverService(); if (os) os->RemoveObserver(this, "xpcom-shutdown"); mThread = nullptr; } mObserver = nullptr; mWeakObserver = nullptr; MutexAutoLock lock(mLock); mShutdown = true; return NS_OK; }