aboutsummaryrefslogtreecommitdiffstats
path: root/support/crown/src/trace_in_no_trace.rs
diff options
context:
space:
mode:
Diffstat (limited to 'support/crown/src/trace_in_no_trace.rs')
-rw-r--r--support/crown/src/trace_in_no_trace.rs196
1 files changed, 196 insertions, 0 deletions
diff --git a/support/crown/src/trace_in_no_trace.rs b/support/crown/src/trace_in_no_trace.rs
new file mode 100644
index 00000000000..0e685c242a0
--- /dev/null
+++ b/support/crown/src/trace_in_no_trace.rs
@@ -0,0 +1,196 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+
+use rustc_ast::ast::{AttrKind, Attribute};
+use rustc_ast::token::TokenKind;
+use rustc_ast::tokenstream::TokenTree;
+use rustc_ast::AttrArgs;
+use rustc_error_messages::MultiSpan;
+use rustc_hir::{self as hir};
+use rustc_lint::{LateContext, LateLintPass, LintContext, LintPass, LintStore};
+use rustc_middle::ty;
+use rustc_session::declare_tool_lint;
+use rustc_span::symbol::Symbol;
+
+use crate::common::{get_local_trait_def_id, get_trait_def_id, implements_trait};
+use crate::symbols;
+
+declare_tool_lint! {
+ pub crown::TRACE_IN_NO_TRACE,
+ Deny,
+ "Warn and report incorrect usage of Traceable (jsmanaged) objects in must_not_have_traceable marked wrappers"
+}
+
+declare_tool_lint! {
+ pub crown::EMPTY_TRACE_IN_NO_TRACE,
+ Warn,
+ "Warn about usage of empty Traceable objects in must_not_have_traceable marked wrappers"
+}
+
+const EMPTY_TRACE_IN_NO_TRACE_MSG: &str =
+ "must_not_have_traceable marked wrapper is not needed for types that implements \
+empty Traceable (like primitive types). Consider removing the wrapper.";
+
+pub fn register(lint_store: &mut LintStore) {
+ let symbols = Symbols::new();
+ lint_store.register_lints(&[&TRACE_IN_NO_TRACE, &EMPTY_TRACE_IN_NO_TRACE]);
+ lint_store.register_late_pass(move |_| Box::new(NotracePass::new(symbols.clone())));
+}
+
+/// Lint for ensuring safe usage of NoTrace wrappers
+///
+/// This lint (disable with `-A trace-in-no-trace`/`#[allow(trace_in_no_trace)]`) ensures that
+/// wrappers marked with must_not_have_traceable(i: usize) only stores
+/// non-jsmanaged (DOES NOT implement JSTraceble) type in i-th generic
+///
+/// For example usage look at the tests
+pub(crate) struct NotracePass {
+ symbols: Symbols,
+}
+
+impl NotracePass {
+ pub(crate) fn new(symbols: Symbols) -> Self {
+ Self { symbols }
+ }
+}
+
+impl LintPass for NotracePass {
+ fn name(&self) -> &'static str {
+ "ServoNotracePass"
+ }
+}
+
+fn get_must_not_have_traceable(sym: &Symbols, attrs: &[Attribute]) -> Option<usize> {
+ attrs
+ .iter()
+ .find(|attr| {
+ matches!(
+ &attr.kind,
+ AttrKind::Normal(normal)
+ if normal.item.path.segments.len() == 3 &&
+ normal.item.path.segments[0].ident.name == sym.crown &&
+ normal.item.path.segments[1].ident.name == sym.trace_in_no_trace_lint &&
+ normal.item.path.segments[2].ident.name == sym.must_not_have_traceable
+ )
+ })
+ .map(|x| match &x.get_normal_item().args {
+ AttrArgs::Empty => 0,
+ AttrArgs::Delimited(a) => match a
+ .tokens
+ .trees()
+ .next()
+ .expect("Arguments not found for must_not_have_traceable")
+ {
+ TokenTree::Token(tok, _) => match tok.kind {
+ TokenKind::Literal(lit) => lit.symbol.as_str().parse().unwrap(),
+ _ => panic!("must_not_have_traceable expected integer literal here"),
+ },
+ TokenTree::Delimited(_, _, _) => {
+ todo!("must_not_have_traceable does not support multiple notraceable positions")
+ },
+ },
+ _ => {
+ panic!("must_not_have_traceable does not support key-value arguments")
+ },
+ })
+}
+
+fn is_jstraceable<'tcx>(cx: &LateContext<'tcx>, ty: ty::Ty<'tcx>) -> bool {
+ // TODO(sagudev): get_trait_def_id is expensive, use lazy and cache it for whole pass
+ if let Some(trait_id) = get_trait_def_id(cx, &["mozjs", "gc", "Traceable"]) {
+ return implements_trait(cx, ty, trait_id, &[]);
+ }
+ // when running tests
+ if let Some(trait_id) = get_local_trait_def_id(cx, "JSTraceable") {
+ return implements_trait(cx, ty, trait_id, &[]);
+ }
+ panic!("JSTraceable not found");
+}
+
+/// Gives warrning or errors for incorect usage of NoTrace like `NoTrace<impl Traceable>`.
+fn incorrect_no_trace<'tcx, I: Into<MultiSpan> + Copy>(
+ sym: &'_ Symbols,
+ cx: &LateContext<'tcx>,
+ ty: ty::Ty<'tcx>,
+ span: I,
+) {
+ let mut walker = ty.walk();
+ while let Some(generic_arg) = walker.next() {
+ let t = match generic_arg.unpack() {
+ rustc_middle::ty::subst::GenericArgKind::Type(t) => t,
+ _ => {
+ walker.skip_current_subtree();
+ continue;
+ },
+ };
+ let recur_into_subtree = match t.kind() {
+ ty::Adt(did, substs) => {
+ if let Some(pos) =
+ get_must_not_have_traceable(sym, &cx.tcx.get_attrs_unchecked(did.did()))
+ {
+ let inner = substs.type_at(pos);
+ if inner.is_primitive_ty() {
+ cx.lint(
+ EMPTY_TRACE_IN_NO_TRACE,
+ EMPTY_TRACE_IN_NO_TRACE_MSG,
+ |lint| lint.set_span(span),
+ )
+ } else if is_jstraceable(cx, inner) {
+ cx.lint(
+ TRACE_IN_NO_TRACE,
+ format!(
+ "must_not_have_traceable marked wrapper must not have \
+jsmanaged inside on {pos}-th position. Consider removing the wrapper."
+ ),
+ |lint| lint.set_span(span),
+ )
+ }
+ false
+ } else {
+ true
+ }
+ },
+ _ => !t.is_primitive_ty(),
+ };
+ if !recur_into_subtree {
+ walker.skip_current_subtree();
+ }
+ }
+}
+
+// NoTrace correct usage of NoTrace must only be checked on Struct (item) and Enums (variants)
+// as these are the only ones that are actually traced
+impl<'tcx> LateLintPass<'tcx> for NotracePass {
+ fn check_item(&mut self, cx: &LateContext<'tcx>, item: &'tcx hir::Item) {
+ // TODO: better performance if we limit with lint attr???
+ /*let attrs = cx.tcx.hir().attrs(item.hir_id());
+ if has_lint_attr(&self.symbols, &attrs, self.symbols.must_root) {
+ return;
+ }*/
+ if let hir::ItemKind::Struct(def, ..) = &item.kind {
+ for ref field in def.fields() {
+ let field_type = cx.tcx.type_of(field.def_id);
+ incorrect_no_trace(&self.symbols, cx, field_type.0, field.span);
+ }
+ }
+ }
+
+ fn check_variant(&mut self, cx: &LateContext, var: &hir::Variant) {
+ match var.data {
+ hir::VariantData::Tuple(fields, ..) => {
+ for field in fields {
+ let field_type = cx.tcx.type_of(field.def_id);
+ incorrect_no_trace(&self.symbols, cx, field_type.0, field.ty.span);
+ }
+ },
+ _ => (), // Struct variants already caught by check_struct_def
+ }
+ }
+}
+
+symbols! {
+ crown
+ trace_in_no_trace_lint
+ must_not_have_traceable
+}