.TH "msbuild" 1
.SH NAME
msbuild
.SH SYNOPSIS
.B msbuild
[options] [project file | directory]
.SH DESCRIPTION
Builds the specified targets in the project file. If a project file is not
specified, MSBuild searches the current working directory for a file that has a
file extension that ends in "proj" and uses that file. If a directory is
specified, MSBuild searches that directory for a project file.
.SH OPTIONS
.TP
.B /target:<targets>
Build these targets in this project. Use a semicolon or a comma to separate multiple targets, or specify each target separately. (Short form: /t)

Example:
    /target:Resources;Compile
.TP
.B /property:<n>=<v>
Set or override these project-level properties. <n> is the property name, and <v> is the property value. Use a semicolon or a comma to separate multiple properties, or specify each property separately. (Short form: /p)

Example:
    /property:WarningLevel=2;OutDir=bin/Debug/
.TP
.B /maxcpucount[:n]
Mono's msbuild does not support parallel builds yet. So, this internally gets set to 1.

Specifies the maximum number of concurrent processes to build with. If the switch is not used, the default value used is 1. If the switch is used without a value MSBuild will use up to the number of processors on the computer. (Short form: /m[:n])
.TP
.B /toolsversion:<version>
The version of the MSBuild Toolset (tasks, targets, etc.) to use during build. This version will override the versions specified by individual projects. (Short form: /tv)

Example:
    /toolsversion:3.5
.TP
.B /verbosity:<level>
Display this amount of information in the event log. The available verbosity levels are: q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic]. (Short form: /v)

Example:
    /verbosity:quiet
.TP
.B
/consoleloggerparameters:<parameters
Parameters to console logger. (Short form: /clp)

The available parameters are:
.nf
    PerformanceSummary      Show time spent in tasks, targets and projects.
    Summary                 Show error and warning summary at the end.
    NoSummary               Don't show error and warning summary at the end.
    ErrorsOnly              Show only errors.
    WarningsOnly            Show only warnings.
    NoItemAndPropertyList   Don't show list of items and properties at the start of each project build.
    ShowCommandLine         Show TaskCommandLineEvent messages
    ShowTimestamp           Display the Timestamp as a prefix to any message.
    ShowEventId             Show eventId for started events, finished events, and messages
    ForceNoAlign            Does not align the text to the size of the console buffer
    DisableConsoleColor     Use the default console colors for all logging messages.
    DisableMPLogging        Disable the multiprocessor logging style of output when running in non-multiprocessor mode.
    EnableMPLogging         Enable the multiprocessor logging style even when running in non-multiprocessor mode. This logging style is on by default.
    ForceConsoleColor       Use ANSI console colors even if console does not support it
    Verbosity               overrides the /verbosity setting for this logger.
.fi

Example:
        /consoleloggerparameters:PerformanceSummary;NoSummary;Verbosity=minimal

.TP
.B /noconsolelogger
Disable the default console logger and do not log events to the console. (Short form: /noconlog)
.TP
.B /fileLogger[n]
Logs the build output to a file. By default the file is in the current directory and named "msbuild[n].log". Events from all nodes are combined into a single log. The location of the file and other parameters for the fileLogger can be specified through the addition of the "/fileLoggerParameters[n]" switch.  "n" if present can be a digit from 1-9, allowing up to 10 file loggers to be attached. (Short form: /fl[n])
.TP
.B /fileloggerparameters[n]:<parameters>
Provides any extra parameters for file loggers. The presence of this switch implies the corresponding /filelogger[n] switch.  "n" if present can be a digit from 1-9.

/fileloggerparameters is also used by any distributed file logger, see description of /distributedFileLogger.  (Short form: /flp[n])
The same parameters listed for the console logger are available. Some additional available parameters are:

.nf
    LogFile     path to the log file into which the build log will be written.
    Append      determines if the build log will be appended to or overwrite the log file. Setting the switch appends the build log to the log file; Not setting the switch overwrites the contents of an existing log file.  The default is not to append to the log file.
    Encoding    specifies the encoding for the file, for example, UTF-8, Unicode, or ASCII Default verbosity is Detailed.
.fi

Examples:

    /fileLoggerParameters:LogFile=MyLog.log;Append;Verbosity=diagnostic;Encoding=UTF-8

    /flp:Summary;Verbosity=minimal;LogFile=msbuild.sum
    /flp1:warningsonly;logfile=msbuild.wrn
    /flp2:errorsonly;logfile=msbuild.err
.TP
.B /distributedlogger:<central logger>*<forwarding logger>
Use this logger to log events from MSBuild, attaching a different logger instance to each node. To specify multiple loggers, specify each logger separately.  (Short form /dl)

     The <logger> syntax is:
       [<logger class>,]<logger assembly>[;<logger parameters>]
     The <logger class> syntax is:
       [<partial or full namespace>.]<logger class name>
     The <logger assembly> syntax is:
       {<assembly name>[,<strong name>] | <assembly file>}
     The <logger parameters> are optional, and are passed to the logger exactly as you typed them. (Short form: /l)

Examples:
    /dl:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral
    /dl:MyLogger,/mylibs/My.dll*ForwardingLogger,/mylibs/Loggger.dll
.TP
.B  /distributedFileLogger
Logs the build output to multiple log files, one log file per MSBuild node. The initial location for these files is the current directory. By default the files are called "MSBuild<nodeid>.log". The location of the files and other parameters for the fileLogger can be specified with the addition of the "/fileLoggerParameters" switch.

If a log file name is set through the fileLoggerParameters switch the distributed logger will use the fileName as a template and append the node id to this fileName to create a log file for each node.
.TP
.B /logger:<logger>
Use this logger to log events from MSBuild. To specify multiple loggers, specify each logger separately.
     The <logger> syntax is:
       [<logger class>,]<logger assembly>[;<logger parameters>]
     The <logger class> syntax is:
       [<partial or full namespace>.]<logger class name>
     The <logger assembly> syntax is:
       {<assembly name>[,<strong name>] | <assembly file>}
     The <logger parameters> are optional, and are passed to the logger exactly as you typed them. (Short form: /l)

 Examples:
   /logger:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral
   /logger:XMLLogger,/MyLoggers/MyLogger.dll;OutputAsHTML
.TP
.B /binaryLogger[:output.binlog]
Serializes all build events to a compressed binary file.  By default the file is in the current directory and named "msbuild.binlog". The binary log is a detailed description of the build process that can later be used to reconstruct text logs and used by other analysis tools. A binary log is usually 10-20x smaller than the most detailed text diagnostic-level log, but it contains more information.  (Short form: /bl)

Examples:
    /bl
    /bl:output.binlog
    /bl:../../custom.binlog
    /binaryLogger
.TP
.B /warnaserror[:code[;code2]]
List of warning codes to treats as errors.  Use a semicolon or a comma to separate multiple warning codes. To treat all warnings as errors use the switch with no values.  (Short form: /err[:c;[c2]])

Example:
    /warnaserror:MSB4130

When a warning is treated as an error the target will continue to execute as if it was a warning but the overall build will fail.
.TP
.B /warnasmessage[:code[;code2]]
List of warning codes to treats as low importance messages.  Use a semicolon or a comma to separate multiple warning codes.  (Short form: /nowarn[:c;[c2]])

Example:
    /warnasmessage:MSB3026
.TP
.B /ignoreprojectextensions:<extensions>
List of extensions to ignore when determining which project file to build. Use a semicolon or a comma to separate multiple extensions.  (Short form: /ignore)

Example:
    /ignoreprojectextensions:.sln
.TP
.B /nodeReuse:<parameters>
Enables or Disables the reuse of MSBuild nodes. The parameters are:
.nf
    True    Nodes will remain after the build completes and will be reused by subsequent builds (default) False Nodes will not remain after the build completes
.fi
(Short form: /nr)

Example:
    /nr:true
.TP
.B /preprocess[:file]
Creates a single, aggregated project file by inlining all the files that would be imported during a build, with their boundaries marked. This can be useful for figuring out what files are being imported and from where, and what they will contribute to the build. By default the output is written to the console window. If the path to an output file is provided that will be used instead. (Short form: /pp)

Example:
    /pp:out.txt
.TP
.B /detailedsummary
Shows detailed information at the end of the build about the configurations built and how they were scheduled to nodes.  (Short form: /ds)
.TP
.B @<file>
Insert command-line settings from a text file. To specify multiple response files, specify each response file separately.

Any response files named "msbuild.rsp" are automatically consumed from the following locations:
.nf
    (1) the directory of msbuild.dll
    (2) the directory of the first project or solution built
.fi
.TP
.B /noautoresponse
Do not auto-include any MSBuild.rsp files. (Short form: /noautorsp)
.TP
.B /nologo
Do not display the startup banner and copyright message.
.TP
.B /version
Display version information only. (Short form: /ver)
.TP
.B /help
Display this usage message. (Short form: /? or /h)

.SH SEE ALSO
.BR mono(1), csc(1)
.SH COPYRIGHT
Copyright (C) Microsoft Corporation. All rights reserved.