You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: README.md
+16-18
Original file line number
Diff line number
Diff line change
@@ -2,11 +2,15 @@
2
2
An cross-platform file encryption tool with AE scheme extracted from XKCP(eXtended Keccak Code Package)
3
3
*[`Keyak`](https://github.com/XKCP/XKCP/blob/master/doc/Keyak-documentation.h), the authenticated encryption schemes River, Lake, Sea, Ocean and Lunar Keyak.This repo only extracts the OceanKeyak
4
4
5
-
# Dependencies
5
+
##Dependencies
6
6
7
-
## CMake
7
+
###CMake
8
8
9
-
Keyak requires CMake 3.10.0 or newer in order to take advantage of improved support. If you're using Ubuntu 18.04 or newer you should already have a suitable version. If you're using an older distribution (e.g. 16.04) you will need to install a compatible version of CMake yourself. Also, Keyak utilizes the libsodium api to generate unpredictable data, suitable for creating secret keys, so you should install [libsodium](https://download.libsodium.org/libsodium/releases/) into your system path if you are using linux distribution, or if you are using windows, you can type the following commad to set the sodium_DIR environment variable to point at the directory of pre-built libsodium from official website.
9
+
Keyak requires CMake 3.10.0 or newer in order to take advantage of improved support. If you're using Ubuntu 18.04 or newer you should already have a suitable version. If you're using an older distribution (e.g. 16.04) you will need to install a compatible version of CMake yourself.
10
+
11
+
### libsodium
12
+
13
+
Also, Keyak utilizes the libsodium api to generate unpredictable data, suitable for creating secret keys, so you should install [libsodium](https://download.libsodium.org/libsodium/releases/) into your system path if you are using linux distribution, or if you are using windows, you can type the following commad to set the sodium_DIR environment variable to point at the directory of pre-built libsodium from official website.
10
14
11
15
```cmd
12
16
set sodium_DIR path_to_pre-built_lib
@@ -18,7 +22,7 @@ To install libsodium on Linux:
18
22
sudo apt install libsodium-dev
19
23
```
20
24
21
-
# Build
25
+
##Build
22
26
23
27
Clone the code and change into the source code directory
24
28
@@ -29,39 +33,33 @@ git clone https://github.com/qnfm/Standalone-OceanKeyak && cd Standalone-OceanKe
29
33
If you have downloaded the ninja_build binary on Windows, the build command is:
The binary is located in the cmake-build-debug/Release|Debug directory on Windows and cmake-build-debug/ directory on linux
51
+
The binary is located in the build/ directory
48
52
49
-
# Usage
53
+
##Usage
50
54
51
-
To encrypt, you simply need to provide thepath to the filename, remember to keep the generated two files safely and secretly. If you lose these two file (one with .key surfix and the other with .Keyak surfix), the original file will be lost forever!
55
+
To encrypt, you simply need to provide the path to the filename, remember to keep the generated two files (one with `.key` surfix is the secret key and the other with `.Keyak` surfix is the encrypted file) safely and secretly. If you lose these two file , the original file will be lost forever!
52
56
53
-
```
57
+
```bash
54
58
Keyak file_to_be_encrypted
55
59
```
56
60
57
61
To decrypt, put the two output files at the same directory and simply call:
58
62
59
-
```
63
+
```bash
60
64
Keyak path_to_key.key path_to_ciphertext.Keyak
61
65
```
62
-
63
-
# Under which license is the XKCP distributed?
64
-
65
-
Most of the source and header files in the XKCP are released to the **public domain** and associated to the [CC0](http://creativecommons.org/publicdomain/zero/1.0/) deed. The exceptions are the following:
66
-
67
-
*[`brg_endian.h`](lib/common/brg_endian.h) is copyrighted by Brian Gladman and comes with a BSD 3-clause license;
0 commit comments