[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [PATCH] Document CodeQL build requirements


  • To: win-pv-devel@xxxxxxxxxxxxxxxxxxxx
  • From: Paul Durrant <xadimgnik@xxxxxxxxx>
  • Date: Tue, 7 Sep 2021 09:23:47 +0100
  • Delivery-date: Tue, 07 Sep 2021 08:23:53 +0000
  • List-id: Developer list for the Windows PV Drivers subproject <win-pv-devel.lists.xenproject.org>

On 07/09/2021 09:10, Owen Smith wrote:
CodeQL requires an additional tool and rule set which are seperate from the
EWDK ISOs, and require manual installation and configuration

Signed-off-by: Owen Smith <owen.smith@xxxxxxxxxx>

Thanks.

Acked-by: Paul Durrant <paul@xxxxxxx>

I'll apply this to all drivers.

---
  BUILD.md | 12 ++++++++++++
  1 file changed, 12 insertions(+)

diff --git a/BUILD.md b/BUILD.md
index 574ff98..aeca39e 100644
--- a/BUILD.md
+++ b/BUILD.md
@@ -7,6 +7,7 @@ ISO containing all the build environment you need.
The package should support building with the following EWDKs: +- EWDK for Server 2022, version 22000 with Visual Studio Build Tools 16.9
  - EWDK for Windows 10, version 1903 with Visual Studio Build Tools 16.0
  - EWDK for Windows 10, version 1809 with Visual Studio Build Tools 15.8.9
@@ -29,3 +30,14 @@ by default. However, if you set the environment variable DPINST_REDIST to
  point to a directory with x86 and x64 sub-directories containing 32- and
  64-bit dpinst.exe binaries (respectively) then these will be copied into
  the built packages, making installation more convenient.
+
+NOTE: In order to use the '-CodeQL' parameter to generate *.sarif log files,
+an additional tool and set of rules will need installing. The CodeQL engine
+can be downloaded from https://github.com/github/codeql-cli-binaries/releases
+and the driver specific rules can be cloned from
+https://github.com/microsoft/Windows-Driver-Developer-Supplemental-Tools.
+Once acquired, the rules need to be in a sibling folder of the engine (e.g.
+C:\Tools\CodeQL and C:\Tools\Windows-Driver-Developer-Supplemental-Tools) and
+the CodeQL engine (e.g. C:\Tools\CodeQL) must be added to the PATH environment
+variable. Further information available at
+https://docs.microsoft.com/en-us/windows-hardware/drivers/devtest/static-tools-and-codeql





 


Rackspace

Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.