Skip to content

Commit a770701

Browse files
kojo1kojo1
committed
wolfSentry in Japanese
1 parent 90c81fb commit a770701

File tree

6 files changed

+818
-0
lines changed

6 files changed

+818
-0
lines changed

‎wolfSentry/Makefile‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,14 @@ SOURCES = chapter01.md \
1010

1111
PDF = wolfSentry-Manual.pdf
1212

13+
ifeq ($(DOC_LANG),JA)
14+
PDF = wolfSentry-Manual-jp.pdf
15+
DOXYFILE = Doxyfile-ja
16+
else
17+
PDF = wolfSentry-Manual.pdf
18+
DOXYFILE = Doxyfile
19+
endif
20+
1321
.PHONY: html-prep
1422
html-prep:
1523

‎wolfSentry/mkdocs-ja.yml‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
site_name: wolfSentry Manual
2+
site_url: https://wolfssl.com/
3+
docs_dir: build/html/
4+
site_dir: html/
5+
copyright: Copyright © 2022 wolfSSL Inc.
6+
nav:
7+
- "1. はじめに": index.md
8+
- "2. wolfSentryのビルド": chapter02.md
9+
- "3. wolfSentry API": chapter03.md
10+
- "4. wolfSentry の使用例": chapter04.md
11+
theme:
12+
name: null
13+
custom_dir: ../mkdocs-material/material
14+
language: en
15+
palette:
16+
primary: indigo
17+
accent: indigo
18+
font:
19+
text: roboto
20+
code: roboto mono
21+
icon: "logo.png"
22+
logo: logo.png
23+
favicon: logo.png
24+
feature:
25+
tabs: true
26+
extra_css: [skin.css]
27+
use_directory_urls: false

‎wolfSentry/src-ja/chapter01.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# はじめに
2+
3+
このマニュアルは、wolfSentry に組み込まれた侵入検知保護システム (IDPS) の技術ガイドとして書かれています。 wolfSentry を構築して開始する方法を説明し、構築オプション、機能、移植性の強化、サポートなどの概要を提供します。
4+
5+
## wolfSentry を選ぶ理由
6+
7+
wolfSentry は、サイズとリソースのオーバーヘッドの両方で非常に軽量ですが、組み込みのニーズに対して非常に強力な IDPS です。

‎wolfSentry/src-ja/chapter02.md‎

Lines changed: 147 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,147 @@
1+
# wolfSentryのビルド
2+
3+
wolfSentry は移植性を念頭に置いて作成されており、通常、ほとんどのシステムで簡単に構築できるはずです。 もしも
4+
wolfSentry の構築に問題がある場合は、遠慮なくサポート フォーラムを通じてサポートを求めてください。
5+
(<https://www.wolfssl.com/forums>) または [[email protected]](mailto:[email protected]) まで直接お問い合わせください。
6+
7+
## wolfSentry ソースコードの取得
8+
9+
wolfSentry の最新バージョンは、wolfSSL Web サイトから ZIP ファイルとしてダウンロードできます。
10+
11+
<https://www.wolfssl.com/download>
12+
13+
ZIP ファイルをダウンロードしたら、「unzip」コマンドを使用してファイルを解凍します。 ネイティブの行末を使用するには、
14+
unzip を使用する場合は、`-a` 修飾子を有効にします。 unzip のマニュアル ページから、`-a` 修飾子の機能は次のとおりです。
15+
説明された：
16+
17+
> [...] -a オプションを指定すると、zip で識別されるファイルがテキスト ファイル (zipinfo で「t」ラベルが付いているファイル) として識別されます。
18+
> リスト、'b' ではなく) そのように自動的に抽出され、行末を変換し、end-
19+
> ファイルの文字と、必要に応じて文字セット自体。 [...]
20+
21+
## 依存関係
22+
23+
デフォルトのビルドでは、wolfSentry は POSIX ランタイム、特にヒープ アロケータ、clock_gettime、stdio、セマフォ、および文字列 API に依存しています。 ただし、これらの依存関係は、さまざまなビルド時のオプションで回避できます。 特にレシピは
24+
25+
```sh
26+
make STATIC=1 SINGLETHREADED=1 NO_STDIO=1 EXTRA_CFLAGS='-DWOLFSENTRY_NO_CLOCK_BUILTIN -DWOLFSENTRY_NO_MALLOC_BUILTIN'
27+
```
28+
29+
少数の基本的な文字列関数のみに依存する libwolfsentry.a を生成します。 次に、アロケータと時間のコールバックを `struct で設定する必要があります
30+
`wolfsentry_init()` に供給される wolfsentry_host_platform_interface`。
31+
32+
## ビルドとテスト
33+
34+
GNU Make をサポートするプラットフォームでは、`make` を実行すると、通常どおり wolfSentry がビルドされます。 他のプラットフォームでは、`src` ディレクトリとその `json` サブディレクトリにある C ファイルを使用してコンパイルする必要があります。
35+
36+
テスト スイートをビルドして実行するには、`make -j test` または `make V=1 -j test` を詳細に使用できます。
37+
38+
39+
### ビルド オプション
40+
41+
`make` に追加できるいくつかのフラグと、ヘッダー ファイルまたは `CFLAGS` のいずれかでビルド時の定義として使用されるフラグがあります。 `make` フラグを使用するには、以下を使用できます。
42+
43+
```sh
44+
make SINGLETHREADED=1 EXTRA_CFLAGS='-DWOLFSENTRY_NO_CLOCK_BUILTIN'
45+
```
46+
47+
これらは、ビルド時に wolfSentry がビルドされる `wolfsentry_options.h` ファイルに保存されます。 `make` を使用していない場合は、次のテンプレートを使用してこのファイルを作成できます。
48+
49+
```c
50+
#ifndef WOLFSENTRY_OPTIONS_H
51+
#define WOLFSENTRY_OPTIONS_H
52+
53+
#endif /* WOLFSENTRY_OPTIONS_H */
54+
```
55+
56+
次の表に、可能なオプションを示します。
57+
58+
| | `make` オプション | 説明 |
59+
| | --------------| ------------|
60+
| | 'V' | 詳細な `make` 出力 |
61+
|| 例えば `make V=1 -j test`|
62+
| | `USER_MAKE_CONF` | 含めるユーザー定義の Makefile |
63+
|| 例えば `make -j USER_MAKE_CONF=Makefile.settings` |
64+
| | `SRC_TOP` | ソース コードの最上位ディレクトリ (デフォルトは「pwd -P」) |
65+
| | `BUILD_TOP`| 別の場所 (ソース ツリーの外部またはサブディレクトリ内) にアーティファクトを使用してビルドする |
66+
|| 例えば `make BUILD_TOP=./build -j test`|
67+
| | `デバッグ` | 使用するコンパイラ デバッグ フラグ (デフォルトは `-ggdb`) |
68+
| | オプティム | 使用するオプティマイザ フラグ (デフォルトは `-O3`) |
69+
| | `C_WARNFLAGS` | 使用する警告フラグ (デフォルト [^1] を参照) |
70+
| | NO_STDIO | プラットフォームに「STDIO」がありません |
71+
| | `NO_JSON` | JSON 構成サポートをコンパイルしないでください |
72+
| | `USER_SETTINGS_FILE`| インクルードする追加のヘッダー ファイル |
73+
| | `シングルヘッド` | シングル スレッドの使用にスレッド セーフ セマンティクスを使用しない |
74+
|| 例えば `make -j SINGLETHREADED=1 テスト` |
75+
| | `静的` | 静的バイナリをビルドする |
76+
| | 剥ぎ取られた | デバッグ シンボルのバイナリを削除 |
77+
| | `BUILD_DYNAMIC` | 動的ライブラリを構築 |
78+
| | `VERY_QUIET` | 非常に静かなビルドを有効にする |
79+
| | `TAR` | `make dist` の GNU tar バイナリへのパス。macOS では `gtar` に設定する必要があります |
80+
| | `バージョン` | コンパイルするバージョン番号 (デフォルトは [^2] を参照) |
81+
82+
[^1]: `-Wall -Wextra -Werror -Wformat=2 -Winit-self -Wmissing-include-dirs -Wunknown-pragmas -Wshadow -Wpointer-arith -Wcast-align -Wwrite-strings -Wconversion -Wstrict-prototypes -Wold-style-definition -Wmissing-declarations -Wmissing-format-attribute -Wpointer-arith -Woverlength-strings -Wredundant-decls -Winline -Winvalid-pch -Wdouble-promotion -Wvla -Wno-missing-field-initializers -Wno -bad-function-cast -Wno-type-limits` および GCC が使用されている場合は、`-Wjump-misses-init -Wlogical-op` の追加フラグが使用されます。
83+
84+
[^2]: `VERSION として定義:= $(shell git rev-parse --short=8 HEAD 2>/dev/null || echo xxxxxxxx)$(shell git diff --quiet 2>/dev/null | | [ $$? -ne 1 ] || echo "-dirty")`
85+
86+
87+
```
88+
| | プリプロセッサ マクロ | 説明 |
89+
| | ------------------- | ----------- |
90+
| | `WOLFSENTRY_NO_STDIO` | プラットフォームに「STDIO」がありません |
91+
| | `WOLFSENTRY_NO_JSON` | JSON 構成サポートをコンパイルしないでください |
92+
| | `WOLFSENTRY_USER_SETTINGS_FILE` | インクルードする追加のヘッダー ファイル |
93+
| | `WOLFSENTRY_SINGLETHREADED` | シングル スレッドの使用にスレッド セーフ セマンティクスを使用しない |
94+
| | `CENTIJSON_USE_LOCALE` | JSON パーサーはロケール依存の文字を使用する必要があります |
95+
| | `WOLFSENTRY_NO_PROTOCOL_NAMES` | 構成ファイルのプロトコル名のサポートを無効にする |
96+
| | `DEBUG_JSON` | JSON パーサーにデバッグ `printf()` を追加 |
97+
| | `WOLFSENTRY_NO_ERROR_STRINGS` | エラー文字列関数へのエラー コードを無効にする |
98+
| | `WOLFSENTRY_NO_MALLOC_BUILTINS` | 組み込みの malloc 関数を無効にする |
99+
| | `WOLFSENTRY_HAVE_NONGNU_ATOMICS` | アトミックは非 GNU です (`SINGLETHREADED` が設定されている場合は無視されます) |
100+
| | `WOLFSENTRY_NO_CLOCK_BUILTIN` | Bulitin 時間関数を使用しないでください |
101+
| | `WOLFSENTRY_LWIP` | wolfSentry は BSD ソケットではなく LWIP に対して構築されています |
102+
| | `FREERTOS` | FreeRTOS サポートでビルド |
103+
104+
### ビルドオプションの例
105+
106+
別のビルド場所から非標準の場所にインストールします。
107+
108+
```sh
109+
$make BUILD_TOP=./build INSTALL_DIR=/usr INSTALL_LIBDIR=/usr/lib64 インストール
110+
```
111+
112+
libwolfsentry.a をビルドし、さまざまなアナライザー (メモリとスレッド
113+
valgrind およびサニタイザー テストのフル バッテリー下でのテスト):
114+
115+
```sh
116+
$make -j check
117+
```
118+
119+
マルチスレッドをサポートせずに libwolfsentry.a をビルドしてテストします。
120+
121+
```sh
122+
$make -j SINGLETHREADED=1 test
123+
```
124+
125+
その他の使用可能な make フラグは、「STATIC=1」、「STRIPPED=1」、「NO_JSON=1」、および
126+
「NO_JSON_DOM=1」、および「DEBUG」、「OPTIM」、および「C_WARNFLAGS」のデフォルト値
127+
便利にオーバーライドすることもできます。
128+
129+
ユーザー提供の makefile プリアンブルを使用してビルドし、デフォルトをオーバーライドします。
130+
131+
```sh
132+
$make -j USER_MAKE_CONF=Makefile.settings
133+
```
134+
135+
(`Makefile.settings` には、`OPTIM := -Os` のような単純な設定を含めることができます。
136+
追加の規則と依存メカニズムを含む、複雑な makefile コード)。
137+
138+
可能な限り最小で最も単純なライブラリを構築します。
139+
140+
```sh
141+
make -j SINGLETHREADED=1 NO_STDIO=1 DEBUG= OPTIM=-Os EXTRA_CFLAGS='-DWOLFSENTRY_NO_CLOCK_BUILTIN -DWOLFSENTRY_NO_MALLOC_BUILTIN -DWOLFSENTRY_NO_ERROR_STRINGS -Wno-error=inline -Wno-inline'
142+
```
143+
144+
ユーザー設定を使用してビルドおよびテストします。
145+
146+
```sh
147+
$make -j USER_SETT

‎wolfSentry/src-ja/chapter03.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# wolfSentry API
2+

0 commit comments

Comments
 (0)