README.htm: Overview of Static Driver Verifier Research Platform

Static Driver Verifier (SDV) is a compile-time static verification tool, included in the Windows Driver Kit (WDK). The SDV Research Platform (SDVRP) is an extension to SDV that allows you to adapt SDV to:

• Support additional frameworks (or APIs) and write custom SLIC rules for this framework.
• Experiment with the model checking step.

• Getting Started
• Documentation
• Installation Instructions

Notice: Links in this file are relative and will only work after installation of SDVRP, when this file is opened from the Start -> All Programs -> Microsoft Static Driver Verifier folder .

Getting Started

• Obtain and install WDK and SDVRP (See section Installation Instructions beneath).
• Understand SDV: See staticdv.chm, in particular sections "Static Driver Verifier Concepts" and the "Static Driver Verifier for WDM Drivers: WHDC Lab" article on the WHDC SDV web site http://www.microsoft.com/whdc/devtools/tools/sdv.mspx .
• Try the SDVRP Custom Framework. See SDVRP.docx’s "Walk Through: fail_driver1".
• Read the rest of SDVRP.docx and SLIC.docx and start experimenting on your own!

Documentation

After installation the following documents are available in the Start -> All Programs -> Microsoft Static Driver Verifier folder:

• README.htm: This file.
• SDVRP.docx: SDVRP Documentation.  This is the primary document supporting SDVRP development; however it does not cover the details of the SLIC language, or the basic operation of SDV.  These topics are covered by SLIC.docx and staticdv.chm (see beneath).
• SLIC.docx: SLIC Documentation.  Syntax and semantics of SLIC, the rule specification language of SDV.
• bebop.docx: Bebop Documentation.  Syntax and semantics of Boolean Programs, the internal language used for the model checking step in SDV. Instructions on how to run on the Bebeop Boolean Program Test Suite
• staticdv.chm: SDV Documentation.  This is the documentation provided with the regular version of Static Driver Verifier.  It does not cover the SDVRP extensions.  This document is also included in the Windows Driver Kit Documentation.
• License.rtf: License Agreement.  This license is also presented during download and installation.

Installation Instructions

• Install the WDK.
  • What: The SDVRP requires that the (freely available) Windows Driver Kit Version 7.1.0 (WDK) first be installed. The WDK contains compiler, build environment, and supporting tools that is required to use SDV.
  • See http://www.microsoft.com/whdc/driver/wdk/ for information about obtaining the WDK. (As of this writing under: How to Get the WDK -> Microsoft Download Center).
  • Recommend default selection of Features and Location.
  • Notice: The WDK will be installed to "%SystemDrive%\WinDDK\7600.16385.1".
• Install the SDVRP.
  • What: The SDVRP contains a customized version of SDV that can be used for rule development.
  • Recommend default selection of Features and Installation Path. Installation Path must be a path with no spaces in path name.
  • Notice: The SDVRP will be installed to "%SystemDrive%\WinDDK\SDV".
• Confirm the WDK use the SDVRP version of SDV:
  • What: The WDK already has SDV available (in the "tools\sdv" folder), but this WDK version of SDV is not useable for SDVRP work.  The WDK build environment should automatically detect that SDVRP is installed and use the SDVRP version of SDV. 
  • Open a "Windows Win7 x86 Free Build Environment" window (from All Programs -> Windows Driver Kits -> 7600.16385.1 -> Build Environments -> Windows 7 -> x86 Free Build Environment)
  • Validate that this line is printed when you start the build environment: "WARNING: Using external version of Static Driver Verifier."
  • In case of trouble you should look at the script %SystemDrive%\WinDDK\7600.16385.1\bin\setenv.bat, search for SDV.
• The SDVRP is now ready for use!