Arguments for digestergui

The Digester software supports numerous arguments when started from the command line (e.g. from MS-​​DOS prompt). The following list shows an overview of the supported arguments, which can be viewed also directly in the program using the menu Help -> About Digester... (see Arguments tab). Here, also the currently used arguments are shown in the row below the argument list.

All supported options can be passed in any order, but the corresponding values ​​must be in place. All arguments are optional, input errors are detected as far as possible and compensated automatically. Either the program reports incorrect arguments directly or creates appropriate entries in the log file. 


Usage: digestergui [-options] <file>

Supported options include:

-help | -?            print this help message and exit
-configdir <value>    subdirectory of user's home for configuration
-files <file> ...     list of files to be checked
-headless             no GUI available, do not create dialogs
-locale <value>       set user locale (eng_US|ger_DE|...)
-logconsole           activates the console logging
-logenc <value>       set log encoding (ISO-8859-1|UTF-8|...)
-loglevel <value>     (SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST|ALL|OFF)
-logpipe              pipe stdout and stderr to the logger
-plaf <value>         pluggable look & feel
-theme <value>        theme for pluggable look & feel
-title                title of the main window
-urls <url> ...       list of network resources to be downloaded and checked
-version              print product version and exit

 

-help | -?

Print the list of supported arguments and terminates the application directly. You can use either -help or -?.

-configdir <value>

Sets the directory to use for storing the configuration of the Digester software. By default, the configuration files are stored within the directory .digester-1.6.x in the user's home directory. On Windows, for example C:\Documents and Settings\User\.digester-1.6.x

The directory will always be created within the user's home directory, the argument -configdir .digester for example forces storage in the directory C:\Documents and Settings\User\.digester. Specifying an absolute path to another drive is not possible.

-files <file> ...

Passes one or more files from the local filesystem to be checked by the Digester software. Here you can pass either message digest files or examinee files. The program recognizes the candidates for checking and automatically starts processing the available digests. The results can be viewed as usual within the Digester software.

Besides this parameter one single file can also be passed directly as a parameter without option. This feature is required to open message digest files directly from the operating system such as Windows. Please note that file associations are not available for all operating systems.

-headless

Starts the application in the command-line mode without calling any functions of the graphical user interface (GUI). This argument can be used under Linux/UNIX for example, if starting the program from a SSH shell causes X server messages like the following being created (e.g. if the arguments should only be listed):

    X connection to localhost:10.0 broken (explicit kill or server shutdown). 

-locale <value>

Sets the user language based on ISO 639-1/639-2 language codes and ISO 3166-1 country codes. Possible values are eng_US (language = English, country = U.S.A.), ger_DE (language = German, country = Germany) etc. If the specified language is not supported, the application falls back to the previous language. If this is not possible, eng_US is used since this is the default language for the Digester software.

-logconsole

Enables the logging using the command line. By default only the log file is written. If desired, the log messages can also be printed via the command line using this parameter.

-logenc <value>

Sets the character set for logging. Possible values are ISO-8859-1 (default) or UTF-8. You can use any of the supported encodings here. The list of available charsets can be viewed directly from the program by activating the Help -> About Digester... menu (see the Encodings tab).

-loglevel <value>

Activates the log level in the sense of importance for the created log messages. Possible values are SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, ALL, and OFF. By default, the Digester software logs with the INFO level, but it may be useful to have a finer log level being enabled (e.g. CONFIG).

-logpipe

Enables forwarding the program output to the logging engine. Thus, all messages generated by the program are written to the log file. This setting usually makes sense, because important messages could be overlooked if the program is executed directly from the command line.

-plaf <value>

Sets the pluggable look & feel. The parameter value must be passed in full class notation like

    com.sun.java.swing.plaf.nimbus.NimbusLookAndFeel

for the new Nimbus look & feel of Java (version 1.6.0_10 or later). The list of available look & feels can be viewed directly from the program by activating the menu Help -> About Digester... (see tab Look & Feels). See also the -theme parameter.

-theme <value>

Sets the theme for the look & feel. Some look and feels provide support for so-called themes (a.k.a. skin). This parameter is only interpreted, if the -plaf parameter is passed as well (see above). Possible values for the look & feel

    javax.swing.plaf.metal.MetalLookAndFeel

to be passed as themes are for example the Default Metal and Ocean themes. The available themes for the supported look & feels can be viewed directly from the application by activating the menu Help -> About Digester... (see the Look & Feels tab). See also the -plaf parameter.

-title <value>

Sets the title of the Digester main window to the desired value. This may be useful if the Digester software is deployed using both Web Start and the installer variants simultaneously. Both applications are titled the same, so that a distinction becomes difficult. With this parameter, you can easily add terms such as "Web Start" to be able to distinguish the application versions.

-urls <url> ...

Passes one or more network files to be downloaded and checked by the Digester software. Here you can pass either digest files or alternatively original files. The program detects potential candidates for checking automatically and starts checking the contained digests. The results can be viewed as usual with the Digester software.

A directory is required here, where the files can be downloaded. You can setup this directory in the preferences with the following alternatives: 

 


Please keep in mind that the network functionality is not supported by the Basic Edition and the Standard Edition.

-version

Prints the current program version to standard output and terminates the program immediately.

Limitations of the Installer

The installer software version currently used for the Digester software does not support dynamic command line arguments, so that the default arguments need to be statically compiled and cannot be changed by the user. Nevertheless, it is possible to specify additional parameters.

Please start the Digester software and activate the menu Help -> About Digester... and see the Arguments tab for the parameters currently in use. These parameters cannot be changed at the moment, but the other parameters can be added to the parameter list as described above.

Please note, that the parameters -help/-? and -version causes the program to print some information to standard output which then terminates. Unfortunately, this output does not become visible for the current installer versions of the software. We are in contact with the manufacturer of the installer software so that the mentioned limitations may be fixed in the near future. Please consider not to use the parameters -help/-? and -version if not necessary.

Parameters for Web Start

Most of the above mentioned parameters can also be used for the Web Start installations of the software. All arguments can be used as HTTP parameters to be processed by the server logic which can then forward the desired configuration to your local installation (install additional JAR files etc.). A typical Web Start call using HTTP parameters looks as follows:

        http://jws.leisenfels.com:8080/digester-1.6.x/install.jnlp?logconsole&locale=ger_DE

In the example, the application is started with command line logging and German language enabled.

Please note, that the parameters -help/-? and -version causes the program to print some information to standard output which then terminates. Unfortunately, this output does not become visible unless the Web Start console is being activated. And even then, the application will be closed immediately, so that the messages are shown only for a few milliseconds. Please consider not to use the parameters -help/-? and -version when using the Web Start release of the Digester software.

Additional Links