esolang/beam

Beam

• Beam官方网站/文档

本镜像属于https://github.com/hakatashi/esolang-box（v2.6.0）的一部分。

概述

esolang-box项目提供一致的Docker化接口，用于运行244种编程语言——从主流语言到晦涩的深奥编程语言。每个镜像遵循相同的接口规范：

• 第一个参数：源代码文件路径
• stdin：程序输入
• stdout：程序输出

这意味着你可以在不同语言间切换而无需改变调用方式。所有镜像均可在Docker Hub的esolang/命名空间下获取。本镜像中的beam命令（别名script）用于运行Beam解释器。

核心功能

1. 执行Beam编程语言代码
2. 支持通过标准输入传递程序输入
3. 提供交互式shell用于调试或环境探索
4. 支持通过strace追踪execve和execveat系统调用

使用场景

• 学习和测试Beam编程语言
• 探索深奥编程语言的特性
• 快速运行Beam代码片段
• 调试Beam程序的系统调用行为

配置说明

运行脚本

sh
$ ls
hello.beam

$ docker run --rm -v "$PWD":/code:ro esolang/beam beam /code/hello.beam
Hello, World!

通过stdin传递输入

sh
$ docker run -i --rm -v "$PWD":/code:ro esolang/beam beam /code/hello.beam < input.txt

打开交互式shell

适用于调试或探索镜像环境：

sh
$ docker run -it --rm -v "$PWD":/code:ro esolang/beam sh
# beam /code/hello.beam
Hello, World!

用strace追踪系统调用

esolang-box支持追踪execve和execveat系统调用。设置STRACE_OUTPUT_PATH环境变量并授予SYS_PTRACE权限，可将strace日志写入指定路径：

sh
$ docker run --cap-add=SYS_PTRACE --rm -v "$PWD":/code \
    --env STRACE_OUTPUT_PATH=/code/strace.txt \
    esolang/beam beam /code/hello.beam
Hello, World!

注意事项：

• 在4.8版本以下的内核中，https://bugs.chromium.org/p/project-zero/issues/detail?id=1718。请避免在这类系统（如Ubuntu Xenial）上使用--cap-add=SYS_PTRACE。
• Strace会带来显著的性能开销——系统调用的运行速度可能比正常情况慢约10倍。