ABI(Application Binary Interface)は、バイナリコンポーネント間の規約であり、データレイアウト、呼び出し規約、シンボルおよびオブジェクトフォーマットなどを含みます。関数の境界を挟んで異なるコンパイラによって生成されたコードであっても、引数がどこに配置されるか、どのレジスタが変更されるか、戻り値がどのように表現されるかについて合意する必要があります。
ABI に違反すると、即座にクラッシュするだけでなく、引数を静かに誤って読み込んだり、後で使用する値を破壊したりすることもあります。本稿では、一般的なユーザーランドの x86-64 呼び出しを例に挙げます。システムコール、カーネルコード、および特殊な呼び出し規約については別途考慮する必要があります。
引数はまず分類し、次に位置を割り当てる
System V AMD64 において、一般的な整数またはポインタの最初の 6 個の引数は RDI、RSI、RDX、RCX、R8、R9 を使用します。浮動小数点引数は別の XMM レジスタのルールセットを使用します。複合型(aggregate types)は ABI に従って分類する必要があり、すべての引数を単なる「最初の 6 つ」のリストに詰め込むことはできません。
Windows x64 において、最初の 4 個の引数の位置は、その型に応じて RCX/RDX/R8/R9 または対応する XMM0–3 を使用します。呼び出し側は、レジスタ引数のホーム/シャドウスペースとして少なくとも 32 バイトを予約します。整数と浮動小数点の混在する引数は、2 つの独立した無限の上位 4 位キューではありません。Microsoft x64 呼び出し規約
項目 System V AMD64 の一般的なルール Windows x64 の一般的なルール
整数/ポインタレジスタ RDI、RSI、RDX、RCX、R8、R9 最初の 4 つの位置に RCX、RDX、R8、R9 を使用
スカラー浮動小数点 ルールに従って XMM0–7 に割り当て 最初の 4 つの位置に対応する XMM0–3
シャドウスペース Windows 形式の強制 4 槽領域なし 呼び出し側が 32 バイトを予約
レッドゾーン ユーザーランドで約 128 バイトの予約あり 同等の保証なし
複合型、可変長引数、ベクトル 分類と特殊ルールを参照 独立したルールを参照
戻り値も型に応じて分類されます:スカラー整数は通常 RAX、スカラー浮動小数点は通常 XMM0 を使用します。いくつかの複合型は複数のレジスタに分割され、他の複合型は隠し結果ポインタを通じて返されます。「128 ビット構造体を RDX:RAX に統一して配置する」というのは正しくありません。AMD64 ABI
同じ混合引数宣言でも、レジスタ割り当てが異なる理由
可変長引数や複合型を含まない固定プロトタイプ double mix(int a, double b, int c, double d) を観察します。System V では、整数引数シーケンスと浮動小数点引数シーケンスがそれぞれ消費されます:a は EDI、b は XMM0、c は ESI、d は XMM1 を使用します。Windows x64 では、引数の位置に応じてレジスタが選択されます:a は ECX、b は XMM1、c は R8D、d は XMM3 を使用します。
引数 System V AMD64 Windows x64
a:第 1 引数、int EDI ECX
b:第 2 引数、double XMM0 XMM1
c:第 3 引数、int ESI R8D
d:第 4 引数、double XMM1 XMM3
表内の int は対応する 32 ビット値のみを使用します。宣言から、レジスタの上位ビットが他の引数の渡送に使用できると推論しないでください。以下のソースファイルはプラットフォームヘッダーに依存せず、2 つのターゲットに対してそれぞれアセンブリを生成できます。
double mix ( int a , double double b , int c , double d ) {
return a + b + c + d;
}
clang -- target= x86_64-unknown-linux-gnu - O2 - S - masm= intel mix.c - o mix-sysv.s
clang -- target= x86_64-pc-windows-msvc - O2 - S - masm= intel mix.c - o mix-win.s
整数から double への変換命令から 2 つの整数のソースを識別し、加算チェーンをたどって浮動小数点の入力を確認できます。ここではターゲット間でアセンブリを生成するだけで、Windows プログラムを実行する必要はありません。戻り値はどちらも XMM0 ですが、入力レイアウトが異なるため、関数ポインタの強制変換によって差異を解消することはできません。Microsoft 引数渡送
引数の位置と型のキュー、なぜ混在させてはいけないのか?
以下では、単なる固定表の提示ではなく、引数の型が変更されるたびに位置を再割り当てします。System V 側では、int と double がそれぞれ独自のシーケンスを進みます。Windows 側では引数の位置が保持されるため、XMM0 がまだパラメータ伝達に使用されていない場合でも、2 番目の位置の double は XMM1 になります。最初の 4 位を超えると、この例ではスタックスロットが使用されます。これは、まだ空きレジスタがあるかどうかとは無関係です。
図を準備しています 再読み込み
引数の位置と型のキュー、なぜ混在させてはいけないのか? System V のこの例では、整数と浮動小数点のシーケンスがそれぞれ消費されます。Windows では最初の 4 引数が位置に応じて GPR または XMM を選択し、5 番目の浮動小数点引数を XMM0 に無理やり詰めることはできません。
{"id":"abi-argument-positions","title":"引数の位置と型のキュー、なぜ混在させてはいけないのか?","summary":"System V のこの例では、整数と浮動小数点のシーケンスがそれぞれ消費されます。Windows では最初の 4 引数が位置に応じて GPR または XMM を選択し、5 番目の浮動小数点引数を XMM0 に無理やり詰めることはできません。","height":1000,"html":"<h2 data-i18n=\"heading\"></h2><p class=\"intro\" data-i18n=\"intro\"></p><div id=\"arguments\" class=\"choices\"></div><div id=\"locations\" class=\"table\"></div><div class=\"metrics\"><div><span data-i18n=\"space\"></span><strong id=\"space\"></strong></div></div><p class=\"hint\" data-i18n=\"hint\"></p><details class=\"scope\"><summary data-i18n=\"scopeLabel\"></summary><p data-i18n=\"scope\"></p></details>","css":".intro{margin:8px 0 18px;color:var(--muted);font-size:14px}.caption,.hint{font-size:12px;color:var(--muted);margin-top:12px}.control{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:6px 12px;align-items:center;margin:14px 0;font-size:13px}.control label{font-size:13px}.control output{color:var(--accent);min-width:5em;text-align:right;font-variant-numeric:tabular-nums}.control input{grid-column:1/-1;width:100%;margin:0}.presets{display:flex;gap:4px;align-items:stretch}.presets button{flex:1 1 0;min-width:0;overflow-wrap:anywhere;font-size:13px}.actions{display:flex;gap:8px;flex-wrap:wrap;margin:14px 0}.actions button{flex:1;min-width:0;font-size:13px;min-height:42px}.copy{display:grid;font-size:14px;margin:16px 0}.copy>*{grid-area:1/1;margin:0}.reserve{visibility:hidden}.scope{margin-top:14px;color:var(--muted);font-size:12px}.scope summary{padding:8px 0;cursor:pointer}.scope p{margin-top:10px}.two{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;margin:16px 0}.card{border:1px solid var(--rule);border-radius:9px;padding:14px;min-width:0}.card header{font-size:14px;font-weight:600;margin-bottom:10px}.card button{font-size:12px;width:100%;min-width:0}.card small{display:block;font-size:12px;color:var(--muted)}.card code{font-size:12px;overflow-wrap:anywhere}.metrics{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;margin:16px 0}.metrics>div{border-left:2px solid var(--accent);padding-left:10px;min-width:0}.metrics span{display:block;min-height:3.2em;color:var(--muted);font-size:12px}.metrics strong{font-size:23px;display:block;font-weight:500;overflow-wrap:anywhere;font-variant-numeric:tabular-nums}.formula{border-top:1px solid var(--rule);padding-top:12px;margin-top:14px;font-size:13px;font-variant-numeric:tabular-nums;overflow-wrap:anywhere}.value{font:500 20px var(--viz-font-ui)}.legend{display:flex;flex-wrap:wrap;gap:6px 14px;font-size:12px;color:var(--muted);margin:12px 0}.legend span:before{content:'';display:inline-block;width:8px;height:8px;border-radius:2px;background:var(--accent);margin-right:6px}.legend .second:before{background:var(--second)}.check{display:flex;align-items:center;gap:8px;font-size:13px;margin:12px 0}.check input{width:16px;height:16px;flex-shrink:0;accent-color:var(--accent)}select,input[type=text],input[type=number]{background:var(--paper);color:var(--ink);font:inherit;font-size:13px;padding:10px;border:1px solid var(--rule);border-radius:7px;max-width:100%;min-width:0}select{width:100%;min-height:42px}.band{height:20px;display:flex;background:var(--surface);border-radius:4px;overflow:hidden}.band i{height:100%;display:block;background:var(--accent);transition:width .25s}.band i.second{background:var(--second)}button:disabled{cursor:default}.status{font-size:13px;min-height:4.8em}.mono{font-family:var(--viz-font-mono);font-variant-numeric:tabular-nums}.muted{color:var(--muted)}\n@media(max-width:480px){.two{gap:8px}.card{padding:12px 9px}.actions button,.presets button{font-size:12px}.metrics strong{font-size:20px}.metrics{gap:8px}}\n@media(prefers-reduced-motion:reduce){*,*::before,*::after{transition:none!important;animation:none!important}}\n.track-row{margin:16px 0}.track-row>span{display:block;font-size:12px;color:var(--muted);margin-bottom:7px}.track{display:flex;gap:5px;min-width:0}.cell{flex:1;min-width:0;min-height:48px;border:1px solid var(--rule);border-radius:5px;background:var(--surface);display:flex;align-items:center;justify-content:center;text-align:center;padding:5px 3px;font-size:12px;overflow-wrap:anywhere;font-variant-numeric:tabular-nums}.cell.on{background:var(--accent-soft);border-color:var(--accent)}.cell.gold{background:var(--second-soft);border-color:var(--second)}.cell.empty{border-style:dashed;color:var(--muted)}.cell.error{border-color:var(--second);text-decoration:line-through}.choices{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:6px;margin:14px 0}.choices button{min-width:0;padding:10px 4px;font-size:12px;overflow-wrap:anywhere}.choices button[aria-current=true]{border-color:var(--accent);background:var(--accent-soft)}.relation{display:grid;grid-template-columns:minmax(0,1fr) 28px minmax(0,1fr);align-items:center;gap:6px;margin:12px 0}.relation .cell{min-height:72px}.relation>i{text-align:center;font-style:normal;color:var(--accent)}.readout{font-size:13px;white-space:pre-line;min-height:6.4em;overflow-wrap:anywhere}.plot{position:relative;border-left:1px solid var(--rule);border-bottom:1px solid var(--rule);padding:8px 0;margin:18px 0}.plot-row{height:28px;position:relative;margin:4px 0;background:var(--surface)}.plot-row i{position:absolute;inset-block:5px;background:var(--accent);min-width:2px;transition:width .2s,left .2s}.plot-row b{position:relative;padding:4px 6px;font:11px/28px var(--viz-font-ui);background:var(--paper);border-radius:3px}.axis{display:flex;justify-content:space-between;font-size:11px;color:var(--muted)}\n\n/* Action labels must remain readable across locales and narrow embeds. */\n.actions{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}\n.actions button{overflow-wrap:anywhere;white-space:normal;min-height:58px;padding:8px}\nbutton{overflow-wrap:anywhere}\n@media(min-width:640px){.actions{grid-template-columns:repeat(3,minmax(0,1fr))}}\n\n.metrics span{overflow-wrap:anywhere}\n.panel{border:1px solid var(--rule);border-radius:9px;padding:12px;margin:14px 0;min-width:0}.panel h3{font-size:13px;margin:0 0 10px;color:var(--muted)}.source{font:13px/1.8 var(--viz-font-mono);white-space:pre-wrap;overflow-wrap:anywhere;margin:12px 0}.source mark{background:var(--accent-soft);color:var(--ink);border-bottom:2px solid var(--accent)}.source .fault{background:var(--second-soft);border-color:var(--second)}.diagram{display:block;width:100%;height:auto;max-height:320px;margin:14px 0;overflow:visible}.diagram text{fill:var(--ink);font:12px var(--viz-font-ui)}.diagram .edge{stroke:var(--muted);stroke-width:1.5;fill:none}.diagram .edge.on{stroke:var(--accent);stroke-width:3}.diagram .node{fill:var(--surface);stroke:var(--rule);stroke-width:1.5}.diagram .node.on{fill:var(--accent-soft);stroke:var(--accent)}.diagram .node.gold{fill:var(--second-soft);stroke:var(--second)}.log{font:12px/1.8 var(--viz-font-mono);white-space:pre-line;overflow-wrap:anywhere;min-height:7.2em}.table{display:grid;gap:5px;margin:14px 0}.table .tr{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:5px}.table .tr>*{padding:8px 5px;background:var(--surface);border-radius:4px;min-width:0;overflow-wrap:anywhere;font-size:12px}.table .tr .on{background:var(--accent-soft)}.table .tr .gold{background:var(--second-soft)}.choices button{min-height:44px}.metrics strong{min-height:1.6em}.code-line{display:block}.code-line.on{background:var(--accent-soft);border-left:2px solid var(--accent);padding-left:6px}.status-badge{font-size:12px;color:var(--accent)}.tile-grid{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:6px}.tile-grid .cell{min-height:40px}.actions button{min-height:48px}.form-field{display:grid;gap:8px;margin:14px 0;font-size:13px}.form-field input{width:100%;font-family:var(--viz-font-ui)}.metrics.three{grid-template-columns:repeat(3,minmax(0,1fr))}.formula{min-height:3.2em}.presets{flex-wrap:wrap}.presets button{flex-basis:25%;min-height:44px}\n\n#arguments{grid-template-columns:repeat(3,minmax(0,1fr))}#locations .tr{grid-template-columns:.6fr 1fr 1fr}#locations .tr>div{min-height:4.8em}","js":"const $=s=>document.querySelector(s);const set=(id,v)=>$('#'+id).textContent=v;const t=k=>viz.t(k);function cells(id,values){$('#'+id).replaceChildren(...values.map(v=>{const e=document.createElement('div');e.className='cell '+(v.cls||'');e.textContent=v.text;e.title=v.title||v.text;return e;}));}function pressed(mode){document.querySelectorAll('[data-mode]').forEach(e=>e.setAttribute('aria-pressed',String(e.dataset.mode===mode)));}const esc=s=>String(s).replace(/[&<>\"']/g,c=>({'&':'&','<':'<','>':'>','\"':'"',\"'\":'''}[c]));const fmt=s=>'{'+[...s].sort().join(', ')+'}';function graph(id,nodes,edges){const el=$('#'+id);el.setAttribute('viewBox','0 0 360 200');el.innerHTML='<defs><marker id=\"arrow-'+id+'\" viewBox=\"0 0 10 10\" refX=\"8\" refY=\"5\" markerWidth=\"5\" markerHeight=\"5\" orient=\"auto-start-reverse\"><path d=\"M 0 0 L 10 5 L 0 10 z\" fill=\"var(--muted)\"/></marker></defs>'+edges.map(e=>{const a=nodes[e[0]],b=nodes[e[1]],dx=b.x-a.x,dy=b.y-a.y,d=Math.hypot(dx,dy)||1;if(edges.some(r=>r[0]===e[1]&&r[1]===e[0])){const nx=-dy/d,ny=dx/d;return '<path class=\"edge '+(e[2]?'on':'')+'\" d=\"M '+(a.x+dx/d*22+nx*12)+' '+(a.y+dy/d*22+ny*12)+' Q '+((a.x+b.x)/2+nx*38)+' '+((a.y+b.y)/2+ny*38)+' '+(b.x-dx/d*25+nx*12)+' '+(b.y-dy/d*25+ny*12)+'\" marker-end=\"url(#arrow-'+id+')\"/>';}return '<line class=\"edge '+(e[2]?'on':'')+'\" x1=\"'+(a.x+dx/d*25)+'\" y1=\"'+(a.y+dy/d*25)+'\" x2=\"'+(b.x-dx/d*28)+'\" y2=\"'+(b.y-dy/d*28)+'\" marker-end=\"url(#arrow-'+id+')\"/>';}).join('')+nodes.map(n=>'<g><circle class=\"node '+(n.cls||'')+'\" cx=\"'+n.x+'\" cy=\"'+n.y+'\" r=\"25\"/><text x=\"'+n.x+'\" y=\"'+(n.y+4)+'\" text-anchor=\"middle\">'+esc(n.name)+'</text>'+(n.sub?'<text x=\"'+n.x+'\" y=\"'+(n.y+43)+'\" text-anchor=\"middle\">'+esc(n.sub)+'</text>':'')+'</g>').join('');}function table(id,rows){$('#'+id).replaceChildren(...rows.map(r=>{const row=document.createElement('div');row.className='tr';r.forEach(x=>{const c=document.createElement('div');if(typeof x==='object'){c.textContent=x.text;c.className=x.cls||'';}else c.textContent=x;row.append(c)});return row;}));}let types=['int','double','int','double','double','int'];function draw(){let ni=0,nf=0;const sys=['EDI','ESI','EDX','ECX','R8D','R9D'],win=['ECX','EDX','R8D','R9D'],rows=types.map((type,i)=>['p'+(i+1)+': '+type,type==='int'?sys[ni++]:'XMM'+nf++,i<4?(type==='int'?win[i]:'XMM'+i):'[RSP+'+(40+(i-4)*8)+']']);types.forEach((type,i)=>{let b=document.querySelector('[data-arg=\"'+i+'\"]');if(!b){b=document.createElement('button');$('#arguments').append(b);}b.textContent='p'+(i+1)+': '+type;b.dataset.arg=i;b.setAttribute('aria-pressed',String(type==='double'));b.onclick=()=>{types[i]=type==='int'?'double':'int';draw()};});table('locations',[['','System V','Windows'],...rows]);set('space','32 byte');$('#locations').dataset.rows=JSON.stringify(rows);}draw();","audio":false,"strings":{"heading":"引数の位置と型のキュー、なぜ混在させてはいけないのか?","hint":"各引数ボタンで直接型を切り替えられます。型の修正は、より新しい関数シグネチャでの比較を目的としています。","intro":"6 つの引数をクリックして、int / double を切り替えます。2 つの ABI は固定プロトタイプでの位置を同時に示し、混合引数がレジスタをどのように消費するかを観察します。","reset":"リセット","scope":"固定プロトタイプ、6 つのスカラー int/double、複合型、可変長引数、ベクトル、隠し引数なし。スタックオフセットは関数エントリの RSP を基準とし、Windows の 32 バイト home 領域は別途予約されます。","scopeLabel":"モデル範囲と規約","space":"Windows 必須 home space"}}
保存規約:誰が値を呼び出し間で存続させる責任を負うか
Caller-saved(呼び出し側保存)とは、呼び出し先が変更できることを意味し、呼び出し側が古い値をまだ必要とする場合は、事前に保存するか位置を変更する必要があります。Callee-saved(呼び出し先保存)とは、呼び出し先がそのレジスタを使用する場合、戻る前に呼び出し側の値を復元する必要があることを意味します。
System V では、RBX、RBP、R12–R15 は一般的な呼び出し先保存レジスタであり、RSP は呼び出し復帰の規約に従って復元されなければなりません。RAX、RCX、RDX、RSI、RDI、R8–R11 は呼び出しによって破壊される可能性があります。ベクトルレジスタやステータスレジスタにも独自のルールがあり、汎用レジスタのみを確認すればよいわけではありません。
これはレジスタ割り当てに直接影響します:呼び出しをまたいで存続する値は、呼び出しによって破壊される位置に保護なしで置くことはできません。
スタックレイアウトと整列
System V 例:rbp を使用したスタックフレームレイアウトの一種
スタック上で渡される 7 番目の整数引数
rbp + 16
戻りアドレス
rbp + 8
呼び出し元の rbp
rbp
ローカル変数 / スパイル / 保存領域
負のオフセット、レイアウトはコンパイラ次第
現在割り当てられた領域の低アドレス境界
rsp
高アドレス
低アドレス
レイアウトの一例です。フレームポインタは省略可能であり、保存領域の順序やローカル変数の位置はこの図によって固定されるわけではありません。
一般的な System V 呼び出しでは、call の前に RSP が 16 バイト境界に整列されており、call によって 8 バイトの戻りアドレスがプッシュされた後、関数エントリでの (RSP+8) がその整列を満たします。スタック上で渡されるベクトルなどの場合、より強い要件がある場合があり、対応する ABI ルールを基準とする必要があります。
したがって、7 つの整数引数を提示する際、現在のスタック状態とパディングを完全に無視して push 第7引数; call と書くことはできません。呼び出し側は、引数領域全体を事前に予約してから書き込むことができ、ソースコードの引数順序に従って個別に push する必要はありません。
ローカル変数は必ずしもスタック上にあるわけではなく、最適化後にはレジスタ内にあるか、定数に置き換えられているか、完全に消えている可能性があります。フレームポインタも省略できます。展開情報は、RSP から古い RBP を探す表を保存するだけでなく、呼び出し元の状態をどのように復元するかを記述します。ELF におけるランタイム展開には、.eh_frame などの情報が関与することがあります。
序文と終文:規約を満たすコードは固定テンプレートではない
序文では、呼び出し先保存レジスタの保存、スタックスペースの割り当て、フレームポインタの設定が行われる可能性があります。終文では対応する状態が復元されます。リーフ関数にはこれらの動作がない場合があり、最適化により保存が必要となるパスに遅らせることもできます。
以下は、Linux System V において外部の twice(long) を呼び出し、1 を加える GNU アセンブリの例です。Intel 構文を使用し、エントリでの RSP を 16 で割った余りが 8 であるため、8 減算して後の call のための整列を整えます。
.intel_syntax noprefix
.text
.globl plus_one_twice
.type plus_one_twice, @function
plus_one_twice:
.cfi_startproc
sub rsp, 8
.cfi_def_cfa_offset 16
call twice@PLT
add rsp, 8
.cfi_def_cfa_offset 8
add rax, 1
ret
.cfi_endproc
.size plus_one_twice, .-plus_one_twice
.section .note.GNU-stack,"",@progbits
最初の long 引数はすでに RDI にあり、戻り値は RAX にあります。この関数は、追加の保存を必要とする RBX などのレジスタを使用していません。CFI はスタックの調整に合わせて CFA を記述し、展開器が呼び出し状態を復元できるようにします。
呼び出し後に元の引数を継続して使用するには、それを保持しなければならない
計算を twice(x) + x に変更します。x は当初 RDI にあり、twice は RDI を合法적으로書き換えることができるため、戻った後に RDI を直接加算するのは誤りです。以下では、まず呼び出し元の RBX をスタックに保存し、RBX を使用して x を保持します。twice は受け取った RBX を復元する必要があり、最後にこの関数が上位の呼び出し元の古い値を復元します。
# keep_x.s:GNU アセンブリ、Linux System V AMD64
.intel_syntax noprefix
.text
.globl keep_x
.type keep_x, @function
keep_x:
.cfi_startproc
push rbx
.cfi_def_cfa_offset 16
.cfi_offset rbx, -16
mov rbx, rdi
call twice@PLT
add rax, rbx
pop rbx
.cfi_def_cfa_offset 8
.cfi_restore rbx
ret
.cfi_endproc
.size keep_x, .-keep_x
.section .note.GNU-stack,"",@progbits
エントリでの RSP を 16 で割った余りが 8 であり、プッシュされた 8 バイトは RBX を保存すると同時に、call 前の RSP を 16 で割った余りを 0 にします。ここでは、前のセクションの sub rsp,8 をそのままコピーしてさらに減算すべきではありません。そうすると、この呼び出しポイントの整列を再び破壊してしまいます。
extern long keep_x ( long ) ;
long twice ( long x ) { return x * 2 ; }
int main ( void ) {
return keep_x ( 7 ) != 21 || keep_x ( - 3 ) != - 9 ;
}
cc -O2 abi-main.c keep_x.s -o abi-demo を実行して abi-demo を実行すると、正常な終了ステータスは 0 になります。ここでは限られた小さな値のみを使用して、long の乗算または加算の符号付きオーバーフローが ABI の問題を隠さないようにします。
あるコンパイラがたまたま RDI を変更しなかったからといって、誤った書き方が正しいことを証明するものではありません。呼び出し境界のチェックは、呼び出し先がどの状態を破壊できるかに基づいて行わなければならず、単に某回の機械語を観察するだけでは不十分です。実装の変更、インスツルメンテーション、または別の互換定義へのリンクにより、潜伏していたエラーが表面化する可能性があります。
RBX の 2 つの値は異なる呼び出し層に属する
keep_x への入り口
RBX = 上位の古い値
プッシュ後に RBX を借用
スタックに古い値を保存;RBX = x
twice 復帰後
x を使用して合計し、pop で復元
エントリ rsp % 16 = 8 → プッシュ後 = 0 → call で戻りアドレスをプッシュ
呼び出し先保存レジスタは使用可能ですが、戻る際には呼び出し側が見ていた値を復元しなければなりません。
呼び出しをまたぐ x、どこに保存すれば信頼できるのか?
値が保持されたか、上位のレジスタが復元されたか、呼び出しポイントが整列されているかは、3 つの独立したチェック項目です。以下では、「21 を計算するが RBX を破壊する」または「値はすべて正しいが、余分なスタック減算により整列を失う」という状況を構築できます。数値結果は、例示された呼び出し先の動作に対する記号的推論です。ABI に違反した場合、それが実際の機械実行においてその数値を返すという保証として扱うことはできません。
図を準備しています 再読み込み
呼び出しをまたぐ x、どこに保存すれば信頼できるのか? RDI は呼び出し先によって書き換え可能です。RBX を使用して x を保持する際は、まず上位の古い RBX を保存する必要があります。今回のプッシュで整列は完了しており、さらに `sub rsp,8` をコピーすると整列を破壊します。
{"id":"abi-preservation-alignment","title":"呼び出しをまたぐ x、どこに保存すれば信頼できるのか?","summary":"RDI は呼び出し先によって書き換え可能です。RBX を使用して x を保持する際は、まず上位の古い RBX を保存する必要があります。今回のプッシュで整列は完了しており、さらに `sub rsp,8` をコピーすると整列を破壊します。","height":1000,"html":"<h2 data-i18n=\"heading\"></h2><p class=\"intro\" data-i18n=\"intro\"></p><div class=\"presets\" role=\"group\" data-i18n-label=\"mode\"><button data-mode=\"none\" data-i18n=\"none\"></button><button data-mode=\"bare\" data-i18n=\"bare\"></button><button data-mode=\"saved\" data-i18n=\"saved\"></button></div><label class=\"check\"><input type=\"checkbox\" id=\"extra\"><span data-i18n=\"extra\"></span></label><div id=\"states\" class=\"table\"></div><div class=\"metrics\"><div><span data-i18n=\"result\"></span><strong id=\"result\"></strong></div><div><span data-i18n=\"rbx\"></span><strong id=\"rbx\"></strong></div><div><span data-i18n=\"align\"></span><strong id=\"align\"></strong></div></div><div class=\"copy\"><p id=\"explanation\" role=\"status\"></p><p class=\"reserve\" aria-hidden=\"true\" data-i18n=\"ok\"></p><p class=\"reserve\" aria-hidden=\"true\" data-i18n=\"bad\"></p></div><details class=\"scope\"><summary data-i18n=\"scopeLabel\"></summary><p data-i18n=\"scope\"></p></details>","css":".intro{margin:8px 0 18px;color:var(--muted);font-size:14px}.caption,.hint{font-size:12px;color:var(--muted);margin-top:12px}.control{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:6px 12px;align-items:center;margin:14px 0;font-size:13px}.control label{font-size:13px}.control output{color:var(--accent);min-width:5em;text-align:right;font-variant-numeric:tabular-nums}.control input{grid-column:1/-1;width:100%;margin:0}.presets{display:flex;gap:4px;align-items:stretch}.presets button{flex:1 1 0;min-width:0;overflow-wrap:anywhere;font-size:13px}.actions{display:flex;gap:8px;flex-wrap:wrap;margin:14px 0}.actions button{flex:1;min-width:0;font-size:13px;min-height:42px}.copy{display:grid;font-size:14px;margin:16px 0}.copy>*{grid-area:1/1;margin:0}.reserve{visibility:hidden}.scope{margin-top:14px;color:var(--muted);font-size:12px}.scope summary{padding:8px 0;cursor:pointer}.scope p{margin-top:10px}.two{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;margin:16px 0}.card{border:1px solid var(--rule);border-radius:9px;padding:14px;min-width:0}.card header{font-size:14px;font-weight:600;margin-bottom:10px}.card button{font-size:12px;width:100%;min-width:0}.card small{display:block;font-size:12px;color:var(--muted)}.card code{font-size:12px;overflow-wrap:anywhere}.metrics{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;margin:16px 0}.metrics>div{border-left:2px solid var(--accent);padding-left:10px;min-width:0}.metrics span{display:block;min-height:3.2em;color:var(--muted);font-size:12px}.metrics strong{font-size:23px;display:block;font-weight:500;overflow-wrap:anywhere;font-variant-numeric:tabular-nums}.formula{border-top:1px solid var(--rule);padding-top:12px;margin-top:14px;font-size:13px;font-variant-numeric:tabular-nums;overflow-wrap:anywhere}.value{font:500 20px var(--viz-font-ui)}.legend{display:flex;flex-wrap:wrap;gap:6px 14px;font-size:12px;color:var(--muted);margin:12px 0}.legend span:before{content:'';display:inline-block;width:8px;height:8px;border-radius:2px;background:var(--accent);margin-right:6px}.legend .second:before{background:var(--second)}.check{display:flex;align-items:center;gap:8px;font-size:13px;margin:12px 0}.check input{width:16px;height:16px;flex-shrink:0;accent-color:var(--accent)}select,input[type=text],input[type=number]{background:var(--paper);color:var(--ink);font:inherit;font-size:13px;padding:10px;border:1px solid var(--rule);border-radius:7px;max-width:100%;min-width:0}select{width:100%;min-height:42px}.band{height:20px;display:flex;background:var(--surface);border-radius:4px;overflow:hidden}.band i{height:100%;display:block;background:var(--accent);transition:width .25s}.band i.second{background:var(--second)}button:disabled{cursor:default}.status{font-size:13px;min-height:4.8em}.mono{font-family:var(--viz-font-mono);font-variant-numeric:tabular-nums}.muted{color:var(--muted)}\n@media(max-width:480px){.two{gap:8px}.card{padding:12px 9px}.actions button,.presets button{font-size:12px}.metrics strong{font-size:20px}.metrics{gap:8px}}\n@media(prefers-reduced-motion:reduce){*,*::before,*::after{transition:none!important;animation:none!important}}\n.track-row{margin:16px 0}.track-row>span{display:block;font-size:12px;color:var(--muted);margin-bottom:7px}.track{display:flex;gap:5px;min-width:0}.cell{flex:1;min-width:0;min-height:48px;border:1px solid var(--rule);border-radius:5px;background:var(--surface);display:flex;align-items:center;justify-content:center;text-align:center;padding:5px 3px;font-size:12px;overflow-wrap:anywhere;font-variant-numeric:tabular-nums}.cell.on{background:var(--accent-soft);border-color:var(--accent)}.cell.gold{background:var(--second-soft);border-color:var(--second)}.cell.empty{border-style:dashed;color:var(--muted)}.cell.error{border-color:var(--second);text-decoration:line-through}.choices{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:6px;margin:14px 0}.choices button{min-width:0;padding:10px 4px;font-size:12px;overflow-wrap:anywhere}.choices button[aria-current=true]{border-color:var(--accent);background:var(--accent-soft)}.relation{display:grid;grid-template-columns:minmax(0,1fr) 28px minmax(0,1fr);align-items:center;gap:6px;margin:12px 0}.relation .cell{min-height:72px}.relation>i{text-align:center;font-style:normal;color:var(--accent)}.readout{font-size:13px;white-space:pre-line;min-height:6.4em;overflow-wrap:anywhere}.plot{position:relative;border-left:1px solid var(--rule);border-bottom:1px solid var(--rule);padding:8px 0;margin:18px 0}.plot-row{height:28px;position:relative;margin:4px 0;background:var(--surface)}.plot-row i{position:absolute;inset-block:5px;background:var(--accent);min-width:2px;transition:width .2s,left .2s}.plot-row b{position:relative;padding:4px 6px;font:11px/28px var(--viz-font-ui);background:var(--paper);border-radius:3px}.axis{display:flex;justify-content:space-between;font-size:11px;color:var(--muted)}\n\n/* Action labels must remain readable across locales and narrow embeds. */\n.actions{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}\n.actions button{overflow-wrap:anywhere;white-space:normal;min-height:58px;padding:8px}\nbutton{overflow-wrap:anywhere}\n@media(min-width:640px){.actions{grid-template-columns:repeat(3,minmax(0,1fr))}}\n\n.metrics span{overflow-wrap:anywhere}\n.panel{border:1px solid var(--rule);border-radius:9px;padding:12px;margin:14px 0;min-width:0}.panel h3{font-size:13px;margin:0 0 10px;color:var(--muted)}.source{font:13px/1.8 var(--viz-font-mono);white-space:pre-wrap;overflow-wrap:anywhere;margin:12px 0}.source mark{background:var(--accent-soft);color:var(--ink);border-bottom:2px solid var(--accent)}.source .fault{background:var(--second-soft);border-color:var(--second)}.diagram{display:block;width:100%;height:auto;max-height:320px;margin:14px 0;overflow:visible}.diagram text{fill:var(--ink);font:12px var(--viz-font-ui)}.diagram .edge{stroke:var(--muted);stroke-width:1.5;fill:none}.diagram .edge.on{stroke:var(--accent);stroke-width:3}.diagram .node{fill:var(--surface);stroke:var(--rule);stroke-width:1.5}.diagram .node.on{fill:var(--accent-soft);stroke:var(--accent)}.diagram .node.gold{fill:var(--second-soft);stroke:var(--second)}.log{font:12px/1.8 var(--viz-font-mono);white-space:pre-line;overflow-wrap:anywhere;min-height:7.2em}.table{display:grid;gap:5px;margin:14px 0}.table .tr{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:5px}.table .tr>*{padding:8px 5px;background:var(--surface);border-radius:4px;min-width:0;overflow-wrap:anywhere;font-size:12px}.table .tr .on{background:var(--accent-soft)}.table .tr .gold{background:var(--second-soft)}.choices button{min-height:44px}.metrics strong{min-height:1.6em}.code-line{display:block}.code-line.on{background:var(--accent-soft);border-left:2px solid var(--accent);padding-left:6px}.status-badge{font-size:12px;color:var(--accent)}.tile-grid{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:6px}.tile-grid .cell{min-height:40px}.actions button{min-height:48px}.form-field{display:grid;gap:8px;margin:14px 0;font-size:13px}.form-field input{width:100%;font-family:var(--viz-font-ui)}.metrics.three{grid-template-columns:repeat(3,minmax(0,1fr))}.formula{min-height:3.2em}.presets{flex-wrap:wrap}.presets button{flex-basis:25%;min-height:44px}\n\n.metrics{grid-template-columns:repeat(3,minmax(0,1fr))}.metrics strong{font-size:20px}#states .tr{grid-template-columns:1fr 1fr}","js":"const $=s=>document.querySelector(s);const set=(id,v)=>$('#'+id).textContent=v;const t=k=>viz.t(k);function cells(id,values){$('#'+id).replaceChildren(...values.map(v=>{const e=document.createElement('div');e.className='cell '+(v.cls||'');e.textContent=v.text;e.title=v.title||v.text;return e;}));}function pressed(mode){document.querySelectorAll('[data-mode]').forEach(e=>e.setAttribute('aria-pressed',String(e.dataset.mode===mode)));}const esc=s=>String(s).replace(/[&<>\"']/g,c=>({'&':'&','<':'<','>':'>','\"':'"',\"'\":'''}[c]));const fmt=s=>'{'+[...s].sort().join(', ')+'}';function graph(id,nodes,edges){const el=$('#'+id);el.setAttribute('viewBox','0 0 360 200');el.innerHTML='<defs><marker id=\"arrow-'+id+'\" viewBox=\"0 0 10 10\" refX=\"8\" refY=\"5\" markerWidth=\"5\" markerHeight=\"5\" orient=\"auto-start-reverse\"><path d=\"M 0 0 L 10 5 L 0 10 z\" fill=\"var(--muted)\"/></marker></defs>'+edges.map(e=>{const a=nodes[e[0]],b=nodes[e[1]],dx=b.x-a.x,dy=b.y-a.y,d=Math.hypot(dx,dy)||1;if(edges.some(r=>r[0]===e[1]&&r[1]===e[0])){const nx=-dy/d,ny=dx/d;return '<path class=\"edge '+(e[2]?'on':'')+'\" d=\"M '+(a.x+dx/d*22+nx*12)+' '+(a.y+dy/d*22+ny*12)+' Q '+((a.x+b.x)/2+nx*38)+' '+((a.y+b.y)/2+ny*38)+' '+(b.x-dx/d*25+nx*12)+' '+(b.y-dy/d*25+ny*12)+'\" marker-end=\"url(#arrow-'+id+')\"/>';}return '<line class=\"edge '+(e[2]?'on':'')+'\" x1=\"'+(a.x+dx/d*25)+'\" y1=\"'+(a.y+dy/d*25)+'\" x2=\"'+(b.x-dx/d*28)+'\" y2=\"'+(b.y-dy/d*28)+'\" marker-end=\"url(#arrow-'+id+')\"/>';}).join('')+nodes.map(n=>'<g><circle class=\"node '+(n.cls||'')+'\" cx=\"'+n.x+'\" cy=\"'+n.y+'\" r=\"25\"/><text x=\"'+n.x+'\" y=\"'+(n.y+4)+'\" text-anchor=\"middle\">'+esc(n.name)+'</text>'+(n.sub?'<text x=\"'+n.x+'\" y=\"'+(n.y+43)+'\" text-anchor=\"middle\">'+esc(n.sub)+'</text>':'')+'</g>').join('');}function table(id,rows){$('#'+id).replaceChildren(...rows.map(r=>{const row=document.createElement('div');row.className='tr';r.forEach(x=>{const c=document.createElement('div');if(typeof x==='object'){c.textContent=x.text;c.className=x.cls||'';}else c.textContent=x;row.append(c)});return row;}));}let mode='saved';function draw(){const push=mode==='saved'?8:0,extra=$('#extra').checked?8:0,mod=(8-push-extra+32)%16,result=mode==='none'?113:21,rbx=mode==='bare'?7:90;table('states',[['entry','RDI=7; RBX=90'],['before call','RSP−'+(push+extra)],['callee','RAX=14; RDI=99'],['after restore','RBX='+rbx]]);set('result',result);set('rbx',rbx);set('align',mod);const valid=result===21&&rbx===90&&mod===0;set('explanation',t(valid?'ok':'bad'));$('#states').dataset.valid=String(valid);pressed(mode);}$('#extra').onchange=draw;document.querySelectorAll('[data-mode]').forEach(b=>b.onclick=()=>{mode=b.dataset.mode;draw()});draw();","audio":false,"strings":{"align":"call 前の RSP mod16","bad":"呼び出し契約の少なくとも 1 つが失敗;結果がたまたま正しくても、他の破壊を隠すことはできない。","bare":"RBX を借用、保存なし","extra":"余分な sub/add rsp,8","heading":"呼び出しをまたぐ x、どこに保存すれば信頼できるのか?","intro":"目標は twice(x)+x、x=7。保存方案を選択し、さらに 8 バイトスタックを減算するかどうかを決定し、値と呼び出しポイントの整列をチェックします。","mode":"保存方案","none":"RDI に直接依存","ok":"値の保存、RBX の復元、スタック整列の 3 項目が同時に成立。","rbx":"復帰時の RBX(90 であるべき)","reset":"リセット","result":"本関数の結果(目標 21)","saved":"push/pop RBX","scope":"固定 System V AMD64 通常スカラー呼び出し、エントリ RSP mod16=8、上位 RBX=90。twice は 14 を返し、RDI を 99 に合法적으로変更する。本例の呼び出し境界のみをチェック。","scopeLabel":"モデル範囲と規約"}}
レッドゾーン:一時値を呼び出しをまたいで無保護にしておいてはいけない
System V ユーザーランドでは、RSP 以下に 128 バイトのレッドゾーンが提供されており、シグナル処理などは関連する規約に従う必要があります。関数は RSP を調整せずに、一時データを保存するためにこれを使用できます。特にリーフ関数で一般的です。
しかし、ネストされた呼び出しはより低いアドレスのスタックスペースを使用するため、レッドゾーン内の値が通常の関数呼び出しを安全に跨ぐことを期待できません。非リーフ関数でも、呼び出しをまたいで存続する必要のない一時データを適切な区間で使用できるため、「リーフ関数のみがいかなる意味でも使用できる」というのは極端すぎます。カーネル、割り込み、および他のプラットフォームでは、この保証をそのまま持ち込むことはできません。
可変長引数:呼び出し側は実際の引数を知り、呼び出し先は規約に従って取り出す
printf などの関数宣言にはすべての実引数の型が列挙されていませんが、呼び出しポイントのコンパイラは実際の式を知っており、デフォルトの引数昇格を適用します。例えば、float は double に昇格されます。フォーマット文字列と実際の実引数の一致は、言語およびインターフェースのチェックの問題です。
System V において、可変長引数呼び出しには、ベクトルレジスタ引数の使用数を表す AL レジスタの上限値が使用され、値の範囲は ABI で規定されています。呼び出し先は必要に応じてレジスタ保存領域を構築し、va_list はレジスタ領域とスタック引数領域を追跡します。呼び出し側がすべての XMM 引数を事前に呼び出し先の va_list に書き込むわけではありません。
Windows の可変長引数のルールは異なり、浮動小数点実引数は関連する位置に汎用レジスタに同時に配置する必要がある場合があります。ABI をまたぐ手書きのブリッジでは、これを特別に処理する必要があり、単に引数レジスタの名前を置き換えるだけでは不十分です。
PIC と PIE:絶対アドレス依存の軽減
位置依存コード(Position Independent Code, PIC)は、ローカルデータとコードへのアクセスに PC 相対アドレス指定を頻繁に利用し、動的バインド可能なシンボルには GOT、PLT、または他の規約パスを使用します。すべての PIC シンボルアクセスが必ずしも GOT 間接を 1 回余分に必要とするわけではありません。バインド、可視性、およびリンカの緩和により、直接的な相対アクセスが許可される場合があります。
PIE(Position Independent Executable)は、位置依存実行ファイルの一種であり、ロードアドレスのランダム化と組み合わせて使用されます。特定の再配置が必要かどうか、および再配置がどこで行われるかは、オブジェクトフォーマットとシンボルルールを組み合わせる必要があります。リンクとロード を参照。
言語間境界のクイックリファレンス
関数プロトタイプ、データサイズと整列、複合型の分類、呼び出し規約、例外が境界を跨いで処理できるかどうか、メモリを誰が解放するか、およびシンボル名を確認します。extern "C" などの宣言は、一部のリンクおよび呼び出し規則を指定できますが、すべての言語オブジェクトが互換性のあるレイアウトとライフサイクルを持つように自動的にするものではありません。
参考文献
Keywords: ABI, calling convention, stack alignment, caller-saved, callee-saved, shadow space, red zone, variadic, CFI, PIC, PIE