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
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.
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.
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.
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).
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.
Prints the current program version to standard output and terminates the program immediately.