Skip to content

Add challenge 23 24 for Vec #267

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 14 commits into from
Jun 10, 2025
Merged
2 changes: 2 additions & 0 deletions doc/src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,4 +36,6 @@
- [20: Verify the safety of char-related functions in str::pattern](./challenges/0020-str-pattern-pt1.md)
- [21: Verify the safety of substring-related functions in str::pattern](./challenges/0021-str-pattern-pt2.md)
- [22: Verify the safety of str iter functions](./challenges/0022-str-iter.md)
- [23: Verify the safety of Vec functions part 1](./challenges/0023-vec-pt1.md)
- [24: Verify the safety of Vec functions part 2](./challenges/0024-vec-pt2.md)
- [25: Verify the safety of `VecDeque` functions](./challenges/0025-vecdeque.md)
78 changes: 78 additions & 0 deletions doc/src/challenges/0023-vec-pt1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
# Challenge 23: Verify the safety of `Vec` functions part 1

- **Status:** Open
- **Tracking Issue:** [#284](https://github.com/model-checking/verify-rust-std/issues/284)
- **Start date:** *2025-03-07*
- **End date:** *2025-10-17*
- **Reward:** *15000 USD*

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


## Goal

Verify the safety of `std::Vec` functions (library/alloc/src/vec/mod.rs).


### Success Criteria

Verify the safety of the following public functions in (library/alloc/src/vec/mod.rs):

| Function |
|---------|
|from_raw_parts|
|from_nonnull|
|from_nonnull_in|
|into_raw_parts_with_alloc|
|into_boxed_slice|
|truncate|
|set_len|
|swap_remove|
|insert|
|remove|
|retain_mut|
|dedup_by|
|push|
|push_within_capacity|
|pop|
|append|
|append_elements|
|drain|
|clear|
|split_off|
|leak|
|spare_capacity_mut|
|split_at_spare_mut|
|split_at_spare_mut_with_len|
|extend_from_within|
|into_flattened|
|extend_with|
|spec_extend_from_within|
|deref|
|deref_mut|
|into_iter|
|extend_desugared|
|extend_trusted|
|extract_if|
|drop|
|try_from|




The verification must be unbounded---it must hold for slices of arbitrary length.

The verification must hold for generic type `T` (no monomorphization).

### List of UBs

All proofs must automatically ensure the absence of the following undefined behaviors [ref](https://github.com/rust-lang/reference/blob/142b2ed77d33f37a9973772bd95e6144ed9dce43/src/behavior-considered-undefined.md):

* Accessing (loading from or storing to) a place that is dangling or based on a misaligned pointer.
* Reading from uninitialized memory except for padding or unions.
* Mutating immutable bytes.
* Producing an invalid value


Note: All solutions to verification challenges need to satisfy the criteria established in the [challenge book](../general-rules.md)
in addition to the ones listed above.
67 changes: 67 additions & 0 deletions doc/src/challenges/0024-vec-pt2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
# Challenge 24: Verify the safety of `Vec` functions part 2

- **Status:** Open
- **Tracking Issue:** [#285](https://github.com/model-checking/verify-rust-std/issues/285)
- **Start date:** *2025/03/07*
- **End date:** *2025/10/17*
- **Reward:** *15000 USD*

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


## Goal

Continue from part 1 (Challenge 23), for this challenge, you need to verify the safety of `std::Vec` iterator functions in other files in (library/alloc/src/vec/).


### Success Criteria

Verify the safety of the following functions that in implemented for `IntoIter` in (library/alloc/src/vec/into_iter.rs):

| Function |
|---------|
|as_slice|
|as_mut_slice|
|forget_allocation_drop_remaining|
|into_vecdeque|
|next|
|size_hint|
|advance_by|
|next_chunk|
|fold|
|try_fold|
|__iterator_get_unchecked|
|next_back|
|advance_back_by|
|drop|

and the following functions from other files:

| Function | in File|
|---------|---------|
|next| extract_if.rs|
|spec_extend (for IntoIter) | spec_extend.rs |
|spec_extend (for slice::Iter) | spec_extend.rs |
|from_elem (for i8)| spec_from_elem.rs |
|from_elem (for u8)| spec_from_elem.rs |
|from_elem (for ())| spec_from_elem.rs |
|from_iter| spec_from_iter.rs|
|from_iter (default)| spec_from_iter_nested.rs|


The verification must be unbounded---it must hold for slices of arbitrary length.

The verification must hold for generic type `T` (no monomorphization).

### List of UBs

All proofs must automatically ensure the absence of the following undefined behaviors [ref](https://github.com/rust-lang/reference/blob/142b2ed77d33f37a9973772bd95e6144ed9dce43/src/behavior-considered-undefined.md):

* Accessing (loading from or storing to) a place that is dangling or based on a misaligned pointer.
* Reading from uninitialized memory except for padding or unions.
* Mutating immutable bytes.
* Producing an invalid value


Note: All solutions to verification challenges need to satisfy the criteria established in the [challenge book](../general-rules.md)
in addition to the ones listed above.
Loading