compiler/rustc_codegen_llvm/src/llvm/mod.rs

   1 #![allow(non_snake_case)]
   2
   3 pub use self::AtomicRmwBinOp::*;
   4 pub use self::CallConv::*;
   5 pub use self::CodeGenOptSize::*;
   6 pub use self::IntPredicate::*;
   7 pub use self::Linkage::*;
   8 pub use self::MetadataType::*;
   9 pub use self::RealPredicate::*;
  10
  11 use libc::c_uint;
  12 use rustc_data_structures::small_c_str::SmallCStr;
  13 use rustc_llvm::RustString;
  14 use std::cell::RefCell;
  15 use std::ffi::{CStr, CString};
  16 use std::str::FromStr;
  17 use std::string::FromUtf8Error;
  18
  19 pub mod archive_ro;
  20 pub mod diagnostic;
  21 mod ffi;
  22
  23 pub use self::ffi::*;
  24
  25 impl LLVMRustResult {
  26     pub fn into_result(self) -> Result<(), ()> {
  27         match self {
  28             LLVMRustResult::Success => Ok(()),
  29             LLVMRustResult::Failure => Err(()),
  30         }
  31     }
  32 }
  33
  34 pub fn AddFunctionAttributes<'ll>(llfn: &'ll Value, idx: AttributePlace, attrs: &[&'ll Attribute]) {
  35     unsafe {
  36         LLVMRustAddFunctionAttributes(llfn, idx.as_uint(), attrs.as_ptr(), attrs.len());
  37     }
  38 }
  39
  40 pub fn AddCallSiteAttributes<'ll>(
  41     callsite: &'ll Value,
  42     idx: AttributePlace,
  43     attrs: &[&'ll Attribute],
  44 ) {
  45     unsafe {
  46         LLVMRustAddCallSiteAttributes(callsite, idx.as_uint(), attrs.as_ptr(), attrs.len());
  47     }
  48 }
  49
  50 pub fn CreateAttrStringValue<'ll>(llcx: &'ll Context, attr: &str, value: &str) -> &'ll Attribute {
  51     unsafe {
  52         LLVMCreateStringAttribute(
  53             llcx,
  54             attr.as_ptr().cast(),
  55             attr.len().try_into().unwrap(),
  56             value.as_ptr().cast(),
  57             value.len().try_into().unwrap(),
  58         )
  59     }
  60 }
  61
  62 pub fn CreateAttrString<'ll>(llcx: &'ll Context, attr: &str) -> &'ll Attribute {
  63     unsafe {
  64         LLVMCreateStringAttribute(
  65             llcx,
  66             attr.as_ptr().cast(),
  67             attr.len().try_into().unwrap(),
  68             std::ptr::null(),
  69             0,
  70         )
  71     }
  72 }
  73
  74 pub fn CreateAlignmentAttr(llcx: &Context, bytes: u64) -> &Attribute {
  75     unsafe { LLVMRustCreateAlignmentAttr(llcx, bytes) }
  76 }
  77
  78 pub fn CreateDereferenceableAttr(llcx: &Context, bytes: u64) -> &Attribute {
  79     unsafe { LLVMRustCreateDereferenceableAttr(llcx, bytes) }
  80 }
  81
  82 pub fn CreateDereferenceableOrNullAttr(llcx: &Context, bytes: u64) -> &Attribute {
  83     unsafe { LLVMRustCreateDereferenceableOrNullAttr(llcx, bytes) }
  84 }
  85
  86 pub fn CreateByValAttr<'ll>(llcx: &'ll Context, ty: &'ll Type) -> &'ll Attribute {
  87     unsafe { LLVMRustCreateByValAttr(llcx, ty) }
  88 }
  89
  90 pub fn CreateStructRetAttr<'ll>(llcx: &'ll Context, ty: &'ll Type) -> &'ll Attribute {
  91     unsafe { LLVMRustCreateStructRetAttr(llcx, ty) }
  92 }
  93
  94 pub fn CreateUWTableAttr(llcx: &Context, async_: bool) -> &Attribute {
  95     unsafe { LLVMRustCreateUWTableAttr(llcx, async_) }
  96 }
  97
  98 pub fn CreateAllocSizeAttr(llcx: &Context, size_arg: u32) -> &Attribute {
  99     unsafe { LLVMRustCreateAllocSizeAttr(llcx, size_arg) }
 100 }
 101
 102 pub fn CreateAllocKindAttr(llcx: &Context, kind_arg: AllocKindFlags) -> &Attribute {
 103     unsafe { LLVMRustCreateAllocKindAttr(llcx, kind_arg.bits()) }
 104 }
 105
 106 #[derive(Copy, Clone)]
 107 pub enum AttributePlace {
 108     ReturnValue,
 109     Argument(u32),
 110     Function,
 111 }
 112
 113 impl AttributePlace {
 114     pub fn as_uint(self) -> c_uint {
 115         match self {
 116             AttributePlace::ReturnValue => 0,
 117             AttributePlace::Argument(i) => 1 + i,
 118             AttributePlace::Function => !0,
 119         }
 120     }
 121 }
 122
 123 #[derive(Copy, Clone, PartialEq)]
 124 #[repr(C)]
 125 pub enum CodeGenOptSize {
 126     CodeGenOptSizeNone = 0,
 127     CodeGenOptSizeDefault = 1,
 128     CodeGenOptSizeAggressive = 2,
 129 }
 130
 131 impl FromStr for ArchiveKind {
 132     type Err = ();
 133
 134     fn from_str(s: &str) -> Result<Self, Self::Err> {
 135         match s {
 136             "gnu" => Ok(ArchiveKind::K_GNU),
 137             "bsd" => Ok(ArchiveKind::K_BSD),
 138             "darwin" => Ok(ArchiveKind::K_DARWIN),
 139             "coff" => Ok(ArchiveKind::K_COFF),
 140             _ => Err(()),
 141         }
 142     }
 143 }
 144
 145 pub fn SetInstructionCallConv(instr: &Value, cc: CallConv) {
 146     unsafe {
 147         LLVMSetInstructionCallConv(instr, cc as c_uint);
 148     }
 149 }
 150 pub fn SetFunctionCallConv(fn_: &Value, cc: CallConv) {
 151     unsafe {
 152         LLVMSetFunctionCallConv(fn_, cc as c_uint);
 153     }
 154 }
 155
 156 // Externally visible symbols that might appear in multiple codegen units need to appear in
 157 // their own comdat section so that the duplicates can be discarded at link time. This can for
 158 // example happen for generics when using multiple codegen units. This function simply uses the
 159 // value's name as the comdat value to make sure that it is in a 1-to-1 relationship to the
 160 // function.
 161 // For more details on COMDAT sections see e.g., https://www.airs.com/blog/archives/52
 162 pub fn SetUniqueComdat(llmod: &Module, val: &Value) {
 163     unsafe {
 164         let name = get_value_name(val);
 165         LLVMRustSetComdat(llmod, val, name.as_ptr().cast(), name.len());
 166     }
 167 }
 168
 169 pub fn SetUnnamedAddress(global: &Value, unnamed: UnnamedAddr) {
 170     unsafe {
 171         LLVMSetUnnamedAddress(global, unnamed);
 172     }
 173 }
 174
 175 pub fn set_thread_local_mode(global: &Value, mode: ThreadLocalMode) {
 176     unsafe {
 177         LLVMSetThreadLocalMode(global, mode);
 178     }
 179 }
 180
 181 impl AttributeKind {
 182     /// Create an LLVM Attribute with no associated value.
 183     pub fn create_attr(self, llcx: &Context) -> &Attribute {
 184         unsafe { LLVMRustCreateAttrNoValue(llcx, self) }
 185     }
 186 }
 187
 188 pub fn set_section(llglobal: &Value, section_name: &str) {
 189     let section_name_cstr = CString::new(section_name).expect("unexpected CString error");
 190     unsafe {
 191         LLVMSetSection(llglobal, section_name_cstr.as_ptr());
 192     }
 193 }
 194
 195 pub fn add_global<'a>(llmod: &'a Module, ty: &'a Type, name: &str) -> &'a Value {
 196     let name_cstr = CString::new(name).expect("unexpected CString error");
 197     unsafe { LLVMAddGlobal(llmod, ty, name_cstr.as_ptr()) }
 198 }
 199
 200 pub fn set_initializer(llglobal: &Value, constant_val: &Value) {
 201     unsafe {
 202         LLVMSetInitializer(llglobal, constant_val);
 203     }
 204 }
 205
 206 pub fn set_global_constant(llglobal: &Value, is_constant: bool) {
 207     unsafe {
 208         LLVMSetGlobalConstant(llglobal, if is_constant { ffi::True } else { ffi::False });
 209     }
 210 }
 211
 212 pub fn set_linkage(llglobal: &Value, linkage: Linkage) {
 213     unsafe {
 214         LLVMRustSetLinkage(llglobal, linkage);
 215     }
 216 }
 217
 218 pub fn set_visibility(llglobal: &Value, visibility: Visibility) {
 219     unsafe {
 220         LLVMRustSetVisibility(llglobal, visibility);
 221     }
 222 }
 223
 224 pub fn set_alignment(llglobal: &Value, bytes: usize) {
 225     unsafe {
 226         ffi::LLVMSetAlignment(llglobal, bytes as c_uint);
 227     }
 228 }
 229
 230 pub fn set_comdat(llmod: &Module, llglobal: &Value, name: &str) {
 231     unsafe {
 232         LLVMRustSetComdat(llmod, llglobal, name.as_ptr().cast(), name.len());
 233     }
 234 }
 235
 236 /// Safe wrapper around `LLVMGetParam`, because segfaults are no fun.
 237 pub fn get_param(llfn: &Value, index: c_uint) -> &Value {
 238     unsafe {
 239         assert!(
 240             index < LLVMCountParams(llfn),
 241             "out of bounds argument access: {} out of {} arguments",
 242             index,
 243             LLVMCountParams(llfn)
 244         );
 245         LLVMGetParam(llfn, index)
 246     }
 247 }
 248
 249 /// Safe wrapper for `LLVMGetValueName2` into a byte slice
 250 pub fn get_value_name(value: &Value) -> &[u8] {
 251     unsafe {
 252         let mut len = 0;
 253         let data = LLVMGetValueName2(value, &mut len);
 254         std::slice::from_raw_parts(data.cast(), len)
 255     }
 256 }
 257
 258 /// Safe wrapper for `LLVMSetValueName2` from a byte slice
 259 pub fn set_value_name(value: &Value, name: &[u8]) {
 260     unsafe {
 261         let data = name.as_ptr().cast();
 262         LLVMSetValueName2(value, data, name.len());
 263     }
 264 }
 265
 266 pub fn build_string(f: impl FnOnce(&RustString)) -> Result<String, FromUtf8Error> {
 267     let sr = RustString { bytes: RefCell::new(Vec::new()) };
 268     f(&sr);
 269     String::from_utf8(sr.bytes.into_inner())
 270 }
 271
 272 pub fn build_byte_buffer(f: impl FnOnce(&RustString)) -> Vec<u8> {
 273     let sr = RustString { bytes: RefCell::new(Vec::new()) };
 274     f(&sr);
 275     sr.bytes.into_inner()
 276 }
 277
 278 pub fn twine_to_string(tr: &Twine) -> String {
 279     unsafe {
 280         build_string(|s| LLVMRustWriteTwineToString(tr, s)).expect("got a non-UTF8 Twine from LLVM")
 281     }
 282 }
 283
 284 pub fn last_error() -> Option<String> {
 285     unsafe {
 286         let cstr = LLVMRustGetLastError();
 287         if cstr.is_null() {
 288             None
 289         } else {
 290             let err = CStr::from_ptr(cstr).to_bytes();
 291             let err = String::from_utf8_lossy(err).to_string();
 292             libc::free(cstr as *mut _);
 293             Some(err)
 294         }
 295     }
 296 }
 297
 298 pub struct OperandBundleDef<'a> {
 299     pub raw: &'a mut ffi::OperandBundleDef<'a>,
 300 }
 301
 302 impl<'a> OperandBundleDef<'a> {
 303     pub fn new(name: &str, vals: &[&'a Value]) -> Self {
 304         let name = SmallCStr::new(name);
 305         let def = unsafe {
 306             LLVMRustBuildOperandBundleDef(name.as_ptr(), vals.as_ptr(), vals.len() as c_uint)
 307         };
 308         OperandBundleDef { raw: def }
 309     }
 310 }
 311
 312 impl Drop for OperandBundleDef<'_> {
 313     fn drop(&mut self) {
 314         unsafe {
 315             LLVMRustFreeOperandBundleDef(&mut *(self.raw as *mut _));
 316         }
 317     }
 318 }