Skip to content

Commit

Permalink
Fixes
Browse files Browse the repository at this point in the history
  • Loading branch information
incaseoftrouble committed Jun 7, 2024
1 parent 13980f6 commit 5e5f8f7
Showing 1 changed file with 7 additions and 6 deletions.
13 changes: 7 additions & 6 deletions doc/benchexec-in-container.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,9 @@ SPDX-License-Identifier: Apache-2.0
This document explains the complications of using BenchExec inside
containerized environments (such as Docker or Podman) and shows how you can
create your own interactive Docker image (or adapt existing ones) to use
BenchExec within it.
BenchExec within it. We focus mainly on the (nowadays standard) cgroups v2,
a brief guidline for the (outdated) cgroups v1 is provided
[below](#cgroups-v1).

There is a difference between executing only BenchExec inside a
(non-interactive) container and a fully interactive one which contains
Expand Down Expand Up @@ -50,11 +52,10 @@ docker run --privileged --cap-drop=all -t my-container benchexec <arguments>
## BenchExec in Interactive Containers

Next follows a step-by-step guide to create a Docker / Podman image with
BenchExec (assuming cgroups v2, the standard nowadays). Some further background
and reasoning is provided later. Summarized, the main reason why BenchExec
needs a "custom" setup for containers is due to how cgroups work in combination
with containers; we need to "manually" set up a separate cgroup for BenchExec.
A brief guidline for the outdated cgroups v1 is provided [below](#cgroups-v1).
BenchExec (assuming cgroups v2). Some further background and reasoning is
provided later. Summarized, the main reason why BenchExec needs a "custom"
setup for containers is due to how cgroups work in combination with containers;
we need to "manually" set up a separate cgroup for BenchExec.

While this setup should work on most recent system, we cannot guarantee this,
since there simply are too many variables. In some cases, you may need to
Expand Down

0 comments on commit 5e5f8f7

Please sign in to comment.