You can specify a CrossStudio project file:
crossbuild [options …] project-file
You must specify a configuration to build using -config. For instance:
crossbuild -config "V5T Thumb LE Release" arm.hzp
The above example uses the configuration V5T Thumb LE Release to build all projects in the solution contained in arm.hzp.
To build a specific project that is in a solution, you can specify it using the -project option. For example:
crossbuild -config "V5T Thumb LE Release" -project "libm" libc.hzp
This example will use the configuration V5T Thumb LE Release to build the project libm that is contained in libc.hzp.
If your project file imports other project files (using the <import…> mechanism), when denoting projects you must specify the solution names as a comma-separated list in parentheses after the project name:
crossbuild -config "V5T Thumb LE Release" -project "libc(C Library)" arm.hzp
libc(C Library) specifies the libc project in the C Library solution that has been imported by the project file arm.hzp.
To build a specific solution that has been imported from other project files, you can use the -solution option. This option takes the solution names as a comma-separated list. For example:
crossbuild -config "ARM Debug" -solution "ARM Targets,EB55" arm.hzp
In this example, ARM Targets,EB55 specifies the EB55 solution imported by the ARM Targets solution, which was itself imported by the project file arm.hzp.
You can do a batch build using the -batch option:
crossbuild -config "ARM Debug" -batch libc.hzp
This will build the projects in libc.hzp that are marked for batch build in the configuration ARM Debug.
By default, a make-style build will be done—i.e., the dates of input files are checked against the dates of output files, and the build is avoided if the output is up to date. You can force a complete build by using the -rebuild option. Alternatively, to remove all output files, use the -clean option.
To see the commands being used in the build, use the -echo option. To also see why commands are being executed, use the -verbose option. You can see what commands will be executed, without executing them, by using the -show option.