Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 10/04/2021

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

Document Table of Contents project_restore (::quartus::project)

The following table displays information for the project_restore Tcl command:

Tcl Package and Version

Belongs to ::quartus::project

Syntax project_restore [-h | -help] [-long_help] [-destination <directory> ] [-overwrite] [-update_included_file_info] <archive_file>
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-destination <directory> Directory where restored files are placed
-overwrite Option to overwrite files in destination directory
-update_included_file_info Option to update included file information
<archive_file> Archive file name

Restores a Quartus Prime Archive File (.qar) that contains the project and its related files. By default, the archive is restored into the current directory. Use the "-destination" option to restore the files into a new directory. By default, the command fails if the archive already contains files in the destination directory. Use the "-overwrite" option to overwrite any existing files in the destination directory.

Example Usage
## Restore archive and expand files into current directory
project_restore chiptrip.qar
## or
project_restore chiptrip.qar -destination 

## Restore archive. Expand files into current directory, 
## but overwrite any existing files in "."
project_restore chiptrip.qar -destination . -overwrite

## Restore project into a "restored" subdirectory
project_restore chiptrip.qar -destination "restored" -overwrite
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
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: Error(s) found while restoring the archive. See error message(s) for details.