src/librustc_trans/trans/glue.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 //!
  12 //
  13 // Code relating to taking, dropping, etc as well as type descriptors.
  14
  15
  16 use back::abi;
  17 use back::link::*;
  18 use llvm::{ValueRef, True, get_param};
  19 use llvm;
  20 use middle::lang_items::ExchangeFreeFnLangItem;
  21 use middle::subst;
  22 use middle::subst::{Subst, Substs};
  23 use trans::adt;
  24 use trans::base::*;
  25 use trans::build::*;
  26 use trans::callee;
  27 use trans::cleanup;
  28 use trans::cleanup::CleanupMethods;
  29 use trans::consts;
  30 use trans::common::*;
  31 use trans::datum;
  32 use trans::debuginfo;
  33 use trans::expr;
  34 use trans::machine::*;
  35 use trans::tvec;
  36 use trans::type_::Type;
  37 use trans::type_of::{type_of, sizing_type_of, align_of};
  38 use middle::ty::{self, Ty};
  39 use util::ppaux::{ty_to_short_str, Repr};
  40 use util::ppaux;
  41
  42 use arena::TypedArena;
  43 use std::c_str::ToCStr;
  44 use libc::c_uint;
  45 use syntax::ast;
  46 use syntax::parse::token;
  47
  48 pub fn trans_exchange_free_dyn<'blk, 'tcx>(cx: Block<'blk, 'tcx>, v: ValueRef,
  49                                            size: ValueRef, align: ValueRef)
  50                                            -> Block<'blk, 'tcx> {
  51     let _icx = push_ctxt("trans_exchange_free");
  52     let ccx = cx.ccx();
  53     callee::trans_lang_call(cx,
  54         langcall(cx, None, "", ExchangeFreeFnLangItem),
  55         &[PointerCast(cx, v, Type::i8p(ccx)), size, align],
  56         Some(expr::Ignore)).bcx
  57 }
  58
  59 pub fn trans_exchange_free<'blk, 'tcx>(cx: Block<'blk, 'tcx>, v: ValueRef,
  60                                        size: u64, align: u32) -> Block<'blk, 'tcx> {
  61     trans_exchange_free_dyn(cx, v, C_uint(cx.ccx(), size),
  62                                    C_uint(cx.ccx(), align))
  63 }
  64
  65 pub fn trans_exchange_free_ty<'blk, 'tcx>(bcx: Block<'blk, 'tcx>, ptr: ValueRef,
  66                                           content_ty: Ty<'tcx>) -> Block<'blk, 'tcx> {
  67     assert!(type_is_sized(bcx.ccx().tcx(), content_ty));
  68     let sizing_type = sizing_type_of(bcx.ccx(), content_ty);
  69     let content_size = llsize_of_alloc(bcx.ccx(), sizing_type);
  70
  71     // `Box<ZeroSizeType>` does not allocate.
  72     if content_size != 0 {
  73         let content_align = align_of(bcx.ccx(), content_ty);
  74         trans_exchange_free(bcx, ptr, content_size, content_align)
  75     } else {
  76         bcx
  77     }
  78 }
  79
  80 pub fn get_drop_glue_type<'a, 'tcx>(ccx: &CrateContext<'a, 'tcx>,
  81                                     t: Ty<'tcx>) -> Ty<'tcx> {
  82     let tcx = ccx.tcx();
  83     // Even if there is no dtor for t, there might be one deeper down and we
  84     // might need to pass in the vtable ptr.
  85     if !type_is_sized(tcx, t) {
  86         return t
  87     }
  88     if !type_needs_drop(tcx, t) {
  89         return tcx.types.i8;
  90     }
  91     match t.sty {
  92         ty::ty_uniq(typ) if !type_needs_drop(tcx, typ)
  93                          && type_is_sized(tcx, typ) => {
  94             let llty = sizing_type_of(ccx, typ);
  95             // `Box<ZeroSizeType>` does not allocate.
  96             if llsize_of_alloc(ccx, llty) == 0 {
  97                 tcx.types.i8
  98             } else {
  99                 t
 100             }
 101         }
 102         _ => t
 103     }
 104 }
 105
 106 pub fn drop_ty<'blk, 'tcx>(bcx: Block<'blk, 'tcx>,
 107                            v: ValueRef,
 108                            t: Ty<'tcx>,
 109                            source_location: Option<NodeInfo>)
 110                            -> Block<'blk, 'tcx> {
 111     // NB: v is an *alias* of type t here, not a direct value.
 112     debug!("drop_ty(t={})", t.repr(bcx.tcx()));
 113     let _icx = push_ctxt("drop_ty");
 114     if type_needs_drop(bcx.tcx(), t) {
 115         let ccx = bcx.ccx();
 116         let glue = get_drop_glue(ccx, t);
 117         let glue_type = get_drop_glue_type(ccx, t);
 118         let ptr = if glue_type != t {
 119             PointerCast(bcx, v, type_of(ccx, glue_type).ptr_to())
 120         } else {
 121             v
 122         };
 123
 124         match source_location {
 125             Some(sl) => debuginfo::set_source_location(bcx.fcx, sl.id, sl.span),
 126             None => debuginfo::clear_source_location(bcx.fcx)
 127         };
 128
 129         Call(bcx, glue, &[ptr], None);
 130     }
 131     bcx
 132 }
 133
 134 pub fn drop_ty_immediate<'blk, 'tcx>(bcx: Block<'blk, 'tcx>,
 135                                      v: ValueRef,
 136                                      t: Ty<'tcx>,
 137                                      source_location: Option<NodeInfo>)
 138                                      -> Block<'blk, 'tcx> {
 139     let _icx = push_ctxt("drop_ty_immediate");
 140     let vp = alloca(bcx, type_of(bcx.ccx(), t), "");
 141     Store(bcx, v, vp);
 142     drop_ty(bcx, vp, t, source_location)
 143 }
 144
 145 pub fn get_drop_glue<'a, 'tcx>(ccx: &CrateContext<'a, 'tcx>, t: Ty<'tcx>) -> ValueRef {
 146     debug!("make drop glue for {}", ppaux::ty_to_string(ccx.tcx(), t));
 147     let t = get_drop_glue_type(ccx, t);
 148     debug!("drop glue type {}", ppaux::ty_to_string(ccx.tcx(), t));
 149     match ccx.drop_glues().borrow().get(&t) {
 150         Some(&glue) => return glue,
 151         _ => { }
 152     }
 153
 154     let llty = if type_is_sized(ccx.tcx(), t) {
 155         type_of(ccx, t).ptr_to()
 156     } else {
 157         type_of(ccx, ty::mk_uniq(ccx.tcx(), t)).ptr_to()
 158     };
 159
 160     let llfnty = Type::glue_fn(ccx, llty);
 161
 162     let (glue, new_sym) = match ccx.available_drop_glues().borrow().get(&t) {
 163         Some(old_sym) => {
 164             let glue = decl_cdecl_fn(ccx, old_sym[], llfnty, ty::mk_nil(ccx.tcx()));
 165             (glue, None)
 166         },
 167         None => {
 168             let (sym, glue) = declare_generic_glue(ccx, t, llfnty, "drop");
 169             (glue, Some(sym))
 170         },
 171     };
 172
 173     ccx.drop_glues().borrow_mut().insert(t, glue);
 174
 175     // To avoid infinite recursion, don't `make_drop_glue` until after we've
 176     // added the entry to the `drop_glues` cache.
 177     match new_sym {
 178         Some(sym) => {
 179             ccx.available_drop_glues().borrow_mut().insert(t, sym);
 180             // We're creating a new drop glue, so also generate a body.
 181             make_generic_glue(ccx, t, glue, make_drop_glue, "drop");
 182         },
 183         None => {},
 184     }
 185
 186     glue
 187 }
 188
 189 fn trans_struct_drop_flag<'blk, 'tcx>(mut bcx: Block<'blk, 'tcx>,
 190                                       t: Ty<'tcx>,
 191                                       v0: ValueRef,
 192                                       dtor_did: ast::DefId,
 193                                       class_did: ast::DefId,
 194                                       substs: &subst::Substs<'tcx>)
 195                                       -> Block<'blk, 'tcx> {
 196     let repr = adt::represent_type(bcx.ccx(), t);
 197     let struct_data = if type_is_sized(bcx.tcx(), t) {
 198         v0
 199     } else {
 200         let llval = GEPi(bcx, v0, &[0, abi::FAT_PTR_ADDR]);
 201         Load(bcx, llval)
 202     };
 203     let drop_flag = unpack_datum!(bcx, adt::trans_drop_flag_ptr(bcx, &*repr, struct_data));
 204     with_cond(bcx, load_ty(bcx, drop_flag.val, bcx.tcx().types.bool), |cx| {
 205         trans_struct_drop(cx, t, v0, dtor_did, class_did, substs)
 206     })
 207 }
 208
 209 fn trans_struct_drop<'blk, 'tcx>(bcx: Block<'blk, 'tcx>,
 210                                  t: Ty<'tcx>,
 211                                  v0: ValueRef,
 212                                  dtor_did: ast::DefId,
 213                                  class_did: ast::DefId,
 214                                  substs: &subst::Substs<'tcx>)
 215                                  -> Block<'blk, 'tcx> {
 216     let repr = adt::represent_type(bcx.ccx(), t);
 217
 218     // Find and call the actual destructor
 219     let dtor_addr = get_res_dtor(bcx.ccx(), dtor_did, t,
 220                                  class_did, substs);
 221
 222     // The first argument is the "self" argument for drop
 223     let params = unsafe {
 224         let ty = Type::from_ref(llvm::LLVMTypeOf(dtor_addr));
 225         ty.element_type().func_params()
 226     };
 227
 228     let fty = ty::lookup_item_type(bcx.tcx(), dtor_did).ty.subst(bcx.tcx(), substs);
 229     let self_ty = match fty.sty {
 230         ty::ty_bare_fn(_, ref f) => {
 231             assert!(f.sig.0.inputs.len() == 1);
 232             f.sig.0.inputs[0]
 233         }
 234         _ => bcx.sess().bug(format!("Expected function type, found {}",
 235                                     bcx.ty_to_string(fty))[])
 236     };
 237
 238     let (struct_data, info) = if type_is_sized(bcx.tcx(), t) {
 239         (v0, None)
 240     } else {
 241         let data = GEPi(bcx, v0, &[0, abi::FAT_PTR_ADDR]);
 242         let info = GEPi(bcx, v0, &[0, abi::FAT_PTR_EXTRA]);
 243         (Load(bcx, data), Some(Load(bcx, info)))
 244     };
 245
 246     adt::fold_variants(bcx, &*repr, struct_data, |variant_cx, st, value| {
 247         // Be sure to put all of the fields into a scope so we can use an invoke
 248         // instruction to call the user destructor but still call the field
 249         // destructors if the user destructor panics.
 250         let field_scope = variant_cx.fcx.push_custom_cleanup_scope();
 251
 252         // Class dtors have no explicit args, so the params should
 253         // just consist of the environment (self).
 254         assert_eq!(params.len(), 1);
 255         let self_arg = if type_is_fat_ptr(bcx.tcx(), self_ty) {
 256             // The dtor expects a fat pointer, so make one, even if we have to fake it.
 257             let boxed_ty = ty::mk_open(bcx.tcx(), t);
 258             let scratch = datum::rvalue_scratch_datum(bcx, boxed_ty, "__fat_ptr_drop_self");
 259             Store(bcx, value, GEPi(bcx, scratch.val, &[0, abi::FAT_PTR_ADDR]));
 260             Store(bcx,
 261                   // If we just had a thin pointer, make a fat pointer by sticking
 262                   // null where we put the unsizing info. This works because t
 263                   // is a sized type, so we will only unpack the fat pointer, never
 264                   // use the fake info.
 265                   info.unwrap_or(C_null(Type::i8p(bcx.ccx()))),
 266                   GEPi(bcx, scratch.val, &[0, abi::FAT_PTR_EXTRA]));
 267             PointerCast(variant_cx, scratch.val, params[0])
 268         } else {
 269             PointerCast(variant_cx, value, params[0])
 270         };
 271         let args = vec!(self_arg);
 272
 273         // Add all the fields as a value which needs to be cleaned at the end of
 274         // this scope. Iterate in reverse order so a Drop impl doesn't reverse
 275         // the order in which fields get dropped.
 276         for (i, ty) in st.fields.iter().enumerate().rev() {
 277             let llfld_a = adt::struct_field_ptr(variant_cx, &*st, value, i, false);
 278
 279             let val = if type_is_sized(bcx.tcx(), *ty) {
 280                 llfld_a
 281             } else {
 282                 let boxed_ty = ty::mk_open(bcx.tcx(), *ty);
 283                 let scratch = datum::rvalue_scratch_datum(bcx, boxed_ty, "__fat_ptr_drop_field");
 284                 Store(bcx, llfld_a, GEPi(bcx, scratch.val, &[0, abi::FAT_PTR_ADDR]));
 285                 Store(bcx, info.unwrap(), GEPi(bcx, scratch.val, &[0, abi::FAT_PTR_EXTRA]));
 286                 scratch.val
 287             };
 288             variant_cx.fcx.schedule_drop_mem(cleanup::CustomScope(field_scope),
 289                                              val, *ty);
 290         }
 291
 292         let dtor_ty = ty::mk_ctor_fn(bcx.tcx(),
 293                                      class_did,
 294                                      &[get_drop_glue_type(bcx.ccx(), t)],
 295                                      ty::mk_nil(bcx.tcx()));
 296         let (_, variant_cx) = invoke(variant_cx, dtor_addr, args[], dtor_ty, None);
 297
 298         variant_cx.fcx.pop_and_trans_custom_cleanup_scope(variant_cx, field_scope);
 299         variant_cx
 300     })
 301 }
 302
 303 fn size_and_align_of_dst<'blk, 'tcx>(bcx: Block<'blk, 'tcx>, t: Ty<'tcx>, info: ValueRef)
 304                                      -> (ValueRef, ValueRef) {
 305     debug!("calculate size of DST: {}; with lost info: {}",
 306            bcx.ty_to_string(t), bcx.val_to_string(info));
 307     if type_is_sized(bcx.tcx(), t) {
 308         let sizing_type = sizing_type_of(bcx.ccx(), t);
 309         let size = C_uint(bcx.ccx(), llsize_of_alloc(bcx.ccx(), sizing_type));
 310         let align = C_uint(bcx.ccx(), align_of(bcx.ccx(), t));
 311         return (size, align);
 312     }
 313     match t.sty {
 314         ty::ty_struct(id, substs) => {
 315             let ccx = bcx.ccx();
 316             // First get the size of all statically known fields.
 317             // Don't use type_of::sizing_type_of because that expects t to be sized.
 318             assert!(!ty::type_is_simd(bcx.tcx(), t));
 319             let repr = adt::represent_type(ccx, t);
 320             let sizing_type = adt::sizing_type_of(ccx, &*repr, true);
 321             let sized_size = C_uint(ccx, llsize_of_alloc(ccx, sizing_type));
 322             let sized_align = C_uint(ccx, llalign_of_min(ccx, sizing_type));
 323
 324             // Recurse to get the size of the dynamically sized field (must be
 325             // the last field).
 326             let fields = ty::struct_fields(bcx.tcx(), id, substs);
 327             let last_field = fields[fields.len()-1];
 328             let field_ty = last_field.mt.ty;
 329             let (unsized_size, unsized_align) = size_and_align_of_dst(bcx, field_ty, info);
 330
 331             // Return the sum of sizes and max of aligns.
 332             let size = Add(bcx, sized_size, unsized_size);
 333             let align = Select(bcx,
 334                                ICmp(bcx, llvm::IntULT, sized_align, unsized_align),
 335                                sized_align,
 336                                unsized_align);
 337             (size, align)
 338         }
 339         ty::ty_trait(..) => {
 340             // info points to the vtable and the second entry in the vtable is the
 341             // dynamic size of the object.
 342             let info = PointerCast(bcx, info, Type::int(bcx.ccx()).ptr_to());
 343             let size_ptr = GEPi(bcx, info, &[1u]);
 344             let align_ptr = GEPi(bcx, info, &[2u]);
 345             (Load(bcx, size_ptr), Load(bcx, align_ptr))
 346         }
 347         ty::ty_vec(unit_ty, None) => {
 348             // The info in this case is the length of the vec, so the size is that
 349             // times the unit size.
 350             let llunit_ty = sizing_type_of(bcx.ccx(), unit_ty);
 351             let unit_size = llsize_of_alloc(bcx.ccx(), llunit_ty);
 352             (Mul(bcx, info, C_uint(bcx.ccx(), unit_size)), C_uint(bcx.ccx(), 8u))
 353         }
 354         _ => bcx.sess().bug(format!("Unexpected unsized type, found {}",
 355                                     bcx.ty_to_string(t))[])
 356     }
 357 }
 358
 359 fn make_drop_glue<'blk, 'tcx>(bcx: Block<'blk, 'tcx>, v0: ValueRef, t: Ty<'tcx>)
 360                               -> Block<'blk, 'tcx> {
 361     // NB: v0 is an *alias* of type t here, not a direct value.
 362     let _icx = push_ctxt("make_drop_glue");
 363     match t.sty {
 364         ty::ty_uniq(content_ty) => {
 365             match content_ty.sty {
 366                 ty::ty_vec(ty, None) => {
 367                     tvec::make_drop_glue_unboxed(bcx, v0, ty, true)
 368                 }
 369                 ty::ty_str => {
 370                     let unit_ty = ty::sequence_element_type(bcx.tcx(), content_ty);
 371                     tvec::make_drop_glue_unboxed(bcx, v0, unit_ty, true)
 372                 }
 373                 ty::ty_trait(..) => {
 374                     let lluniquevalue = GEPi(bcx, v0, &[0, abi::FAT_PTR_ADDR]);
 375                     // Only drop the value when it is non-null
 376                     let concrete_ptr = Load(bcx, lluniquevalue);
 377                     with_cond(bcx, IsNotNull(bcx, concrete_ptr), |bcx| {
 378                         let dtor_ptr = Load(bcx, GEPi(bcx, v0, &[0, abi::FAT_PTR_EXTRA]));
 379                         let dtor = Load(bcx, dtor_ptr);
 380                         Call(bcx,
 381                              dtor,
 382                              &[PointerCast(bcx, lluniquevalue, Type::i8p(bcx.ccx()))],
 383                              None);
 384                         bcx
 385                     })
 386                 }
 387                 ty::ty_struct(..) if !type_is_sized(bcx.tcx(), content_ty) => {
 388                     let llval = GEPi(bcx, v0, &[0, abi::FAT_PTR_ADDR]);
 389                     let llbox = Load(bcx, llval);
 390                     let not_null = IsNotNull(bcx, llbox);
 391                     with_cond(bcx, not_null, |bcx| {
 392                         let bcx = drop_ty(bcx, v0, content_ty, None);
 393                         let info = GEPi(bcx, v0, &[0, abi::FAT_PTR_EXTRA]);
 394                         let info = Load(bcx, info);
 395                         let (llsize, llalign) = size_and_align_of_dst(bcx, content_ty, info);
 396                         trans_exchange_free_dyn(bcx, llbox, llsize, llalign)
 397                     })
 398                 }
 399                 _ => {
 400                     assert!(type_is_sized(bcx.tcx(), content_ty));
 401                     let llval = v0;
 402                     let llbox = Load(bcx, llval);
 403                     let not_null = IsNotNull(bcx, llbox);
 404                     with_cond(bcx, not_null, |bcx| {
 405                         let bcx = drop_ty(bcx, llbox, content_ty, None);
 406                         trans_exchange_free_ty(bcx, llbox, content_ty)
 407                     })
 408                 }
 409             }
 410         }
 411         ty::ty_struct(did, substs) | ty::ty_enum(did, substs) => {
 412             let tcx = bcx.tcx();
 413             match ty::ty_dtor(tcx, did) {
 414                 ty::TraitDtor(dtor, true) => {
 415                     // FIXME(16758) Since the struct is unsized, it is hard to
 416                     // find the drop flag (which is at the end of the struct).
 417                     // Lets just ignore the flag and pretend everything will be
 418                     // OK.
 419                     if type_is_sized(bcx.tcx(), t) {
 420                         trans_struct_drop_flag(bcx, t, v0, dtor, did, substs)
 421                     } else {
 422                         // Give the user a heads up that we are doing something
 423                         // stupid and dangerous.
 424                         bcx.sess().warn(format!("Ignoring drop flag in destructor for {}\
 425                                                  because the struct is unsized. See issue\
 426                                                  #16758",
 427                                                 bcx.ty_to_string(t))[]);
 428                         trans_struct_drop(bcx, t, v0, dtor, did, substs)
 429                     }
 430                 }
 431                 ty::TraitDtor(dtor, false) => {
 432                     trans_struct_drop(bcx, t, v0, dtor, did, substs)
 433                 }
 434                 ty::NoDtor => {
 435                     // No dtor? Just the default case
 436                     iter_structural_ty(bcx, v0, t, |bb, vv, tt| drop_ty(bb, vv, tt, None))
 437                 }
 438             }
 439         }
 440         ty::ty_unboxed_closure(..) => iter_structural_ty(bcx,
 441                                                          v0,
 442                                                          t,
 443                                                          |bb, vv, tt| drop_ty(bb, vv, tt, None)),
 444         ty::ty_trait(..) => {
 445             // No need to do a null check here (as opposed to the Box<trait case
 446             // above), because this happens for a trait field in an unsized
 447             // struct. If anything is null, it is the whole struct and we won't
 448             // get here.
 449             let lluniquevalue = GEPi(bcx, v0, &[0, abi::FAT_PTR_ADDR]);
 450             let dtor_ptr = Load(bcx, GEPi(bcx, v0, &[0, abi::FAT_PTR_EXTRA]));
 451             let dtor = Load(bcx, dtor_ptr);
 452             Call(bcx,
 453                  dtor,
 454                  &[PointerCast(bcx, Load(bcx, lluniquevalue), Type::i8p(bcx.ccx()))],
 455                  None);
 456             bcx
 457         }
 458         ty::ty_vec(ty, None) => tvec::make_drop_glue_unboxed(bcx, v0, ty, false),
 459         _ => {
 460             assert!(type_is_sized(bcx.tcx(), t));
 461             if type_needs_drop(bcx.tcx(), t) &&
 462                 ty::type_is_structural(t) {
 463                 iter_structural_ty(bcx, v0, t, |bb, vv, tt| drop_ty(bb, vv, tt, None))
 464             } else {
 465                 bcx
 466             }
 467         }
 468     }
 469 }
 470
 471 // Generates the declaration for (but doesn't emit) a type descriptor.
 472 pub fn declare_tydesc<'a, 'tcx>(ccx: &CrateContext<'a, 'tcx>, t: Ty<'tcx>)
 473                                 -> tydesc_info<'tcx> {
 474     // If emit_tydescs already ran, then we shouldn't be creating any new
 475     // tydescs.
 476     assert!(!ccx.finished_tydescs().get());
 477
 478     let llty = type_of(ccx, t);
 479
 480     if ccx.sess().count_type_sizes() {
 481         println!("{}\t{}", llsize_of_real(ccx, llty),
 482                  ppaux::ty_to_string(ccx.tcx(), t));
 483     }
 484
 485     let llsize = llsize_of(ccx, llty);
 486     let llalign = llalign_of(ccx, llty);
 487     let name = mangle_internal_name_by_type_and_seq(ccx, t, "tydesc");
 488     debug!("+++ declare_tydesc {} {}", ppaux::ty_to_string(ccx.tcx(), t), name);
 489     let gvar = name.with_c_str(|buf| {
 490         unsafe {
 491             llvm::LLVMAddGlobal(ccx.llmod(), ccx.tydesc_type().to_ref(), buf)
 492         }
 493     });
 494     note_unique_llvm_symbol(ccx, name);
 495
 496     let ty_name = token::intern_and_get_ident(
 497         ppaux::ty_to_string(ccx.tcx(), t)[]);
 498     let ty_name = C_str_slice(ccx, ty_name);
 499
 500     debug!("--- declare_tydesc {}", ppaux::ty_to_string(ccx.tcx(), t));
 501     tydesc_info {
 502         ty: t,
 503         tydesc: gvar,
 504         size: llsize,
 505         align: llalign,
 506         name: ty_name,
 507     }
 508 }
 509
 510 fn declare_generic_glue<'a, 'tcx>(ccx: &CrateContext<'a, 'tcx>, t: Ty<'tcx>,
 511                                   llfnty: Type, name: &str) -> (String, ValueRef) {
 512     let _icx = push_ctxt("declare_generic_glue");
 513     let fn_nm = mangle_internal_name_by_type_and_seq(
 514         ccx,
 515         t,
 516         format!("glue_{}", name)[]);
 517     let llfn = decl_cdecl_fn(ccx, fn_nm[], llfnty, ty::mk_nil(ccx.tcx()));
 518     note_unique_llvm_symbol(ccx, fn_nm.clone());
 519     return (fn_nm, llfn);
 520 }
 521
 522 fn make_generic_glue<'a, 'tcx, F>(ccx: &CrateContext<'a, 'tcx>,
 523                                   t: Ty<'tcx>,
 524                                   llfn: ValueRef,
 525                                   helper: F,
 526                                   name: &str)
 527                                   -> ValueRef where
 528     F: for<'blk> FnOnce(Block<'blk, 'tcx>, ValueRef, Ty<'tcx>) -> Block<'blk, 'tcx>,
 529 {
 530     let _icx = push_ctxt("make_generic_glue");
 531     let glue_name = format!("glue {} {}", name, ty_to_short_str(ccx.tcx(), t));
 532     let _s = StatRecorder::new(ccx, glue_name);
 533
 534     let arena = TypedArena::new();
 535     let empty_param_substs = Substs::trans_empty();
 536     let fcx = new_fn_ctxt(ccx, llfn, ast::DUMMY_NODE_ID, false,
 537                           ty::FnConverging(ty::mk_nil(ccx.tcx())),
 538                           &empty_param_substs, None, &arena);
 539
 540     let bcx = init_function(&fcx, false, ty::FnConverging(ty::mk_nil(ccx.tcx())));
 541
 542     update_linkage(ccx, llfn, None, OriginalTranslation);
 543
 544     ccx.stats().n_glues_created.set(ccx.stats().n_glues_created.get() + 1u);
 545     // All glue functions take values passed *by alias*; this is a
 546     // requirement since in many contexts glue is invoked indirectly and
 547     // the caller has no idea if it's dealing with something that can be
 548     // passed by value.
 549     //
 550     // llfn is expected be declared to take a parameter of the appropriate
 551     // type, so we don't need to explicitly cast the function parameter.
 552
 553     let llrawptr0 = get_param(llfn, fcx.arg_pos(0) as c_uint);
 554     let bcx = helper(bcx, llrawptr0, t);
 555     finish_fn(&fcx, bcx, ty::FnConverging(ty::mk_nil(ccx.tcx())));
 556
 557     llfn
 558 }
 559
 560 pub fn emit_tydescs(ccx: &CrateContext) {
 561     let _icx = push_ctxt("emit_tydescs");
 562     // As of this point, allow no more tydescs to be created.
 563     ccx.finished_tydescs().set(true);
 564     let glue_fn_ty = Type::generic_glue_fn(ccx).ptr_to();
 565     for (_, ti) in ccx.tydescs().borrow().iter() {
 566         // Each of the glue functions needs to be cast to a generic type
 567         // before being put into the tydesc because we only have a singleton
 568         // tydesc type. Then we'll recast each function to its real type when
 569         // calling it.
 570         let drop_glue = consts::ptrcast(get_drop_glue(ccx, ti.ty), glue_fn_ty);
 571         ccx.stats().n_real_glues.set(ccx.stats().n_real_glues.get() + 1);
 572
 573         let tydesc = C_named_struct(ccx.tydesc_type(),
 574                                     &[ti.size, // size
 575                                       ti.align, // align
 576                                       drop_glue, // drop_glue
 577                                       ti.name]); // name
 578
 579         unsafe {
 580             let gvar = ti.tydesc;
 581             llvm::LLVMSetInitializer(gvar, tydesc);
 582             llvm::LLVMSetGlobalConstant(gvar, True);
 583             llvm::SetLinkage(gvar, llvm::InternalLinkage);
 584         }
 585     };
 586 }