Skip to main content

A Framework for Reliable Benchmarking and Resource Measurement.

Project description

Build Status Code Quality Test Coverage PyPI version Apache 2.0 License

News:

  • BenchExec 1.8 stores results in ZIP archives to save space and make their handling easier.

  • We have published a paper titled Benchmarking and Resource Measurement on BenchExec and its background at SPIN 2015. It also contains a list of rules that you should always follow when doing benchmarking (and which BenchExec handles for you).

BenchExec provides three major features:

  • execution of arbitrary commands with precise and reliable measurement and limitation of resource usage (e.g., CPU time and memory)

  • an easy way to define benchmarks with specific tool configurations and resource limits, and automatically executing them on large sets of input files

  • generation of interactive tables and plots for the results

Contrary to other benchmarking frameworks, it is able to reliably measure and limit resource usage of the benchmarked tool even if it spawns subprocesses. In order to achieve this, it uses the cgroups feature of the Linux kernel to correctly handle groups of processes. Optionally, it can execute benchmarks under a separate user account. BenchExec is intended for benchmarking non-interactive tools on Linux systems. It measures CPU time, wall time, and memory usage of a tool, and allows to specify limits for these resources. It also allows to limit the CPU cores and (on NUMA systems) memory regions. In addition to measuring resource usage, BenchExec can verify that the result of the tool was as expected, and extract further statistical data from the output. Results from multiple runs can be combined into CSV and interactive HTML tables, of which the latter provide scatter and quantile plots (have a look at our demo table).

BenchExec works only on Linux and needs a one-time setup of cgroups by the machine’s administrator. The actual benchmarking can be done by any user and does not need root access.

BenchExec was originally developed for use with the software verification framework CPAchecker and is now developed as an independent project at the Software Systems Lab at the University of Passau.

Users of BenchExec

BenchExec was successfully used for benchmarking in all four instances of the International Competition on Software Verification with a wide variety of benchmarked tools and hundreds of thousands benchmark runs.

The developers of the following tools use BenchExec:

If you would like to be listed here, contact us.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

BenchExec-1.8.tar.gz (392.5 kB view hashes)

Uploaded Source

Built Distributions

BenchExec-1.8-py3.4.egg (437.3 kB view hashes)

Uploaded Source

BenchExec-1.8-py3-none-any.whl (205.8 kB view hashes)

Uploaded Python 3

BenchExec-1.8-py2.7.egg (204.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page