Naming project files

Ounce/Make uses conventions outlined in this topic to name AppScan® Source project files.

  • When creating AppScan Source project files, Ounce/Make uses the relative directory path from the directory in which you invoked ouncemake to the directory where ouncemake creates the project file.
  • The directory where you invoke ouncemake becomes the first component in the path name.
  • Underscores replace all path separators such as backslash (\) on Windows™ and slash (/) on Linux™.
  • When the filename length exceeds operating system limitations, Ounce/Make strips components of the path, starting on the left, until the filename length complies with the system naming convention.
  • When you run ouncemake at the root of a file system, such as / or c:\, ouncemake creates an AppScan Source project file named root.ppf.

AppScan Source saves the created .ppf in the location next to the makefile that the ppf represents. For example, if you run Ounce/Make, creating a single project file, AppScan Source saves the ppf in the directory from which you invoked Ounce/Make. Refer to Example 2: Ounce/Make with recursive option to see the ppf files created in multi-project mode.

Note: If there is more than one makefile in a directory, Ounce/Make creates only one .ppf file in the directory.

Example 1

This example illustrates a ppf file created with the path separators replaced by underscores.

Invoke ouncemake from the following directory:

C:\development\source

During execution, Ounce/Make creates an AppScan Source project file in:

C:\development\source\components\server

The name of the ppf is source_components_server.ppf:


Project file name

Example 2

Microsoft™ Windows and Linux limit path and file names. These operating systems limit the number of characters to 255. Example 2 shows the case of a filename exceeding path length limitations.

User invokes Ounce/Make from the following directory:

C:\path1\path2\path3\path4\path5\development\source

During execution, Ounce/Make creates an AppScan Source project in the following directory:

C:\path1\path2\path3\path4\path5\development\source\components\server

If the filename can be a maximum of 25 characters, due to path limitations, the resulting filename is:

components_server.ppf