src/librustc_codegen_llvm/abi.rs

   1 // Copyright 2012-2016 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 llvm::{self, AttributePlace};
  12 use base;
  13 use builder::{Builder, MemFlags};
  14 use common::C_usize;
  15 use context::CodegenCx;
  16 use mir::place::PlaceRef;
  17 use mir::operand::OperandValue;
  18 use type_::Type;
  19 use type_of::{LayoutLlvmExt, PointerKind};
  20 use value::Value;
  21
  22 use rustc_target::abi::{LayoutOf, Size, TyLayout, Abi as LayoutAbi};
  23 use rustc::ty::{self, Ty};
  24 use rustc::ty::layout;
  25
  26 use libc::c_uint;
  27
  28 pub use rustc_target::spec::abi::Abi;
  29 pub use rustc::ty::layout::{FAT_PTR_ADDR, FAT_PTR_EXTRA};
  30 pub use rustc_target::abi::call::*;
  31
  32 macro_rules! for_each_kind {
  33     ($flags: ident, $f: ident, $($kind: ident),+) => ({
  34         $(if $flags.contains(ArgAttribute::$kind) { $f(llvm::Attribute::$kind) })+
  35     })
  36 }
  37
  38 trait ArgAttributeExt {
  39     fn for_each_kind<F>(&self, f: F) where F: FnMut(llvm::Attribute);
  40 }
  41
  42 impl ArgAttributeExt for ArgAttribute {
  43     fn for_each_kind<F>(&self, mut f: F) where F: FnMut(llvm::Attribute) {
  44         for_each_kind!(self, f,
  45                        ByVal, NoAlias, NoCapture, NonNull, ReadOnly, SExt, StructRet, ZExt, InReg)
  46     }
  47 }
  48
  49 pub trait ArgAttributesExt {
  50     fn apply_llfn(&self, idx: AttributePlace, llfn: &Value);
  51     fn apply_callsite(&self, idx: AttributePlace, callsite: &Value);
  52 }
  53
  54 impl ArgAttributesExt for ArgAttributes {
  55     fn apply_llfn(&self, idx: AttributePlace, llfn: &Value) {
  56         let mut regular = self.regular;
  57         unsafe {
  58             let deref = self.pointee_size.bytes();
  59             if deref != 0 {
  60                 if regular.contains(ArgAttribute::NonNull) {
  61                     llvm::LLVMRustAddDereferenceableAttr(llfn,
  62                                                          idx.as_uint(),
  63                                                          deref);
  64                 } else {
  65                     llvm::LLVMRustAddDereferenceableOrNullAttr(llfn,
  66                                                                idx.as_uint(),
  67                                                                deref);
  68                 }
  69                 regular -= ArgAttribute::NonNull;
  70             }
  71             if let Some(align) = self.pointee_align {
  72                 llvm::LLVMRustAddAlignmentAttr(llfn,
  73                                                idx.as_uint(),
  74                                                align.abi() as u32);
  75             }
  76             regular.for_each_kind(|attr| attr.apply_llfn(idx, llfn));
  77         }
  78     }
  79
  80     fn apply_callsite(&self, idx: AttributePlace, callsite: &Value) {
  81         let mut regular = self.regular;
  82         unsafe {
  83             let deref = self.pointee_size.bytes();
  84             if deref != 0 {
  85                 if regular.contains(ArgAttribute::NonNull) {
  86                     llvm::LLVMRustAddDereferenceableCallSiteAttr(callsite,
  87                                                                  idx.as_uint(),
  88                                                                  deref);
  89                 } else {
  90                     llvm::LLVMRustAddDereferenceableOrNullCallSiteAttr(callsite,
  91                                                                        idx.as_uint(),
  92                                                                        deref);
  93                 }
  94                 regular -= ArgAttribute::NonNull;
  95             }
  96             if let Some(align) = self.pointee_align {
  97                 llvm::LLVMRustAddAlignmentCallSiteAttr(callsite,
  98                                                        idx.as_uint(),
  99                                                        align.abi() as u32);
 100             }
 101             regular.for_each_kind(|attr| attr.apply_callsite(idx, callsite));
 102         }
 103     }
 104 }
 105
 106 pub trait LlvmType {
 107     fn llvm_type(&self, cx: &CodegenCx<'ll, '_>) -> &'ll Type;
 108 }
 109
 110 impl LlvmType for Reg {
 111     fn llvm_type(&self, cx: &CodegenCx<'ll, '_>) -> &'ll Type {
 112         match self.kind {
 113             RegKind::Integer => Type::ix(cx, self.size.bits()),
 114             RegKind::Float => {
 115                 match self.size.bits() {
 116                     32 => Type::f32(cx),
 117                     64 => Type::f64(cx),
 118                     _ => bug!("unsupported float: {:?}", self)
 119                 }
 120             }
 121             RegKind::Vector => {
 122                 Type::vector(Type::i8(cx), self.size.bytes())
 123             }
 124         }
 125     }
 126 }
 127
 128 impl LlvmType for CastTarget {
 129     fn llvm_type(&self, cx: &CodegenCx<'ll, '_>) -> &'ll Type {
 130         let rest_ll_unit = self.rest.unit.llvm_type(cx);
 131         let (rest_count, rem_bytes) = if self.rest.unit.size.bytes() == 0 {
 132             (0, 0)
 133         } else {
 134             (self.rest.total.bytes() / self.rest.unit.size.bytes(),
 135             self.rest.total.bytes() % self.rest.unit.size.bytes())
 136         };
 137
 138         if self.prefix.iter().all(|x| x.is_none()) {
 139             // Simplify to a single unit when there is no prefix and size <= unit size
 140             if self.rest.total <= self.rest.unit.size {
 141                 return rest_ll_unit;
 142             }
 143
 144             // Simplify to array when all chunks are the same size and type
 145             if rem_bytes == 0 {
 146                 return Type::array(rest_ll_unit, rest_count);
 147             }
 148         }
 149
 150         // Create list of fields in the main structure
 151         let mut args: Vec<_> =
 152             self.prefix.iter().flat_map(|option_kind| option_kind.map(
 153                 |kind| Reg { kind: kind, size: self.prefix_chunk }.llvm_type(cx)))
 154             .chain((0..rest_count).map(|_| rest_ll_unit))
 155             .collect();
 156
 157         // Append final integer
 158         if rem_bytes != 0 {
 159             // Only integers can be really split further.
 160             assert_eq!(self.rest.unit.kind, RegKind::Integer);
 161             args.push(Type::ix(cx, rem_bytes * 8));
 162         }
 163
 164         Type::struct_(cx, &args, false)
 165     }
 166 }
 167
 168 pub trait ArgTypeExt<'ll, 'tcx> {
 169     fn memory_ty(&self, cx: &CodegenCx<'ll, 'tcx>) -> &'ll Type;
 170     fn store(&self, bx: &Builder<'_, 'll, 'tcx>, val: &'ll Value, dst: PlaceRef<'ll, 'tcx>);
 171     fn store_fn_arg(&self, bx: &Builder<'_, 'll, 'tcx>, idx: &mut usize, dst: PlaceRef<'ll, 'tcx>);
 172 }
 173
 174 impl ArgTypeExt<'ll, 'tcx> for ArgType<'tcx, Ty<'tcx>> {
 175     /// Get the LLVM type for a place of the original Rust type of
 176     /// this argument/return, i.e. the result of `type_of::type_of`.
 177     fn memory_ty(&self, cx: &CodegenCx<'ll, 'tcx>) -> &'ll Type {
 178         self.layout.llvm_type(cx)
 179     }
 180
 181     /// Store a direct/indirect value described by this ArgType into a
 182     /// place for the original Rust type of this argument/return.
 183     /// Can be used for both storing formal arguments into Rust variables
 184     /// or results of call/invoke instructions into their destinations.
 185     fn store(&self, bx: &Builder<'_, 'll, 'tcx>, val: &'ll Value, dst: PlaceRef<'ll, 'tcx>) {
 186         if self.is_ignore() {
 187             return;
 188         }
 189         let cx = bx.cx;
 190         if self.is_sized_indirect() {
 191             OperandValue::Ref(val, None, self.layout.align).store(bx, dst)
 192         } else if self.is_unsized_indirect() {
 193             bug!("unsized ArgType must be handled through store_fn_arg");
 194         } else if let PassMode::Cast(cast) = self.mode {
 195             // FIXME(eddyb): Figure out when the simpler Store is safe, clang
 196             // uses it for i16 -> {i8, i8}, but not for i24 -> {i8, i8, i8}.
 197             let can_store_through_cast_ptr = false;
 198             if can_store_through_cast_ptr {
 199                 let cast_dst = bx.pointercast(dst.llval, cast.llvm_type(cx).ptr_to());
 200                 bx.store(val, cast_dst, self.layout.align);
 201             } else {
 202                 // The actual return type is a struct, but the ABI
 203                 // adaptation code has cast it into some scalar type.  The
 204                 // code that follows is the only reliable way I have
 205                 // found to do a transform like i64 -> {i32,i32}.
 206                 // Basically we dump the data onto the stack then memcpy it.
 207                 //
 208                 // Other approaches I tried:
 209                 // - Casting rust ret pointer to the foreign type and using Store
 210                 //   is (a) unsafe if size of foreign type > size of rust type and
 211                 //   (b) runs afoul of strict aliasing rules, yielding invalid
 212                 //   assembly under -O (specifically, the store gets removed).
 213                 // - Truncating foreign type to correct integral type and then
 214                 //   bitcasting to the struct type yields invalid cast errors.
 215
 216                 // We instead thus allocate some scratch space...
 217                 let scratch_size = cast.size(cx);
 218                 let scratch_align = cast.align(cx);
 219                 let llscratch = bx.alloca(cast.llvm_type(cx), "abi_cast", scratch_align);
 220                 bx.lifetime_start(llscratch, scratch_size);
 221
 222                 // ...where we first store the value...
 223                 bx.store(val, llscratch, scratch_align);
 224
 225                 // ...and then memcpy it to the intended destination.
 226                 base::call_memcpy(bx,
 227                                   bx.pointercast(dst.llval, Type::i8p(cx)),
 228                                   self.layout.align,
 229                                   bx.pointercast(llscratch, Type::i8p(cx)),
 230                                   scratch_align,
 231                                   C_usize(cx, self.layout.size.bytes()),
 232                                   MemFlags::empty());
 233
 234                 bx.lifetime_end(llscratch, scratch_size);
 235             }
 236         } else {
 237             OperandValue::Immediate(val).store(bx, dst);
 238         }
 239     }
 240
 241     fn store_fn_arg(&self, bx: &Builder<'a, 'll, 'tcx>, idx: &mut usize, dst: PlaceRef<'ll, 'tcx>) {
 242         let mut next = || {
 243             let val = llvm::get_param(bx.llfn(), *idx as c_uint);
 244             *idx += 1;
 245             val
 246         };
 247         match self.mode {
 248             PassMode::Ignore => {},
 249             PassMode::Pair(..) => {
 250                 OperandValue::Pair(next(), next()).store(bx, dst);
 251             }
 252             PassMode::Indirect(_, Some(_)) => {
 253                 OperandValue::Ref(next(), Some(next()), self.layout.align).store(bx, dst);
 254             }
 255             PassMode::Direct(_) | PassMode::Indirect(_, None) | PassMode::Cast(_) => {
 256                 self.store(bx, next(), dst);
 257             }
 258         }
 259     }
 260 }
 261
 262 pub trait FnTypeExt<'tcx> {
 263     fn of_instance(cx: &CodegenCx<'ll, 'tcx>, instance: &ty::Instance<'tcx>) -> Self;
 264     fn new(cx: &CodegenCx<'ll, 'tcx>,
 265            sig: ty::FnSig<'tcx>,
 266            extra_args: &[Ty<'tcx>]) -> Self;
 267     fn new_vtable(cx: &CodegenCx<'ll, 'tcx>,
 268                   sig: ty::FnSig<'tcx>,
 269                   extra_args: &[Ty<'tcx>]) -> Self;
 270     fn new_internal(
 271         cx: &CodegenCx<'ll, 'tcx>,
 272         sig: ty::FnSig<'tcx>,
 273         extra_args: &[Ty<'tcx>],
 274         mk_arg_type: impl Fn(Ty<'tcx>, Option<usize>) -> ArgType<'tcx, Ty<'tcx>>,
 275     ) -> Self;
 276     fn adjust_for_abi(&mut self,
 277                       cx: &CodegenCx<'ll, 'tcx>,
 278                       abi: Abi);
 279     fn llvm_type(&self, cx: &CodegenCx<'ll, 'tcx>) -> &'ll Type;
 280     fn llvm_cconv(&self) -> llvm::CallConv;
 281     fn apply_attrs_llfn(&self, llfn: &'ll Value);
 282     fn apply_attrs_callsite(&self, bx: &Builder<'a, 'll, 'tcx>, callsite: &'ll Value);
 283 }
 284
 285 impl<'tcx> FnTypeExt<'tcx> for FnType<'tcx, Ty<'tcx>> {
 286     fn of_instance(cx: &CodegenCx<'ll, 'tcx>, instance: &ty::Instance<'tcx>) -> Self {
 287         let sig = instance.fn_sig(cx.tcx);
 288         let sig = cx.tcx.normalize_erasing_late_bound_regions(ty::ParamEnv::reveal_all(), &sig);
 289         FnType::new(cx, sig, &[])
 290     }
 291
 292     fn new(cx: &CodegenCx<'ll, 'tcx>,
 293            sig: ty::FnSig<'tcx>,
 294            extra_args: &[Ty<'tcx>]) -> Self {
 295         FnType::new_internal(cx, sig, extra_args, |ty, _| {
 296             ArgType::new(cx.layout_of(ty))
 297         })
 298     }
 299
 300     fn new_vtable(cx: &CodegenCx<'ll, 'tcx>,
 301                   sig: ty::FnSig<'tcx>,
 302                   extra_args: &[Ty<'tcx>]) -> Self {
 303         FnType::new_internal(cx, sig, extra_args, |ty, arg_idx| {
 304             let mut layout = cx.layout_of(ty);
 305             // Don't pass the vtable, it's not an argument of the virtual fn.
 306             // Instead, pass just the data pointer, but give it the type `*const/mut dyn Trait`
 307             // or `&/&mut dyn Trait` because this is special-cased elsewhere in codegen
 308             if arg_idx == Some(0) {
 309                 let fat_pointer_ty = if layout.is_unsized() {
 310                     // unsized `self` is passed as a pointer to `self`
 311                     // FIXME (mikeyhew) change this to use &own if it is ever added to the language
 312                     cx.tcx.mk_mut_ptr(layout.ty)
 313                 } else {
 314                     match layout.abi {
 315                         LayoutAbi::ScalarPair(..) => (),
 316                         _ => bug!("receiver type has unsupported layout: {:?}", layout)
 317                     }
 318
 319                     // In the case of Rc<Self>, we need to explicitly pass a *mut RcBox<Self>
 320                     // with a Scalar (not ScalarPair) ABI. This is a hack that is understood
 321                     // elsewhere in the compiler as a method on a `dyn Trait`.
 322                     // To get the type `*mut RcBox<Self>`, we just keep unwrapping newtypes until we
 323                     // get a built-in pointer type
 324                     let mut fat_pointer_layout = layout;
 325                     'descend_newtypes: while !fat_pointer_layout.ty.is_unsafe_ptr()
 326                         && !fat_pointer_layout.ty.is_region_ptr()
 327                     {
 328                         'iter_fields: for i in 0..fat_pointer_layout.fields.count() {
 329                             let field_layout = fat_pointer_layout.field(cx, i);
 330
 331                             if !field_layout.is_zst() {
 332                                 fat_pointer_layout = field_layout;
 333                                 continue 'descend_newtypes
 334                             }
 335                         }
 336
 337                         bug!("receiver has no non-zero-sized fields {:?}", fat_pointer_layout);
 338                     }
 339
 340                     fat_pointer_layout.ty
 341                 };
 342
 343                 // we now have a type like `*mut RcBox<dyn Trait>`
 344                 // change its layout to that of `*mut ()`, a thin pointer, but keep the same type
 345                 // this is understood as a special case elsewhere in the compiler
 346                 let unit_pointer_ty = cx.tcx.mk_mut_ptr(cx.tcx.mk_unit());
 347                 layout = cx.layout_of(unit_pointer_ty);
 348                 layout.ty = fat_pointer_ty;
 349             }
 350             ArgType::new(layout)
 351         })
 352     }
 353
 354     fn new_internal(
 355         cx: &CodegenCx<'ll, 'tcx>,
 356         sig: ty::FnSig<'tcx>,
 357         extra_args: &[Ty<'tcx>],
 358         mk_arg_type: impl Fn(Ty<'tcx>, Option<usize>) -> ArgType<'tcx, Ty<'tcx>>,
 359     ) -> Self {
 360         debug!("FnType::new_internal({:?}, {:?})", sig, extra_args);
 361
 362         use self::Abi::*;
 363         let conv = match cx.sess().target.target.adjust_abi(sig.abi) {
 364             RustIntrinsic | PlatformIntrinsic |
 365             Rust | RustCall => Conv::C,
 366
 367             // It's the ABI's job to select this, not ours.
 368             System => bug!("system abi should be selected elsewhere"),
 369
 370             Stdcall => Conv::X86Stdcall,
 371             Fastcall => Conv::X86Fastcall,
 372             Vectorcall => Conv::X86VectorCall,
 373             Thiscall => Conv::X86ThisCall,
 374             C => Conv::C,
 375             Unadjusted => Conv::C,
 376             Win64 => Conv::X86_64Win64,
 377             SysV64 => Conv::X86_64SysV,
 378             Aapcs => Conv::ArmAapcs,
 379             PtxKernel => Conv::PtxKernel,
 380             Msp430Interrupt => Conv::Msp430Intr,
 381             X86Interrupt => Conv::X86Intr,
 382             AmdGpuKernel => Conv::AmdGpuKernel,
 383
 384             // These API constants ought to be more specific...
 385             Cdecl => Conv::C,
 386         };
 387
 388         let mut inputs = sig.inputs();
 389         let extra_args = if sig.abi == RustCall {
 390             assert!(!sig.variadic && extra_args.is_empty());
 391
 392             match sig.inputs().last().unwrap().sty {
 393                 ty::Tuple(ref tupled_arguments) => {
 394                     inputs = &sig.inputs()[0..sig.inputs().len() - 1];
 395                     tupled_arguments
 396                 }
 397                 _ => {
 398                     bug!("argument to function with \"rust-call\" ABI \
 399                           is not a tuple");
 400                 }
 401             }
 402         } else {
 403             assert!(sig.variadic || extra_args.is_empty());
 404             extra_args
 405         };
 406
 407         let target = &cx.sess().target.target;
 408         let win_x64_gnu = target.target_os == "windows"
 409                        && target.arch == "x86_64"
 410                        && target.target_env == "gnu";
 411         let linux_s390x = target.target_os == "linux"
 412                        && target.arch == "s390x"
 413                        && target.target_env == "gnu";
 414         let rust_abi = match sig.abi {
 415             RustIntrinsic | PlatformIntrinsic | Rust | RustCall => true,
 416             _ => false
 417         };
 418
 419         // Handle safe Rust thin and fat pointers.
 420         let adjust_for_rust_scalar = |attrs: &mut ArgAttributes,
 421                                       scalar: &layout::Scalar,
 422                                       layout: TyLayout<'tcx, Ty<'tcx>>,
 423                                       offset: Size,
 424                                       is_return: bool| {
 425             // Booleans are always an i1 that needs to be zero-extended.
 426             if scalar.is_bool() {
 427                 attrs.set(ArgAttribute::ZExt);
 428                 return;
 429             }
 430
 431             // Only pointer types handled below.
 432             if scalar.value != layout::Pointer {
 433                 return;
 434             }
 435
 436             if scalar.valid_range.start() < scalar.valid_range.end() {
 437                 if *scalar.valid_range.start() > 0 {
 438                     attrs.set(ArgAttribute::NonNull);
 439                 }
 440             }
 441
 442             if let Some(pointee) = layout.pointee_info_at(cx, offset) {
 443                 if let Some(kind) = pointee.safe {
 444                     attrs.pointee_size = pointee.size;
 445                     attrs.pointee_align = Some(pointee.align);
 446
 447                     // HACK(eddyb) LLVM inserts `llvm.assume` calls when inlining functions
 448                     // with align attributes, and those calls later block optimizations.
 449                     if !is_return && !cx.tcx.sess.opts.debugging_opts.arg_align_attributes {
 450                         attrs.pointee_align = None;
 451                     }
 452
 453                     // `Box` pointer parameters never alias because ownership is transferred
 454                     // `&mut` pointer parameters never alias other parameters,
 455                     // or mutable global data
 456                     //
 457                     // `&T` where `T` contains no `UnsafeCell<U>` is immutable,
 458                     // and can be marked as both `readonly` and `noalias`, as
 459                     // LLVM's definition of `noalias` is based solely on memory
 460                     // dependencies rather than pointer equality
 461                     let no_alias = match kind {
 462                         PointerKind::Shared => false,
 463                         PointerKind::UniqueOwned => true,
 464                         PointerKind::Frozen |
 465                         PointerKind::UniqueBorrowed => !is_return
 466                     };
 467                     if no_alias {
 468                         attrs.set(ArgAttribute::NoAlias);
 469                     }
 470
 471                     if kind == PointerKind::Frozen && !is_return {
 472                         attrs.set(ArgAttribute::ReadOnly);
 473                     }
 474                 }
 475             }
 476         };
 477
 478         let arg_of = |ty: Ty<'tcx>, arg_idx: Option<usize>| {
 479             let is_return = arg_idx.is_none();
 480             let mut arg = mk_arg_type(ty, arg_idx);
 481             if arg.layout.is_zst() {
 482                 // For some forsaken reason, x86_64-pc-windows-gnu
 483                 // doesn't ignore zero-sized struct arguments.
 484                 // The same is true for s390x-unknown-linux-gnu.
 485                 if is_return || rust_abi || (!win_x64_gnu && !linux_s390x) {
 486                     arg.mode = PassMode::Ignore;
 487                 }
 488             }
 489
 490             // FIXME(eddyb) other ABIs don't have logic for scalar pairs.
 491             if !is_return && rust_abi {
 492                 if let layout::Abi::ScalarPair(ref a, ref b) = arg.layout.abi {
 493                     let mut a_attrs = ArgAttributes::new();
 494                     let mut b_attrs = ArgAttributes::new();
 495                     adjust_for_rust_scalar(&mut a_attrs,
 496                                            a,
 497                                            arg.layout,
 498                                            Size::ZERO,
 499                                            false);
 500                     adjust_for_rust_scalar(&mut b_attrs,
 501                                            b,
 502                                            arg.layout,
 503                                            a.value.size(cx).abi_align(b.value.align(cx)),
 504                                            false);
 505                     arg.mode = PassMode::Pair(a_attrs, b_attrs);
 506                     return arg;
 507                 }
 508             }
 509
 510             if let layout::Abi::Scalar(ref scalar) = arg.layout.abi {
 511                 if let PassMode::Direct(ref mut attrs) = arg.mode {
 512                     adjust_for_rust_scalar(attrs,
 513                                            scalar,
 514                                            arg.layout,
 515                                            Size::ZERO,
 516                                            is_return);
 517                 }
 518             }
 519
 520             arg
 521         };
 522
 523         let mut fn_ty = FnType {
 524             ret: arg_of(sig.output(), None),
 525             args: inputs.iter().chain(extra_args).enumerate().map(|(i, ty)| {
 526                 arg_of(ty, Some(i))
 527             }).collect(),
 528             variadic: sig.variadic,
 529             conv,
 530         };
 531         fn_ty.adjust_for_abi(cx, sig.abi);
 532         fn_ty
 533     }
 534
 535     fn adjust_for_abi(&mut self,
 536                       cx: &CodegenCx<'ll, 'tcx>,
 537                       abi: Abi) {
 538         if abi == Abi::Unadjusted { return }
 539
 540         if abi == Abi::Rust || abi == Abi::RustCall ||
 541            abi == Abi::RustIntrinsic || abi == Abi::PlatformIntrinsic {
 542             let fixup = |arg: &mut ArgType<'tcx, Ty<'tcx>>| {
 543                 if arg.is_ignore() { return; }
 544
 545                 match arg.layout.abi {
 546                     layout::Abi::Aggregate { .. } => {}
 547
 548                     // This is a fun case! The gist of what this is doing is
 549                     // that we want callers and callees to always agree on the
 550                     // ABI of how they pass SIMD arguments. If we were to *not*
 551                     // make these arguments indirect then they'd be immediates
 552                     // in LLVM, which means that they'd used whatever the
 553                     // appropriate ABI is for the callee and the caller. That
 554                     // means, for example, if the caller doesn't have AVX
 555                     // enabled but the callee does, then passing an AVX argument
 556                     // across this boundary would cause corrupt data to show up.
 557                     //
 558                     // This problem is fixed by unconditionally passing SIMD
 559                     // arguments through memory between callers and callees
 560                     // which should get them all to agree on ABI regardless of
 561                     // target feature sets. Some more information about this
 562                     // issue can be found in #44367.
 563                     //
 564                     // Note that the platform intrinsic ABI is exempt here as
 565                     // that's how we connect up to LLVM and it's unstable
 566                     // anyway, we control all calls to it in libstd.
 567                     layout::Abi::Vector { .. }
 568                         if abi != Abi::PlatformIntrinsic &&
 569                             cx.sess().target.target.options.simd_types_indirect =>
 570                     {
 571                         arg.make_indirect();
 572                         return
 573                     }
 574
 575                     _ => return
 576                 }
 577
 578                 let size = arg.layout.size;
 579                 if arg.layout.is_unsized() || size > layout::Pointer.size(cx) {
 580                     arg.make_indirect();
 581                 } else {
 582                     // We want to pass small aggregates as immediates, but using
 583                     // a LLVM aggregate type for this leads to bad optimizations,
 584                     // so we pick an appropriately sized integer type instead.
 585                     arg.cast_to(Reg {
 586                         kind: RegKind::Integer,
 587                         size
 588                     });
 589                 }
 590             };
 591             fixup(&mut self.ret);
 592             for arg in &mut self.args {
 593                 fixup(arg);
 594             }
 595             if let PassMode::Indirect(ref mut attrs, _) = self.ret.mode {
 596                 attrs.set(ArgAttribute::StructRet);
 597             }
 598             return;
 599         }
 600
 601         if let Err(msg) = self.adjust_for_cabi(cx, abi) {
 602             cx.sess().fatal(&msg);
 603         }
 604     }
 605
 606     fn llvm_type(&self, cx: &CodegenCx<'ll, 'tcx>) -> &'ll Type {
 607         let args_capacity: usize = self.args.iter().map(|arg|
 608             if arg.pad.is_some() { 1 } else { 0 } +
 609             if let PassMode::Pair(_, _) = arg.mode { 2 } else { 1 }
 610         ).sum();
 611         let mut llargument_tys = Vec::with_capacity(
 612             if let PassMode::Indirect(..) = self.ret.mode { 1 } else { 0 } + args_capacity
 613         );
 614
 615         let llreturn_ty = match self.ret.mode {
 616             PassMode::Ignore => Type::void(cx),
 617             PassMode::Direct(_) | PassMode::Pair(..) => {
 618                 self.ret.layout.immediate_llvm_type(cx)
 619             }
 620             PassMode::Cast(cast) => cast.llvm_type(cx),
 621             PassMode::Indirect(..) => {
 622                 llargument_tys.push(self.ret.memory_ty(cx).ptr_to());
 623                 Type::void(cx)
 624             }
 625         };
 626
 627         for arg in &self.args {
 628             // add padding
 629             if let Some(ty) = arg.pad {
 630                 llargument_tys.push(ty.llvm_type(cx));
 631             }
 632
 633             let llarg_ty = match arg.mode {
 634                 PassMode::Ignore => continue,
 635                 PassMode::Direct(_) => arg.layout.immediate_llvm_type(cx),
 636                 PassMode::Pair(..) => {
 637                     llargument_tys.push(arg.layout.scalar_pair_element_llvm_type(cx, 0, true));
 638                     llargument_tys.push(arg.layout.scalar_pair_element_llvm_type(cx, 1, true));
 639                     continue;
 640                 }
 641                 PassMode::Indirect(_, Some(_)) => {
 642                     let ptr_ty = cx.tcx.mk_mut_ptr(arg.layout.ty);
 643                     let ptr_layout = cx.layout_of(ptr_ty);
 644                     llargument_tys.push(ptr_layout.scalar_pair_element_llvm_type(cx, 0, true));
 645                     llargument_tys.push(ptr_layout.scalar_pair_element_llvm_type(cx, 1, true));
 646                     continue;
 647                 }
 648                 PassMode::Cast(cast) => cast.llvm_type(cx),
 649                 PassMode::Indirect(_, None) => arg.memory_ty(cx).ptr_to(),
 650             };
 651             llargument_tys.push(llarg_ty);
 652         }
 653
 654         if self.variadic {
 655             Type::variadic_func(&llargument_tys, llreturn_ty)
 656         } else {
 657             Type::func(&llargument_tys, llreturn_ty)
 658         }
 659     }
 660
 661     fn llvm_cconv(&self) -> llvm::CallConv {
 662         match self.conv {
 663             Conv::C => llvm::CCallConv,
 664             Conv::AmdGpuKernel => llvm::AmdGpuKernel,
 665             Conv::ArmAapcs => llvm::ArmAapcsCallConv,
 666             Conv::Msp430Intr => llvm::Msp430Intr,
 667             Conv::PtxKernel => llvm::PtxKernel,
 668             Conv::X86Fastcall => llvm::X86FastcallCallConv,
 669             Conv::X86Intr => llvm::X86_Intr,
 670             Conv::X86Stdcall => llvm::X86StdcallCallConv,
 671             Conv::X86ThisCall => llvm::X86_ThisCall,
 672             Conv::X86VectorCall => llvm::X86_VectorCall,
 673             Conv::X86_64SysV => llvm::X86_64_SysV,
 674             Conv::X86_64Win64 => llvm::X86_64_Win64,
 675         }
 676     }
 677
 678     fn apply_attrs_llfn(&self, llfn: &'ll Value) {
 679         let mut i = 0;
 680         let mut apply = |attrs: &ArgAttributes| {
 681             attrs.apply_llfn(llvm::AttributePlace::Argument(i), llfn);
 682             i += 1;
 683         };
 684         match self.ret.mode {
 685             PassMode::Direct(ref attrs) => {
 686                 attrs.apply_llfn(llvm::AttributePlace::ReturnValue, llfn);
 687             }
 688             PassMode::Indirect(ref attrs, _) => apply(attrs),
 689             _ => {}
 690         }
 691         for arg in &self.args {
 692             if arg.pad.is_some() {
 693                 apply(&ArgAttributes::new());
 694             }
 695             match arg.mode {
 696                 PassMode::Ignore => {}
 697                 PassMode::Direct(ref attrs) |
 698                 PassMode::Indirect(ref attrs, None) => apply(attrs),
 699                 PassMode::Indirect(ref attrs, Some(ref extra_attrs)) => {
 700                     apply(attrs);
 701                     apply(extra_attrs);
 702                 }
 703                 PassMode::Pair(ref a, ref b) => {
 704                     apply(a);
 705                     apply(b);
 706                 }
 707                 PassMode::Cast(_) => apply(&ArgAttributes::new()),
 708             }
 709         }
 710     }
 711
 712     fn apply_attrs_callsite(&self, bx: &Builder<'a, 'll, 'tcx>, callsite: &'ll Value) {
 713         let mut i = 0;
 714         let mut apply = |attrs: &ArgAttributes| {
 715             attrs.apply_callsite(llvm::AttributePlace::Argument(i), callsite);
 716             i += 1;
 717         };
 718         match self.ret.mode {
 719             PassMode::Direct(ref attrs) => {
 720                 attrs.apply_callsite(llvm::AttributePlace::ReturnValue, callsite);
 721             }
 722             PassMode::Indirect(ref attrs, _) => apply(attrs),
 723             _ => {}
 724         }
 725         if let layout::Abi::Scalar(ref scalar) = self.ret.layout.abi {
 726             // If the value is a boolean, the range is 0..2 and that ultimately
 727             // become 0..0 when the type becomes i1, which would be rejected
 728             // by the LLVM verifier.
 729             if let layout::Int(..) = scalar.value {
 730                 if !scalar.is_bool() {
 731                     let range = scalar.valid_range_exclusive(bx.cx);
 732                     if range.start != range.end {
 733                         bx.range_metadata(callsite, range);
 734                     }
 735                 }
 736             }
 737         }
 738         for arg in &self.args {
 739             if arg.pad.is_some() {
 740                 apply(&ArgAttributes::new());
 741             }
 742             match arg.mode {
 743                 PassMode::Ignore => {}
 744                 PassMode::Direct(ref attrs) |
 745                 PassMode::Indirect(ref attrs, None) => apply(attrs),
 746                 PassMode::Indirect(ref attrs, Some(ref extra_attrs)) => {
 747                     apply(attrs);
 748                     apply(extra_attrs);
 749                 }
 750                 PassMode::Pair(ref a, ref b) => {
 751                     apply(a);
 752                     apply(b);
 753                 }
 754                 PassMode::Cast(_) => apply(&ArgAttributes::new()),
 755             }
 756         }
 757
 758         let cconv = self.llvm_cconv();
 759         if cconv != llvm::CCallConv {
 760             llvm::SetInstructionCallConv(callsite, cconv);
 761         }
 762     }
 763 }