Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 9/26/2022
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

4.1.28.32. project_archive (::quartus::project)

The following table displays information for the project_archive Tcl command:

Tcl Package and Version

Belongs to ::quartus::project

Syntax project_archive [-h | -help] [-long_help] [-all_revisions] [-include_libraries] [-include_outputs] [-overwrite] [-use_file_set <file_set> ] [-version_compatible_database] <archive_name>
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-all_revisions Option to archive all revisions
-include_libraries Option to include related system libraries
-include_outputs Option to include output files in archive
-overwrite Option to overwrite any currently existing archive file
-use_file_set <file_set> Option to create the archive using the specified file set
-version_compatible_database Option to include version-compatible database if supported
<archive_name> Archive file name
Description
Archives an open project and its related files into a
Quartus Prime Archive File (.qar).

The description of operations is as follows:

Option                       Description
------                       -------------------------
use_file_set                 Creates the archive using the specified
                             file set. By default, the 'basic'
                             file set is used. For more information
                             about file sets, type:

                             quartus_sh --archive -list_file_sets

all_revisions                Archives all revisions.

overwrite                    Overwrites existing archive file.

include_outputs              Includes output files in archive.

include_libraries            Includes related Megafunction and
                             IP library files.

version_compatible_database  Includes version-compatible database
                             if supported.
Example Usage
## Default mode: Archive current revisions without output files or libraries
project_archive chiptrip.qar

## Archive all revisions without output files or libraries
project_archive chiptrip.qar -all_revisions

## Archive current revision with version-compatible database if supported
project_archive chiptrip.qar -version_compatible_database

## Same as first one, but overwrite any existing archive file
project_archive chiptrip.qar -overwrite

## Include output files and libraries
project_archive chiptrip.qar -include_outputs -include_libraries
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_ERROR 1 ERROR: Error(s) found while archiving the project. See error message(s) for details.
TCL_ERROR 1 ERROR: Project archive failed. Some files could not be processed. Refer to the Quartus Prime Archive Log File (<archive_name>.qarlog).
TCL_ERROR 1 ERROR: Can't run Tcl command while a process is in progress: <string>. To run the command, stop the compilation or simulation; or wait for the compilation or simulation to complete.
TCL_ERROR 1 ERROR: You must open a project before you can use this command.