Merge pull request #760 from isaak654/patch-8

[Sbie build readme] Fix typos and change it to markdown
This commit is contained in:
DavidXanatos 2021-06-02 18:50:40 +02:00 committed by GitHub
commit e58906719a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 50 additions and 54 deletions

50
Sandboxie/ReadMe.md Normal file
View File

@ -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.

View File

@ -1,54 +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 aplhabetical 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.
KmdUtil (\install\kmdutil). Builds KmdUtil.exe which is used during the installtion 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).
Parse (\msgs). Creates the Sbie messages files.
SandboxBITS (apps\com\BITS). Creates SandboxieBITS.exe (Background Intelligent Transfer Service)
SandboxCrypto (apps\com\Crypto) 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.
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).
SandboxWUAU (\apps\com\WUAU) Creates SandboxieWUAU.exe. 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.
SbieIni (\apps\ini). Creates SbieIni.exe. A utility for querying and updating the sandboxie.ini configuration file.
SboxDcomLaunch (\apps\com\DcomLaunch). Creates SandboxieDcomLaunch.exe.
SboxDll (\core\dll). Creates the Sbie injection DLL. This DLL injects into every process running in the sandbox.
SboxDrv (\core\drv). 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.
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.