wolftpm-src 0.1.0

Compile wolfTPM from source for use by wolftpm-sys
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

# wolftpm-src

Build-script crate that compiles [wolfTPM](https://github.com/wolfSSL/wolfTPM)
from C source for use by `wolftpm-sys`.

## wolfTPM source

`wolftpm-src` requires the wolfTPM C source tree.  Two ways to supply it:

### Option 1: Environment variable (recommended for development)

```sh
export WOLFTPM_SRC=/path/to/wolfTPM
cargo build -p wolftpm-sys
```

### Option 2: Bundled submodule (for building without a local clone)

```sh
git submodule update --init wolftpm-src/wolftpm
cargo build -p wolftpm-sys
```

## wolfSSL dependency

wolfTPM requires wolfSSL headers at compile time.  Supply them via any of:

| Variable | Description |
|---|---|
| `WOLFSSL_DIR` | Install prefix (headers at `$WOLFSSL_DIR/include`) |
| `WOLFSSL_INCLUDE_DIR` | Direct path to the wolfSSL include directory |
| `WOLFSSL_SRC` | wolfSSL source tree (vendored build) |

## Features

| Feature | Description |
|---|---|
| `linux-dev` | Linux `/dev/tpm0` kernel driver transport |
| `swtpm` | Software TPM socket transport (swtpm / IBM TPM2 simulator) |

If neither feature is enabled, wolfTPM autodetects the available transport at
runtime on Linux.

## License

`wolftpm-src` is licensed under GPL-2.0-only or a commercial wolfSSL license.
wolfTPM itself is also GPL-2.0-only or commercial.