Extract files from a core container to disk
Syntax
extract_files [‑base_dir <arg>] [‑force] [‑no_ip_dir] [‑no_paths] [‑quiet]
[‑verbose] <files>...
Returns
List of files that were extracted with the new paths.
Usage
Name | Description |
---|---|
[-base_dir]
|
Base directory for extracted files Default: ip_files |
[-force]
|
Overwrite existing files |
[-no_ip_dir]
|
Don't include the IP dir as part of the extract directory |
[-no_paths]
|
Don't include directories when extracting files |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
<files>
|
Name of the file(s) to be extracted |
Categories
Description
Extract the files from an IP in core container format.
The core container format for IP is a compressed zip file that reduces the file structure in the design, and increases tool performance.
This command returns a list of files extracted from the core container IP, or returns an error if it fails.
Arguments
-base_dir <arg>
- (Optional) Specify the directory to write the extracted files into. By default the extract_files
command will write files into a folder called ip_files inside of the current working directory.
-force
- (Optional) Overwrite existing files of the same name if any exist.
-no_ip_dir
- (Optional) Don't include an IP sub-folder as part of path for the the extracted files. In this case, the files will be exported to the specified directory, without a sub-folder named after the core container IP.
-no_paths
- (Optional) Don't include sub-folders of the core container in the extracted files. This option will cause all files to be extracted to the top-level ip_files folder, or the folder specified by the -base_dir
option.
-quiet
- (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
-verbose
- (Optional) Temporarily override any message limits and return all messages from this command.
set_msg_config
command.
<files>
- (Required) Specify the name of the IP core container (.XCIX) file to extract the files from.
Examples
extract_files -base_dir C:/Data [get_files char_fifo.xcix]