llprocesslauncher.h
上传用户:king477883
上传日期:2021-03-01
资源大小:9553k
文件大小:3k
源码类别:

游戏引擎

开发平台:

C++ Builder

  1. /** 
  2.  * @file llprocesslauncher.h
  3.  * @brief Utility class for launching, terminating, and tracking the state of processes.
  4.  *
  5.  * $LicenseInfo:firstyear=2008&license=viewergpl$
  6.  * 
  7.  * Copyright (c) 2008-2010, Linden Research, Inc.
  8.  * 
  9.  * Second Life Viewer Source Code
  10.  * The source code in this file ("Source Code") is provided by Linden Lab
  11.  * to you under the terms of the GNU General Public License, version 2.0
  12.  * ("GPL"), unless you have obtained a separate licensing agreement
  13.  * ("Other License"), formally executed by you and Linden Lab.  Terms of
  14.  * the GPL can be found in doc/GPL-license.txt in this distribution, or
  15.  * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
  16.  * 
  17.  * There are special exceptions to the terms and conditions of the GPL as
  18.  * it is applied to this Source Code. View the full text of the exception
  19.  * in the file doc/FLOSS-exception.txt in this software distribution, or
  20.  * online at
  21.  * http://secondlifegrid.net/programs/open_source/licensing/flossexception
  22.  * 
  23.  * By copying, modifying or distributing this software, you acknowledge
  24.  * that you have read and understood your obligations described above,
  25.  * and agree to abide by those obligations.
  26.  * 
  27.  * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
  28.  * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
  29.  * COMPLETENESS OR PERFORMANCE.
  30.  * $/LicenseInfo$
  31.  */
  32.  
  33. #ifndef LL_LLPROCESSLAUNCHER_H
  34. #define LL_LLPROCESSLAUNCHER_H
  35. #if LL_WINDOWS
  36. #include <windows.h>
  37. #endif
  38. /*
  39. LLProcessLauncher handles launching external processes with specified command line arguments.
  40. It also keeps track of whether the process is still running, and can kill it if required.
  41. */
  42. class LL_COMMON_API LLProcessLauncher
  43. {
  44. LOG_CLASS(LLProcessLauncher);
  45. public:
  46. LLProcessLauncher();
  47. virtual ~LLProcessLauncher();
  48. void setExecutable(const std::string &executable);
  49. void setWorkingDirectory(const std::string &dir);
  50. void clearArguments();
  51. void addArgument(const std::string &arg);
  52. void addArgument(const char *arg);
  53. int launch(void);
  54. bool isRunning(void);
  55. // Attempt to kill the process -- returns true if the process is no longer running when it returns.
  56. // Note that even if this returns false, the process may exit some time after it's called.
  57. bool kill(void);
  58. // Use this if you want the external process to continue execution after the LLProcessLauncher instance controlling it is deleted.
  59. // Normally, the destructor will attempt to kill the process and wait for termination.
  60. // This should only be used if the viewer is about to exit -- otherwise, the child process will become a zombie after it exits.
  61. void orphan(void);
  62. // This needs to be called periodically on Mac/Linux to clean up zombie processes.
  63. static void reap(void);
  64. // Accessors for platform-specific process ID
  65. #if LL_WINDOWS
  66. HANDLE getProcessHandle() { return mProcessHandle; };
  67. #else
  68. pid_t getProcessID() { return mProcessID; };
  69. #endif
  70. private:
  71. std::string mExecutable;
  72. std::string mWorkingDir;
  73. std::vector<std::string> mLaunchArguments;
  74. #if LL_WINDOWS
  75. HANDLE mProcessHandle;
  76. #else
  77. pid_t mProcessID;
  78. #endif
  79. };
  80. #endif // LL_LLPROCESSLAUNCHER_H