Skip to content

Commit

Permalink
update readme to include how to install from cargo
Browse files Browse the repository at this point in the history
  • Loading branch information
radumarias committed Apr 19, 2024
1 parent 6e1865f commit e368f55
Show file tree
Hide file tree
Showing 3 changed files with 12 additions and 9 deletions.
2 changes: 1 addition & 1 deletion Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[package]
name = "encrypted_fs"
description = "An encrypted file system that mounts with FUSE on Linux. It can be used to create encrypted directories."
version = "0.1.18"
version = "0.1.19"
edition = "2021"
license = "MIT OR Apache-2.0"
authors = ["Radu Marias"]
Expand Down
17 changes: 10 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,16 @@ Crate [encrypted_fs](https://crates.io/crates/encrypted_fs) on crates.io.

# Usage

You can use it as a command line tool to mount an encrypted file system. or directly using the library to build your own binary.
You can use it as a command line tool to mount an encrypted file system. or directly using the library to build your own binary (for library, you can follow the [documentation](https://docs.rs/encrypted_fs/latest/encrypted_fs/)).

## Library
## Command Line Tool

For using the library, you can follow the [documentation](https://docs.rs/encrypted_fs/latest/encrypted_fs/).
## Installation

## Command Line Tool
You can install the encrypted file system binary using the following command:
```bash
cargo install encrypted_fs
```

To use the encrypted file system, you need to have FUSE installed on your system. You can install it by running the following command (or based on your distribution):
```bash
Expand All @@ -37,7 +40,7 @@ This offers the possibility to change the password without needing to decrypt an
This is done by decrypting the key with the old password and re-encrypting it with the new password.

To change the password, you can run the following command:
```
```bash
encrypted_fs --change-password --data-dir DATA_DIR
```
Where `DATA_DIR` is the directory where the encrypted data is stored.\
Expand All @@ -47,7 +50,7 @@ It will prompt you to enter the old password and then the new password.

You can specify the encryption algorithm and derive key hash rounds adding these arguments to the command line:

```
```bash
--cipher CIPHER --derive-key-hash-rounds ROUNDS
```
Where `CIPHER` is the encryption algorithm and `ROUNDS` is the number of rounds to derive the key hash.\
Expand All @@ -58,6 +61,6 @@ Default values are `ChaCha20` and `600_000` respectively.
### Log level
You can specify the log level adding the `--log-level` argument to the command line. Possible values: `TRACE`, `DEBUG`, `INFO` (default), `WARN`, `ERROR`.

```
```bash
--log-level LEVEL
```

0 comments on commit e368f55

Please sign in to comment.