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.

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.
    - 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.

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.

To learn about the required and optional elements that are specified in the properties file, see Ouncemake properties file elements.

When you run Ounce/Make, if you do not specify the -p option on the command line, Ounce/Make looks through its search path looking for the ouncemake_properties.xml file (see Ounce/Make command syntax and make options to learn about specifying options on the command line). The Ounce/Make search path is platform-dependent.

The Microsoft™ Windows™ search path is:

Current® working directory
<data_dir>\config (where <data_dir> is the location of your AppScan® Source program data, as described in Installation and user data file locations)

The Linux™ search path is:

Current® working directory
<data_dir>/config (where <data_dir> is the location of your AppScan® Source program data, as described in Installation and user data file locations)
User's home directory
/etc

Note:

On Linux™, if you do not specify the -p option and the properties file does not exist in the search path, AppScan® Source will automatically create one in the current working directory.
For backwards compatibility, Ounce/Make recognizes pmake_properties.xml. If both pmake_properties.xml and ouncemake_properties.xml exist in the same directory, ouncemake_properties.xml takes precedence.