PrimeTime® GCA

Tool Invocation Commands

Version K-2015.12, December 2015
Copyright Notice and Proprietary Information
© 2015 Synopsys, Inc. All rights reserved. This software and documentation contain confidential and proprietary
information that is the property of Synopsys, Inc. The software and documentation are furnished under a license
agreement and may be used or copied only in accordance with the terms of the license agreement. No part of the
software and documentation may be reproduced, transmitted, or translated, in any form or by any means, electronic,
mechanical, manual, optical, or otherwise, without prior written permission of Synopsys, Inc., or as expressly provided
by the license agreement.
Destination Control Statement
All technical data contained in this publication is subject to the export control laws of the United States of America.
Disclosure to nationals of other countries contrary to United States law is prohibited. It is the reader's responsibility to
determine the applicable regulations and to comply with them.
Disclaimer
SYNOPSYS, INC., AND ITS LICENSORS MAKE NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH
REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
Trademarks
Synopsys and certain Synopsys product names are trademarks of Synopsys, as set forth at
http://www.synopsys.com/Company/Pages/Trademarks.aspx.
All other product or company names may be trademarks of their respective owners.
Third-Party Links
Any links to third-party websites included in this document are for your convenience only. Synopsys does not endorse
and is not responsible for such websites and their practices, including privacy practices, availability, and content.

Synopsys, Inc.
690 E. Middlefield Road
Mountain View, CA 94043
www.synopsys.com

PrimeTime® GCA Tool Invocation Commands, Version K-2015.12 ii

Copyright Notice for the Command-Line Editing Feature
© 1992, 1993 The Regents of the University of California. All rights reserved. This code is derived from software
contributed to Berkeley by Christos Zoulas of Cornell University.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
following conditions are met:
1.Redistributions of source code must retain the above copyright notice, this list of conditions and the following
disclaimer.
2.Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials provided with the distribution.
3.All advertising materials mentioning features or use of this software must display the following acknowledgement:

This product includes software developed by the University of California, Berkeley and its contributors.

4.Neither the name of the University nor the names of its contributors may be used to endorse or promote products
derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Copyright Notice for the Line-Editing Library

© 1992 Simmule Turner and Rich Salz. All rights reserved.

This software is not subject to any license of the American Telephone and Telegraph Company or of the Regents of
the University of California.

Permission is granted to anyone to use this software for any purpose on any computer system, and to alter it and
redistribute it freely, subject to the following restrictions:
1.The authors are not responsible for the consequences of use of this software, no matter how awful, even if they arise
from flaws in it.
2.The origin of this software must not be misrepresented, either by explicit claim or by omission. Since few users ever
read sources, credits must appear in the documentation.
3.Altered versions must be plainly marked as such, and must not be misrepresented as being the original software.
Since few users ever read sources, credits must appear in the documentation.
4.This notice may not be removed or altered.

PrimeTime® GCA Tool Invocation Commands, Version K-2015.12 iii

PrimeTime® GCA Tool Invocation Commands, Version K-2015.12 iv
Contents 1

gca_shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

v
 ®
PrimeTime
PrimeTime® GCA Tool Invocation
GCA Tool Invocation Commands
Commands K-2015.12
Version K-2015.12

Contents vi
PrimeTime® GCA Tool Invocation Commands Version K-2015.12

gca_shell
Runs the PrimeTime GCA shell.

SYNTAX

gca_shell
[-no_gui]
[-f file_name]
[-native]
[-x command_string]
[-man]
[-no_init]
[-version]
display_env_var

Data Types
file_name string
display_env_var string
command_string string

ARGUMENTS
-no_gui
Do not start GUI mode. The gca_shell starts in GUI mode by default. You can manually
launch the GUI with gui_start.
-f file_name
Executes file_name (a file of the gca_shell commands) before displaying the initial
gca_shell prompt. If the last statement in file_name is quit, no prompt is displayed and
the command shell is exited.
-native
Directs the gca_shell to start up using the native executable of the requested
architecture, if available. This directs the gca_shell to start using the 32-bit executable of
the requested architecture on a 32-bit platform or the 64-bit executable of the requested
arhcitecture on a 64-bit platform. If the native executable is unavailable, the startup
process terminates.

Chapter 1:
gca_shell 1
1-1
 ®
PrimeTime
PrimeTime® GCA Tool Invocation
GCA Tool Invocation Commands
Commands K-2015.12
Version K-2015.12

-x command_string
Executes the gca_shell statements in command_string before displaying the initial
gca_shell prompt. You can enter multiple statements, separating each statement with a
semicolon, with quotation marks around the entire set of command statements after the
-x. If you also use the -f option, the statements from -x are executed before the script
from -f is executed. If the last statement entered is quit, no prompt is displayed and the
command shell is exited.
-man
Launches the online help browser. The gca_shell executable will not be run and no
licenses are required. To change the browser, use the USER_HELP_BROWSER
environment variable. For example, to change the online help browser to Mozilla, enter
setenv USER_HELP_BROWSER /usr/bin/mozilla
-no_init
Directs the gca_shell not to execute any .synopsys_pt.setup startup files.
-version
Displays the version number and build date information, and then exits.

DESCRIPTION
Interprets and executes the PrimeTime GCA commands. The gca_shell command
interpreter is based on Tcl (Tool Command Language).
The gca_shell executes commands until you terminate the session with the quit or exit
command. During interactive mode, you can also terminate the gca_shell session by typing
Ctrl+D.
To cancel or interrupt the command currently executing in the gca_shell, type Ctrl+C. The
time it takes for a command to process an interrupt (stop what it is doing and continue with
the next command) depends upon the size of the design and the type of command. If you
enter Ctrl+C three times before a command responds to the interrupt, gca_shell exits, and
the following message is displayed:

Information: Process terminated by interrupt.

SEE ALSO

PrimeTime GCA User Guide.

gca_shell 2
PrimeTime® GCA Tool Invocation Commands Version K-2015.12

Chapter 1:
gca_shell 3
1-3