remove_all_global_assignments (::quartus::project)

Tcl Package and Version

Syntax

remove_all_global_assignments [-h | -help] [-long_help] [-entity <entity_name> ] [-fall] -name <name> [-rise] [-section_id <section id> ] [-tag <data> ]

Arguments

-h | -help

Short help

-long_help

Long help with examples and possible return values

-entity <entity_name>

Entity to which assignment belongs

-fall

Option applies to falling edge

-name <name>

Assignment name (string pattern is matched using Tcl string matching)

-rise

Option applies to rising edge

-section_id <section id>

Section id

-tag <data>

Option to tag data to this assignment

Description

Removes all matching global assignments.

The "-name" option is not case sensitive. This option can take 
string patterns containing special characters from the set 
"*?\[]" as the value. The value is matched using Tcl string 
matching.

This Tcl command reads the global assignments found in
the Quartus Prime Settings File (.qsf). This Tcl command filters
the assignments data found in the .qsf and removes the data
based on the values specified by the "-name" option.

Certain sections in the .qsf can appear more than once. 
For example, because there may be more than one clock 
used in a project, there may be more than one CLOCK section 
each containing its own set of clock assignments. To uniquely 
identify sections of this type, a <Section Id> is used. 
<Section Id> can be one of three types. It can be the same as 
the revision name, or it can be some unique name. The 
following is a list of sections requiring a <Section Id> and 
the associated <Section Id> description:

Section Id                    Description
---------------------------   ------------------------------
CHIP                          Same as revision name
LOGICLOCK_REGION              A unique name
EDA_TOOL_SETTINGS             A unique name
CLIQUE                        A unique name
BREAKPOINT                    A unique name
CLOCK                         A unique name
AUTO_INSERT_SLD_NODE_ENTITY   A unique name

For entity-specific assignments, use the "-entity" option to 
remove the assignment(s) from the specified entity. If the
"-entity" option is not specified, the value for the 
FOCUS_ENTITY_NAME assignment is used. If the FOCUS_ENTITY_NAME
value is not found, the revision name is used.

Assignments removed by using this Tcl command are 
not saved to the Quartus Prime Settings File (.qsf) unless you
explicitly call one of the following two Tcl commands:

1) export_assignments
2) project_close (unless "-dont_export_assignments" is specified)

These two Tcl commands reside in the ::quartus::project Tcl 
package. You must save assignment changes before you run 
Quartus Prime command-line executables. Note, however, that 
the Tcl commands "execute_flow" and "execute_module" (part 
of the ::quartus::flow Tcl package) automatically call 
"export_assignments" before they run command-line executables.

Example Usage

## Remove all the registered source files

remove_all_global_assignments -name SOURCE_FILE

# Using wildcards
remove_all_global_assignments -name SOURCE*

Return Value

Code Name

Code

String Return

TCL_OK

0

INFO: Operation successful

TCL_OK

0

INFO: <string> global assignment(s) were removed

TCL_OK

0

WARNING: Ignored assignment: <string>. The assignment is no longer supported.

TCL_ERROR

1

ERROR: Assignment is not a global assignment: <string> -- it is an instance assignment. Specify a global assignment name or use the instance assignment commands.

TCL_ERROR

1

ERROR: Can't find file(s) associated with assignment. Specify a different assignment name.

TCL_ERROR

1

ERROR: Can't find section information for assignment. Specify a different assignment name.

TCL_ERROR

1

ERROR: Can't find active revision name. Make sure there is an open, active revision name.

TCL_ERROR

1

ERROR: Entity does not exist or uses illegal name characters: <string>. Specify a legal entity name.

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: Value <string> for the -<string> option is illegal. Specify a legal value.

TCL_ERROR

1

ERROR: Option -<string> for <string> assignment is illegal. Specify a legal option or remove the option.

TCL_ERROR

1

ERROR: Options cannot be specified together: -<string>, -<string> and -<string>. Specify only one or two of the three options.

TCL_ERROR

1

ERROR: Missing destination for assignment. Specify the destination for the assignment.

TCL_ERROR

1

ERROR: You must open a project before you can use this command.

TCL_ERROR

1

ERROR: Found two options: -<string> and -<string>. Choose one of the options.

TCL_ERROR

1

ERROR: Illegal assignment name: <string>. Specify a legal assignment name. To view the list of legal assignment names, run get_all_assignment_names.

TCL_ERROR

1

ERROR: An unknown error has occured.

Tcl Package and Version	Belongs to ::quartus::project 6.0
Syntax	`remove_all_global_assignments [-h \| -help] [-long_help]` `[-entity` <entity_name> `]` `[-fall]` `-name` <name> `[-rise]` `[-section_id` <section id> `]` `[-tag` <data> `]`
Arguments	`-h \| -help`		Short help
	`-long_help`		Long help with examples and possible return values
	`-entity` <entity_name>		Entity to which assignment belongs
	`-fall`		Option applies to falling edge
	`-name` <name>		Assignment name (string pattern is matched using Tcl string matching)
	`-rise`		Option applies to rising edge
	`-section_id` <section id>		Section id
	`-tag` <data>		Option to tag data to this assignment
Description	Removes all matching global assignments. The "-name" option is not case sensitive. This option can take string patterns containing special characters from the set "*?\[]" as the value. The value is matched using Tcl string matching. This Tcl command reads the global assignments found in the Quartus Prime Settings File (.qsf). This Tcl command filters the assignments data found in the .qsf and removes the data based on the values specified by the "-name" option. Certain sections in the .qsf can appear more than once. For example, because there may be more than one clock used in a project, there may be more than one CLOCK section each containing its own set of clock assignments. To uniquely identify sections of this type, a <Section Id> is used. <Section Id> can be one of three types. It can be the same as the revision name, or it can be some unique name. The following is a list of sections requiring a <Section Id> and the associated <Section Id> description: Section Id Description --------------------------- ------------------------------ CHIP Same as revision name LOGICLOCK_REGION A unique name EDA_TOOL_SETTINGS A unique name CLIQUE A unique name BREAKPOINT A unique name CLOCK A unique name AUTO_INSERT_SLD_NODE_ENTITY A unique name For entity-specific assignments, use the "-entity" option to remove the assignment(s) from the specified entity. If the "-entity" option is not specified, the value for the FOCUS_ENTITY_NAME assignment is used. If the FOCUS_ENTITY_NAME value is not found, the revision name is used. Assignments removed by using this Tcl command are not saved to the Quartus Prime Settings File (.qsf) unless you explicitly call one of the following two Tcl commands: 1) export_assignments 2) project_close (unless "-dont_export_assignments" is specified) These two Tcl commands reside in the ::quartus::project Tcl package. You must save assignment changes before you run Quartus Prime command-line executables. Note, however, that the Tcl commands "execute_flow" and "execute_module" (part of the ::quartus::flow Tcl package) automatically call "export_assignments" before they run command-line executables.
Example Usage	## Remove all the registered source files remove_all_global_assignments -name SOURCE_FILE # Using wildcards remove_all_global_assignments -name SOURCE*
Return Value	Code Name	Code	String Return
	TCL_OK	0	INFO: Operation successful
	TCL_OK	0	INFO: <string> global assignment(s) were removed
	TCL_OK	0	WARNING: Ignored assignment: <string>. The assignment is no longer supported.
	TCL_ERROR	1	ERROR: Assignment is not a global assignment: <string> -- it is an instance assignment. Specify a global assignment name or use the instance assignment commands.
	TCL_ERROR	1	ERROR: Can't find file(s) associated with assignment. Specify a different assignment name.
	TCL_ERROR	1	ERROR: Can't find section information for assignment. Specify a different assignment name.
	TCL_ERROR	1	ERROR: Can't find active revision name. Make sure there is an open, active revision name.
	TCL_ERROR	1	ERROR: Entity does not exist or uses illegal name characters: <string>. Specify a legal entity name.
	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: Value <string> for the -<string> option is illegal. Specify a legal value.
	TCL_ERROR	1	ERROR: Option -<string> for <string> assignment is illegal. Specify a legal option or remove the option.
	TCL_ERROR	1	ERROR: Options cannot be specified together: -<string>, -<string> and -<string>. Specify only one or two of the three options.
	TCL_ERROR	1	ERROR: Missing destination for assignment. Specify the destination for the assignment.
	TCL_ERROR	1	ERROR: You must open a project before you can use this command.
	TCL_ERROR	1	ERROR: Found two options: -<string> and -<string>. Choose one of the options.
	TCL_ERROR	1	ERROR: Illegal assignment name: <string>. Specify a legal assignment name. To view the list of legal assignment names, run get_all_assignment_names.
	TCL_ERROR	1	ERROR: An unknown error has occured.