Introduction to Using the "tomb" Command (with examples)

1. Creating a New Tomb

The command tomb dig -s 100 encrypted_directory.tomb is used to create a new tomb with an initial size of 100 MB. The tomb is a secure and encrypted storage directory that can be safely transported and hidden in a filesystem.

In this example, we create a new tomb named “encrypted_directory.tomb” with a size of 100 MB. This tomb can be used to securely store sensitive files or data that needs to be protected.

Example Output:

Creating tomb file encrypted_directory.tomb...
Size: 100 MB

2. Creating a Key File for a Tomb

The command tomb forge encrypted_directory.tomb.key is used to create a new key file that can be used to lock a tomb. The user will be prompted for a password for the key.

In this example, we create a new key file named “encrypted_directory.tomb.key” for locking the tomb “encrypted_directory.tomb”. This key file can be used to unlock and access the tomb in the future.

Example Output:

Creating key file encrypted_directory.tomb.key...
Enter password for the key: [password input]

3. Forcibly Creating a New Key for a Tomb

The command tomb forge encrypted_directory.tomb.key -f is used to forcefully create a new key for a tomb, even if the tomb isn’t allowing key forging due to swap.

In some scenarios, a tomb may prevent the creation of a new key due to security reasons like swapping the key in memory. However, in situations where key forging is necessary, the -f option can be used to forcefully create a new key file.

Example Output:

Creating key file encrypted_directory.tomb.key...
Forcing key creation...
Enter password for the key: [password input]

4. Initializing and Locking an Empty Tomb

The command tomb lock encrypted_directory.tomb -k encrypted_directory.tomb.key is used to initialize and lock an empty tomb using a key made with the forge command.

In this example, we initialize and lock an empty tomb named “encrypted_directory.tomb” using the key file “encrypted_directory.tomb.key” that was created earlier. This ensures that the tomb is secured and can only be accessed with the correct key.

Example Output:

Locking tomb encrypted_directory.tomb...
Using key file encrypted_directory.tomb.key
The tomb is now locked and secured.

5. Mounting a Tomb

The command tomb open encrypted_directory.tomb -k encrypted_directory.tomb.key is used to mount a tomb, using its key, and make it usable as a regular filesystem directory.

In this example, we mount the tomb “encrypted_directory.tomb” using its key file “encrypted_directory.tomb.key”. Once mounted, the tomb can be accessed and used as a regular directory for storing and retrieving files.

Example Output:

Mounting tomb encrypted_directory.tomb...
Using key file encrypted_directory.tomb.key
The tomb is now mounted at /media/encrypted_directory

6. Closing a Tomb

The command tomb close encrypted_directory.tomb is used to close a tomb. This command fails if the tomb is being used by a process.

In this example, we close the tomb “encrypted_directory.tomb”. If the tomb is not being used by any process, it will be closed successfully. Otherwise, an error will be displayed indicating that the tomb is still in use.

Example Output:

Closing tomb encrypted_directory.tomb...
Tomb closed successfully.

7. Forcefully Closing All Open Tombs

The command tomb slam all is used to forcefully close all open tombs and kill any applications using them.

In some cases, it may be necessary to forcefully close all open tombs, especially if there are applications or processes still using them. The slam command ensures that all open tombs are closed forcefully, terminating any associated processes.

Example Output:

Forcefully closing all open tombs...
All open tombs successfully closed.

8. Listing Open Tombs

The command tomb list is used to list all open tombs.

When working with multiple tombs, it can be useful to have a way to view all the currently open tombs. The list command displays a list of all open tombs, providing information such as the tomb file, mount point, and the associated key file.

Example Output:

Listing all open tombs...
--------------------------------
Tomb File: encrypted_directory.tomb
Mount Point: /media/encrypted_directory
Key File: encrypted_directory.tomb.key
--------------------------------

By using the different commands provided by the “tomb” command, users can effectively manage encrypted storage directories with ease and security. The examples above demonstrate various use cases, including creating new tombs, generating key files, locking and unlocking tombs, mounting and closing tombs, and managing multiple open tombs.