- C++ 92.6%
- C 3.9%
- Python 1.7%
- Starlark 0.6%
- CMake 0.4%
- Other 0.7%
First increment of the production arena that blesses host-visible memory once and recycles it, killing the per-BO share/unshare churn behind RM EPERM / poisoning / long-uptime crashes. - HostVisibleArena.h: env config (GFXSTREAM_ARENA_MB budget, GFXSTREAM_ARENA_THRESHOLD_KB size gate: 0=all-dynamic/off, -1=all-arena/strict-OOM-on-full, >0=hybrid) + routesToArena() decision. - Wired into the udmabuf host-visible branch of on_vkAllocateMemory: parses once, logs the mode, computes the per-alloc routing decision. Default config (threshold 0) is a no-op -> behavior unchanged. Builds clean. Next: the blessed folio-backed recycle pool (generalizing the RingBlob MADV_COLLAPSE pool) that acts on the routing decision, then v2 offset suballocation (guest gfxstream_vk CoherentMemory). Grounded plan + confirmed active path in GFXSTREAM_ARENA_PLAN.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Smu6N2o945D86k4hE1i9jr Change-Id: I2c50fa8e3e9cccaa55386e0a1b2cc8e7d5902a0f |
History
|
|
|---|---|---|
| .config | ||
| .github | ||
| .kokoro | ||
| codegen | ||
| common | ||
| docs | ||
| guest | ||
| host | ||
| scripts | ||
| tests | ||
| third_party | ||
| toolchain | ||
| .bazelrc | ||
| .clang-format | ||
| .gitignore | ||
| Android.bp | ||
| BUILD.bazel | ||
| build_variables.bzl | ||
| CMakeLists.txt | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| meson.build | ||
| meson_options.txt | ||
| MODULE.bazel | ||
| MODULE.bazel.lock | ||
| MODULE_LICENSE_APACHE2 | ||
| OWNERS | ||
| README.md | ||
| REPO.bazel | ||
Gfxstream
Graphics Streaming Kit, colloquially known as Gfxstream and previously known as Vulkan Cereal, is a collection of code generators and libraries for streaming rendering APIs from one place to another.
- From a virtual machine guest to host for virtualized graphics
- From one process to another for IPC graphics
- From one computer to another via network sockets
Building
Linux
Bazel
The Bazel build current supports building the host server which is typically used for Android virtual device host tooling.
cd <gfxstream project>
bazel build ...
bazel test ...
CMake
The CMake build has historically been used for building the host backend for Goldfish.
The CMake build can be used from either a standalone Gfxstream checkout or from inside an Android repo.
Then,
mkdir build
cd build
cmake .. -G Ninja
ninja
For validating a Goldfish build,
cd <aosp/emu-main-dev repo>
cd external/qemu
python android/build/python/cmake.py --gfxstream
Meson
The Meson build has historically been used for building the backend for Linux guest on Linux host use cases.
cd <gfxstream project>
meson setup \
-Ddefault_library=static \
-Dgfxstream-build=host \
build
meson compile -C build
Soong
The Android Soong build is used for building the guest components for virtual device (Cuttlefish, Goldfish, etc) images and was previously used for building the host backend for virtual device host tools.
Please follow the instructions here for getting started with Android development and setting up a repo.
Then,
m libgfxstream_backend
and libgfxstream_backend.so can be found in out/host.
For validating changes, consider running
cd hardware/google/gfxstream
mma
to build everything inside of the Gfxstream directory.
Windows
Make sure the latest CMake is installed. Make sure Visual Studio 2019 is installed on your system along with all the Clang C++ toolchain components. Then:
mkdir build
cd build
cmake . ../ -A x64 -T ClangCL
A solution file should be generated. Then open the solution file in Visual
studio and build the gfxstream_backend target.
Codegen
Regenerating GLES/RenderControl code
Run:
scripts/generate-apigen-source.sh
Regenerating Vulkan code
To re-generate both guest and Vulkan code, please run:
scripts/generate-gfxstream-vulkan.sh
Testing
Linux
Bazel
bazel test ...
or
bazel test tests/end2end:gfxstream_end2end_tests
Soong
From within an Android repo, run:
atest --host GfxstreamEnd2EndTests
Windows
There are a bunch of test executables generated. They require libEGL.dll and
libGLESv2.dll and vulkan-1.dll to be available, possibly from your GPU
vendor or ANGLE, in the %PATH%.
Notice
This is not an officially supported Google product. This project is not eligible for the Google Open Source Software Vulnerability Rewards Program.