---
name: "cxxbridge"
section: "1"
platform: "linux"
package: "cxxbridge-cmd"
version: "1.0.141-1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cxxbridge"
---

# cxxbridge(1)

generate C++ code from rust source files

## NAME

cxxbridge - generate C++ code from rust source files

## DESCRIPTION

### Usage:

- cxxbridge \<input\>.rs

  Emit .cc file for bridge to stdout

- cxxbridge \<input\>.rs **--header**

  Emit .h file for bridge to stdout

- cxxbridge **--header**

  Emit "rust/cxx.h" header to stdout

### Arguments:

-

  \[input\]

-

  Input Rust source file containing #\[cxx::bridge\].

## OPTIONS

**--cfg** \<name="value" \| name\[=true\] \| name=false\>

-

  Compilation configuration matching what will be used to build the Rust side of the bridge.

**--cxx-impl-annotations** \<annotation\>

-

  Optional annotation for implementations of C++ function wrappers that may be exposed to Rust. You may for example need to provide \_\_declspec(dllexport) or \_\_attribute\_\_((visibility("default"))) if Rust code from one shared object or executable depends on these C++ functions in another.

**--header**

-

  Emit header with declarations only. Optional if using \`-o\` with a path ending in \`.h\`.

**--help**

-

  Print help information.

**-i**, **--include** \<include\>

-

  Any additional headers to #include. The cxxbridge tool does not parse or even require the given paths to exist; they simply go into the generated C++ code as #include lines.

**-o**, **--output** \<output\>

-

  Path of file to write as output. Output goes to stdout if **-o** is not specified.

**--version**

-

  Print version information.

## AUTHOR

- Matthias Geiger \<werdahias@debian.org\>

  ## COPYRIGHT

Copyright © 2025 Matthias Geiger

This manual page was written for the Debian system (and may be used by others).

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 or (at your option) any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.