]> git.lizzy.rs Git - rust.git/blob - src/librustc_trans/lib.rs
Rollup merge of #40576 - dwrensha:mir-terminator-kind-doc-typo, r=nikomatsakis
[rust.git] / src / librustc_trans / lib.rs
1 // Copyright 2012-2013 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 //! The Rust compiler.
12 //!
13 //! # Note
14 //!
15 //! This API is completely unstable and subject to change.
16
17 #![crate_name = "rustc_trans"]
18 #![unstable(feature = "rustc_private", issue = "27812")]
19 #![crate_type = "dylib"]
20 #![crate_type = "rlib"]
21 #![doc(html_logo_url = "https://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png",
22       html_favicon_url = "https://doc.rust-lang.org/favicon.ico",
23       html_root_url = "https://doc.rust-lang.org/nightly/")]
24 #![deny(warnings)]
25
26 #![feature(associated_consts)]
27 #![feature(box_patterns)]
28 #![feature(box_syntax)]
29 #![feature(const_fn)]
30 #![feature(custom_attribute)]
31 #![cfg_attr(stage0, feature(field_init_shorthand))]
32 #![allow(unused_attributes)]
33 #![feature(i128_type)]
34 #![feature(libc)]
35 #![feature(quote)]
36 #![feature(rustc_diagnostic_macros)]
37 #![feature(rustc_private)]
38 #![feature(slice_patterns)]
39 #![feature(staged_api)]
40 #![feature(unicode)]
41 #![feature(conservative_impl_trait)]
42
43 use rustc::dep_graph::WorkProduct;
44
45 extern crate flate;
46 extern crate libc;
47 #[macro_use] extern crate rustc;
48 extern crate rustc_back;
49 extern crate rustc_data_structures;
50 extern crate rustc_incremental;
51 pub extern crate rustc_llvm as llvm;
52 extern crate rustc_platform_intrinsics as intrinsics;
53 extern crate rustc_const_math;
54 extern crate rustc_const_eval;
55 #[macro_use]
56 #[no_link]
57 extern crate rustc_bitflags;
58
59 #[macro_use] extern crate log;
60 #[macro_use] extern crate syntax;
61 extern crate syntax_pos;
62 extern crate rustc_errors as errors;
63 extern crate serialize;
64
65 pub use rustc::session;
66 pub use rustc::middle;
67 pub use rustc::lint;
68 pub use rustc::util;
69
70 pub use base::trans_crate;
71 pub use disr::Disr;
72
73 pub mod back {
74     pub use rustc::hir::svh;
75
76     pub mod archive;
77     pub mod linker;
78     pub mod link;
79     pub mod lto;
80     pub mod symbol_export;
81     pub mod symbol_names;
82     pub mod write;
83     pub mod msvc;
84     pub mod rpath;
85 }
86
87 pub mod diagnostics;
88
89 #[macro_use]
90 mod macros;
91
92 mod abi;
93 mod adt;
94 mod asm;
95 mod assert_module_sources;
96 mod attributes;
97 mod base;
98 mod builder;
99 mod cabi_aarch64;
100 mod cabi_arm;
101 mod cabi_asmjs;
102 mod cabi_mips;
103 mod cabi_mips64;
104 mod cabi_msp430;
105 mod cabi_nvptx;
106 mod cabi_nvptx64;
107 mod cabi_powerpc;
108 mod cabi_powerpc64;
109 mod cabi_s390x;
110 mod cabi_sparc;
111 mod cabi_sparc64;
112 mod cabi_x86;
113 mod cabi_x86_64;
114 mod cabi_x86_win64;
115 mod callee;
116 mod collector;
117 mod common;
118 mod consts;
119 mod context;
120 mod debuginfo;
121 mod declare;
122 mod disr;
123 mod glue;
124 mod intrinsic;
125 mod machine;
126 mod meth;
127 mod mir;
128 mod monomorphize;
129 mod partitioning;
130 mod symbol_map;
131 mod symbol_names_test;
132 mod trans_item;
133 mod tvec;
134 mod type_;
135 mod type_of;
136 mod value;
137
138 #[derive(Clone)]
139 pub struct ModuleTranslation {
140     /// The name of the module. When the crate may be saved between
141     /// compilations, incremental compilation requires that name be
142     /// unique amongst **all** crates.  Therefore, it should contain
143     /// something unique to this crate (e.g., a module path) as well
144     /// as the crate name and disambiguator.
145     pub name: String,
146     pub symbol_name_hash: u64,
147     pub source: ModuleSource,
148 }
149
150 #[derive(Clone)]
151 pub enum ModuleSource {
152     /// Copy the `.o` files or whatever from the incr. comp. directory.
153     Preexisting(WorkProduct),
154
155     /// Rebuild from this LLVM module.
156     Translated(ModuleLlvm),
157 }
158
159 #[derive(Copy, Clone)]
160 pub struct ModuleLlvm {
161     pub llcx: llvm::ContextRef,
162     pub llmod: llvm::ModuleRef,
163 }
164
165 unsafe impl Send for ModuleTranslation { }
166 unsafe impl Sync for ModuleTranslation { }
167
168 pub struct CrateTranslation {
169     pub modules: Vec<ModuleTranslation>,
170     pub metadata_module: ModuleTranslation,
171     pub link: middle::cstore::LinkMeta,
172     pub metadata: Vec<u8>,
173     pub exported_symbols: back::symbol_export::ExportedSymbols,
174     pub no_builtins: bool,
175     pub windows_subsystem: Option<String>,
176     pub linker_info: back::linker::LinkerInfo
177 }
178
179 __build_diagnostic_array! { librustc_trans, DIAGNOSTICS }