2015-03-25 17:35:51 -05:00
|
|
|
% Link args
|
|
|
|
|
|
|
|
|
|
There is one other way to tell rustc how to customize linking, and that is via
|
|
|
|
|
the `link_args` attribute. This attribute is applied to `extern` blocks and
|
|
|
|
|
specifies raw flags which need to get passed to the linker when producing an
|
|
|
|
|
artifact. An example usage would be:
|
|
|
|
|
|
|
|
|
|
``` no_run
|
|
|
|
|
#![feature(link_args)]
|
|
|
|
|
|
|
|
|
|
#[link_args = "-foo -bar -baz"]
|
|
|
|
|
extern {}
|
|
|
|
|
# fn main() {}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Note that this feature is currently hidden behind the `feature(link_args)` gate
|
|
|
|
|
because this is not a sanctioned way of performing linking. Right now rustc
|
|
|
|
|
shells out to the system linker, so it makes sense to provide extra command line
|
|
|
|
|
arguments, but this will not always be the case. In the future rustc may use
|
2015-06-25 18:29:23 -05:00
|
|
|
LLVM directly to link native libraries, in which case `link_args` will have no
|
2015-03-25 17:35:51 -05:00
|
|
|
meaning.
|
|
|
|
|
|
|
|
|
|
It is highly recommended to *not* use this attribute, and rather use the more
|
|
|
|
|
formal `#[link(...)]` attribute on `extern` blocks instead.
|
|
|
|
|
|
