Aria Beingessner Gankra

## swiift-abi-2.md

      
              1 file
            
          
              0 forks
            
          
              0 comments
            
          
              0 stars
            
          
                Gankra
                / swiift-abi-2.md
            
            
              Created
              November 1, 2019 17:06
            
          
    % Swift and the Price of ABI Stability
For those who don't follow Swift's development, ABI stability has been one of its most ambitious projects, and it finally shipped in Swift 5. The result is something I find endlessly fascinating, because I think Swift has pushed the notion of ABI stability farther than any language with minimal compromise.
This article is broken up into two sections: background and details. Feel free to skip to the details if you're very comfortable with the problems inherent to producing a robust dynamically linked system interface.
If you aren't comfortable with the basic concepts of type layouts, ABIs, and calling conventions, I recommend reading the article I wrote on [the basic concepts of type layout and ABI as they pertain to Rust][rust-abi].

  
## layer-dump.txt
Painting --- compositing layer tree:
LayerManager (0x164ce420400) --- in 3D-sorted rendering order
  ContainerLayerMLGPU (0x164c4441800) [shadow-visible=< (x=0, y=0, w=3205, h=2017); (x=0, y=2017, w=3162, h=4826); >] [visible=< (x=0, y=0, w=3205, h=2016); >] [opaqueContent] [metrics0={ [metrics={ [cb=(x=0.000000, y=0.000000, w=3205.000000, h=2016.000000)] [sr=(x=0.000000, y=0.000000, w=1282.000000, h=806.400024)] [s=(0,0)] [dp=(x=0.000000, y=0.000000, w=1282.000000, h=806.400024)] [cdp=(x=0.000000, y=0.000000, w=0.000000, h=0.000000)] [scrollId=3] [z=2.5] }] [color=rgba(0, 0, 0, 0.000000)] }] [presShellResolution=1]
    PaintedLayerMLGPU (0x164c4445800) [shadow-visible=< (x=0, y=0, w=3205, h=2016); >] [visible=< (x=0, y=0, w=3205, h=2016); >] { hitregion=< (x=0, y=0, w=3205, h=2016); > dispatchtocontentregion=< (x=100, y=2, w=2660, h=83); >} [opaqueContent] [valid=< (x=0, y=0, w=3205, h=2016); >]
      ContentHost (0x164c440da60) [buffer-rect=(x=0, y=0, w=3205, h=2016)] [buffer-rotation=(0,0)]
        ShmemTe

## result-abi-notes.md

      
              1 file
            
          
              0 forks
            
          
              0 comments
            
          
              0 stars
            
          
                Gankra
                / result-abi-notes.md
            
            
              Created
              August 13, 2019 20:33
            
          
Initial LLVM-dev post on Swift calling convention: https://lists.llvm.org/pipermail/llvm-dev/2016-March/096250.html


Swift ABI Docs: https://github.com/apple/swift/tree/master/docs/ABI

Design Concerns of Error Returns: https://github.com/apple/swift/blob/master/docs/ABI/CallingConvention.rst
Registers: https://github.com/apple/swift/blob/master/docs/ABI/RegisterUsage.md
llvm parameter attributes: http://llvm.org/docs/LangRef.html#parameter-attributes
asm overheads: https://github.com/jckarter/jckarter.github.io/blob/master/joe/media/error-abis.pdf


C++ Lightweight Exceptions Proposal: http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2019/p0709r3.pdf


## gradient.rs
    /// Generate a color ramp filling the indices in [start_idx, end_idx) and interpolating
    /// from start_color to end_color.
    fn fill_colors(
        start_idx: usize,
        end_idx: usize,
        start_color: &PremultipliedColorF,
        end_color: &PremultipliedColorF,
        entries: &mut ArrayVec<[GradientDataEntry; GRADIENT_DATA_SIZE]>,
    ) {
        debug_assert_eq!(start_idx, entries.len());

## speedrunning-faq.md

      
              1 file
            
          
              0 forks
            
          
              0 comments
            
          
              0 stars
            
          
                Gankra
                / speedrunning-faq.md
            
            
              Last active
              June 28, 2019 19:44
                — forked from 0xabad1dea/speedrunning-faq.md
            
              
                Speedrunning FAQ/Glossary
              
          
    Speedrunning FAQ/Glossary

by 0xabad1dea September 2018
You may notice a decidedly Nintendo bias to the examples. I can't change who I am.
What is Speedrunning?

Speedrunning is:

Completing a video game


## memory-initialization.md

      
              1 file
            
          
              0 forks
            
          
              0 comments
            
          
              0 stars
            
          
                Gankra
                / memory-initialization.md
            
            
              Last active
              May 9, 2019 21:07
            
          
    My mental model of Initialization and Deinitialization:
This is kind've a brain dump of concepts, and does not necessarily represent a well-defined and minimized model. For instance, it's not clear to me if deinitialized memory is a "real" thing, or just a concept I like to have to think about dropped memory.
There are 3 (5) states a bit can have: uninit, init (0 or 1), deinit (0 or 1)
Freshly allocated memory is uninit. mem::unitialized() produces uninit.
Initializing memory makes it init with a definite value.

  
## test.rs
#[cfg(not(target_os = "freebsd"))]
#[repr(C)]
pub struct ContainsNoExternTy {
    pub field: no_extern::NoExternTy,
}

#[cfg(target_os = "freebsd")]
#[repr(C)]
pub struct ContainsNoExternTy {
    pub field: u64,

## test.html
<!DOCTYPE HTML>
<html reftest-async-scroll>
<head>
<style>
body {
    display: flex;
    flex-direction: column;
    width: 100%;
    height: 100%;
}

## clipping.rs
// **** This clip-chain correctly clips the content
ClipChain((
    id: (3, (1, 10)),
    parent: None,
), [
    Clip(4, (1, 10)),// [0]
    Clip(2, (1, 10)),// [1]
]),// [16]


## builder.rs
(
    output_rect: ((0, 0), (2880, 1710)),
    background_color: Some((
        r: 1,
        g: 1,
        b: 1,
        a: 1,
    )),
    root_pic_index: (1),
    pending_retained_tiles: (
	Painting --- compositing layer tree:
	LayerManager (0x164ce420400) --- in 3D-sorted rendering order
	ContainerLayerMLGPU (0x164c4441800) [shadow-visible=< (x=0, y=0, w=3205, h=2017); (x=0, y=2017, w=3162, h=4826); >] [visible=< (x=0, y=0, w=3205, h=2016); >] [opaqueContent] [metrics0={ [metrics={ [cb=(x=0.000000, y=0.000000, w=3205.000000, h=2016.000000)] [sr=(x=0.000000, y=0.000000, w=1282.000000, h=806.400024)] [s=(0,0)] [dp=(x=0.000000, y=0.000000, w=1282.000000, h=806.400024)] [cdp=(x=0.000000, y=0.000000, w=0.000000, h=0.000000)] [scrollId=3] [z=2.5] }] [color=rgba(0, 0, 0, 0.000000)] }] [presShellResolution=1]
	PaintedLayerMLGPU (0x164c4445800) [shadow-visible=< (x=0, y=0, w=3205, h=2016); >] [visible=< (x=0, y=0, w=3205, h=2016); >] { hitregion=< (x=0, y=0, w=3205, h=2016); > dispatchtocontentregion=< (x=100, y=2, w=2660, h=83); >} [opaqueContent] [valid=< (x=0, y=0, w=3205, h=2016); >]
	ContentHost (0x164c440da60) [buffer-rect=(x=0, y=0, w=3205, h=2016)] [buffer-rotation=(0,0)]
	ShmemTe
	/// Generate a color ramp filling the indices in [start_idx, end_idx) and interpolating
	/// from start_color to end_color.
	fn fill_colors(
	start_idx: usize,
	end_idx: usize,
	start_color: &PremultipliedColorF,
	end_color: &PremultipliedColorF,
	entries: &mut ArrayVec<[GradientDataEntry; GRADIENT_DATA_SIZE]>,
	) {
	debug_assert_eq!(start_idx, entries.len());
	#[cfg(not(target_os = "freebsd"))]
	#[repr(C)]
	pub struct ContainsNoExternTy {
	pub field: no_extern::NoExternTy,
	}

	#[cfg(target_os = "freebsd")]
	#[repr(C)]
	pub struct ContainsNoExternTy {
	pub field: u64,
	<!DOCTYPE HTML>
	<html reftest-async-scroll>
	<head>
	<style>
	body {
	display: flex;
	flex-direction: column;
	width: 100%;
	height: 100%;
	}
	// **** This clip-chain correctly clips the content
	ClipChain((
	id: (3, (1, 10)),
	parent: None,
	), [
	Clip(4, (1, 10)),// [0]
	Clip(2, (1, 10)),// [1]
	]),// [16]
	(
	output_rect: ((0, 0), (2880, 1710)),
	background_color: Some((
	r: 1,
	g: 1,
	b: 1,
	a: 1,
	)),
	root_pic_index: (1),
	pending_retained_tiles: (