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

# binfmtcxx-interpreter(1)

binfmt\_misc C++ handler

## NAME

binfmtcxx-interpreter - binfmt\_misc C++ handler

## SYNOPSIS

**binfmtcxx-interpreter** *C++-source-file-name* **\[***command-line opions ...***\]**

## DESCRIPTION

**binfmtcxx-interpreter** compiles a C++ source file specified on the command-line using  C++ 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 **/\*BINFMTCXX:** at the beginning of the file.

That line also is used to specify the additional command-line options for C++ compiler.

## ENVIRONMENT

- **GXX**

  The compiler used. The default is to use **g++**

- **CXX**

  The compiler used, if  **GXX** 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.

- **BINFMTCXX\_GXX\_OPTS**

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

  The default is   **-O0 -Wall -g**

## AUTHOR

Junichi Uekawa (dancer@debian.org)

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

## SEE ALSO

[**binfmtasm-interpreter**(1)](/binfmtasm-interpreter/1.md),  [**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)