Gendarme - Rule-based code analysis for Mono.
Contents
Copyright
Copyright (C) 2005-2010 Novell, Inc (http://www.novell.com)
Description
Gendarme is a extensible rule-based tool used to find problems in .NET applications and libraries.
Gendarme inspects programs and libraries that contain code in ECMA CIL format (Mono and .NET) and looks
for common problems with the code, problems that compilers do not typically check or have historically
not checked.
Environment Variables
GENDARME_COLOR
The runner will use colors when displaying defects on the console. By default colors are dark in
order to display correctly on any background. You can change this default to "light" (lighter
colors looks nice on a dark background, or "none" so no colors will be used. E.g.
GENDARME_COLOR=none gendarme ...
Exit Status
0 The runner returns 0 when no error has occurred. If some code was analyzed then this also means
that no defects were found and reported.
1 The runner execution was successful but either some defects where found or no assembly was
specified.
2 The runner execution was interrupted by I/O errors (e.g. missing files).
3 The runner founds errors in the (default or user supplied) configuration files. Specific error
messages should be printed on the console.
4 The runner execution was interrupted by a non-handled exception. This is likely a bug inside
Gendarme and should be reported on Novell's bugzilla (http://bugzilla.novell.com) or on the
mailing-list.
Files
ignore-file
This file is used to filter out defects from gendarme reports.
rules.xml
This file is used in conjunction with the --set option to control and configure the rules used by
Gendarme. It contains a set of named rules (rule sets) and each rule set contains a list of rules.
gendarme.exe.config
Used by debug versions of Gendarme to enable logging for rules. It is useful for Gendarme's
developers (i.e. not meant for end-users).
Mailing Lists
Mailing lists are listed at the http://groups.google.com/group/gendarmeName
Gendarme - Rule-based code analysis for Mono.
Options
--configconfigfile
Specify the rule sets and rule settings. Default is 'rules.xml'.
--setruleset
Specify a rule set from configfile. Defaults to 'default'.
--logfile
Save the report, as a text file, to the specified file.
--xmlfile
Save the report, formatted as XML, to the specified file.
--htmlfile
Save the report, formatted as HTML, to the specified file.
--console
Write the defects on stdout. This is the default (implicit) behavior if none of --log, --xml, or
--html options are specified. If (explicitely) specified then the defects will be shown on both
stdout and inside text/xml/html report(s).
--ignoreignore-file
Do not report defects listed in the specified file.
--limitN
Stop reporting after N defects are found.
--severity[all|audit[+]|low[+|-]|medium[+|-]|high[+|-]|critical[-]],...
Filter the reported defects to include the specified severity levels. Default is 'medium+' (i.e.
low and audit levels are ignored).
--confidence[all|low[+]|normal[+|-]|high[+|-]|total[-]],...
Filter the reported defects to include the specified confidence levels. Default is 'normal+'
(i.e. low level is ignored).
--quiet
Used to disable progress and other information which is normally written to stdout.
--v|verbose
When present additional progress information is written to stdout. May be used more than once to
write even more info.
--version
Display Gendarme's version number. This will match the Mono version number that this copy of
Gendarme was released with.
assemblies...
Specify the assemblies to verify. You can specify multiple filenames, including masks (? and *).
You can also provide a file that lists several assemblies (one per line) by prefixing the filename
with @ on the command line.
See Also
gendarme(5),gd2i(1),mono(1)Gendarme(Gendarme 4.2.0.0)
Synopsis
gendarme[--configconfigfile][--setruleset][--logfile|--xmlfile|--htmlfile][options]assemblies...
