DVT VHDL IDE User Guide
Rev. 19.1.34, 11 October 2019

32.6.1 dvt.sh

The DVT IDE Launcher.

Usage

dvt.sh

dvt.sh -h[elp]

dvt.sh
   [-site site]
   [-workspace <dir>]
   [-import_workspace_settings <dir>]
   [-force_import_workspace_settings <dir>]
   [-dvt_log_location <file>]
   [-bg]
   [-options]
   [-eclipse_args <args>]
   [-heap_size <size>]
   [-stack_size <size>]
   [-eclipsespace <dir>]

Where:

 [-workspace <dir>]
    Path to the eclipse workspace (temporary eclipse directory).

 [-import_workspace_settings <dir>]
    Path to the eclipse workspace from which settings will be imported.
    Valid only with -workspace.

 [-force_import_workspace_settings <dir>]
    Same as -import_workspace_settings, but it will overwrite target workspace settings.
    Valid only with -workspace.

 [-eclipsespace <dir>]
    Path to a custom eclipse storage directory (instead of ~/.eclipse).

 [-dvt_log_location <file>]
    File where DVT output will be sent (e.g. /dev/null).
    Default /tmp/dvt_log_13686.

 [-bg]
    Launch DVT in background.

 [-options <option list>] (only in Linux)
   Comma separated list of options:
     disable_cairo                - do not Cairo advanced graphics library
     disable_xulrunner            - do not use included XULRunner
     disable_force_gtk2           - do not force Eclipse to use GTK2
     disable_gtk_theme            - do not use custom GTK2 themes generated through DVT
     disable_force_classic_theme  - do not force Eclipse to use the classic theme
     dump_allocated_swt_resources - dump allocated SWT resources when 'No more handles' error is thrown

 [-heap_size <size>] (only in Linux)
    Set the Java heap size (syntax is <N>[g|G|m|M|k|K])
    Default is 1024m for 32 bit OSs and 3072m for 64 bit OSs

 [-stack_size <size>] (only in Linux)
    Set the thread stack size, size syntax is <N>[g|G|m|M|k|K].
    Default is 1m for 32 bit OSs and 4m for 64 bit OSs

 [-eclipse_args <args>]
    Everything that follows this argument is passed to the eclipse executable as-is.
    THIS MUST BE THE LAST ARGUMENT OF THE COMMAND LINE

Examples

Start DVT without any option. You will be prompted for the workspace location.

$> dvt.sh

Start DVT with the maximum heap size of 4096 MB. You will be prompted for the workspace location.

$> dvt.sh -heap_size 4096m

Start DVT in the specified workspace.

$> dvt.sh -workspace /home/cristian/dvt/workspace

Start DVT in the specified workspace and use the specified eclipsespace for storing user-specific eclipse data, like for example plugins installed by user on top of a shared installation. By default this data is stored in /home/cristian/.eclipse.

$> dvt.sh -workspace /nfsdisk/cristian/dvt/workspace -eclipsespace /nfsdisk/cristian/dvt/eclipsespace

Start DVT with a custom configuration file. The default is /apps/amiq/dvt/eclipse/eclipse.ini. IMPORTANT NOTE: -eclipse_args must be the last argument of the command line

$> dvt.sh -eclipse_args --launcher.ini /nfsdisk/cristian/dvt/mydvt.ini

Start DVT without using the included XULRunner and without forcing the classic Eclipse theme

$> dvt.sh -options disable_xulrunner,disable_force_classic_theme