Switches

<< Click to Display Table of Contents >>

Navigation:  CryptoForge Files > Command-Line Interface >

Switches

Main Switches

/sa:<Leave | Delete | Shred> (Can be used with commands: /e, /d)

Specifies which action to perform on source files after executing the task. For example, after encrypting a file (this means after creating a new file which is an encrypted version of the source file) you may want to have the source file shredded, which is the same two-step process that takes place when you right-click a file and choose Encrypt from the context menu. You may also prefer to leave the original file as it is and keep both versions (same as Encrypt Copy Here), or delete the file in the standard way. When decrypting a file, on the other hand, you will normally not shred the source file, because there is no need to shred an encrypted file unless the password has been put at risk. Needless to say, if for some reason the primary task were not successful, source files would always remain untouched. By default (i.e. if you do not include this switch), CryptoForge will leave files as they are.

Examples:

a) Encrypt C:\MyDocs\Sensitive.xls and when done creating the encrypted file, shred the original one by overwriting it 6 times:
CFFiles /e /sa:Shred /passes:6 C:\MyDocs\Sensitive.xls

b) Decrypt C:\MyDocs\Sensitive.xls.cfe and then delete it:
CFFiles /d /sa:Delete C:\MyDocs\Sensitive.xls.cfe

 

/nim (Can be used with commands: /e, /d, /w)

Enables the non-interactive server running mode. When this switch is specified, no dialog box will be displayed. Any questions that would otherwise be asked to the user are presumed to be answered as Yes, or Skip if an error occurs (or a wrong password is specified when decrypting). In non-interactive mode some optimizations naturally take place. Use this switch with caution for shredding files because the warning message will not appear at all. If this switch is specified, then the following switches are ignored: /sp /wbw. When encrypting or decrypting in non-interactive mode, you must specify a passphrase by using the /passw switch, otherwise the program will terminate indicating failure.

 

/td:<DirectoryName> (Can be used with commands: /e, /d)

By default, generated files are stored in the same directory as the sources. By including this switch, you instruct CryptoForge to create produced files in a specified directory. If the directory does not exist, it will be created.

Example:

Encrypt all the files in C:\MyDocs directory, leaving original files as they are, and store the encrypted versions in \\Server-1\MyName\MyBackups:
CFFiles /e /sa:Leave /td:\\Server-1\MyName\MyBackups C:\MyDocs

 

/passw:<YourPassphrase> (Can be used with commands: /e, /d)

Specifies the passphrase for encryption or decryption. Note that the passphrase is case sensitive. If it contains spaces, you must use double quotes to wrap the entire switch. If this switch is not included, then the Enter Passphrase dialog box will appear prompting the user to enter it. Note: Evaluation version passphrase is limited to 14 characters in length.

Example:

Decrypt all the files in \\Server-1\MyName\MyBackups directory and place recovered files in C:\MyDocs. Use "My SECRET Words" as the password and enable the non-interactive running mode:
CFFiles /d /nim /td:C:\MyDocs "/passw:My SECRET Words" \\Server-1\MyName\MyBackups

 

/lf:<file_name> (Can be used with commands: /e, /d, /w)

Specifies the name of a text file that contains the list of files, folders, or disks, to be processed. Just make sure that each of your items in the list is on its own line. You may specify both usual file names and a list file in the same command-line. When the command-line is executed, CryptoForge loads the list file, reads the items, and performs the specified task on them.

Example:

Create encrypted versions of all the items in the list file C:\My Documents\backup list.txt and store them in \\Server-2\Backups\MyName:
CFFiles /e /td:\\Server-2\Backups\MyName "/lf:C:\My Documents\backup list.txt"

 

/lofr (Can be used with commands: /e, /d, /w)

This switch instructs CryptoForge to perform the task employing the common options that the current user has set in the Properties dialog box. In other words, the program will read the options from the Windows registry in the HKEY_CURRENT_USER key. When this switch is specified, the following switches are ignored: /efn, /subf, /dc, /cl, /acfe, /passes, /sp, /alg, /ssf, /wbw.

 

Common Options Switches

/efn (Can be used with commands: /e)

This switch corresponds to the Encrypt filename option.

 

/subf (Can be used with commands: /e, /d, /w)

This switch corresponds to the Include subfolders option.

 

/dc (Can be used with commands: /e)

Specifying this switch is the opposite of the Compress before encryption option. This switch deactivates compression, which is activated by default.

 

/cl:<Level> (Can be used with commands: /e)

Specifies the compression level, from 1 to 4. This switch is ignored if the /dc switch is included. Default level is 1, which gives the best speed.

Example:

Encrypt C:\MyDocs\MySensitive.doc using the highest compression level:
CFFiles /e /cl:4 C:\MyDocs\MySensitive.doc

 

/acfe:<Extension1,ExtensionN> (Can be used with commands: /e)

This switch corresponds to the list of already-compressed file extensions. Every extension in the list must include the leading dot. This switch is ignored if the /dc switch is included. By default, the program attempts to compress all file types.

Example:

Encrypt C:\MyDocs directory and, to optimize speed, do not try to compress .zip, .rar, and .cab archives:
CFFiles /e /acfe:.zip,.rar,.cab C:\MyDocs

 

/passes:<Number_of_Passes> (Can be used with commands: /e, /d, /w)

Specifies the number of times that CryptoForge overwrites files when shredding, from 1 to 99. Default number of passes is 1. Files are shredded both when you use the /w command, or the /sa:Shred switch.

Example:

a) Shred all the files in C:\MyTrash overwriting them 8 times:
CFFiles /w /passes:8 C:\MyTrash

b) Encrypt C:\MyDocs and shred source files 7 times:
CFFiles /e /sa:Shred /passes:7 C:\MyDocs

 

/sp (Can be used with commands: /e, /d, /w)

This switch corresponds to the Show progress window option. It is ignored when running in non-interactive mode.

 

/alg:<AlgorithmName> (Can be used with commands: /e)

Specifies the algorithm(s) used for encryption. Valid names are: Blowfish, Rijndael, TripleDES, and Gost. If you wish to encrypt with more than one algorithm at the same time, then separate their names with comma characters. Default algorithm is Blowfish.

Example:

a) Encrypt C:\MyDocs with Rijndael:
CFFiles /e /alg:Rijndael C:\MyDocs

b) Encrypt C:\MyDocs and D:\MyImages with TripleDES and Blowfish:
CFFiles /e /alg:TripleDES,Blowfish C:\MyDocs C:\MyImages

 

/ssf (Can be used with commands: /e, /w)

This switch corresponds to the Skip system files option.

 

/wf (Can be used with commands: /w)

This switch corresponds to the Shred folders option.

 

/wbw (Can be used with commands: /w)

This switch corresponds to the Display a warning message before shredding option. It is ignored when running in non-interactive mode.

 

To learn how to determine whether the task has succeeded or not, see:

Return Values