aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
blob: c0f85a51758b1c3918f111a4e8456c3c0dbfc1b3 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
# AES tools

Simple AES implementation and utilities.

## Development

### Prerequisites

* Boost.Filesystem, Boost.Program_options and Boost.System

### Building the utilities

Create the build files using CMake and build using your native build tools
(Visual Studio/make/etc.).

For example, using Visual Studio 2013 Update 4 for Windows Desktop (targetting
x86 and using static Boost libraries):

    > cd
    C:\workspace\personal\build\aes-tools

    > cmake -G "Visual Studio 12 2013" ^
        -D BOOST_ROOT=C:\workspace\third-party\boost_1_58_0 ^
        -D Boost_USE_STATIC_LIBS=ON ^
        C:\workspace\personal\aes-tools
    ...

    > msbuild aes-tools.sln
    ...

## Usage on older CPUs

To run the executables that are using the AES-NI instruction set on a CPU
without the support for these instructions, you can use [Intel Software
Development Emulator].
After you install the emulator, you can run an executable like this:

    > sde -- encrypt_block.exe -a aes128 -m ecb -- 000102030405060708090a0b0c0d0e0f 00112233445566778899aabbccddeeff
    69c4e0d86a7b0430d8cdb78070b4c55a

[Intel Software Development Emulator]: https://software.intel.com/en-us/articles/intel-software-development-emulator

## Documentation

You can generate the docs using [Doxygen].
The docs will be generated in the "doc/" directory under the project's root.

[Doxygen]: http://www.stack.nl/~dimitri/doxygen/

## Utilities

See [Utilities].

[Utilities]: utils/README.md

## Testing

See [Testing].

[Testing]: test/README.md

## License

This project, including all of the files and their contents, is licensed under
the terms of the MIT License.
See [LICENSE.txt] for details.

[LICENSE.txt]: LICENSE.txt