DVT VHDL IDE User Guide
Rev. 20.1.26, 30 July 2020

32.7.1 dvt.sh

DVT Eclipse IDE Launcher

Usage

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

  -help                                   Show this help.
  -bg                                     Launch DVT in background.
  -dvt_log_location <file>                Path to the log of stdout/sterr. Default is /tmp/dvt_log_<PID>.
  -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.
  -force_import_workspace_settings <dir>  Same as -import_workspace_settings, but it will overwrite target workspace settings.
  -eclipsespace <dir>                     Path to the Eclipse configuration and user area. Default is /home/user/.eclipse.
  -heap_size <size>                       Set the Java heap size (syntax is <N>[g|G|m|M|k|K]). Default is 3072m.
  -stack_size <size>                      Set the Java thread stack size (syntax is <N>[g|G|m|M|k|K]). Default is 4m.
  -options <option list>                  Comma separated list of options:
                                              disable_swt_auto_config      - do not use auto-config for SWT GTK version and SWT Browser engine
                                              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 SWT allocated resources when 'No more handles' error is thrown
  -eclipse_args <args>                    A list of eclipse.ini arguments to be passed directly to the Eclipse binary.
                                          To indicate the end of list use -- argument.
                                          See: http://wiki.eclipse.org/Eclipse.ini.

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/$USER/dvt/workspace

Start DVT in the specified workspace and use the specified Eclipse configuration and user area (plugins installed by user on top of a shared installation).
    $> dvt.sh -workspace /home/$USER/dvt/workspace -eclipsespace /path/to/$USER/dvt/eclipsespace

Start DVT with a custom configuration file. The default is $DVT_HOME/eclipse/eclipse.ini. 
    $> dvt.sh -eclipse_args --launcher.ini /home/$USER/dvt/eclipse.ini