Arguments for digestercli

The command-line version of the Digester software supports numerous arguments to be passed. The following list shows an overview of the supported arguments. By passing one of the -check, -generate, -refresh, or -sync arguments the software is called in the according operational mode. Each mode has its own list of supported parameters which are discussed by the following acticles. This page describes the parameters supported by the digestercli application in general (all modes).

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. You can pass files, directories, or URLs to be processed as a space-separated list using the -targets argument.

 

Usage: digestercli [-options] -targets <file|directory|url> ...

Supported options include (type 'digestercli -? sync' to see the sync mode options):

-help | -? <mode>               print help and exit, modes: check, generate, refresh, sync
-bsdperdirectory                process BSD-compliant file per directory
-bsdpertarget                   process BSD-compliant file per target
-calculateonly                  no files, just calculate
-check                          check message digest files
-checkbsd                       check for BSD files
-checkgnu                       check for GNU files
-checkintermediates             check intermediate message digests
-checkpgp                       check for PGP signature files
-checkxml                       check for Digester XML files
-checkxmlpgp                    check for Digester XML file signatures
-configdir <value>              subdirectory of user's home for configuration
-download                       download URLs and check, checked directly otherwise
-downloaddir <value>            directory to store downloads
-exponentialstart <value>       start creating XML intermediates at byte index
-extmd2 <value>                 file extension for MD2
-extmd4 <value>                 file extension for MD4
-extmd5 <value>                 file extension for MD5
-extpgp <value>                 file extension for PGP signatures
-extripemd128 <value>           file extension for RIPEMD-128
-extripemd160 <value>           file extension for RIPEMD-160
-extripemd256 <value>           file extension for RIPEMD-256
-extripemd320 <value>           file extension for RIPEMD-320
-extsha1 <value>                file extension for SHA-1
-extsha224 <value>              file extension for SHA-224
-extsha256 <value>              file extension for SHA-256
-extsha384 <value>              file extension for SHA-384
-extsha512 <value>              file extension for SHA-512
-exttiger <value>               file extension for Tiger
-extwhirlpool <value>           file extension for Whirlpool
-extxml <value>                 file extension for Digester XML
-failonerror                    exit if an error occurs
-flipsourcetarget <set>         reverse mode: transfer from target set to source
-generate                       generate message digests
-gensrctemplate <template>      execute generate template before sync (source set)
-gensrctemplaterefresh          execute template in refresh mode (source set)
-gentemplate <set> <template>   execute generate template before sync (named target set)
-gentemplaterefresh <set>       execute template in refresh mode (named target set)
-gnuperdirectory                process MD5SUM-compliant file per directory
-gnupertarget                   process MD5SUM-compliant file per target
-headless                       no GUI available, do not create dialogs
-hexcase <value>                format of hexadecimal digests (lower|upper)
-ignoredigests                  do not generate digests for digest files
-ignoreregex <value>            regular expression for files to be ignored
-includeregex <value>           regular expression for files to be included
-locale <value>                 set user locale (eng_US|ger_DE|...)
-maxintermediates <value>       limit the number of XML intermediates
-md2                            process MD2 message digests
-md4                            process MD4 message digests
-md5                            process MD5 message digests
-optdigest                      digests for source and target match
-optfilesize                    source/target file sizes match
-optintermediate                intermediates for source and target match
-optpgpsig                      PGP signatures for source and target match
-opttimestamp                   source/target timestamps match
-optxmlentryfilesize            XML entry file sizes match source and target
-optxmlentrytimestamp           XML entry timestamps match source and target
-overwrite                      overwrite existing files
-pgpformat <value>              write binary or ASCII PGP signature files (ascii|binary)
-pgpkey <ID> <URL>              use PGP key with ID (required) and URL (optional)
-pgpkeydownload                 automatically download unknown PGP keys
-pgpkeyignore                   ignore signatures for unknown PGP keys
-pgpkeyinstall                  install downloaded PGP keys permanently
-pgppertarget                   process PGP signature file per target
-pgpversion <value>             version header for PGP signatures
-refresh                        refresh message digest files
-refreshallformats              search files in all formats for existing digests
-refreshgnubsdtimestamp         recycle digest if GNU/BSD file timestamp matches
-refreshignoremissing           recycle digest although intermediates are missing
-refreshpgptimestamp            recycle digest if PGP signature file timestamp matches
-refreshremoveartifacts         delete message digest files without targets
-refreshremoveother             delete message digest files in other formats
-refreshxmltimestamp            recycle digest if XML file timestamp matches
-refreshxmlentryfilesize        recycle digest if target XML entry file size matches
-refreshxmlentrytimestamp       recycle digest if target XML entry timestamp matches
-ripemd128                      process RIPEMD-128 hash files
-ripemd160                      process RIPEMD-160 hash files
-ripemd256                      process RIPEMD-256 hash files
-ripemd320                      process RIPEMD-320 hash files
-sha1 | sha                     process SHA-1 hash files
-sha224                         process SHA-224 hash files
-sha256                         process SHA-256 hash files
-sha384                         process SHA-384 hash files
-sha512                         process SHA-512 hash files
-sourcetimestamp                apply source file timestamps to target files
-stoponmismatch                 stop calculation on intermediate mismatch
-subdirectories                 include subdirectories
-summaryfile <value>            name of the directory files without extension
-sync                           synchronize files and directories with message digests
-syncgnubsdtimestamp            trust digests if file timestamp matches (GNU/BSD)
-syncmapping <value>            use sync mapping options as defaults
-syncpgptimestamp               trust signatures if file timestamp matches (PGP)
-syncxmlentryfilesize           trust digests if XML entry file size matches
-syncxmlentrytimestamp          trust digests if XML entry timestamp matches
-syncxmltimestamp               trust digests if file timestamp matches (XML)
-template <value>               use template options as defaults
-tiger                          process Tiger hash files
-timestamp                      apply target file timestamps for generated files
-transferall                    transfer all sources without optimization
-verbose                        print additional messages
-whirlpool                      process Whirlpool hash files
-version                        print product version and exit
-xmlabsolutepaths               add absolute paths for Digester XML files
-xmladdurls                     add URL elements for Digester XML files
-xmlcomment <value>             comment for Digester XML files
-xmldigestformat <value>        format of XML file digests (hex|base64)
-xmlintermediates <value>       create XML intermediates (linear|exponential)
-xmllinearevery <value>         create XML intermediates every n bytes
-xmlperdirectory                process Digester XML file per directory
-xmlpertarget                   process Digester XML file per target
-xmlpgp                         add PGP signatures for Digester XML files
-xmlpgpkeyid                    add PGP key IDs for Digester XML files
-xmlpgpkeyname                  add PGP key names for Digester XML files
-xmlpgpkeyemail                 add PGP key eMail addresses for Digester XML files
-xmlpgpkeyurl                   add PGP key network addresses for Digester XML files
-xmlurl <value>                 URL address to be added, see xmladdurls

 

-help | -? <Modus>

Print the list of supported arguments and terminates the application directly. You can use either -help or -?. Please add one of the check, generate, refresh, or sync arguments to get the list of supported arguments for the check, generate, refresh, or sync mode of the software.

-configdir <Wert>

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.

-failonerror

If an error occurs during processing then the program terminates automatically. This may take a while depending on the application state or processed task. This parameter is useful especially when the software is being executed from Ant build scripts.

-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 <Wert>

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.

-version

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

Additional Links