src/librustc_metadata/cstore_impl.rs

   1 // Copyright 2015 The Rust Project Developers. See the COPYRIGHT
   2 // file at the top-level directory of this distribution and at
   3 // http://rust-lang.org/COPYRIGHT.
   4 //
   5 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
   6 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
   7 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
   8 // option. This file may not be copied, modified, or distributed
   9 // except according to those terms.
  10
  11 use cstore;
  12 use encoder;
  13 use locator;
  14 use schema;
  15
  16 use rustc::middle::cstore::{InlinedItem, CrateStore, CrateSource, LibSource, DepKind, ExternCrate};
  17 use rustc::middle::cstore::{NativeLibrary, LinkMeta, LinkagePreference, LoadedMacro};
  18 use rustc::hir::def::{self, Def};
  19 use rustc::middle::lang_items;
  20 use rustc::session::Session;
  21 use rustc::ty::{self, Ty, TyCtxt};
  22 use rustc::hir::def_id::{CrateNum, DefId, DefIndex, CRATE_DEF_INDEX};
  23
  24 use rustc::dep_graph::DepNode;
  25 use rustc::hir::map as hir_map;
  26 use rustc::hir::map::DefKey;
  27 use rustc::mir::Mir;
  28 use rustc::util::nodemap::{NodeSet, DefIdMap};
  29 use rustc_back::PanicStrategy;
  30
  31 use syntax::ast;
  32 use syntax::attr;
  33 use syntax::parse::{token, new_parser_from_source_str};
  34 use syntax_pos::mk_sp;
  35 use rustc::hir::svh::Svh;
  36 use rustc_back::target::Target;
  37 use rustc::hir;
  38
  39 impl<'tcx> CrateStore<'tcx> for cstore::CStore {
  40     fn describe_def(&self, def: DefId) -> Option<Def> {
  41         self.dep_graph.read(DepNode::MetaData(def));
  42         self.get_crate_data(def.krate).get_def(def.index)
  43     }
  44
  45     fn stability(&self, def: DefId) -> Option<attr::Stability> {
  46         self.dep_graph.read(DepNode::MetaData(def));
  47         self.get_crate_data(def.krate).get_stability(def.index)
  48     }
  49
  50     fn deprecation(&self, def: DefId) -> Option<attr::Deprecation> {
  51         self.dep_graph.read(DepNode::MetaData(def));
  52         self.get_crate_data(def.krate).get_deprecation(def.index)
  53     }
  54
  55     fn visibility(&self, def: DefId) -> ty::Visibility {
  56         self.dep_graph.read(DepNode::MetaData(def));
  57         self.get_crate_data(def.krate).get_visibility(def.index)
  58     }
  59
  60     fn closure_kind(&self, def_id: DefId) -> ty::ClosureKind
  61     {
  62         assert!(!def_id.is_local());
  63         self.dep_graph.read(DepNode::MetaData(def_id));
  64         self.get_crate_data(def_id.krate).closure_kind(def_id.index)
  65     }
  66
  67     fn closure_ty<'a>(&self, tcx: TyCtxt<'a, 'tcx, 'tcx>, def_id: DefId) -> ty::ClosureTy<'tcx> {
  68         assert!(!def_id.is_local());
  69         self.dep_graph.read(DepNode::MetaData(def_id));
  70         self.get_crate_data(def_id.krate).closure_ty(def_id.index, tcx)
  71     }
  72
  73     fn item_variances(&self, def: DefId) -> Vec<ty::Variance> {
  74         self.dep_graph.read(DepNode::MetaData(def));
  75         self.get_crate_data(def.krate).get_item_variances(def.index)
  76     }
  77
  78     fn item_type<'a>(&self, tcx: TyCtxt<'a, 'tcx, 'tcx>, def: DefId)
  79                      -> Ty<'tcx>
  80     {
  81         self.dep_graph.read(DepNode::MetaData(def));
  82         self.get_crate_data(def.krate).get_type(def.index, tcx)
  83     }
  84
  85     fn item_predicates<'a>(&self, tcx: TyCtxt<'a, 'tcx, 'tcx>, def: DefId)
  86                            -> ty::GenericPredicates<'tcx>
  87     {
  88         self.dep_graph.read(DepNode::MetaData(def));
  89         self.get_crate_data(def.krate).get_predicates(def.index, tcx)
  90     }
  91
  92     fn item_super_predicates<'a>(&self, tcx: TyCtxt<'a, 'tcx, 'tcx>, def: DefId)
  93                                  -> ty::GenericPredicates<'tcx>
  94     {
  95         self.dep_graph.read(DepNode::MetaData(def));
  96         self.get_crate_data(def.krate).get_super_predicates(def.index, tcx)
  97     }
  98
  99     fn item_generics<'a>(&self, tcx: TyCtxt<'a, 'tcx, 'tcx>, def: DefId)
 100                          -> ty::Generics<'tcx>
 101     {
 102         self.dep_graph.read(DepNode::MetaData(def));
 103         self.get_crate_data(def.krate).get_generics(def.index, tcx)
 104     }
 105
 106     fn item_attrs(&self, def_id: DefId) -> Vec<ast::Attribute>
 107     {
 108         self.dep_graph.read(DepNode::MetaData(def_id));
 109         self.get_crate_data(def_id.krate).get_item_attrs(def_id.index)
 110     }
 111
 112     fn trait_def<'a>(&self, tcx: TyCtxt<'a, 'tcx, 'tcx>, def: DefId) -> ty::TraitDef<'tcx>
 113     {
 114         self.dep_graph.read(DepNode::MetaData(def));
 115         self.get_crate_data(def.krate).get_trait_def(def.index, tcx)
 116     }
 117
 118     fn adt_def<'a>(&self, tcx: TyCtxt<'a, 'tcx, 'tcx>, def: DefId) -> ty::AdtDefMaster<'tcx>
 119     {
 120         self.dep_graph.read(DepNode::MetaData(def));
 121         self.get_crate_data(def.krate).get_adt_def(def.index, tcx)
 122     }
 123
 124     fn fn_arg_names(&self, did: DefId) -> Vec<ast::Name>
 125     {
 126         self.dep_graph.read(DepNode::MetaData(did));
 127         self.get_crate_data(did.krate).get_fn_arg_names(did.index)
 128     }
 129
 130     fn inherent_implementations_for_type(&self, def_id: DefId) -> Vec<DefId>
 131     {
 132         self.dep_graph.read(DepNode::MetaData(def_id));
 133         self.get_crate_data(def_id.krate).get_inherent_implementations_for_type(def_id.index)
 134     }
 135
 136     fn implementations_of_trait(&self, filter: Option<DefId>) -> Vec<DefId>
 137     {
 138         if let Some(def_id) = filter {
 139             self.dep_graph.read(DepNode::MetaData(def_id));
 140         }
 141         let mut result = vec![];
 142         self.iter_crate_data(|_, cdata| {
 143             cdata.get_implementations_for_trait(filter, &mut result)
 144         });
 145         result
 146     }
 147
 148     fn associated_item_def_ids(&self, def_id: DefId) -> Vec<DefId> {
 149         self.dep_graph.read(DepNode::MetaData(def_id));
 150         let mut result = vec![];
 151         self.get_crate_data(def_id.krate)
 152             .each_child_of_item(def_id.index, |child| result.push(child.def.def_id()));
 153         result
 154     }
 155
 156     fn impl_polarity(&self, def: DefId) -> hir::ImplPolarity
 157     {
 158         self.dep_graph.read(DepNode::MetaData(def));
 159         self.get_crate_data(def.krate).get_impl_polarity(def.index)
 160     }
 161
 162     fn impl_trait_ref<'a>(&self, tcx: TyCtxt<'a, 'tcx, 'tcx>, def: DefId)
 163                           -> Option<ty::TraitRef<'tcx>>
 164     {
 165         self.dep_graph.read(DepNode::MetaData(def));
 166         self.get_crate_data(def.krate).get_impl_trait(def.index, tcx)
 167     }
 168
 169     fn custom_coerce_unsized_kind(&self, def: DefId)
 170                                   -> Option<ty::adjustment::CustomCoerceUnsized>
 171     {
 172         self.dep_graph.read(DepNode::MetaData(def));
 173         self.get_crate_data(def.krate).get_custom_coerce_unsized_kind(def.index)
 174     }
 175
 176     fn impl_parent(&self, impl_def: DefId) -> Option<DefId> {
 177         self.dep_graph.read(DepNode::MetaData(impl_def));
 178         self.get_crate_data(impl_def.krate).get_parent_impl(impl_def.index)
 179     }
 180
 181     fn trait_of_item(&self, def_id: DefId) -> Option<DefId> {
 182         self.dep_graph.read(DepNode::MetaData(def_id));
 183         self.get_crate_data(def_id.krate).get_trait_of_item(def_id.index)
 184     }
 185
 186     fn associated_item<'a>(&self, _tcx: TyCtxt<'a, 'tcx, 'tcx>, def: DefId)
 187                            -> Option<ty::AssociatedItem>
 188     {
 189         self.dep_graph.read(DepNode::MetaData(def));
 190         self.get_crate_data(def.krate).get_associated_item(def.index)
 191     }
 192
 193     fn is_const_fn(&self, did: DefId) -> bool
 194     {
 195         self.dep_graph.read(DepNode::MetaData(did));
 196         self.get_crate_data(did.krate).is_const_fn(did.index)
 197     }
 198
 199     fn is_defaulted_trait(&self, trait_def_id: DefId) -> bool
 200     {
 201         self.dep_graph.read(DepNode::MetaData(trait_def_id));
 202         self.get_crate_data(trait_def_id.krate).is_defaulted_trait(trait_def_id.index)
 203     }
 204
 205     fn is_default_impl(&self, impl_did: DefId) -> bool {
 206         self.dep_graph.read(DepNode::MetaData(impl_did));
 207         self.get_crate_data(impl_did.krate).is_default_impl(impl_did.index)
 208     }
 209
 210     fn is_foreign_item(&self, did: DefId) -> bool {
 211         self.get_crate_data(did.krate).is_foreign_item(did.index)
 212     }
 213
 214     fn is_statically_included_foreign_item(&self, id: ast::NodeId) -> bool
 215     {
 216         self.do_is_statically_included_foreign_item(id)
 217     }
 218
 219     fn dylib_dependency_formats(&self, cnum: CrateNum)
 220                                 -> Vec<(CrateNum, LinkagePreference)>
 221     {
 222         self.get_crate_data(cnum).get_dylib_dependency_formats()
 223     }
 224
 225     fn dep_kind(&self, cnum: CrateNum) -> DepKind
 226     {
 227         self.get_crate_data(cnum).dep_kind.get()
 228     }
 229
 230     fn lang_items(&self, cnum: CrateNum) -> Vec<(DefIndex, usize)>
 231     {
 232         self.get_crate_data(cnum).get_lang_items()
 233     }
 234
 235     fn missing_lang_items(&self, cnum: CrateNum)
 236                           -> Vec<lang_items::LangItem>
 237     {
 238         self.get_crate_data(cnum).get_missing_lang_items()
 239     }
 240
 241     fn is_staged_api(&self, cnum: CrateNum) -> bool
 242     {
 243         self.get_crate_data(cnum).is_staged_api()
 244     }
 245
 246     fn is_allocator(&self, cnum: CrateNum) -> bool
 247     {
 248         self.get_crate_data(cnum).is_allocator()
 249     }
 250
 251     fn is_panic_runtime(&self, cnum: CrateNum) -> bool
 252     {
 253         self.get_crate_data(cnum).is_panic_runtime()
 254     }
 255
 256     fn is_compiler_builtins(&self, cnum: CrateNum) -> bool {
 257         self.get_crate_data(cnum).is_compiler_builtins()
 258     }
 259
 260     fn panic_strategy(&self, cnum: CrateNum) -> PanicStrategy {
 261         self.get_crate_data(cnum).panic_strategy()
 262     }
 263
 264     fn crate_name(&self, cnum: CrateNum) -> token::InternedString
 265     {
 266         token::intern_and_get_ident(&self.get_crate_data(cnum).name[..])
 267     }
 268
 269     fn original_crate_name(&self, cnum: CrateNum) -> token::InternedString
 270     {
 271         token::intern_and_get_ident(&self.get_crate_data(cnum).name())
 272     }
 273
 274     fn extern_crate(&self, cnum: CrateNum) -> Option<ExternCrate>
 275     {
 276         self.get_crate_data(cnum).extern_crate.get()
 277     }
 278
 279     fn crate_hash(&self, cnum: CrateNum) -> Svh
 280     {
 281         self.get_crate_hash(cnum)
 282     }
 283
 284     fn crate_disambiguator(&self, cnum: CrateNum) -> token::InternedString
 285     {
 286         token::intern_and_get_ident(&self.get_crate_data(cnum).disambiguator())
 287     }
 288
 289     fn plugin_registrar_fn(&self, cnum: CrateNum) -> Option<DefId>
 290     {
 291         self.get_crate_data(cnum).root.plugin_registrar_fn.map(|index| DefId {
 292             krate: cnum,
 293             index: index
 294         })
 295     }
 296
 297     fn native_libraries(&self, cnum: CrateNum) -> Vec<NativeLibrary>
 298     {
 299         self.get_crate_data(cnum).get_native_libraries()
 300     }
 301
 302     fn reachable_ids(&self, cnum: CrateNum) -> Vec<DefId>
 303     {
 304         self.get_crate_data(cnum).get_reachable_ids()
 305     }
 306
 307     fn is_no_builtins(&self, cnum: CrateNum) -> bool {
 308         self.get_crate_data(cnum).is_no_builtins()
 309     }
 310
 311     fn def_index_for_def_key(&self,
 312                              cnum: CrateNum,
 313                              def: DefKey)
 314                              -> Option<DefIndex> {
 315         let cdata = self.get_crate_data(cnum);
 316         cdata.key_map.get(&def).cloned()
 317     }
 318
 319     /// Returns the `DefKey` for a given `DefId`. This indicates the
 320     /// parent `DefId` as well as some idea of what kind of data the
 321     /// `DefId` refers to.
 322     fn def_key(&self, def: DefId) -> hir_map::DefKey {
 323         // Note: loading the def-key (or def-path) for a def-id is not
 324         // a *read* of its metadata. This is because the def-id is
 325         // really just an interned shorthand for a def-path, which is the
 326         // canonical name for an item.
 327         //
 328         // self.dep_graph.read(DepNode::MetaData(def));
 329         self.get_crate_data(def.krate).def_key(def.index)
 330     }
 331
 332     fn relative_def_path(&self, def: DefId) -> Option<hir_map::DefPath> {
 333         // See `Note` above in `def_key()` for why this read is
 334         // commented out:
 335         //
 336         // self.dep_graph.read(DepNode::MetaData(def));
 337         self.get_crate_data(def.krate).def_path(def.index)
 338     }
 339
 340     fn struct_field_names(&self, def: DefId) -> Vec<ast::Name>
 341     {
 342         self.dep_graph.read(DepNode::MetaData(def));
 343         self.get_crate_data(def.krate).get_struct_field_names(def.index)
 344     }
 345
 346     fn item_children(&self, def_id: DefId) -> Vec<def::Export>
 347     {
 348         self.dep_graph.read(DepNode::MetaData(def_id));
 349         let mut result = vec![];
 350         self.get_crate_data(def_id.krate)
 351             .each_child_of_item(def_id.index, |child| result.push(child));
 352         result
 353     }
 354
 355     fn load_macro(&self, id: DefId, sess: &Session) -> LoadedMacro {
 356         let data = self.get_crate_data(id.krate);
 357         if let Some(ref proc_macros) = data.proc_macros {
 358             return LoadedMacro::ProcMacro(proc_macros[id.index.as_usize() - 1].1.clone());
 359         }
 360
 361         let (name, def) = data.get_macro(id.index);
 362         let source_name = format!("<{} macros>", name);
 363
 364         // NB: Don't use parse_tts_from_source_str because it parses with quote_depth > 0.
 365         let mut parser = new_parser_from_source_str(&sess.parse_sess, source_name, def.body);
 366
 367         let lo = parser.span.lo;
 368         let body = match parser.parse_all_token_trees() {
 369             Ok(body) => body,
 370             Err(mut err) => {
 371                 err.emit();
 372                 sess.abort_if_errors();
 373                 unreachable!();
 374             }
 375         };
 376         let local_span = mk_sp(lo, parser.prev_span.hi);
 377
 378         // Mark the attrs as used
 379         for attr in &def.attrs {
 380             attr::mark_used(attr);
 381         }
 382
 383         sess.imported_macro_spans.borrow_mut()
 384             .insert(local_span, (def.name.as_str().to_string(), def.span));
 385
 386         LoadedMacro::MacroRules(ast::MacroDef {
 387             ident: ast::Ident::with_empty_ctxt(def.name),
 388             id: ast::DUMMY_NODE_ID,
 389             span: local_span,
 390             imported_from: None, // FIXME
 391             allow_internal_unstable: attr::contains_name(&def.attrs, "allow_internal_unstable"),
 392             attrs: def.attrs,
 393             body: body,
 394         })
 395     }
 396
 397     fn maybe_get_item_ast<'a>(&'tcx self,
 398                               tcx: TyCtxt<'a, 'tcx, 'tcx>,
 399                               def_id: DefId)
 400                               -> Option<(&'tcx InlinedItem, ast::NodeId)>
 401     {
 402         self.dep_graph.read(DepNode::MetaData(def_id));
 403
 404         match self.inlined_item_cache.borrow().get(&def_id) {
 405             Some(&None) => {
 406                 return None; // Not inlinable
 407             }
 408             Some(&Some(ref cached_inlined_item)) => {
 409                 // Already inline
 410                 debug!("maybe_get_item_ast({}): already inline as node id {}",
 411                           tcx.item_path_str(def_id), cached_inlined_item.item_id);
 412                 return Some((tcx.map.expect_inlined_item(cached_inlined_item.inlined_root),
 413                              cached_inlined_item.item_id));
 414             }
 415             None => {
 416                 // Not seen yet
 417             }
 418         }
 419
 420         debug!("maybe_get_item_ast({}): inlining item", tcx.item_path_str(def_id));
 421
 422         let inlined = self.get_crate_data(def_id.krate).maybe_get_item_ast(tcx, def_id.index);
 423
 424         let cache_inlined_item = |original_def_id, inlined_item_id, inlined_root_node_id| {
 425             let cache_entry = cstore::CachedInlinedItem {
 426                 inlined_root: inlined_root_node_id,
 427                 item_id: inlined_item_id,
 428             };
 429             self.inlined_item_cache
 430                 .borrow_mut()
 431                 .insert(original_def_id, Some(cache_entry));
 432             self.defid_for_inlined_node
 433                 .borrow_mut()
 434                 .insert(inlined_item_id, original_def_id);
 435         };
 436
 437         let find_inlined_item_root = |inlined_item_id| {
 438             let mut node = inlined_item_id;
 439             let mut path = Vec::with_capacity(10);
 440
 441             // If we can't find the inline root after a thousand hops, we can
 442             // be pretty sure there's something wrong with the HIR map.
 443             for _ in 0 .. 1000 {
 444                 path.push(node);
 445                 let parent_node = tcx.map.get_parent_node(node);
 446                 if parent_node == node {
 447                     return node;
 448                 }
 449                 node = parent_node;
 450             }
 451             bug!("cycle in HIR map parent chain")
 452         };
 453
 454         match inlined {
 455             None => {
 456                 self.inlined_item_cache
 457                     .borrow_mut()
 458                     .insert(def_id, None);
 459             }
 460             Some(&InlinedItem::Item(d, ref item)) => {
 461                 assert_eq!(d, def_id);
 462                 let inlined_root_node_id = find_inlined_item_root(item.id);
 463                 cache_inlined_item(def_id, item.id, inlined_root_node_id);
 464             }
 465             Some(&InlinedItem::TraitItem(_, ref trait_item)) => {
 466                 let inlined_root_node_id = find_inlined_item_root(trait_item.id);
 467                 cache_inlined_item(def_id, trait_item.id, inlined_root_node_id);
 468
 469                 // Associated consts already have to be evaluated in `typeck`, so
 470                 // the logic to do that already exists in `middle`. In order to
 471                 // reuse that code, it needs to be able to look up the traits for
 472                 // inlined items.
 473                 let ty_trait_item = tcx.associated_item(def_id).clone();
 474                 let trait_item_def_id = tcx.map.local_def_id(trait_item.id);
 475                 tcx.associated_items.borrow_mut()
 476                    .insert(trait_item_def_id, ty_trait_item);
 477             }
 478             Some(&InlinedItem::ImplItem(_, ref impl_item)) => {
 479                 let inlined_root_node_id = find_inlined_item_root(impl_item.id);
 480                 cache_inlined_item(def_id, impl_item.id, inlined_root_node_id);
 481             }
 482         }
 483
 484         // We can be sure to hit the cache now
 485         return self.maybe_get_item_ast(tcx, def_id);
 486     }
 487
 488     fn local_node_for_inlined_defid(&'tcx self, def_id: DefId) -> Option<ast::NodeId> {
 489         assert!(!def_id.is_local());
 490         match self.inlined_item_cache.borrow().get(&def_id) {
 491             Some(&Some(ref cached_inlined_item)) => {
 492                 Some(cached_inlined_item.item_id)
 493             }
 494             Some(&None) => {
 495                 None
 496             }
 497             _ => {
 498                 bug!("Trying to lookup inlined NodeId for unexpected item");
 499             }
 500         }
 501     }
 502
 503     fn defid_for_inlined_node(&'tcx self, node_id: ast::NodeId) -> Option<DefId> {
 504         self.defid_for_inlined_node.borrow().get(&node_id).map(|x| *x)
 505     }
 506
 507     fn get_item_mir<'a>(&self, tcx: TyCtxt<'a, 'tcx, 'tcx>, def: DefId) -> Mir<'tcx> {
 508         self.dep_graph.read(DepNode::MetaData(def));
 509         self.get_crate_data(def.krate).maybe_get_item_mir(tcx, def.index).unwrap_or_else(|| {
 510             bug!("get_item_mir: missing MIR for {}", tcx.item_path_str(def))
 511         })
 512     }
 513
 514     fn is_item_mir_available(&self, def: DefId) -> bool {
 515         self.dep_graph.read(DepNode::MetaData(def));
 516         self.get_crate_data(def.krate).is_item_mir_available(def.index)
 517     }
 518
 519     fn crates(&self) -> Vec<CrateNum>
 520     {
 521         let mut result = vec![];
 522         self.iter_crate_data(|cnum, _| result.push(cnum));
 523         result
 524     }
 525
 526     fn used_libraries(&self) -> Vec<NativeLibrary>
 527     {
 528         self.get_used_libraries().borrow().clone()
 529     }
 530
 531     fn used_link_args(&self) -> Vec<String>
 532     {
 533         self.get_used_link_args().borrow().clone()
 534     }
 535
 536     fn metadata_filename(&self) -> &str
 537     {
 538         locator::METADATA_FILENAME
 539     }
 540
 541     fn metadata_section_name(&self, target: &Target) -> &str
 542     {
 543         locator::meta_section_name(target)
 544     }
 545
 546     fn used_crates(&self, prefer: LinkagePreference) -> Vec<(CrateNum, LibSource)>
 547     {
 548         self.do_get_used_crates(prefer)
 549     }
 550
 551     fn used_crate_source(&self, cnum: CrateNum) -> CrateSource
 552     {
 553         self.get_crate_data(cnum).source.clone()
 554     }
 555
 556     fn extern_mod_stmt_cnum(&self, emod_id: ast::NodeId) -> Option<CrateNum>
 557     {
 558         self.do_extern_mod_stmt_cnum(emod_id)
 559     }
 560
 561     fn encode_metadata<'a>(&self, tcx: TyCtxt<'a, 'tcx, 'tcx>,
 562                            reexports: &def::ExportMap,
 563                            link_meta: &LinkMeta,
 564                            reachable: &NodeSet) -> Vec<u8>
 565     {
 566         encoder::encode_metadata(tcx, self, reexports, link_meta, reachable)
 567     }
 568
 569     fn metadata_encoding_version(&self) -> &[u8]
 570     {
 571         schema::METADATA_HEADER
 572     }
 573
 574     /// Returns a map from a sufficiently visible external item (i.e. an external item that is
 575     /// visible from at least one local module) to a sufficiently visible parent (considering
 576     /// modules that re-export the external item to be parents).
 577     fn visible_parent_map<'a>(&'a self) -> ::std::cell::RefMut<'a, DefIdMap<DefId>> {
 578         let mut visible_parent_map = self.visible_parent_map.borrow_mut();
 579         if !visible_parent_map.is_empty() { return visible_parent_map; }
 580
 581         use std::collections::vec_deque::VecDeque;
 582         use std::collections::hash_map::Entry;
 583         for cnum in (1 .. self.next_crate_num().as_usize()).map(CrateNum::new) {
 584             let cdata = self.get_crate_data(cnum);
 585
 586             match cdata.extern_crate.get() {
 587                 // Ignore crates without a corresponding local `extern crate` item.
 588                 Some(extern_crate) if !extern_crate.direct => continue,
 589                 _ => {},
 590             }
 591
 592             let mut bfs_queue = &mut VecDeque::new();
 593             let mut add_child = |bfs_queue: &mut VecDeque<_>, child: def::Export, parent: DefId| {
 594                 let child = child.def.def_id();
 595
 596                 if self.visibility(child) != ty::Visibility::Public {
 597                     return;
 598                 }
 599
 600                 match visible_parent_map.entry(child) {
 601                     Entry::Occupied(mut entry) => {
 602                         // If `child` is defined in crate `cnum`, ensure
 603                         // that it is mapped to a parent in `cnum`.
 604                         if child.krate == cnum && entry.get().krate != cnum {
 605                             entry.insert(parent);
 606                         }
 607                     }
 608                     Entry::Vacant(entry) => {
 609                         entry.insert(parent);
 610                         bfs_queue.push_back(child);
 611                     }
 612                 }
 613             };
 614
 615             bfs_queue.push_back(DefId {
 616                 krate: cnum,
 617                 index: CRATE_DEF_INDEX
 618             });
 619             while let Some(def) = bfs_queue.pop_front() {
 620                 for child in self.item_children(def) {
 621                     add_child(bfs_queue, child, def);
 622                 }
 623             }
 624         }
 625
 626         visible_parent_map
 627     }
 628 }