aboutsummaryrefslogblamecommitdiffstatshomepage
path: root/README.md
blob: 7318f2929ceac6ee9e20b0923f48df99b1bc92de (plain) (tree)
1
2
3
4
5
6
7
8
9

         
 
                                        
 

             
 
                                                                          
                                           
 



                        

        
 

                                                                          
 







                                                                              

                                        


                                       
                           
       
 

                   
 


                                                                         
                                                                    
 
                                                                                                                

                                    

                                                                                                                    

        
 

             
 
                            

                         

       
 
                                  

                              
                          
AES tools
=========

Simple AES implementation and utilities.

Prerequisites
-------------

To build the solution, you first need to build a few of Boost's libraries.
The complete list of Boost dependencies is:

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

Building
--------

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    ^
        -D Boost_USE_STATIC_RUNTIME=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 -a aes128 -m ecb -- 000102030405060708090a0b0c0d0e0f 00112233445566778899aabbccddeeff
    69c4e0d86a7b0430d8cdb78070b4c55a

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

See also
--------

* [Utilities]
* [Testing]

[Utilities]: utils/README.md
[Testing]: test/README.md

License
-------

Distributed under the MIT License.
See [LICENSE.txt] for details.

[LICENSE.txt]: LICENSE.txt