---
name: "binfmtasm-interpreter"
section: "1"
platform: "linux"
package: "binfmtc"
version: "0.17-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/binfmtasm-interpreter"
---

# binfmtasm-interpreter(1)

binfmt\_misc Assembly handler

## NAME

binfmtasm-interpreter - binfmt\_misc Assembly handler

## SYNOPSIS

**binfmtasm-interpreter** *Assembly-source-file-name* **\[***command-line opions ...***\]**

## DESCRIPTION

**binfmtasm-interpreter** compiles an assembly source file specified on the command-line using  gas compiler, and executes the resulting file.

It is designed to be used as a handler for  **binfmt\_misc** handler, which is a system used in Linux for handling arbitrary files  as executables.

The command-line options are passed on to the  compiled binary.

## FILE MAGIC

There is a requirement for C++ source files to have the  magic characters **/\*BINFMTASMCPP:** at the beginning of the file.

That line also is used to specify the additional command-line options for the assmebler.

## ENVIRONMENT

- **GAS**

  The compiler used. The default is to use **gcc**

- **AS**

  The compiler used, if  **GAS** variable is not set.

  Will fall back to using **GCC** and  **CC**

- **BINFMTCTMPDIR**

  Temporary directory used for binary and execution.

  Falls back to  **$TMPDIR** **$TEMPDIR** or **/tmp**

- **BINFMTC\_DEBUG**

  enables debug output if set.

- **BINFMTASM\_GAS\_OPTS**

  Additional G++ options. Use  **BINFMTC\_DEBUG** to verify the options being passed on to g++.

  The default is   **-O2 -Wall**

## AUTHOR

Junichi Uekawa (dancer@debian.org)

Upstream page is available at  **http://www.netfort.gr.jp/~dancer/software/**

## SEE ALSO

[**binfmtc-interpreter**(1)](/binfmtc-interpreter/1.md),  [**binfmtcxx-interpreter**(1)](/binfmtcxx-interpreter/1.md),  [**binfmtf-interpreter**(1)](/binfmtf-interpreter/1.md),  [**binfmtf95-interpreter**(1)](/binfmtf95-interpreter/1.md),  [**binfmtgcj-interpreter**(1)](/binfmtgcj-interpreter/1.md)