From 602d1484231f4de17213506be6f3740479b7259a Mon Sep 17 00:00:00 2001 From: isaak654 Date: Wed, 7 Apr 2021 17:33:18 +0200 Subject: [PATCH 1/2] Fix typos in Sbie build readme --- Sandboxie/ReadMe.txt | 41 +++++++++++++++++++---------------------- 1 file changed, 19 insertions(+), 22 deletions(-) diff --git a/Sandboxie/ReadMe.txt b/Sandboxie/ReadMe.txt index 7a5af15c..8a99bbda 100644 --- a/Sandboxie/ReadMe.txt +++ b/Sandboxie/ReadMe.txt @@ -8,47 +8,44 @@ Please note: there is another ReadMe.txt in the \install\ folder that explains h https://go.microsoft.com/fwlink/?linkid=2128854 3) The VS Solution File, Sandbox.sln, is in the source code root. Open this SLN in Visual Studio. -Source Projects (in aplhabetical order) +Source Projects (in alphabetical order) Note: the core of Sandboxie are the driver, SbieDrv, the service, SbieSvc, and the injection DLL, SbieDll. Study these projects first. -Common (\apps\common). This builds common.lib which is used by the Control and Start projects. It contains some common GUI objects. +Common (\apps\common). It builds common.lib, which contains some common GUI objects, and it is used by the Control and Start projects. -KmdUtil (\install\kmdutil). Builds KmdUtil.exe which is used during the installtion process. E.g. to start/stop the Sbie driver (SbieDrv.sys). +KmdUtil (\install\kmdutil). It builds KmdUtil.exe, which is used during the installation process, e.g. to start/stop the Sbie driver (SbieDrv.sys). -LowLevel (\core\low). Creates LowLevel.dll which is used in code injection. LowLevel.dll is embeded into SbieSvc.exe as a resource (see core\svc\lowlevel.rc for more information). +LowLevel (\core\low). It creates LowLevel.dll, which is used in code injection. LowLevel.dll is embedded into SbieSvc.exe as a resource (see core\svc\lowlevel.rc for more information). -Parse (\msgs). Creates the Sbie messages files. +Parse (\msgs). It creates the Sbie messages files. -SandboxBITS (apps\com\BITS). Creates SandboxieBITS.exe (Background Intelligent Transfer Service) +SandboxBITS (apps\com\BITS). It creates SandboxieBITS.exe (Background Intelligent Transfer Service). -SandboxCrypto (apps\com\Crypto) Creates SandboxieCrypto.exe +SandboxCrypto (apps\com\Crypto). It creates SandboxieCrypto.exe. -SandboxieInstall (\install\release). Creates the combined x64/x86 installer SandboxieInstall.exe by combining the x64 & x86 installer binaries into a RC file. +SandboxieInstall (\install\release). It creates the combined x64/x86 installer SandboxieInstall.exe by combining the x64 & x86 installer binaries into a RC file. NOTE: SandboxieInstall is not built during the normal SLN build. It must be built manually after the x64 & x86 installers are completed. -SandboxRpcSs (\apps\com\RpcSs) Creates SandboxieRpcSs.exe. Sbie's wrapper for the Remote Procedure Call Sub-System). +SandboxRpcSs (\apps\com\RpcSs). It creates SandboxieRpcSs.exe, the Sbie's wrapper for the Remote Procedure Call Sub-System. -SandboxWUAU (\apps\com\WUAU) Creates SandboxieWUAU.exe. Sbie's wrapper for the Windows Automatic Update Service (WUAUSERV). +SandboxWUAU (\apps\com\WUAU). It creates SandboxieWUAU.exe, the Sbie's wrapper for the Windows Automatic Update Service (WUAUSERV). -SbieControl (\apps\control). Builds SbieCtrl.exe. This is the Sandboxie Control app that displays real-time sandboxed application activity. +SbieControl (\apps\control). It builds SbieCtrl.exe, the Sandboxie Control app that displays real-time sandboxed application activity. -SbieIni (\apps\ini). Creates SbieIni.exe. A utility for querying and updating the sandboxie.ini configuration file. +SbieIni (\apps\ini). It creates SbieIni.exe, a utility for querying and updating the sandboxie.ini configuration file. -SboxDcomLaunch (\apps\com\DcomLaunch). Creates SandboxieDcomLaunch.exe. +SboxDcomLaunch (\apps\com\DcomLaunch). It creates SandboxieDcomLaunch.exe. -SboxDll (\core\dll). Creates the Sbie injection DLL. This DLL injects into every process running in the sandbox. +SboxDll (\core\dll). It creates the Sbie injection DLL, which injects into every process running in the sandbox. -SboxDrv (\core\drv). Creates the Sbie kernel-mode driver. +SboxDrv (\core\drv). It creates the Sbie kernel-mode driver. -SboxHostDll (\SboxHostDll). Builds the Sbie host injection DLL. This DLL is injected into host processes that must be redirected into the sandbox. +SboxHostDll (\SboxHostDll). It builds the Sbie host injection DLL, which is injected into host processes that must be redirected into the sandbox. Currently, the only app this is used for is MS Office. SboxHostDll.dll is injected into OfficeClickToRun.exe. -SboxMsg (\msgs). Creates SboxMsg.dll which contains the Sbie user messages in various languages. - -SboxSvc (\core\svc). Creates the Sbie service. - -Start (\apps\start). Creates start.exe which is used to start processes in the sandbox. - +SboxMsg (\msgs). It creates SboxMsg.dll, which contains the Sbie user messages in various languages. +SboxSvc (\core\svc). It creates the Sbie service. +Start (\apps\start). It creates start.exe, which is used to start processes in the sandbox. From ec579f610f2e5b80a9732f254a9535c78d965dfb Mon Sep 17 00:00:00 2001 From: isaak654 Date: Wed, 7 Apr 2021 18:43:30 +0200 Subject: [PATCH 2/2] Change file type to markdown --- Sandboxie/ReadMe.md | 50 +++++++++++++++++++++++++++++++++++++++++++ Sandboxie/ReadMe.txt | 51 -------------------------------------------- 2 files changed, 50 insertions(+), 51 deletions(-) create mode 100644 Sandboxie/ReadMe.md delete mode 100644 Sandboxie/ReadMe.txt diff --git a/Sandboxie/ReadMe.md b/Sandboxie/ReadMe.md new file mode 100644 index 00000000..658ae044 --- /dev/null +++ b/Sandboxie/ReadMe.md @@ -0,0 +1,50 @@ +### Sandboxie Build Instructions + +Please note: there is another ReadMe file in the \install\ folder that explains how to create the Sandboxie installers. + +1) Sandboxie builds under MS Visual Studio 2019. +2) Install the Windows Driver Kit (WDK) for Windows 10, version 2004: + https://go.microsoft.com/fwlink/?linkid=2128854 +3) The VS Solution File, Sandbox.sln, is in the source code root. Open this SLN in Visual Studio. + +### Source Projects (in alphabetical order) + +Note: the core of Sandboxie are the driver, SbieDrv, the service, SbieSvc, and the injection DLL, SbieDll. Study these projects first. + +`Common (\apps\common)`. It builds common.lib, which contains some common GUI objects, and it is used by the Control and Start projects. + +`KmdUtil (\install\kmdutil)`. It builds KmdUtil.exe, which is used during the installation process, e.g. to start/stop the Sbie driver (SbieDrv.sys). + +`LowLevel (\core\low)`. It creates LowLevel.dll, which is used in code injection. LowLevel.dll is embedded into SbieSvc.exe as a resource (see core\svc\lowlevel.rc for more information). + +`Parse (\msgs)`. It creates the Sbie messages files. + +`SandboxBITS (apps\com\BITS)`. It creates SandboxieBITS.exe (Background Intelligent Transfer Service). + +`SandboxCrypto (apps\com\Crypto)`. It creates SandboxieCrypto.exe. + +`SandboxieInstall (\install\release)`. It creates the combined x64/x86 installer SandboxieInstall.exe by combining the x64 & x86 installer binaries into a RC file. +- Please note: SandboxieInstall is not built during the normal SLN build. It must be built manually after the x64 & x86 installers are completed. + +`SandboxRpcSs (\apps\com\RpcSs)`. It creates SandboxieRpcSs.exe, the Sbie's wrapper for the Remote Procedure Call Sub-System. + +`SandboxWUAU (\apps\com\WUAU)`. It creates SandboxieWUAU.exe, the Sbie's wrapper for the Windows Automatic Update Service (WUAUSERV). + +`SbieControl (\apps\control)`. It builds SbieCtrl.exe, the Sandboxie Control app that displays real-time sandboxed application activity. + +`SbieIni (\apps\ini)`. It creates SbieIni.exe, a utility for querying and updating the sandboxie.ini configuration file. + +`SboxDcomLaunch (\apps\com\DcomLaunch)`. It creates SandboxieDcomLaunch.exe. + +`SboxDll (\core\dll)`. It creates the Sbie injection DLL, which injects into every process running in the sandbox. + +`SboxDrv (\core\drv)`. It creates the Sbie kernel-mode driver. + +`SboxHostDll (\SboxHostDll)`. It builds the Sbie host injection DLL, which is injected into host processes that must be redirected into the sandbox. +Currently, the only app this is used for is MS Office. SboxHostDll.dll is injected into OfficeClickToRun.exe. + +`SboxMsg (\msgs)`. It creates SboxMsg.dll, which contains the Sbie user messages in various languages. + +`SboxSvc (\core\svc)`. It creates the Sbie service. + +`Start (\apps\start)`. It creates start.exe, which is used to start processes in the sandbox. diff --git a/Sandboxie/ReadMe.txt b/Sandboxie/ReadMe.txt deleted file mode 100644 index 8a99bbda..00000000 --- a/Sandboxie/ReadMe.txt +++ /dev/null @@ -1,51 +0,0 @@ - -SANDBOXIE BUILD INSTRUCTIONS - -Please note: there is another ReadMe.txt in the \install\ folder that explains how to create the Sandboxie installers. - -1) Sandboxie builds under MS Visual Studio 2019. -2) Install the Windows Driver Kit (WDK) for Windows 10, version 2004. - https://go.microsoft.com/fwlink/?linkid=2128854 -3) The VS Solution File, Sandbox.sln, is in the source code root. Open this SLN in Visual Studio. - -Source Projects (in alphabetical order) - -Note: the core of Sandboxie are the driver, SbieDrv, the service, SbieSvc, and the injection DLL, SbieDll. Study these projects first. - -Common (\apps\common). It builds common.lib, which contains some common GUI objects, and it is used by the Control and Start projects. - -KmdUtil (\install\kmdutil). It builds KmdUtil.exe, which is used during the installation process, e.g. to start/stop the Sbie driver (SbieDrv.sys). - -LowLevel (\core\low). It creates LowLevel.dll, which is used in code injection. LowLevel.dll is embedded into SbieSvc.exe as a resource (see core\svc\lowlevel.rc for more information). - -Parse (\msgs). It creates the Sbie messages files. - -SandboxBITS (apps\com\BITS). It creates SandboxieBITS.exe (Background Intelligent Transfer Service). - -SandboxCrypto (apps\com\Crypto). It creates SandboxieCrypto.exe. - -SandboxieInstall (\install\release). It creates the combined x64/x86 installer SandboxieInstall.exe by combining the x64 & x86 installer binaries into a RC file. - NOTE: SandboxieInstall is not built during the normal SLN build. It must be built manually after the x64 & x86 installers are completed. - -SandboxRpcSs (\apps\com\RpcSs). It creates SandboxieRpcSs.exe, the Sbie's wrapper for the Remote Procedure Call Sub-System. - -SandboxWUAU (\apps\com\WUAU). It creates SandboxieWUAU.exe, the Sbie's wrapper for the Windows Automatic Update Service (WUAUSERV). - -SbieControl (\apps\control). It builds SbieCtrl.exe, the Sandboxie Control app that displays real-time sandboxed application activity. - -SbieIni (\apps\ini). It creates SbieIni.exe, a utility for querying and updating the sandboxie.ini configuration file. - -SboxDcomLaunch (\apps\com\DcomLaunch). It creates SandboxieDcomLaunch.exe. - -SboxDll (\core\dll). It creates the Sbie injection DLL, which injects into every process running in the sandbox. - -SboxDrv (\core\drv). It creates the Sbie kernel-mode driver. - -SboxHostDll (\SboxHostDll). It builds the Sbie host injection DLL, which is injected into host processes that must be redirected into the sandbox. - Currently, the only app this is used for is MS Office. SboxHostDll.dll is injected into OfficeClickToRun.exe. - -SboxMsg (\msgs). It creates SboxMsg.dll, which contains the Sbie user messages in various languages. - -SboxSvc (\core\svc). It creates the Sbie service. - -Start (\apps\start). It creates start.exe, which is used to start processes in the sandbox.