# 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.
```

## See also

- [encrypt processing code](https://d3codex.com/processingcodes/encrypt-processing-code/)
- [encrypt-file command](https://d3codex.com/tcl/encrypt-file-command/)

---
Source: https://d3codex.com/tcl/decrypt-file-command/ - part of the D3Codex reference.