WolfSSL
/
wolfcrypt-py
mirror of https://github.com/wolfSSL/wolfcrypt-py.git
1
0
Fork 0
Code Issues Releases Wiki Activity
wolfcrypt-py/windows
History
Hayden Roche 352219fc87 Make several improvements to the CFFI build process. 
- Move _build_ffi.py to scripts/build_ffi.py. Do as little in the global
namespace of the script as possible by putting functionality into functions,
including a new main function.
- Improve feature detection by allowing user_settings.h in addition to
options.h. This is particularly useful on Windows.
- Add the windows directory. This contains subdirectories non_fips and
fips_ready, which each have a user_settings.h. The non_fips user_settings.h is
used by the build script to build on Windows with CMake, when not using
USE_LOCAL_WOLFSSL. The fips_ready user_settings.h is an example user_settings.h
that works with our FIPS Ready code and wolfcrypt-py.
- Improve Windows support. This commit modifies the way we build wolfSSL for
wolfcrypt-py on Windows. Instead of using CMake directly, we use it with
user_settings.h. This is typically how Windows users are building wolfSSL, and
it gets around some shortcoming of wolfSSL's CMake support (e.g. not all
required features are supported). Additionally, USE_LOCAL_WOLFSSL now works
properly on Windows. When using USE_LOCAL_WOLFSSL, it should point to a wolfSSL
source code directory. This works for FIPS bundles, too. Finally, for FIPS on
Windows, we only support DLL builds. The CFFI library (.pyd extension) requires
this DLL to work. build_ffi.py detects this scenario and copies the .dll into
the wolfcrypt package directory. I've modified setup.py to distribute the
.dll with the package.
- Add some missing FIPS gates. Testing against FIPS v2 triggered some errors.
Those are fixed in this commit.
 		2022-11-03 14:56:04 +01:00
..
fips_ready Make several improvements to the CFFI build process. 2022-11-03 14:56:04 +01:00
non_fips Make several improvements to the CFFI build process. 2022-11-03 14:56:04 +01:00
README.md Make several improvements to the CFFI build process. 2022-11-03 14:56:04 +01:00

README.md

Overview

This directory contains user_settings.h files that can be used to build wolfSSL on Windows for use with wolfcrypt-py. non_fips/user_settings.h is, as the name indicates, intended for non-FIPS builds. fips_ready/user_settings.h is for FIPS Ready builds. non_fips/user_settings.h is used by build_ffi.py when building wolfcrypt-py on Windows without USE_LOCAL_WOLFSSL. fips_ready/user_settings.h isn't used by build_ffi.py.

Non-FIPS

If building with our wolfssl64.sln Visual Studio solution, copy non_fips\user_settings.h into IDE\WIN in the wolfSSL directory, overwriting the existing user_settings.h. Build the solution, set the environment variable USE_LOCAL_WOLFSSL to point to the wolfSSL directory, and proceed with the wolfcrypt-py build/install (e.g. pip install . from the wolfcrypt-py directory).

FIPS Ready

The instructions are similar to the non-FIPS instructions. Copy fips_ready\user_settings.h into IDE\WIN10. Build the IDE\WIN10\wolfssl-fips.sln solution. Set the environment variable USE_LOCAL_WOLFSSL to point to the wolfSSL directory, and proceed with the wolfcrypt-py build/install (e.g. pip install . from the wolfcrypt-py directory).