https://github.com/mmastrac/linktime
Link-time initialization, destruction, scattered data collection macros for Rust
https://github.com/mmastrac/linktime
constructor ctor dtor dylib link-section linktime macros rust
Last synced: 5 days ago
JSON representation
Link-time initialization, destruction, scattered data collection macros for Rust
- Host: GitHub
- URL: https://github.com/mmastrac/linktime
- Owner: mmastrac
- License: apache-2.0
- Created: 2018-12-06T03:50:42.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2026-05-03T22:03:29.000Z (30 days ago)
- Last Synced: 2026-05-03T23:28:15.727Z (30 days ago)
- Topics: constructor, ctor, dtor, dylib, link-section, linktime, macros, rust
- Language: Rust
- Homepage:
- Size: 1.08 MB
- Stars: 983
- Watchers: 6
- Forks: 70
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# linktime
Cross-platform libraries for link-time initialization, finalization and
collection in Rust.
| crate | | docs | version |
| ------------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `linktime` | Convenience crate for `ctor`, `dtor` and `link-section` | [](https://docs.rs/linktime) | [](https://crates.io/crates/linktime) |
| `ctor` | Module initialization functions before main | [](https://docs.rs/ctor) | [](https://crates.io/crates/ctor) |
| `dtor` | Module shutdown functions before main | [](https://docs.rs/dtor) | [](https://crates.io/crates/dtor) |
| `link-section` | Linker-managed typed (slices) and untyped sections | [](https://docs.rs/link-section) | [](https://crates.io/crates/link-section) |
| `scattered-collect` | Linker-managed collections: slices, sorted slices, maps | [](https://docs.rs/scattered-collect) | [](https://crates.io/crates/scattered-collect) |
## Crates
The `linktime` project comprises three crates, and the top-level `linktime`
crate aggregates them all.
Pick-and-choose, or import the top-level crate to get all three.
## [`ctor`](ctor/)
Module initialization functions for Rust (like `__attribute__((constructor))` in
C/C++).
Run code before `main` to initialize data, external resources, or other state.
```toml
[dependencies]
linktime = { version = "...", features = ["ctor"] } # note: already enabled by default
# or
ctor = "..."
```
```rust
use linktime::ctor; // or ctor::ctor
use libc_print::*;
#[ctor(unsafe)]
fn foo() {
libc_println!("Life before main!");
}
```
## [`dtor`](dtor/)
Module shutdown functions for Rust (like `__attribute__((destructor))`).
Run code after `main` to clean up resources, or perform other final operations.
```toml
[dependencies]
linktime = { version = "...", features = ["dtor"] } # note: already enabled by default
# or
dtor = "..."
```
```rust
use linktime::dtor; // or dtor::dtor
use libc_print::*;
#[dtor(unsafe)]
fn foo() {
libc_println!("Life after main!");
}
```
## [`link-section`](link-section/)
Typed and untyped link section support for Rust.
Collect related items from an entire linked binary into a single link section.
```toml
[dependencies]
linktime = { version = "...", features = ["link-section"] } # note: already enabled by default
# or
link-section = "..."
```
```rust
use linktime::link_section::{section, in_section, TypedSection};
use linktime::ctor;
use libc_print::*;
#[section(typed)]
static FOO: TypedSection;
#[in_section(FOO)]
fn foo() {
libc_println!("Hello, world!");
}
#[ctor(unsafe)]
fn print_numbers() {
for f in FOO {
f();
}
}
```
## [`scattered-collect`](scattered-collect/)
A crate for defining zero-allocation,linker-managed scattered collections in
Rust.
- `ScatteredIterable`: A collection of items that are available only via
- `ScatteredSlice`: A collection of sized items that collected into a slice in
an arbitrary order.
- `ScatteredSortedSlice`: A collection of items that are available via slice,
in sorted order.
- `ScatteredReferencedSlice`: A collection of items collected into a slice
(link order).
- `ScatteredSortedReferencedSlice`: A collection of sized items that are
available both via sorted slice and via reference at the declaration site.
- `ScatteredMap`: A collection of key-value pairs that are available via
slice, as well as indexed by key.
```rust,ignore
use scattered_collect::{gather, scatter, slice::ScatteredSlice};
#[gather]
static SLICE_PLUGINS: ScatteredSlice<&'static str>;
#[scatter(SLICE_PLUGINS)]
const _: &'static str = "json";
#[scatter(SLICE_PLUGINS)]
const _: &'static str = "yaml";
fn main() {
assert_eq!(SLICE_PLUGINS.len(), 2);
assert!(SLICE_PLUGINS.contains(&"json"));
}
```
## Contributing
Contributions are welcome!
## License
These projects are dual-licensed under the Apache License, Version 2.0 and the
MIT License.