From 116d1ede0cc0d5d57f593264251668531252c74b Mon Sep 17 00:00:00 2001 From: Egor Tensin Date: Wed, 6 May 2015 22:22:41 +0300 Subject: initial commit --- README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..68a0fd1 --- /dev/null +++ b/README.md @@ -0,0 +1,48 @@ +# Windows drivers + +This is a collection of drivers for Windows 7, created to amuse and entertain. + +## Development + +### Prerequisites + +The drivers are compiled using the Windows Driver Kit Version 7.1.0. + +I've developed a set of batch files to facilitate building the drivers and cleaning after the build. +The binaries are copied into the "bin" directory under the root directory. + +To set up the development environment, start a new `cmd` session, and run + + C:\WinDDK\7600.16385.1\bin\setenv.bat C:\WinDDK\7600.16385.1 fre WIN7 no_oacr + +Of course, you may want to modify `setenv.bat` parameters. +For example, to compile under x86-64, call `setenv.bat` like this: + + C:\WinDDK\7600.16385.1\bin\setenv.bat C:\WinDDK\7600.16385.1 fre x64 WIN7 no_oacr + +Then navigate to the root directory and call `setenv.bat`: + + setenv.bat + +### Code signing + +Driver binaries are signed using the self-verified certificate "Test Certificate" in "Test Certificate Store". +You can create this certificate using `add_cert.bat` (but first make sure you've set up the development environment). +To verify it's there, you can use the `certmgr.msc` utility. + +Driver binaries are automatically signed during builds, but you can also sign one manually by passing the path to a .sys file to `sign.bat`. + +### Build & clean + +To build every driver under the "src" directory, call `build_drivers.bat`. +To build a particular driver, pass the path to the driver source directory to `build_driver.bat`. +Driver binaries are copied to the "bin" directory. + +Cleaning after a driver build includes deleting log and object files in the driver source directory and deleting the binaries from the "bin" directory. +To clean after every driver in the "src" directory, call `clean_drivers.bat`. +To clean after a particular driver, pass the path to the driver source directory to `clean_driver.bat`. + +## Licensing + +This project, including all of the files and their contents, is licensed under the terms of the MIT License. +See LICENSE.txt for details. -- cgit v1.2.3