diff --git a/wolfSSL/src-ja/chapter02.md b/wolfSSL/src-ja/chapter02.md index 5ed9d2f6..7bb33461 100644 --- a/wolfSSL/src-ja/chapter02.md +++ b/wolfSSL/src-ja/chapter02.md @@ -149,6 +149,41 @@ cd wolfSSL make make check ``` +## 各社IDEによるビルド + +wolfSSLサイトからwolfSSLソースコード一式をダウンロード、解凍して以下の設定をします。 + +### 1. wolfSSLライブラリー生成プロジェクト +- コンパイル対象のソースファイルの登録 +./srcの下の*.cファイルと./wolfcrypt/srcの*.cファイル一式を登録します。 +ただし、以下のファイルを除きます。 + +``` +./src/ssl_*.c, ./src/x509_*.c, +src/conf.c, src/bio.c +wolfcrypt/src/misc.c, ./wolfcrypt/src/evp.c +``` + +- コンフィグレーションオプションの定義 +ファイル名 "user_settings.h" のヘッダーファイルにコンフィグレーション定義を格納します。 + +wolfssl/examples/configs/README.md, user_settings_template.h を参照してください。 + +- プリディファインドマクロ名の登録 +WOLFSSL_USER_SETTINGS を定義すると、ビルド時に上記のuser_setttings.hファイルがインクルードされます。 + +- インクルードパスの登録 +wolfSSLソースファイルルートのパスと上記user_settings.hのパスを登録します。 + + +### 2. アプリケーション実行ファイル生成プロジェクト + +- 1.で生成したwolfSSLライブラリーをリンク対象として登録します。wolfSSLソースファイルルートのパスと +- 1. で定義したコンフィグレーションオプション(user_settings.h)のパスを + インクルードパスとして登録します。 +- プリディファインドマクロ名として"WOLFSSL_USER_SETTINGS "を指定します。 +- アプリケーションのプログラム先頭付近で "wolfssl/wolfcrypt/settings.h" をインクルードします。 + ## 非標準環境でのビルド diff --git a/wolfSSL/src/chapter02.md b/wolfSSL/src/chapter02.md index 7d235a39..ccfc5655 100644 --- a/wolfSSL/src/chapter02.md +++ b/wolfSSL/src/chapter02.md @@ -129,6 +129,44 @@ make make check ``` +## Building with Various Vendor IDEs + +Download the complete wolfSSL source code package from the wolfSSL website, extract it, and apply the following settings. + +### 1. wolfSSL Library Build Project + +- **Register source files to be compiled** + Register all `*.c` files under `./src` and all `*.c` files under `./wolfcrypt/src`. + Exclude the following files: + +./src/ssl_.c, ./src/x509_.c, +src/conf.c, src/bio.c +wolfcrypt/src/misc.c, ./wolfcrypt/src/evp.c + +- **Define configuration options** +Store the configuration definitions in a header file named `user_settings.h`. + +Refer to: +- `wolfssl/examples/configs/README.md` +- `wolfssl/examples/configs/user_settings_template.h` + +- **Register predefined macro names** +When `WOLFSSL_USER_SETTINGS` is defined, the above `user_settings.h` file is included at build time. + +- **Register include paths** +Register the path to the wolfSSL source file root and the path to the above `user_settings.h`. + +--- + +### 2. Application Executable Build Project + +- Register the wolfSSL library generated in step 1 as a link target. +- Register the wolfSSL source file root path and the configuration option path (`user_settings.h`) defined in step 1 as include paths. +- Specify `"WOLFSSL_USER_SETTINGS"` as a predefined macro name. + + + + ## Building in a non-standard environment While not officially supported, we try to help users wishing to build wolfSSL in a non-standard environment, particularly with embedded and cross-compilation systems. Below are some notes on getting started with this.