[rustc.git] / src / doc / unstable-book / src / language-features / native-link-modifiers-bundle.md

# `native_link_modifiers_bundle`

The tracking issue for this feature is: [#81490]

[#81490]: https://github.com/rust-lang/rust/issues/81490

------------------------

The `native_link_modifiers_bundle` feature allows you to use the `bundle` modifier.

Only compatible with the `static` linking kind. Using any other kind will result in a compiler error.

`+bundle` means objects from the static library are bundled into the produced crate (a rlib, for example) and are used from this crate later during linking of the final binary.

`-bundle` means the static library is included into the produced rlib "by name" and object files from it are included only during linking of the final binary, the file search by that name is also performed during final linking.

This modifier is supposed to supersede the `static-nobundle` linking kind defined by [RFC 1717](https://github.com/rust-lang/rfcs/pull/1717).

The default for this modifier is currently `+bundle`, but it could be changed later on some future edition boundary.
Commit	Line	Data
17df50a5 XL	1	# `native_link_modifiers_bundle`
	2
	3	The tracking issue for this feature is: [#81490]
	4
	5	[#81490]: https://github.com/rust-lang/rust/issues/81490
	6
	7	------------------------
	8
	9	The `native_link_modifiers_bundle` feature allows you to use the `bundle` modifier.
	10
	11	Only compatible with the `static` linking kind. Using any other kind will result in a compiler error.
	12
	13	`+bundle` means objects from the static library are bundled into the produced crate (a rlib, for example) and are used from this crate later during linking of the final binary.
	14
	15	`-bundle` means the static library is included into the produced rlib "by name" and object files from it are included only during linking of the final binary, the file search by that name is also performed during final linking.
	16
	17	This modifier is supposed to supersede the `static-nobundle` linking kind defined by [RFC 1717](https://github.com/rust-lang/rfcs/pull/1717).
	18
	19	The default for this modifier is currently `+bundle`, but it could be changed later on some future edition boundary.