NMAKELOG

NAME
SYNOPSIS
DESCRIPTION
EXAMPLES
FILES
SEE ALSO

Nokia nmake 12 NMAKELOG(1)

NAME

nmakelog, xmakelog − run nmake producing serialized build log

SYNOPSIS

nmakelog [ nmake-arguments ]

xmakelog [ −−info name:value ... ] [ nmake-arguments ]

DESCRIPTION

nmakelog runs nmake(1) configured to produce a serialized build log. nmakelog addresses a problem that occurs when more than one shell action executes concurrently under the control of nmake(1), (e.g. when the value of the −j option is greater than 1, or when coshell(1) is used). In this case, each line of output from multiple concurrently executing commands appears in the output log in the order that it is written, with the result that output of different commands is intermingled, log, making it very difficult to scan and interpret.

nmakelog serializes the output of nmake(1): it creates a log file in which the output of each command appears contiguously and in the correct order in the log file; additionally, at higher levels the output of each recursive make (which may itself be running concurrently with other shell actions and recursive makes, and itself be subordinate to higher level recursive makes) appears contiguously and correctly ordered in the output file.

The nmakelog command line is identical to the nmake(1) command line; use nmakelog as you would nmake(1). As usual, during the build the unserialized output appears on standard output as it is generated; in addition, serialized output appends to file $makelog, by default makelog.

nmakelog may be used with distributed (coshell(1) based) or non-distributed builds.

xmakelog is similar to nmakelog except that it generates the serialized build log in a structured XML format. The additional structure allows other tools to easily navigate the build log and transform it in various ways. Environment variable makelog_format provides control over the format of the generated log file. The structured build log is by default written to file makelog.xml and is created from scratch for each run. Optional --info name:value arguments insert arbitrary name / value pairs representing information about the build into the build log. The information may be used by downstream tools. See Structured Build Logs for more information.

EXAMPLES

nmakelog -j4 -f a.mk


xmakelog --info project:myproj --info build:20081119T1111 -j4 -f a.mk

FILES

logfilter

executable used to reorder log file

taglines

executable used to insert tags on build log lines

SEE ALSO

nmake(1), makerules(1), coshell(1)
Structured Build Logs
nmake User's Guide
nmake Reference Manual
nmake Web Site


nmake 12 July 2010 NMAKELOG(1)