Product Documentation
Virtuoso Studio Design Environment User Guide
Product Version IC23.1, November 2023

Command-Line Options For Cadence Applications

You can use the following command-line options when starting any Cadence application:

Option Description

-45

Provides enhanced drawing of 45-degree diagonal lines. With this option, diagonal lines are not jagged.

This behavior might vary from shell to shell.

-help

Lists the supported command-line options.

-log fileName

Specifies the log file (fileName) to record this session.

For example, to save the log file of the virtuoso executable in the myLogDir directory using a name that reflects the date, such as CDS23Jull6:35.log:
virtuoso -log ~/myLogDir/CDS"date '+%d%h%H%M'".log

-logtime

Adds an absolute timestamp for every entry in the log file. Timestamps are output to the nearest millisecond, but the resolution of the timestamps is determined by the hardware on the system on which the application is run.

By default, the absolute time is logged in UTC (Coordinated Universal Time or GMT) to allow timestamps that can be compared between timezones. The first two lines of the log file display the start time in UTC as well as local time. Time can be logged as the local time rather than UTC by setting the environment variable CDS_USE_LOCAL_TIMESTAMP to true.

This environment variable also controls whether other timestamps in the CDS.log file, such as the timestamp for memory reports, use the local time instead of UTC. When this environment variable is used, the first line of the log file displays the local start time along with the UTC offset. Timestamp logging can also be enabled by setting the environment variable CDS_LOG_TIMESTAMPS to true.

Log files with timestamps can be replayed but the timestamps are ignored during replay. Log files with timestamps are not replayable in the older releases that did not have the timestamp feature.

-logtimerel

Adds a timestamp relative to the previous log entry in the log file. This allows you to see the amount of time that elapsed between entries.

-maxload

Specifies the maximum number of CPU-bound tasks that can be executed simultaneously. The default value for maxload is the number of CPU cores in a machine.

The maxload value should not exceed the maximum number of threads allowed in a Virtuoso session, which is either defined by setrlimit or by the -maxthreads option.

A task is not 100% CPU-bound if it takes less that 1 CPU core load.

-maxthreads

Specifies the maximum number of threads that can be created in a Virtuoso session. The default value for maxthreads is driven by the hard limit set by setrlimit.

If the number of threads in a session exceeds the maxthreads value set by the hard limit, the application exits and a warning message is displayed.

-noblink

Disables blinking. When blinking is disabled, objects that would normally blink in graphics windows stops blinkling.
In many cases, disabling blinking can improve graphics performance, particularly for many VNC X Window setups.

You can also use the SKILL function hiEnableBlink to enable or disable blinking while you are running the application and hiIsBlinkEnabled to check if blinking is enabled.

-nocdsinit

Does not read any .cdsinit files.

-nograph

Specifies non-graphics mode that you can use for SKILL programming and replay log files. To use this mode, you must install the Xvfb server at /usr/bin. This option is used internally by Virtuoso ADE Explorer and Virtuoso ADE Verifier.

This option is intended only for replaying log files generated in graphics mode for testing purposes.

-nographE

Emulates the non-graphical mode using an X server other than cdsXndx (the Cadence-supplied non-graphical X server). This option is similar to -nograph except that it uses the default display or the display specified with either the DISPLAY environment variable or the -display command line option. Windows and forms get drawn on the specified display.

You can also start the non-graphical emulation mode by setting the following environment variable:

CDS_NOGRAPH_DISPLAY display

You can use either the -nograph or -nographE option to start the application.

If you use both -display and CDS_NOGRAPH_DISPLAY, then the -display value overrides that of CDS_NOGRAPH_DISPLAY.

-nographN

Starts the non-graphical mode using the display specified by the argument N, where N can be a number 0 through 9 or +. The + option displays the application in the :400 through :409 display range.

Do not use the -nograph+ option with any of the tenbase options. Use the -nographN option instead.

-nologtime

Overrides the setting made by the environment variable CDS_LOG_TIMESTAMPS and disables timestamp logging.

-noxshm

Prevents use of X Shared Memory Access (XSHM), which is a protocol used for communicating with the X display server to enable better performance. This mode can only be used if the X server is running on the same machine as the Virtuoso software.

Use the -noxshm option in the following situations:

  • If you are using Virtuoso (graphically) with an X display configuration that appears to be local but is in fact remote and if the X server supports the XSHM extension.
  • If you see BadAccess and BadShmSeg error messages when using Virtuoso graphically

Virtuoso automatically stops using the -noxshm option if shared memory access fails to work.

-replay fileName

Executes a SKILL file (fileName).

This option allows replaying a log file from a previous virtuoso session. The font and disclosure settings are not read at startup during replay so these are always started with default settings.

-restore fileName

Restores a saved session from fileName.

This option cannot read a log file because it uses the SKILL function load to load the file toward the end of the initialization process.

-showCtrlFile

Displays the control file content. All Virtuoso early access releases have a limited lifespan to ensure that customers do not use these short-term releases forever. Therefore, a control file is given to the customers that contains an expiration date and the sub-version value of the release.

To view the control file content, you need to run the following command:

virtuoso -showCtrlFile

After you use this option, the Virtuoso session is terminated.

-V

Returns the release number, such as 4.4, without starting the Cadence software.

-W

Returns the version number without starting the Cadence software. To identify the exact software version number, type a command similar to the following in a terminal window.
your_install_dir/tools/dfII/bin/virtuoso -W

The software uses a 24-bit TrueColor visual. If it is not available, then it looks for a 16-bit TrueColor visual. If it cannot find that either, it looks for a 15-bit TrueColor visual. If it cannot find any of these, it stops the operation.

To get information about your visual or visuals and the color depth of each visual:

Related Topics

hiEnableBlink

hiIsBlinkEnabled

Starting Cadence Software


Return to top
 ⠀
X