host#

The Pigweed host target is used for unit testing and some host side tooling.

Toolchains#

Pigweed several toolchains preconfigured for compiling for the host.

Toolchain name	GN path	Compiler	Optimization
`host_clang_debug`	`//targets/host:host_clang_debug`	Clang	`-Og`
`host_clang_size_optimized`	`//targets/host:host_clang_size_optimized`	Clang	`-Os`
`host_clang_speed_optimized`	`//targets/host:host_clang_speed_optimized`	Clang	`-O2`
`host_gcc_debug`	`//targets/host:host_gcc_debug`	GCC	`-Og`
`host_gcc_size_optimized`	`//targets/host:host_gcc_size_optimized`	GCC	`-Os`
`host_gcc_speed_optimized`	`//targets/host:host_gcc_speed_optimized`	GCC	`-O2`

These toolchains may be used directly by downstream projects if desired. For upstream builds, Pigweed uses internal-only variants of these toolchains. The upstream toolchains are defined in //targets/host/pigweed_internal and are prefixed with pw_strict_. The upstream toolchains may not be used by downstream projects.

Toolchains for other C++ standards#

Most Pigweed code requires C++17, but a few modules, such as pw_tokenizer, work with C++14. All Pigweed code is compatible with C++20. Pigweed defines toolchains for testing with C++14 and C++20.

pw_strict_host_clang_debug_cpp14 – Builds with -std=c++14.
pw_strict_host_clang_size_optimized_cpp20 – Builds with -std=c++20.

These toolchains are only permitted for use in upstream pigweed, but downstream users may create similar toolchains as needed.

Building#

To build for the host with a default configuration, invoke Ninja with the top-level host group as the target to build.

$ ninja -C out host

host may be replaced with host_clang, host_gcc, host_clang_debug, etc. to build with a more specific host toolchain. Not all toolchains are supported on all platforms. Unless working specifically on one toolchain, it is recommended to use the default.

Running Tests#

Tests are automatically run as part of the host build, but if you desire to manually run tests, you may invoke them from a shell directly.

Example:

$ ./out/host_[compiler]_debug/obj/pw_status/status_test

RPC server#

The host target implements a system RPC server that runs over a local socket, defaulting to port 33000. To communicate with a process running the host RPC server, use pw rpc -s localhost:33000 <protos>.