decrypt-file command

The decrypt-file command returns an encrypted file back to its original unencrypted format.

To use this command, the OpenSSL libraries must be installed on your system.
  • For UNIX Implementations: The OpenSSL libraries are required.

    If this command is run on a system without OpenSSL, the current process will stop and return to TCL. Additionally, you will see the Encryption libraries are not loaded message.

  • For Windows Only: The OpenSSL libraries must be present when restoring a save that contains encrypted data. Otherwise, the restore process will terminate.

Syntax

 decrypt-file filename{,data-file}

Parameter(s)

filename The name of the file on which to remove encryption.

To remove encryption, you must be logged into the account in which the specified file exists.

data-file (Optional) Specifies which data-file in the file to decrypt.

If not specified, the default data-file is decrypted.

Description

If the encrypt processing code is on the file-defining item, then only the specified attributes will be encrypted and available for decryption.

Example(s)

Example 1

This example decrypts the locations file.

The dictionary-code field has the entry of D, which indicates that the file is no longer encrypted.

 :decrypt-file locations 
 File successfully decrypted.
 :ud locations

 DICT locations  'locations' size = 57
 dictionary-code    D
 base               18652
 modulo             1
 structure
 retrieval-lock
 update-lock
 output-conversion
 correlative
 attribute-type     L
 column-width       10
 input-conversion
 macro
 output-macro
 description
 reallocation
 segment-base segment-mod
 
 hotkey.all
 hotkey1
 hotkey2
 hotkey3
 hotkey4
 hotkey5
 hotkey6
 hotkey7
 hotkey8
 hotkey9
 hotkey0
 DICT locations  'locations' size = 57 exited.
 :dump 18652

  fid:   18652 :   0      0      0   0  (   48DC :  0       0       0  0 )
 000 :....c...WHSE1^Main warehouse^77 Fourth Avenue^Walt:
 050 :ham^MA^02451^Chris Wingman^3737968345^3737961123^_:
 100 :....g...WHSE2^Secondary warehouse^2200 Powell St.^:
 150 :Emeryville^CA^94608^Mark Allen^6509848989^65098433:
 200 :34^_....c...WHSE3^Tertiary Warehouse^2 Venture Pla:
 250 :za^Irvine^CA^92618^Fred Bloggs^3335551234^33355512:
 300 :36^__43334^__61123^__]...K^__^3737961123^__......G:
 350 :r7..]C...tu.^_____________________________________:
 400 :__________________________________________________:
 450 :__________________________________________________:
 500 :__________________________________________________:
 550 :__________________________________________________:
 600 :__________________________________________________:
 650 :__________________________________________________:
 700 :__________________________________________________:
 750 :__________________________________________________:
 800 :__________________________________________________:
 850 :__________________________________________________:
 900 :__________________________________________________:
 950 :__________________________________________________:
 1000 :__________________________________________________:
 1050 :__________________________________________________:
 1100 :__________________________________________________:
 1150 :__________________________________________________:
 1200 :__________________________________________________:
 1250 :__________________________________________________:
 1300 :__________________________________________________:
 1350 :__________________________________________________:
 1400 :__________________________________________________:
 1450 :__________________________________________________:
 1500 :__________________________________________________:
 1550 :__________________________________________________:
 1600 :__________________________________________________:
 1650 :__________________________________________________:
 1700 :__________________________________________________:
 1750 :__________________________________________________:
 1800 :__________________________________________________:
 1850 :__________________________________________________:

Example 2

This example decrypts the accounting file.

 decrypt-file accounting
 File successfully decrypted.
 

Example 3

This example decrypts only the purchases data-file of the accounting file.

 decrypt-file accounting,purchases
 File successfully decrypted.