link-section 0.17.2

Link-time initialized slices for Rust, with full support for Linux, macOS, Windows, WASM and many more platforms.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.17.2] - 2026-05-18

### Changed

- Fixed bug with submission of raw items to `aux` sections.

## [0.17.1] - 2026-05-17

### Added

- `MovableRef` and `Ref` implement `Debug` and `Display` if the referenced type does.

### Changed

- Deprecated `reference` module in favor of `Ref` from the crate root.

## [0.17.0] - 2026-05-16

### Added

- `reference` sections support access both as a slice and as a reference at the
  submission site on all platforms (including WASM).
- `movable` sections support reordering and back-reference updates during
  startup initialization (allowing a "reference" to an item that may move during
  initialization at the submission site).
- `typed` and `mutable` sections have been split: `typed` allows for `const` and
  `static` items, while `mutable` allows for `const` items and `as_mut_slice`
  access.

### Changed

- Bumped MSRV to 1.85.0.
- Significant rewrite to link-section's internal implementation.
- Sections require a type: `#[section(typed)]`, `#[section(untyped)]`,
  `#[section(mutable)]`, `#[section(movable)]`, or `#[section(reference)]`.
- When submitting a fn() with a body to a typed link section, the function's
body is not placed in any specific section. To restore the previous behavior,
manually split function pointers and bodies:

```rust
#[section(untyped, aux(main = FN_ARRAY))]
pub static FN_BODIES: link_section::Section;

#[section(typed)]
pub static FN_ARRAY: link_section::TypedSection<fn()>;

#[in_section(FN_ARRAY)]
const _: fn() = linked_function;

#[in_section(FN_BODIES)]
pub fn linked_function() {
    eprintln!("linked_function");
}
```

## [0.16.1] - 2026-05-11

### Changed

- Repair MSRV breakage for WASM targets.

## [0.16.0] - 2026-05-08

### Added

- Support for AIX targets. Requires `-C link-arg=-bdbg:namedsects:ss` (or a
recent Rust version that sets this automatically).

## [0.15.0] - 2026-05-06

### Added

- Support for `const` items in link sections.
- WASM now requires `const` items, and uses `ctor`-like initialization to copy
  data to a contiguous section. To access link-section slices in WASM in
  constructor functions, make sure to use `priority = 1`.
- Zero-sized types are no longer used in `extern`s. Windows now uses a
  non-zero-sized alignment marker to align the start and end of the section.
  Other LLVM/GCC platforms use a `u8`.
- `link-section` is now `no_std`-compatible.

## [0.14.0] - 2026-05-04

### Changed

- WASM targets now use an extern `read_custom_section` function to read custom
  sections.

## [0.13.1] - 2026-05-02

### Changed

- Documentation polish and typo fixes.

## [0.13.0] - 2026-05-02

### Changed

- `used_linker` feature moved to `--cfg linktime_used_linker` flag.
- On macOS, `fn` items are placed in a `__TEXT,__text,regular,pure_instructions`
  section (fixes a linker warning in nightly).

## [0.11.0] - 2026-04-28

### Changed

- Macro attributes and crate features are auto-documented.

## [0.2.1] - 2026-04-22

### Added

- Included licenses in all files.
- Bumped proc-macro dependency versions.

### Changed

- `link-section` crate no longer offers `const` section pointers.