mirror of
https://github.com/rust-lang/rust.git
synced 2025-05-14 02:49:40 +00:00
a8d22eb39e
Supertraits of `BuilderMethods` are all called `XyzBuilderMethods`. Supertraits of `CodegenMethods` are all called `XyzMethods`. This commit changes the latter to `XyzCodegenMethods`, for consistency.
87 lines
2.9 KiB
Rust
87 lines
2.9 KiB
Rust
use std::ops::Range;
|
|
|
|
use rustc_middle::mir;
|
|
use rustc_middle::ty::{Instance, PolyExistentialTraitRef, Ty};
|
|
use rustc_span::{SourceFile, Span, Symbol};
|
|
use rustc_target::abi::call::FnAbi;
|
|
use rustc_target::abi::Size;
|
|
|
|
use super::BackendTypes;
|
|
use crate::mir::debuginfo::{FunctionDebugContext, VariableKind};
|
|
|
|
pub trait DebugInfoCodegenMethods<'tcx>: BackendTypes {
|
|
fn create_vtable_debuginfo(
|
|
&self,
|
|
ty: Ty<'tcx>,
|
|
trait_ref: Option<PolyExistentialTraitRef<'tcx>>,
|
|
vtable: Self::Value,
|
|
);
|
|
|
|
/// Creates the function-specific debug context.
|
|
///
|
|
/// Returns the FunctionDebugContext for the function which holds state needed
|
|
/// for debug info creation, if it is enabled.
|
|
fn create_function_debug_context(
|
|
&self,
|
|
instance: Instance<'tcx>,
|
|
fn_abi: &FnAbi<'tcx, Ty<'tcx>>,
|
|
llfn: Self::Function,
|
|
mir: &mir::Body<'tcx>,
|
|
) -> Option<FunctionDebugContext<'tcx, Self::DIScope, Self::DILocation>>;
|
|
|
|
// FIXME(eddyb) find a common convention for all of the debuginfo-related
|
|
// names (choose between `dbg`, `debug`, `debuginfo`, `debug_info` etc.).
|
|
fn dbg_scope_fn(
|
|
&self,
|
|
instance: Instance<'tcx>,
|
|
fn_abi: &FnAbi<'tcx, Ty<'tcx>>,
|
|
maybe_definition_llfn: Option<Self::Function>,
|
|
) -> Self::DIScope;
|
|
|
|
fn dbg_loc(
|
|
&self,
|
|
scope: Self::DIScope,
|
|
inlined_at: Option<Self::DILocation>,
|
|
span: Span,
|
|
) -> Self::DILocation;
|
|
|
|
fn extend_scope_to_file(
|
|
&self,
|
|
scope_metadata: Self::DIScope,
|
|
file: &SourceFile,
|
|
) -> Self::DIScope;
|
|
fn debuginfo_finalize(&self);
|
|
|
|
// FIXME(eddyb) find a common convention for all of the debuginfo-related
|
|
// names (choose between `dbg`, `debug`, `debuginfo`, `debug_info` etc.).
|
|
fn create_dbg_var(
|
|
&self,
|
|
variable_name: Symbol,
|
|
variable_type: Ty<'tcx>,
|
|
scope_metadata: Self::DIScope,
|
|
variable_kind: VariableKind,
|
|
span: Span,
|
|
) -> Self::DIVariable;
|
|
}
|
|
|
|
pub trait DebugInfoBuilderMethods: BackendTypes {
|
|
// FIXME(eddyb) find a common convention for all of the debuginfo-related
|
|
// names (choose between `dbg`, `debug`, `debuginfo`, `debug_info` etc.).
|
|
fn dbg_var_addr(
|
|
&mut self,
|
|
dbg_var: Self::DIVariable,
|
|
dbg_loc: Self::DILocation,
|
|
variable_alloca: Self::Value,
|
|
direct_offset: Size,
|
|
// NB: each offset implies a deref (i.e. they're steps in a pointer chain).
|
|
indirect_offsets: &[Size],
|
|
// Byte range in the `dbg_var` covered by this fragment,
|
|
// if this is a fragment of a composite `DIVariable`.
|
|
fragment: Option<Range<Size>>,
|
|
);
|
|
fn set_dbg_loc(&mut self, dbg_loc: Self::DILocation);
|
|
fn clear_dbg_loc(&mut self);
|
|
fn insert_reference_to_gdb_debug_scripts_section_global(&mut self);
|
|
fn set_var_name(&mut self, value: Self::Value, name: &str);
|
|
}
|