NAME

SYNOPSIS

DESCRIPTION

cipherProc configure ?options?

Configure the settings for the gromark cipher. Valid options are:

cipherProc configure -ciphertext string

cipherProc configure -ct string

Set the ciphertext for this cipher instance to string. Invalid letters or numbers in the ciphertext are silently discarded.

cipherProc configure -period n

Set the period for this cipher to n.

cipherProc configure -language language

This option is currently ignored for all cipher types. Set the current cipher language to language. If the cipher has a solve method then digram frequencies for this language are used to determine the best fit. If the language is not specified or not known then english is used.

cipherProc configure -primer n

cipherProc configure -chain n

cipherProc configure -stepinterval n

Set the display interval while solving to n. The stepcommand procedure will be called for every nth iteration while solving. This is used to provide user feedback while solving is taking place.

cipherProc configure -stepcommand proc

Set the display command while solving to proc. This command will be called for every nth iteration while solving. The arguments for this procedure are:

stepcommand iter key pt

iter is the current iteration number. key is the current value of the key that is being used. pt is the plaintext that is produced with this key.

cipherProc configure -bestfitcommand proc

Set the best fit display command while solving to proc. This command will be called every time a better solution is found while autosolving. The arguments for this procedure are:

bestfitcommand iter key value pt

iter is the current iteration number. key is the current value of the key that is being used. value is the value of the metric used to judge how good this solution is. The value is often a digram or trigram frequency count. pt is the plaintext that is produced with this key.

cipherProc cget option

Look up the value for a given option. Valid options are:

cipherProc cget -type

Returns the type of this cipher. In this case, gromark

cipherProc cget -ciphertext

cipherProc cget -ct

Return the ciphertext for this cipher.

cipherProc cget -plaintext

cipherProc cget -pt

Return the plaintext for this cipher based on the current key setting.

cipherProc cget -key

Returns the current key setting for this cipher. The result can be passed back to this cipher instance or another cipher with the cipherProc restore subcommand.

cipherProc cget -keyword

Returns the keyword for this cipher based on the current key.

cipherProc cget -length

Returns the length of the ciphertext for this cipher. 0 is returned if the ciphertext has not been set.

cipherProc cget -period

Return the period for this cipher.

cipherProc cget -primer

Undocumented feature.

cipherProc cget -offset

Undocumented feature.

cipherProc cget -chain

Undocumented feature.

cipherProc cget -stepinterval

Returns the current value of the stepinterval.

cipherProc cget -stepcommand

Returns the name of the procedure currently set for the stepcommand. An empty string is returned if no stepcommand is set.

cipherProc cget -bestfitcommand

Returns the name of the procedure currently set for the bestfitcommand. An empty string is returned if no bestfitcommand is set.

cipherProc cget -language

Returns the name of the language used for this cipher.

cipherProc substitute ct pt

Perform substitutions on the cipher.

cipherProc chainsubstitute ct position

Set the position-th letter in the chain.

cipherProc restore ct pt

Restore a gromark from a saved key.

cipherProc undo ct

Undo the substitutions of the letters in the ct argument.

cipherProc locate pt ?ct?

Drag a tip across the ciphertext until the first valid tip placement is found. If the ct parameter is set then the tip dragging will start at the matching position in the ciphertext.