Home
Reference
Review reference information for the product.
The Ounce/Make build utility
Ounce/Make is a tool that automates the importing of configuration information into AppScan® Source from build environments that use makefile. Ounce/Make eliminates the need to import configuration information from makefiles manually; this the recommended method of configuring these projects.
Ounce/Make properties file
The Ounce/Make Properties file (ouncemake_properties.xml) is an XML file that contains details about your build environment. When Ounce/Make runs, it finds the properties file based on the search path or the -p option. The properties file must specify the compiler used in your build environment, the linker, and make elements.
Ouncemake properties file elements
OuncemakeProperties, the root element of the Properties file, contains the elements that are listed in this topic.
Options
The Options element specifies options to pass to Ounce/Make upon invocation.

Reference
Review reference information for the product.
- The Ounce/Make build utility
  Ounce/Make is a tool that automates the importing of configuration information into AppScan® Source from build environments that use makefile. Ounce/Make eliminates the need to import configuration information from makefiles manually; this the recommended method of configuring these projects.
  - Requirements
    To create AppScan® Source project files successfully, you must run Ounce/Make in a suitable environment. The following list itemizes the requirements for Ounce/Make to run successfully. If you do not meet all of these requirements, Ounce/Make fails.
  - What Ounce/Make supports
    Ounce/Make supports multiple computer platforms, compilers, and make versions.
  - Operation
    Ounce/Make operates with your Make to extract the necessary configuration information from your makefiles and create appropriate AppScan® Source project files (ppf). To accomplish this, Ounce/Make requires that you provide certain information about the build environment, such as the make version used.
  - Ounce/Make command syntax and make options
    Ounce/Make supports multiple options that can change the way it behaves when it runs.
  - Ounce/Make properties file
    The Ounce/Make Properties file (ouncemake_properties.xml) is an XML file that contains details about your build environment. When Ounce/Make runs, it finds the properties file based on the search path or the -p option. The properties file must specify the compiler used in your build environment, the linker, and make elements.
    - Ouncemake properties file elements
      OuncemakeProperties, the root element of the Properties file, contains the elements that are listed in this topic.
      - Compiler
        The Compiler element specifies the compiler executable used in your build environment. The value of this element must be an absolute path to an executable. This element consists of one optional attribute, macro, which specifies the name of the variable that stores the compiler executable when building and a value specific to the path to the compiler. If you do not specify the macro attribute, Ounce/Make sets the macro attribute to CC by default. The Properties File can contain multiple Compiler elements, but at least one is required.
      - Linker
        The Linker element specifies a linker executable used in the build environment. The value of this element must be an absolute path to an executable. The Properties File can contain multiple Linker elements, but at least one is required.
      - Make
        The Make element specifies a make executable used in your build environment. The value of this element must be an absolute path to an executable. The Properties File can contain multiple Make elements, but at least one is required.
      - MakeOptions
        The MakeOptions element specifies the options to pass to the make executable. This element is optional and cannot appear more than once in the Properties File.
      - Options
        The Options element specifies options to pass to Ounce/Make upon invocation.
      - GlobalProjectOptions
        The GlobalProjectOptions element specifies Project level options for all files contained within the project. The GlobalProjectOptions element and its attributes are not required.
      - FileOptions
        The FileOptions element allows include paths, macros, and other compiler options to be specified for files with a particular extension. You can use FileOptions multiple times to specify different options for files with different extensions. For example, as shown below, if you have a project that contains both C and C++ files, create two FileOptions elements, one for each file type.
      - Executable
        The Executable element allows use of any executable (other than compiler, linker, or make) in the build environment. The value of this element must be an absolute path to an executable. The Executable element contains one attribute, macro, which specifies the name of the variable used to store the executable name when building. The value for the macro attribute must be unique across all Executable elements.
      - MountRoot
        The MountRoot element is required if you are assessing source code from a remote system. MountRoot tells Ounce/Make to pre-pend the specified mount point to all absolute include paths that it encounters.
    - Sample properties files
  - Examples
    This section describes three ways to use Ounce/Make.
- AppScan® Source command line interface (CLI)
  The CLI is an interface to core AppScan® Source functionality.
- The Ounce/Ant build tool
  This section describes how to use Ounce/Ant, an AppScan® Source build utility that integrates AppScan Source and Apache Ant. Integrating Ounce/Ant with your Ant environment helps you automate builds and code assessments.
- AppScan® Source Data Access API
  The Data Access API provides access to AppScan® Source-generated assessment results, including findings and finding details. It also provides access to assessment metrics such as analysis date and time, lines of code, V-density, and number of findings.
- Glossary
  Learn common product terminology.

`Options`

The Options element specifies options to pass to Ounce/Make upon invocation.

This element provides an alternative to the use of certain Ounce/Make command line options, as described in Ounce/Make command syntax and make options.

Attributes use the syntax:

<option> = <true | false>

The Options element and its attributes are not required.

The Options element may include the following attributes:


Attribute	Description
`recursive`	Boolean value. True or false. When true, implies `-r` command line option.
`single_project`	Boolean value. True or false. When true, implies `-s` command line option.
`verbose`	Boolean value. True or false. When true, implies `-v` command line option.
`clean`	String value, enclosed in quotation marks (`"`), such as `"make clean"`. When set, implies `-c` command line option. The value should be the command to execute to perform the clean. For example, `gmake clean`.
`build`	Boolean value. True or false. Perform the build while gathering the make options. Note: Incompatible with Cygwin.
`application`	String value. When set, implies `-a` option. The value specified should be the application name that you want.
`no_clean`	Boolean value. True or false. Tell Ounce/Make not to run clean and do not display a prompt reminding that a clean is not going to be run.

Note: Ounce/Make uses the options set in the Properties file. However, if you run Ounce/Make with options included on the command line, these options take precedence over options set in the Properties file. If you run Ounce/Make without options on the command line, Ounce/Make applies the Properties file options.

Example

The following is an example line from the Properties file that makes use of all attributes:

<Options recursive="true" single_project="false" verbose="false"
clean="nmake.exe clean" no_clean="false"></Options>

Description

recursive="true"
single_project="false" directs Ounce/Make to operate in multiple-project mode. When operating in multiple-project mode, the recursive attribute should also be set to true.
verbose="false" turns off verbosity.
clean="nmake.exe clean" cleans the build environment.
no_clean= "false" tells Ounce/Make to run a clean command, suppressing the message stating that the clean will run.