Scroll to navigation

CXXBRIDGE(1) User Commands CXXBRIDGE(1)

NAME

cxxbridge - generate C++ code from rust source files

DESCRIPTION

Usage:

Emit .cc file for bridge to stdout
Emit .h file for bridge to stdout
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

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.

January 2025 cxxbridge 1.0.137