Giter Site home page Giter Site logo

gitter-badger / windowsprotocoltestsuites Goto Github PK

View Code? Open in Web Editor NEW

This project forked from microsoft/windowsprotocoltestsuites

0.0 1.0 0.0 28.53 MB

Windows Protocol Test Suites provide interoperability testing against an implementation of the Windows open specifications.

License: Other

PowerShell 0.03% C# 99.95% Batchfile 0.01% HTML 0.01%

windowsprotocoltestsuites's Introduction

Windows Protocol Test Suites

Originally developed for in-house testing of the Microsoft Open Specifications, Microsoft Protocol Test Suites have been used extensively during plugfests and interoperability labs to test partner implementations. A Test Suite evaluates whether a protocol or protocol family implementation meets certain interoperability requirements. Test Suites do not cover every protocol requirement and in no way certify an implementation, even if all tests pass. However, each test suite provides users with a useful indication of interoperability.

Windows Protocol Test Suites provide interoperability testing against the implementation of Windows open specifications including File Services, Identity Management, Remote Desktop and etc.

  • SMB1 Protocol Test Suite. It covers requirements documented in [MS-SMB], [MS-FSCC] as well [MS-CIFS] dependencies referred to in [MS-SMB].
  • File Server Protocol Test Suite. It is designed to test implementations of file server protocol family including [MS-SMB2], [MS-DFSC], [MS-SWN], [MS-FSRVP], [MS-FSA], [MS-RSVD] and [MS-SQOS].

Components

Windows Protocol Test Suites contain three components:

  • CommonScripts. Common scripts used by every test suite. Normally they're used to configure the environment.
  • ProtocolTestManager. Protocol Test Manager is a UI tool to help you to configure and run test cases.
  • ProtoSDK. Protocol SDK is the protocol library used by every test suite. It provides the data structures of the protocol messages, the methods to encode and decode the messages, the methods to send and recieve messages and etc.
  • TestSuites. All Test Suites code and documents are saved here and categorized by folder representing each test suite.

Prerequisites

The Test Suites are developed and must be installed on Windows platform. You should install the following list of software in order to build Test Suites from source code.

  • .Net framework 3.5
  • Wix toolset v3.7 or higher
  • Visual Studio or Visual Studio test agent, version 2012 or higher
  • Protocol Test Framework. You can use a released package or build a installer package of Protocol Test Framework from source code.
  • Spec Explorer. It is only required for the test suites that contain Model Based Test cases. If you want to regenarate Model Based Test cases, you must install Visual Studio 2012, otherwise higher versions of Visual Studio are supported.

Build

After you clone a copy of this repo, change to the WindowsProtocolTestSuites directory:

cd WindowsProtocolTestSuites

Run buildall.cmd

buildall.cmd

After the build succeeds, the MSI (installer package) files of every test suite should be generated in the folder WindowsProtocolTestSuite\drop\TestSuites\[TestSuiteName]\Installer. Take SMB test suite as an example, MS-SMB-TestSuite-ServerEP.msi should be generated in the folder WindowsProtocolTestSuite\drop\TestSuites\MS-SMB\Installer.

You can also run build.cmd for protocol SDK, Protocol Test Manager and every test suite separately.

To build protocol SDK

cd WindowsProtocolTestSuites\ProtoSDK
build.cmd

To build Protocol Test Manager

cd WindowsProtocolTestSuite\ProtocolTestManager
build.cmd

To build a test suite, take SMB test suite as an example

cd WindowsProtocolTestSuite\TestSuites\MS-SMB\src
build.cmd

Documentation

Every test suite contains three kinds of documents:

  • Technical Document. The Open Specifications documentation for protocols, published by Microsoft. It's the basis of developing Test Suites.
  • Test Design Spec. It provides information about the test scope and test suite design.
  • User Guide. It provides information about how to set up environment and how to install, configure, and run Test Suites.

Contribute

You can find contributing guide here.

License

Windows Protocol Test Suites is under the MIT license.

windowsprotocoltestsuites's People

Contributors

msftgits avatar yazeng avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.