miri/
lib.rs

1#![feature(abort_unwind)]
2#![feature(cfg_select)]
3#![feature(rustc_private)]
4#![feature(float_gamma)]
5#![feature(float_erf)]
6#![feature(map_try_insert)]
7#![feature(never_type)]
8#![feature(try_blocks)]
9#![feature(io_error_more)]
10#![feature(if_let_guard)]
11#![feature(variant_count)]
12#![feature(yeet_expr)]
13#![feature(nonzero_ops)]
14#![feature(pointer_is_aligned_to)]
15#![feature(ptr_metadata)]
16#![feature(unqualified_local_imports)]
17#![feature(derive_coerce_pointee)]
18#![feature(arbitrary_self_types)]
19#![feature(iter_advance_by)]
20#![cfg_attr(bootstrap, feature(duration_from_nanos_u128))]
21// Configure clippy and other lints
22#![allow(
23    clippy::collapsible_else_if,
24    clippy::collapsible_if,
25    clippy::if_same_then_else,
26    clippy::comparison_chain,
27    clippy::enum_variant_names,
28    clippy::field_reassign_with_default,
29    clippy::manual_map,
30    clippy::neg_cmp_op_on_partial_ord,
31    clippy::new_without_default,
32    clippy::single_match,
33    clippy::useless_format,
34    clippy::derive_partial_eq_without_eq,
35    clippy::derived_hash_with_manual_eq,
36    clippy::too_many_arguments,
37    clippy::type_complexity,
38    clippy::bool_to_int_with_if,
39    clippy::needless_question_mark,
40    clippy::needless_lifetimes,
41    clippy::too_long_first_doc_paragraph,
42    clippy::len_zero,
43    // We don't use translatable diagnostics
44    rustc::diagnostic_outside_of_impl,
45    // We are not implementing queries here so it's fine
46    rustc::potential_query_instability,
47    rustc::untranslatable_diagnostic,
48)]
49#![warn(
50    rust_2018_idioms,
51    unqualified_local_imports,
52    clippy::as_conversions,
53    clippy::manual_let_else
54)]
55// Needed for rustdoc from bootstrap (with `-Znormalize-docs`).
56#![recursion_limit = "256"]
57
58// The rustc crates we need
59extern crate rustc_abi;
60extern crate rustc_apfloat;
61extern crate rustc_ast;
62extern crate rustc_codegen_ssa;
63extern crate rustc_const_eval;
64extern crate rustc_data_structures;
65extern crate rustc_errors;
66extern crate rustc_hir;
67extern crate rustc_index;
68extern crate rustc_log;
69extern crate rustc_middle;
70extern crate rustc_session;
71extern crate rustc_span;
72extern crate rustc_symbol_mangling;
73extern crate rustc_target;
74// Linking `rustc_driver` pulls in the required  object code as the rest of the rustc crates are
75// shipped only as rmeta files.
76#[allow(unused_extern_crates)]
77extern crate rustc_driver;
78
79mod alloc;
80mod alloc_addresses;
81mod borrow_tracker;
82mod clock;
83mod concurrency;
84mod data_structures;
85mod diagnostics;
86mod eval;
87mod helpers;
88mod intrinsics;
89mod machine;
90mod math;
91mod operator;
92mod provenance_gc;
93mod shims;
94
95// Establish a "crate-wide prelude": we often import `crate::*`.
96// Make all those symbols available in the same place as our own.
97#[doc(no_inline)]
98pub use rustc_const_eval::interpret::*;
99// Resolve ambiguity.
100#[doc(no_inline)]
101pub use rustc_const_eval::interpret::{self, AllocMap, Provenance as _};
102use rustc_log::tracing::{self, info, trace};
103use rustc_middle::{bug, span_bug};
104
105#[cfg(all(unix, feature = "native-lib"))]
106pub mod native_lib {
107    pub use crate::shims::{init_sv, register_retcode_sv};
108}
109
110// Type aliases that set the provenance parameter.
111pub type Pointer = interpret::Pointer<Option<machine::Provenance>>;
112pub type StrictPointer = interpret::Pointer<machine::Provenance>;
113pub type Scalar = interpret::Scalar<machine::Provenance>;
114pub type ImmTy<'tcx> = interpret::ImmTy<'tcx, machine::Provenance>;
115pub type OpTy<'tcx> = interpret::OpTy<'tcx, machine::Provenance>;
116pub type FnArg<'tcx> = interpret::FnArg<'tcx, machine::Provenance>;
117pub type PlaceTy<'tcx> = interpret::PlaceTy<'tcx, machine::Provenance>;
118pub type MPlaceTy<'tcx> = interpret::MPlaceTy<'tcx, machine::Provenance>;
119
120pub use crate::alloc::MiriAllocBytes;
121pub use crate::alloc_addresses::{EvalContextExt as _, ProvenanceMode};
122pub use crate::borrow_tracker::stacked_borrows::{
123    EvalContextExt as _, Item, Permission, Stack, Stacks,
124};
125pub use crate::borrow_tracker::tree_borrows::{EvalContextExt as _, Tree};
126pub use crate::borrow_tracker::{
127    BorTag, BorrowTrackerMethod, EvalContextExt as _, TreeBorrowsParams,
128};
129pub use crate::clock::{Instant, MonotonicClock};
130pub use crate::concurrency::cpu_affinity::MAX_CPUS;
131pub use crate::concurrency::data_race::{
132    AtomicFenceOrd, AtomicReadOrd, AtomicRwOrd, AtomicWriteOrd, EvalContextExt as _,
133};
134pub use crate::concurrency::init_once::{EvalContextExt as _, InitOnceRef};
135pub use crate::concurrency::sync::{CondvarRef, EvalContextExt as _, MutexRef, RwLockRef};
136pub use crate::concurrency::thread::{
137    BlockReason, DynUnblockCallback, EvalContextExt as _, StackEmptyCallback, ThreadId,
138    ThreadManager, TimeoutAnchor, TimeoutClock, UnblockKind,
139};
140pub use crate::concurrency::{GenmcConfig, GenmcCtx, run_genmc_mode};
141pub use crate::data_structures::dedup_range_map::DedupRangeMap;
142pub use crate::data_structures::mono_hash_map::MonoHashMap;
143pub use crate::diagnostics::{
144    EvalContextExt as _, NonHaltingDiagnostic, TerminationInfo, report_result,
145};
146pub use crate::eval::{MiriConfig, MiriEntryFnType, create_ecx, eval_entry};
147pub use crate::helpers::{EvalContextExt as _, ToU64 as _, ToUsize as _};
148pub use crate::intrinsics::EvalContextExt as _;
149pub use crate::machine::{
150    AlignmentCheck, AllocExtra, BacktraceStyle, DynMachineCallback, FloatRoundingErrorMode,
151    FrameExtra, IsolatedOp, MachineCallback, MemoryKind, MiriInterpCx, MiriInterpCxExt,
152    MiriMachine, MiriMemoryKind, PrimitiveLayouts, Provenance, ProvenanceExtra, RejectOpWith,
153    ValidationMode,
154};
155pub use crate::operator::EvalContextExt as _;
156pub use crate::provenance_gc::{EvalContextExt as _, LiveAllocs, VisitProvenance, VisitWith};
157pub use crate::shims::EmulateItemResult;
158pub use crate::shims::env::{EnvVars, EvalContextExt as _};
159pub use crate::shims::foreign_items::{DynSym, EvalContextExt as _};
160pub use crate::shims::io_error::{EvalContextExt as _, IoError, LibcError};
161pub use crate::shims::os_str::EvalContextExt as _;
162pub use crate::shims::panic::EvalContextExt as _;
163pub use crate::shims::sig::EvalContextExt as _;
164pub use crate::shims::time::EvalContextExt as _;
165pub use crate::shims::tls::TlsData;
166pub use crate::shims::unwind::{CatchUnwindData, EvalContextExt as _};
167
168/// Insert rustc arguments at the beginning of the argument list that Miri wants to be
169/// set per default, for maximal validation power.
170/// Also disable the MIR pass that inserts an alignment check on every pointer dereference. Miri
171/// does that too, and with a better error message.
172pub const MIRI_DEFAULT_ARGS: &[&str] = &[
173    "--cfg=miri",
174    "-Zalways-encode-mir",
175    "-Zextra-const-ub-checks",
176    "-Zmir-emit-retag",
177    "-Zmir-preserve-ub",
178    "-Zmir-opt-level=0",
179    "-Zmir-enable-passes=-CheckAlignment,-CheckNull,-CheckEnums",
180    // Deduplicating diagnostics means we miss events when tracking what happens during an
181    // execution. Let's not do that.
182    "-Zdeduplicate-diagnostics=no",
183];
miri/lib.rs

miri/
lib.rs
