Switch branches/tags
Find file
Fetching contributors…
Cannot retrieve contributors at this time
68 lines (65 sloc) 2.07 KB
.\" ccrewrite manual page.
.\" Copyright (C) 2010 Chris Bacon.
.\" Author:
.\" Chris Bacon <>
.TH Mono "ccrewrite"
ccrewrite \- Rewrite CLR assemblies for runtime code contract verification.
.B ccrewrite --assembly=<assembly> [options]
Rewrite CLR assemblies to convert calls into the System.Diagnostics.Contracts
namespace to perform runtime contract verification. This includes
contract inheritance for virtual methods.
The assembly must have been built with the symbol CONTRACTS_FULL defined,
otherwise the calls to the contract methods will have been removed
by the compiler.
Currently only pre-conditions are supported, using the Contract.Requires()
method. Contract inheritance for virtual methods is supported. Only a
limited range of operations and types can be used within a pre-condition,
an error message will be shown if ccrewrite is unable to process the
specified assembly.
.I "--assembly <assembly-name>"
The assembly to rewrite. If no --output option is specified, then this file
is overwritten with the rewritten version.
.I "--debug"
Use debug information if available to improve the usefulness of contract
failure messages.
.I "--help"
Show help for ccrewrite, listing configuration options.
.I "--level <level> (default=4)"
Set which contract types are present in rewritten assembly:
0 = No contracts;
1 = Release requires;
2 = Requires;
3 = Ensures;
4 = Invariants;
(Each level includes all previous levels)
.I "--output <file-name>"
Write the rewritten assembly to the specified file. If this is not present
then the input assembly file is overwritten with the rewritten version.
.I "--rewrite (default=true)"
Rewrite the assembly. If false, then nothing is done.
.I "--throwOnFailure (default=false)"
Throw a ContractException on unhandled contract failure. The default
behaviour is to Assert.
Written by Chris Bacon
Copyright (C) 2010 Chris Bacon.
Released under MIT license.
Visit for details