OSDN Git Service

(split) LDP: remove getcontext.2 because it is removed in LDP 3.50
[linuxjm/LDP_man-pages.git] / release / man5 / elf.5
1 .\"     $OpenBSD: elf.5,v 1.12 2003/10/27 20:23:58 jmc Exp $
2 .\"Copyright (c) 1999 Jeroen Ruigrok van der Werven
3 .\"All rights reserved.
4 .\"
5 .\"Redistribution and use in source and binary forms, with or without
6 .\"modification, are permitted provided that the following conditions
7 .\"are met:
8 .\"1. Redistributions of source code must retain the above copyright
9 .\"   notice, this list of conditions and the following disclaimer.
10 .\"2. Redistributions in binary form must reproduce the above copyright
11 .\"   notice, this list of conditions and the following disclaimer in the
12 .\"   documentation and/or other materials provided with the distribution.
13 .\"
14 .\"THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 .\"ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 .\"IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 .\"ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 .\"FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 .\"DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 .\"HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21 .\"LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22 .\"SUCH DAMAGE.
23 .\"
24 .\"     $FreeBSD: src/share/man/man5/elf.5,v 1.21 2001/10/01 16:09:23 ru Exp $
25 .\"
26 .\" Slightly adapted - aeb, 2004-01-01
27 .\" 2005-07-15, Mike Frysinger <vapier@gentoo.org>, various fixes
28 .\" 2007-10-11, Mike Frysinger <vapier@gentoo.org>, various fixes
29 .\" 2007-12-08, mtk, Converted from mdoc to man macros
30 .\"
31 .\"*******************************************************************
32 .\"
33 .\" This file was generated with po4a. Translate the source file.
34 .\"
35 .\"*******************************************************************
36 .TH ELF 5 2010\-06\-19 Linux "Linux Programmer's Manual"
37 .SH 名前
38 elf \- 実行可能リンクフォーマット (ELF) ファイルのフォーマット
39 .SH 書式
40 .nf
41 .\" .B #include <elf_abi.h>
42 \fB#include <elf.h>\fP
43 .fi
44 .SH 説明
45 ヘッダファイル \fI<elf.h>\fP は ELF 実行可能バイナリファイルのフォーマットを定義する。
46 これらのファイルとしては、通常の実行可能ファイル・ 再配置可能オブジェクトファイル・コアファイル・共有ライブラリがある。
47 .PP
48 ELF ファイルフォーマットを使う実行可能ファイルは、 ELF ヘッダの後にプログラムヘッダテーブルまたは セクションヘッダテーブル (またはその両方)
49 が続く構成である。 ELF ヘッダは常にファイルのオフセット 0 にある。 プログラムヘッダテーブルとセクションヘッダテーブルの
50 ファイル内でのオフセットは、ELF ヘッダに定義されている。 この 2 つのテーブルはファイルの残りの部分の詳細を記述する。
51 .PP
52 .\" Applications which wish to process ELF binary files for their native
53 .\" architecture only should include
54 .\" .I <elf_abi.h>
55 .\" in their source code.
56 .\" These applications should need to refer to
57 .\" all the types and structures by their generic names
58 .\" "Elf_xxx"
59 .\" and to the macros by
60 .\" ELF_xxx".
61 .\" Applications written this way can be compiled on any architecture,
62 .\" regardless of whether the host is 32-bit or 64-bit.
63 .\" .PP
64 .\" Should an application need to process ELF files of an unknown
65 .\" architecture, then the application needs to explicitly use either
66 .\" "Elf32_xxx"
67 .\" or
68 .\" "Elf64_xxx"
69 .\" type and structure names.
70 .\" Likewise, the macros need to be identified by
71 .\" "ELF32_xxx"
72 .\" or
73 .\" "ELF64_xxx".
74 .\" .PP
75 このヘッダファイルは上記のヘッダを C 言語の構造体で記述し、 また動的セクション・再配置可能セクション・シンボルテーブルの構造体も 含んでいる。
76 .PP
77 以下の型は N ビットアーキテクチャで使われる (N=32,64 であり \fIElfN\fP は \fIElf32\fP または \fIElf64\fP を表し、
78 \fIuintN_t\fP は \fIuint32_t\fP または \fIuint64_t\fP を表す):
79 .in +4n
80 .nf
81
82 .\" Elf32_Size  Unsigned object size
83 ElfN_Addr       符号なしのプログラムアドレス, uintN_t
84 ElfN_Off        符号なしのファイルオフセット, uintN_t
85 ElfN_Section    符号なしのセクションインデックス, uint16_t
86 ElfN_Versym     符号なしのバージョンシンボル情報, uint16_t
87 Elf_Byte        unsigned char
88 ElfN_Half       uint16_t
89 ElfN_Sword      int32_t
90 ElfN_Word       uint32_t
91 ElfN_Sxword     int64_t
92 ElfN_Xword      uint64_t
93 .fi
94 .in
95 .PP
96 (注意: *BSD での用語は少し異なる。 \fIElf64_Half\fP は \fIElf32_Half\fP の 2 倍であり、
97 \fIElf64Quarter\fP が \fIuint16_t\fP に用いられる。 混乱を避けるため、以下では、これらの型はサイズが自明な型に置き換えてある。)
98 .PP
99 このファイルフォーマットが定義する全てのデータ構造体は、 関連するクラスの "自然な" サイズと配置の指針に従う。
100 必要な場合、データ構造体では明示的なパディング (padding, 詰め込み)  が行なわれる。これは 4 バイトオブジェクトに対する 4
101 バイト配置を保証するためや、 構造体のサイズを 4 の倍数にするためなどである。
102 .PP
103 ELF ヘッダは型 \fIElf32_Ehdr\fP または \fIElf64_Ehdr\fP で記述される:
104 .in +4n
105 .nf
106
107 #define EI_NIDENT 16
108
109 typedef struct {
110     unsigned char e_ident[EI_NIDENT];
111     uint16_t      e_type;
112     uint16_t      e_machine;
113     uint32_t      e_version;
114     ElfN_Addr     e_entry;
115     ElfN_Off      e_phoff;
116     ElfN_Off      e_shoff;
117     uint32_t      e_flags;
118     uint16_t      e_ehsize;
119     uint16_t      e_phentsize;
120     uint16_t      e_phnum;
121     uint16_t      e_shentsize;
122     uint16_t      e_shnum;
123     uint16_t      e_shstrndx;
124 } ElfN_Ehdr;
125 .fi
126 .in
127 .PP
128 .\" .Bl -tag -width "e_phentsize"
129 フィールドは以下の意味を持つ:
130 .TP  12
131 \fIe_ident\fP
132 このバイト配列は、プロセッサやファイルの他の部分には依存せずに、 ファイルを解釈 (interpret) するために指定される。
133 この配列内のすべてのものは、接頭辞 \fBEI_\fP で始まるマクロの名前が付き、接頭辞 \fBELF\fP で始まる値を持つ。 以下のマクロが定義されている:
134 .RS 12
135 .\" .Bl -tag -width "EI_VERSION" \" EI_ABIVERSION
136 .TP  12
137 \fBEI_MAG0\fP
138 マジックナンバーの第 1 バイト。 \fBELFMAG0\fP で埋めなければならない。 (0: 0x7f)
139 .TP 
140 \fBEI_MAG1\fP
141 マジックナンバーの第 2 バイト。 \fBELFMAG1\fP で埋めなければならない。 (1: \(aqE\(aq)
142 .TP 
143 \fBEI_MAG2\fP
144 マジックナンバーの第 3 バイト。 \fBELFMAG2\fP で埋めなければならない。 (2: \(aqL\(aq)
145 .TP 
146 \fBEI_MAG3\fP
147 マジックナンバーの第 4 バイト。 \fBELFMAG3\fP で埋めなければならない。 (3: \(aqF\(aq)
148 .TP 
149 \fBEI_CLASS\fP
150 第 5 バイトは、このバイナリのアーキテクチャを示す:
151 .RS 12
152 .\" .Bl -tag -width "ELFCLASSNONE" -compact
153 .TP  14
154 .PD 0
155 \fBELFCLASSNONE\fP
156 このクラスは不正である。
157 .TP 
158 \fBELFCLASS32\fP
159 32 ビットアーキテクチャを定義する。 ファイルと仮想アドレス空間が 4 ギガバイトまでのマシンをサポートする。
160 .TP 
161 \fBELFCLASS64\fP
162 64 ビットアーキテクチャを定義する。
163 .PD
164 .RE
165 .\" .El
166 .TP 
167 \fBEI_DATA\fP
168 .\" .Bl -tag -width "ELFDATA2LSB" -compact
169 第 6 バイトはファイル内のプロセッサ固有データの データエンコーディングを指定する。 現在のところ以下のエンコーディングがサポートされている:
170 .RS 12
171 .TP  14
172 .PD 0
173 \fBELFDATANONE\fP
174 不明なデータフォーマット。
175 .TP 
176 \fBELFDATA2LSB\fP
177 2 の補数、リトルエンディアン。
178 .TP 
179 \fBELFDATA2MSB\fP
180 2 の補数、ビッグエンディアン。
181 .PD
182 .RE
183 .\" .El
184 .TP 
185 .PD 0
186 \fBEI_VERSION\fP
187 .\" .Bl -tag -width "EV_CURRENT" -compact
188 ELF 仕様のバージョン番号:
189 .RS 12
190 .TP  14
191 \fBEV_NONE\fP
192 不正なバージョン。
193 .TP 
194 \fBEV_CURRENT\fP
195 現在のバージョン。
196 .PD
197 .RE
198 .\".El
199 .TP 
200 \fBEI_OSABI\fP
201 .\" .Bl -tag -width "ELFOSABI_STANDALONE" -compact
202 このバイトはオブジェクトのターゲットとなる オペレーティングシステムと ABI を示す。 他の ELF 構造体のフィールドには、
203 プラットフォーム固有の意味を持つフラグや値を持つものもある; これらのフィールドの解釈は、このバイトの値によって決定される。 例えば:
204 .RS 12
205 .TP  20
206 .PD 0
207 \fBELFOSABI_NONE\fP
208 .\" 0
209 ELFOSABI_SYSV と同じ。
210 .TP 
211 \fBELFOSABI_SYSV\fP
212 .\" 0
213 .\" synonym: ELFOSABI_NONE
214 UNIX System V ABI.
215 .TP 
216 \fBELFOSABI_HPUX\fP
217 .\" 1
218 HP\-UX ABI.
219 .TP 
220 \fBELFOSABI_NETBSD\fP
221 .\" 2
222 NetBSD ABI.
223 .TP 
224 \fBELFOSABI_LINUX\fP
225 .\" 3
226 .\" .TP
227 .\" .BR ELFOSABI_HURD
228 .\" Hurd ABI.
229 .\" 4
230 .\" .TP
231 .\" .BR ELFOSABI_86OPEN
232 .\" 86Open Common IA32 ABI.
233 .\" 5
234 Linux ABI.
235 .TP 
236 \fBELFOSABI_SOLARIS\fP
237 .\" 6
238 .\" .TP
239 .\" .BR ELFOSABI_MONTEREY
240 .\" Monterey project ABI.
241 .\" Now replaced by
242 .\" ELFOSABI_AIX
243 .\" 7
244 Solaris ABI.
245 .TP 
246 \fBELFOSABI_IRIX\fP
247 .\" 8
248 IRIX ABI.
249 .TP 
250 \fBELFOSABI_FREEBSD\fP
251 .\" 9
252 FreeBSD ABI.
253 .TP 
254 \fBELFOSABI_TRU64\fP
255 .\" 10
256 .\" ELFOSABI_MODESTO
257 .\" 11
258 .\" ELFOSABI_OPENBSD
259 .\" 12
260 TRU64 UNIX ABI.
261 .TP 
262 \fBELFOSABI_ARM\fP
263 .\" 97
264 ARM アーキテクチャ ABI.
265 .TP 
266 \fBELFOSABI_STANDALONE\fP
267 .\" 255
268 .\" .El
269 スタンドアロン (組み込み) ABI.
270 .PD
271 .RE
272 .TP 
273 \fBEI_ABIVERSION\fP
274 このバイトはオブジェクトがターゲットとしている ABI のバージョンを示す。 このフィールドは互換性のない ABI
275 のバージョンを区別するために使われる。 このバージョン番号の解釈は、 \fBEI_OSABI\fP フィールドで識別される ABI に依存する。
276 この仕様に準拠するアプリケーションは、値 0 を使う。
277 .TP 
278 \fBEI_PAD\fP
279 .\" As reported by Yuri Kozlov and confirmed by Mike Frysinger, EI_BRAND is
280 .\" not in GABI (http://www.sco.com/developers/gabi/latest/ch4.eheader.html)
281 .\" It looks to be a BSDism
282 .\" .TP
283 .\" .BR EI_BRAND
284 .\" Start of architecture identification.
285 パディングの開始。 これらのバイトは予約されており、0 に設定されている。 これらを読み込むプログラムは、これらのバイトを無視すべきである。
286 現在使われていないバイトに意味が与えられる場合、 \fBEI_PAD\fP の値は将来変更されるかもしれない。
287 .TP 
288 \fBEI_NIDENT\fP
289 .\" .El
290 \fIe_ident\fP 配列のサイズ。
291 .RE
292 .TP 
293 \fIe_type\fP
294 この構造体のメンバはオブジェクトファイルタイプを示す:
295 .RS 12
296 .\" .Bl -tag -width "ET_NONE" -compact
297 .TP  12
298 .PD 0
299 \fBET_NONE\fP
300 不明なタイプ。
301 .TP 
302 \fBET_REL\fP
303 再配置可能ファイル。
304 .TP 
305 \fBET_EXEC\fP
306 実行可能ファイル。
307 .TP 
308 \fBET_DYN\fP
309 共有オブジェクト。
310 .TP 
311 \fBET_CORE\fP
312 コアファイル。
313 .PD
314 .RE
315 .\" .El
316 .TP 
317 \fIe_machine\fP
318 このメンバは個々のファイルに必要とされるアーキテクチャを指定する。 例:
319 .RS 12
320 .\" .Bl -tag -width "EM_MIPS_RS4_BE" -compact
321 .TP  12
322 .PD 0
323 \fBEM_NONE\fP
324 .\" 0
325 不明なマシン。
326 .TP 
327 \fBEM_M32\fP
328 .\" 1
329 AT&T WE 32100.
330 .TP 
331 \fBEM_SPARC\fP
332 .\" 2
333 Sun Microsystems SPARC.
334 .TP 
335 \fBEM_386\fP
336 .\" 3
337 Intel 80386.
338 .TP 
339 \fBEM_68K\fP
340 .\" 4
341 Motorola 68000.
342 .TP 
343 \fBEM_88K\fP
344 .\" 5
345 .\" .TP
346 .\" .BR EM_486
347 .\" Intel 80486.
348 .\" 6
349 Motorola 88000.
350 .TP 
351 \fBEM_860\fP
352 .\" 7
353 Intel 80860.
354 .TP 
355 \fBEM_MIPS\fP
356 .\" 8
357 .\" EM_S370
358 .\" 9
359 .\" .TP
360 .\" .BR EM_MIPS_RS4_BE
361 .\" MIPS RS4000 (big-endian only). Deprecated.
362 .\" 10
363 .\" EM_MIPS_RS3_LE (MIPS R3000 little-endian)
364 .\" 10
365 MIPS RS3000 (ビッグエンディアンのみ)。
366 .TP 
367 \fBEM_PARISC\fP
368 .\" 15
369 HP/PA.
370 .TP 
371 \fBEM_SPARC32PLUS\fP
372 .\" 18
373 拡張命令セット付き SPARC。
374 .TP 
375 \fBEM_PPC\fP
376 .\" 20
377 PowerPC.
378 .TP 
379 \fBEM_PPC64\fP
380 .\" 21
381 PowerPC 64\-bit.
382 .TP 
383 \fBEM_S390\fP
384 .\" 22
385 IBM S/390
386 .TP 
387 \fBEM_ARM\fP
388 .\" 40
389 Advanced RISC Machines
390 .TP 
391 \fBEM_SH\fP
392 .\" 42
393 Renesas SuperH
394 .TP 
395 \fBEM_SPARCV9\fP
396 .\" 43
397 SPARC v9 64\-bit.
398 .TP 
399 \fBEM_IA_64\fP
400 .\" 50
401 Intel Itanium
402 .TP 
403 \fBEM_X86_64\fP
404 .\" 62
405 AMD x86\-64
406 .TP 
407 \fBEM_VAX\fP
408 .\" 75
409 .\" EM_CRIS
410 .\" 76
411 .\" .TP
412 .\" .BR EM_ALPHA
413 .\" Compaq [DEC] Alpha.
414 .\" .TP
415 .\" .BR EM_ALPHA_EXP
416 .\" Compaq [DEC] Alpha with enhanced instruction set.
417 DEC Vax.
418 .PD
419 .RE
420 .\" .El
421 .TP 
422 \fIe_version\fP
423 .\" .Bl -tag -width "EV_CURRENT" -compact
424 このメンバはファイルバージョンを示す:
425 .RS 12
426 .TP  12
427 .PD 0
428 \fBEV_NONE\fP
429 不正なバージョン。
430 .TP 
431 \fBEV_CURRENT\fP
432 .\" .El
433 現在のバージョン。
434 .PD
435 .RE
436 .TP 
437 \fIe_entry\fP
438 このメンバは、システムが最初に制御を渡す、 つまりプロセスを開始する仮想アドレスを指定する。 ファイルにエントリポイントが関連付けられていない場合、
439 このメンバには 0 が入る。
440 .TP 
441 \fIe_phoff\fP
442 このメンバはプログラムヘッダテーブルの ファイルオフセット (バイト単位) を保持する。 ファイルにプログラムヘッダテーブルがない場合、 このメンバには
443 0 が入る。
444 .TP 
445 \fIe_shoff\fP
446 このメンバはセクションヘッダテーブルの ファイルオフセット (バイト単位) を保持する。 ファイルにセクションヘッダテーブルがない場合、 このメンバには
447 0 が入る。
448 .TP 
449 \fIe_flags\fP
450 このメンバはファイルに関連付けられたプロセッサ固有のフラグを保持する。 フラグの名前は EF_`machine_flag' という形式である。
451 現在のところフラグは定義されていない。
452 .TP 
453 \fIe_ehsize\fP
454 このメンバは ELF ヘッダサイズ (バイト単位) を保持する。
455 .TP 
456 \fIe_phentsize\fP
457 このメンバはこのファイルのプログラムヘッダテーブルの 1 エントリあたりのサイズ (バイト単位) を保持する; 全てのエントリは同じサイズである。
458 .TP 
459 \fIe_phnum\fP
460 このメンバはプログラムヘッダテーブルにあるエントリの数を保持する。 よって \fIe_phentsize\fP と \fIe_phnum\fP の積がテーブルサイズ
461 (バイト単位) になる。 ファイルにプログラムヘッダがない場合、 \fIe_phnum\fP は値 0 を保持する。
462 .IP
463 .\" This is a Linux extension, added in Linux 2.6.34.
464 .\" .Bl -tag -width "PN_XNUM"
465 プログラムヘッダテーブルのエントリー数が \fBPN_XNUM\fP (0xffff) 以上の場合、
466 このメンバは \fBPN_XNUM\fP (0xffff) になり、プログラムヘッダテーブルの
467 エントリーの実際の数は、セクションヘッダテーブルの最初のエントリーの
468 \fIsh_info\fP メンバに格納される。それ以外の場合、セクションヘッダテーブルの
469 最初のエントリーの \fIsh_info\fP メンバには値 0 が格納される。
470 .RS 12
471 .TP  9
472 \fBPN_XNUM\fP
473 \fIe_phnum\fP が保持できる最大値を表し、 0xffff に定義されている。 \fIe_phnum\fP
474 はプログラムヘッダの実際の数がどこに割り当てられているかを示す。
475 .PD
476 .RE
477 .\" .El
478 .IP
479 .TP 
480 \fIe_shentsize\fP
481 このメンバはセクションヘッダのサイズ (バイト単位) を保持する。 セクションヘッダはセクションヘッダテーブルの 1 つのエントリである;
482 全てのエントリは同じサイズである。
483 .TP 
484 \fIe_shnum\fP
485 このメンバはセクションヘッダテーブルにあるエントリの数を保持する。 よって \fIe_shentsize\fP と \fIe_shnum\fP
486 の積はセクションヘッダテーブルのサイズ (バイト単位) になる。 ファイルにセクションヘッダテーブルがない場合、 \fIe_shnum\fP は値 0
487 を保持する。
488 .IP
489 セクションヘッダテーブルのエントリー数が \fBSHN_LORESERVE\fP (0xff00) 以上の場合、
490 \fIe_shnum\fP には値 0 が入り、セクションヘッダテーブルのエントリーの実際の数は
491 セクションヘッダテーブルの最初のエントリーの \fIsh_size\fP メンバに格納される。
492 それ以外の場合、セクションヘッダテーブルの最初のエントリーの \fIsh_info\fP メンバ
493 には値 0 が格納される。
494 .TP 
495 \fIe_shstrndx\fP
496 このメンバはセクション名文字列テーブルに関連付けられたエントリの セクションヘッダテーブルインデックスを保持する。
497 ファイルにセクション名文字列テーブルがない場合、 このメンバは値 \fBSHN_UNDEF\fP を保持する。 \fBSHN_UNDEF\fP.
498 .IP
499 セクション名前文字列テーブルのインデックスが \fBSHN_LORESERVE\fP (0xff00) 以上の
500 場合、このメンバには \fBSHN_XINDEX\fP (0xffff) が入り、セクション名前文字列
501 テーブルの実際のインデックスはセクションヘッダテーブルの最初のエントリーの
502 \fIsh_link\fP メンバに格納される。それ以外の場合、セクションヘッダテーブルの
503 最初のエントリーの \fIsh_link\fP メンバには値 0 が格納される。
504 .RS 12
505 .\" .Bl -tag -width "SHN_LORESERVE"
506 .TP  14
507 \fBSHN_UNDEF\fP
508 この値は未定義・存在しない・無関係その他、 意味のないセクションの参照であることを表す。 例えば、セクション番号 \fBSHN_UNDEF\fP
509 に関連づけて「定義」されたシンボルは、「未定義」なシンボルである。
510 .TP 
511 \fBSHN_LORESERVE\fP
512 この値は予約済みのインデックス領域の下限を指定する。
513 .TP 
514 \fBSHN_LOPROC\fP
515 この値以上で \fBSHN_HIPROC\fP 以下の値はプロセッサ固有の意味に予約されている。
516 .TP 
517 \fBSHN_HIPROC\fP
518 この値以下で \fBSHN_HIPROC\fP 以上の値はプロセッサ固有の意味に予約されている。
519 .TP 
520 \fBSHN_ABS\fP
521 この値は対応する参照の絶対値を指定する。 例えば、セクション番号 \fBSHN_ABS\fP に関連づけられたシンボルは絶対値を保持し、再配置に影響されない。
522 .TP 
523 \fBSHN_COMMON\fP
524 このセクションに関連して定義されたシンボルは、 Fortran の COMMON や C の未割り当て external 変数のような、
525 共通シンボルである。
526 .TP 
527 \fBSHN_HIRESERVE\fP
528 この値は予約されたインデックスの範囲の上限を指定する。 \fBSHN_LORESERVE\fP と \fBSHN_HIRESERVE\fP は含まれる。
529 この値はセクションヘッダテーブルを参照しない。 つまり、セクションヘッダテーブルは 予約されたインデックスのエントリを \fI含まない 。\fP
530 .RE
531 .\" .El
532 .\" .El
533 .PP
534 実行可能ファイルまたは共有オブジェクトファイルのプログラムヘッダテーブルは、 システムによるプログラム実行準備に必要な、
535 セグメント等の情報を記述する構造体の配列である。 オブジェクトファイルの \fIセグメント\fP には 1 つ以上の \fIセクション\fP が含まれる。
536 プログラムヘッダは実行可能ファイルと共有オブジェクトファイルでのみ意味を持つ。 ファイルは自身のプログラムヘッダサイズを ELF ヘッダの
537 \fIe_phentsize\fP メンバと \fIe_phnum\fP メンバで指定する。 ELF プログラムヘッダは \fIElf32_Phdr\fP 型または
538 \fIElf64_Phdr\fP 型で記述される (どちらになるかはアーキテクチャ依存):
539 .in +4n
540 .nf
541
542 typedef struct {
543     uint32_t   p_type;
544     Elf32_Off  p_offset;
545     Elf32_Addr p_vaddr;
546     Elf32_Addr p_paddr;
547     uint32_t   p_filesz;
548     uint32_t   p_memsz;
549     uint32_t   p_flags;
550     uint32_t   p_align;
551 } Elf32_Phdr;
552 .fi
553 .in
554 .in +4n
555 .nf
556
557 typedef struct {
558     uint32_t   p_type;
559     uint32_t   p_flags;
560     Elf64_Off  p_offset;
561     Elf64_Addr p_vaddr;
562     Elf64_Addr p_paddr;
563     uint64_t   p_filesz;
564     uint64_t   p_memsz;
565     uint64_t   p_align;
566 } Elf64_Phdr;
567 .fi
568 .in
569 .PP
570 .\" .Bl -tag -width "p_offset"
571 32 ビットと 64 ビットのプログラムヘッダの主な違いは、構造体における \fIp_flags\fP メンバの位置にある。
572 .TP  12
573 \fIp_type\fP
574 .\" .Bl -tag -width "PT_DYNAMIC"
575 Phdr 構造体のこのメンバは、 この配列要素がどのような種類のセグメントを記述しているか、 またはこの配列要素の情報をどのように解釈するか、を表す。
576 .RS 12
577 .TP  12
578 \fBPT_NULL\fP
579 この配列要素は使用されておらず、その他のメンバの値は未定義である。 これにより、このプログラムヘッダのエントリは無視される。
580 .TP 
581 \fBPT_LOAD\fP
582 この配列要素は \fIp_filesz\fP と \fIp_memsz\fP で記述されるロード可能セグメントを指定する。
583 このファイルからのバイトデータが、このメモリセグメントの先頭からマップされる。 セグメントのメモリサイズ \fISy\fPp_memsz がファイルサイズ
584 \fISy\fPp_filesz より大きい場合、 「余った」バイトは値 0 となり、 そのセグメント初期化データの後ろに置かれると定められている。
585 ファイルサイズはメモリサイズより大きくてはいけない。 プログラムヘッダテーブルのロード可能セグメントエントリは、 \fIp_vaddr\fP
586 メンバの昇順にソートされて出現する。
587 .TP 
588 \fBPT_DYNAMIC\fP
589 この配列要素は動的リンク情報を指定する。
590 .TP 
591 \fBPT_INTERP\fP
592 この配列要素は、インタプリタとして起動されるパス名 (NULL 文字終端)  の位置とサイズを指定する。 このセグメント型は
593 (共有オブジェクトにもあるかも知れないが)  実行可能ファイルでのみ意味を持つ。 ただし、このセグメント型は 1 つのファイルに 2
594 回以上出現してはならない。 もし存在する場合、このセグメント型は 全てのロード可能セグメントエントリより前になければならない。
595 .TP 
596 \fBPT_NOTE\fP
597 この配列要素は補足情報 (auxiliary information) の位置とサイズを指定する。
598 .TP 
599 \fBPT_SHLIB\fP
600 このセグメント型は予約されているが、意味は指定されていない。 この型の配列要素を保持するプログラムは ABI に準拠しない。
601 .TP 
602 \fBPT_PHDR\fP
603 この配列要素は、もし存在しているならば、 ファイルおよびプログラムのメモリイメージ双方における プログラムヘッダテーブル自身の位置とサイズを指定する。
604 このセグメント型は 1 つのファイルに 2 回以上出現してはならない。 さらに、このセグメント型が存在してもよいのは、プログラムヘッダテーブルが
605 プログラムのメモリイメージの一部である場合のみである。 もし存在する場合、これは全てのロード可能セグメントエントリより 前になければならない。
606 .TP 
607 \fBPT_LOPROC\fP
608 この値以上で \fBPT_HIPROC\fP 以下の値はプロセッサ固有の意味に予約されている。
609 .TP 
610 \fBPT_HIPROC\fP
611 この値以下で \fBPT_LOPROC\fP 以上の値はプロセッサ固有の意味に予約されている。
612 .TP 
613 \fBPT_GNU_STACK\fP
614 .\" .El
615 GNU 拡張であり、Linux カーネルが \fIp_flags\fP のメンバーにセットされたフラグ経由でスタックの状態を制御するために使用する。
616 .RE
617 .TP 
618 \fIp_offset\fP
619 このメンバは、セグメントの先頭バイトがある (ファイル先頭からの) オフセットを保持する。
620 .TP 
621 \fIp_vaddr\fP
622 このメンバは、セグメントの先頭バイトがある メモリの仮想アドレスを保持する。
623 .TP 
624 \fIp_paddr\fP
625 物理アドレスが意味をもつシステムでは、 このメンバはセグメントの物理アドレスとして予約されている。 BSD ではこのメンバは使用されない。0
626 でなければならない。
627 .TP 
628 \fIp_filesz\fP
629 このメンバはセグメントのファイルイメージのバイト数を保持する。 これは 0 でもよい。
630 .TP 
631 \fIp_memsz\fP
632 このメンバはセグメントのメモリイメージのバイト数を保持する。 これは 0 でもよい。
633 .TP 
634 \fIp_flags\fP
635 .\" .Bl -tag -width "PF_X" -compact
636 このメンバはセグメントに関連するフラグのビットマップを保持する:
637 .RS 12
638 .TP 
639 .PD 0
640 \fBPF_X\fP
641 実行可能セグメント。
642 .TP 
643 \fBPF_W\fP
644 書き込み可能セグメント.
645 .TP 
646 \fBPF_R\fP
647 読み込み可能セグメント。
648 .PD
649 .RE
650 .\" .El
651 .IP
652 テキストセグメントは一般にフラグ \fBPF_X\fP と \fBPF_R\fP を持つ。 データセグメントは一般に \fBPF_X\fP, \fBPF_W\fP,
653 \fBPF_R\fP を持つ。
654 .TP 
655 \fIp_align\fP
656 .\" .El
657 このメンバは、セグメントがメモリおよびファイルにおいて配置 (align)  される値を保持する。
658 ロード可能プロセスセグメントは、ページサイズを法として \fIp_vaddr\fP と \fIp_offset\fP と合同でなければならない
659 (訳注:「p_vaddr mod ページサイズ = p_offset mod ページサイズ」 でなければならない)。。 0 と 1
660 という値は配置が必要ないことを意味する。 それ以外の場合、 \fIp_align\fP は正で 2 の整数乗でなければならず、 \fIp_vaddr\fP は
661 \fIp_align\fP を法として \fIp_offset\fP と合同でなければならない (訳注:「p_vaddr mod p_align =
662 p_offset mod p_align」でなければならない)。
663 .PP
664 ファイルのセクションヘッダテーブルには、 全てのファイルセクションの場所が記述されている。 セクションヘッダテーブルは \fIElf32_Shdr\fP
665 構造体または \fIElf64_Shdr\fP 構造体の配列である。 ELF ヘッダの \fIe_shoff\fP メンバはファイルの先頭から
666 セクションヘッダテーブルへのバイトオフセットである。 \fIe_shnum\fP はセクションヘッダテーブルに含まれるエントリの数を保持する。
667 \fIe_shentsize\fP は各エントリのサイズ (バイト単位) を保持する。
668 .PP
669 .\" .Bl -tag -width "SHN_LORESERVE"
670 セクションヘッダテーブルインデックスは、この配列の添字である。
671 いくつかのセクションヘッダテーブルインデックスは予約されている。予約されて
672 いるのは、最初のエントリーと、\fBSHN_LORESERVE\fP と \fBSHN_HIRESERVE\fP の間の
673 インデックスである。
674 最初のエントリーは、ELF 拡張で \fIe_phnum\fP, \fIe_shnum\fP, \fIe_strndx\fP に使用
675 される。それ以外の場合、最初のエントリーの各フィールドには 0 が設定される。
676 オブジェクトファイルにはこれらの特別なインデックスに対応するセクションはない。
677 .RS
678 .TP  14
679 \fBSHN_UNDEF\fP
680 この値は未定義・不明・無関係・無意味なセクション参照の印となる。
681 .TP 
682 \fBSHN_LORESERVE\fP
683 この値は予約済みのインデックス領域の下限を指定する。
684 .TP 
685 \fBSHN_LOPROC\fP
686 この値以上で \fBSHN_HIPROC\fP 以下の値はプロセッサ固有の意味に予約されている。
687 .TP 
688 \fBSHN_HIPROC\fP
689 この値以下で \fBSHN_HIPROC\fP 以上の値はプロセッサ固有の意味に予約されている。
690 .TP 
691 \fBSHN_ABS\fP
692 この値は対応する参照の絶対値を指定する。 例えば、セクション番号 \fBSHN_ABS\fP に関連して定義されているシンボルは、
693 絶対値を保持しているので、再配置に影響されない。
694 .TP 
695 \fBSHN_COMMON\fP
696 このセクションに関連して定義されているシンボルは、 FORTRAN の COMMON や C の未割り当て外部変数のような共通シンボルである。
697 .TP 
698 \fBSHN_HIRESERVE\fP
699 この値は予約済みのインデックス領域の上限を指定する。 システムは \fBSHN_LORESERVE\fP と \fBSHN_HIRESERVE\fP
700 を含む範囲を予約する。 セクションヘッダテーブルは予約されたインデックスに対応するエントリを持たない。
701 .RE
702 .\" .El
703 .PP
704 セクションヘッダは以下の構造体を持つ:
705 .in +4n
706 .nf
707
708 typedef struct {
709     uint32_t   sh_name;
710     uint32_t   sh_type;
711     uint32_t   sh_flags;
712     Elf32_Addr sh_addr;
713     Elf32_Off  sh_offset;
714     uint32_t   sh_size;
715     uint32_t   sh_link;
716     uint32_t   sh_info;
717     uint32_t   sh_addralign;
718     uint32_t   sh_entsize;
719 } Elf32_Shdr;
720 .fi
721 .in
722 .in +4n
723 .nf
724
725 typedef struct {
726     uint32_t   sh_name;
727     uint32_t   sh_type;
728     uint64_t   sh_flags;
729     Elf64_Addr sh_addr;
730     Elf64_Off  sh_offset;
731     uint64_t   sh_size;
732     uint32_t   sh_link;
733     uint32_t   sh_info;
734     uint64_t   sh_addralign;
735     uint64_t   sh_entsize;
736 } Elf64_Shdr;
737 .fi
738 .in
739 .PP
740 .\" .Bl -tag -width "sh_addralign"
741 32 ビットと 64 ビットのセクションヘッダには実際の違いはない。
742 .TP  10
743 \fIsh_name\fP
744 このメンバはセクション名を定める。 この値はセクションヘッダ文字列テーブルセクションのインデックスであり、 NULL
745 文字で終端された文字列の場所を示す。
746 .TP 
747 \fIsh_type\fP
748 .\" .Bl -tag -width "SHT_PROGBITS"
749 このメンバはセクションの内容と意味が含まれるカテゴリを示す。
750 .RS 10
751 .TP  15
752 \fBSHT_NULL\fP
753 この値はセクションヘッダが不活性であることを示す。 これは関連するセクションを持たない。 このセクションヘッダの他のメンバは、未定義の値を持つ。
754 .TP 
755 \fBSHT_PROGBITS\fP
756 このセクションはプログラムにより定義される情報を保持する。 この情報の形式と意味は、ひとえにプログラムによって決定される。
757 .TP 
758 \fBSHT_SYMTAB\fP
759 このセクションはシンボルテーブルを保持する。 一般には \fBSHT_SYMTAB\fP はリンク編集のためのシンボルを提供するが、 動的リンクにも使われる。
760 完全なシンボルテーブルとして、動的リンクには不要な 多くのシンボルを保持できる。 オブジェクトファイルも \fBSHT_DYNSYM\fP
761 セクションを持つことができる。
762 .TP 
763 \fBSHT_STRTAB\fP
764 このセクションは文字列テーブルを保持する。 オブジェクトファイルは複数の文字列テーブルセクションを持つことができる。
765 .TP 
766 \fBSHT_RELA\fP
767 このセクションは明示的な加数 (addend) を持つ再配置エントリを保持する。 再配置エントリの型は、オブジェクトファイルの 32 ビットクラスでは
768 \fIElf32_Rela\fP である。 オブジェクトファイルは複数の再配置セクションを持つことができる。
769 .TP 
770 \fBSHT_HASH\fP
771 このセクションはシンボルハッシュテーブルを保持する。 動的リンクされるオブジェクトは、 シンボルハッシュテーブルを含んでいなければならない。
772 オブジェクトファイルは 1 つのハッシュテーブルのみを持つことができる。
773 .TP 
774 \fBSHT_DYNAMIC\fP
775 このセクションは動的リンクの情報を保持する。 オブジェクトファイルは 1 つの動的セクションのみを持つことができる。
776 .TP 
777 \fBSHT_NOTE\fP
778 このセクションはファイルに何らかの印を付ける情報を保持する。
779 .TP 
780 \fBSHT_NOBITS\fP
781 このタイプのセクションはファイルの領域を使わないという以外は、 \fBSHT_PROGBITS\fP と似ている。 このセクションは 1 バイトも含まないが、
782 \fIsh_offset\fP メンバは概念的なファイルオフセットを持つ。
783 .TP 
784 \fBSHT_REL\fP
785 このセクションは明示的な加数を持たない再配置オフセットを保持する。 再配置オフセットの型は、オブジェクトファイルの 32 ビットクラスでは
786 \fIElf32_Rel\fP である。 オブジェクトファイルは複数の再配置セクションを持つことができる。
787 .TP 
788 \fBSHT_SHLIB\fP
789 このセクションは予約されているが、意味は指定されていない。
790 .TP 
791 \fBSHT_DYNSYM\fP
792 このセクションは動的リンクシンボルの最小セットを保持する。 オブジェクトファイルは \fBSHT_SYMTAB\fP セクションも含むことができる。
793 .TP 
794 \fBSHT_LOPROC\fP
795 この値以上で \fBSHT_HIPROC\fP 以下の範囲はプロセッサ固有の意味に予約されている。
796 .TP 
797 \fBSHT_HIPROC\fP
798 この値以下で \fBSHT_LOPROC\fP 以上の範囲はプロセッサ固有の意味に予約されている。
799 .TP 
800 \fBSHT_LOUSER\fP
801 この値はアプリケーションプログラムのために予約される インデックス範囲の下限を指定する。
802 .TP 
803 \fBSHT_HIUSER\fP
804 .\" .El
805 この値はアプリケーションプログラムのために予約される インデックス範囲の上限を指定する。 \fBSHT_LOUSER\fP から \fBSHT_HIUSER\fP
806 の間のセクションタイプは、 現在または将来のシステム定義セクションタイプと衝突することなく、 アプリケーションで使用することができる。
807 .RE
808 .TP 
809 \fIsh_flags\fP
810 .\" .Bl -tag -width "SHF_EXECINSTR" -compact
811 様々な属性を記述するための 1 ビットのフラグをサポートするセクション。 フラグビットが \fIsh_flags\fP
812 に設定された場合、そのセクションについての属性は "オン" になる。 それ以外の場合、属性が "オフ" であるか属性が適用されない。 未定義の属性は 0
813 に設定される。
814 .RS 10
815 .TP  15
816 \fBSHF_WRITE\fP
817 このセクションはプロセス実行中に書き込み可能なデータを含む。
818 .TP 
819 \fBSHF_ALLOC\fP
820 このセクションはプロセス実行中にメモリを使用する。 制御セクションの中には、オブジェクトファイルのメモリイメージには 存在しないものもある。
821 そうしたセクションの場合、この属性はオフである。
822 .TP 
823 \fBSHF_EXECINSTR\fP
824 このセクションは実行可能なマシン命令を含む。
825 .TP 
826 \fBSHF_MASKPROC\fP
827 このマスクに含まれる全てのビットはプロセッサ固有の意味に予約されている。
828 .RE
829 .\" .El
830 .TP 
831 \fIsh_addr\fP
832 このセクションがプロセスのメモリイメージにある場合、 このメンバはセクションの最初のバイトが存在するアドレスを保持する。 それ以外の場合、このメンバは
833 0 である。
834 .TP 
835 \fIsh_offset\fP
836 このメンバの値は、ファイルの先頭からセクションの最初のバイトへの バイトオフセットを保持する。 セクションタイプ \fBSHT_NOBITS\fP
837 はファイルの領域を全く使用せず、このタイプの \fIsh_offset\fP メンバはファイルの概念的な位置を示す。
838 .TP 
839 \fIsh_size\fP
840 このメンバはセクションのサイズ (バイト単位) を保持する。 セクションタイプが \fBSHT_NOBITS\fP でない限り、そのセクションはファイル中の
841 \fIsh_size\fP バイトを使用する。 タイプが \fBSHT_NOBITS\fP のセクションはサイズが 0 でないが、ファイルの領域を使用しない。
842 .TP 
843 \fIsh_link\fP
844 このメンバは、セクションヘッダテーブルインデックスリンクを保持する。 この解釈はセクションタイプに依存する。
845 .TP 
846 \fIsh_info\fP
847 このメンバは追加情報を保持する。 この解釈はセクションタイプに依存する。
848 .TP 
849 \fIsh_addralign\fP
850 アドレス配置に制約があるセクションもある。 セクションが倍長語 (doubleword) を保持する場合、
851 システムは全てのセクションについて倍長語の配置を保証しなければならない。 つまり、 \fIsh_addr\fP の値は \fIsh_addralign\fP
852 の値を法として 0 と合同でなければならない (訳注:「sh_addr mod sh_addralign = 0 でなければならない)。 2 の 0
853 乗と正の整数乗のみが許可される。 0 または 1 はセクションの配置に制約がないことを意味する。
854 .TP 
855 \fIsh_entsize\fP
856 .\" .El
857 シンボルテーブルのような固定サイズエントリのテーブルを保持する セクションもある。 このようなセクションでは、 このメンバは各エントリのサイズ
858 (バイト単位) を表す。 このメンバが 0 の場合、 そのセクションは固定サイズエントリのテーブルを保持しない。
859 .PP
860 .\" .Bl -tag -width ".shstrtab"
861 さまざまなセクションにプログラム情報・制御情報が保持される:
862 .TP  10
863 \&\fI.bss\fP
864 このセクションはプログラムのメモリイメージに配置される 非初期化データを保持する。 定義上、システムはプログラムの実行開始時に、データを 0
865 で初期化する。 このセクションのタイプは \fBSHT_NOBITS\fP である。 属性タイプは \fBSHF_ALLOC\fP と \fBSHF_WRITE\fP
866 である。
867 .TP 
868 \&\fI.comment\fP
869 このセクションはバージョン制御情報を保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。 属性タイプは使用されない。
870 .TP 
871 \&\fI.ctors\fP
872 このセクションは C++ コンストラクタ関数への初期化されたポインタを保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
873 属性タイプは \fBSHF_ALLOC\fP と \fBSHF_WRITE\fP である。
874 .TP 
875 \&\fI.data\fP
876 このセクションはプログラムのメモリイメージに配置される 初期化済みデータを保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
877 属性タイプは \fBSHF_ALLOC\fP と \fBSHF_WRITE\fP である。
878 .TP 
879 \&\fI.data1\fP
880 このセクションはプログラムのメモリイメージに配置される 初期化済みデータを保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
881 属性タイプは \fBSHF_ALLOC\fP と \fBSHF_WRITE\fP である。
882 .TP 
883 \&\fI.debug\fP
884 このセクションはシンボリックデバッグ用の情報を保持する。 その内容は指定されていない。 このセクションのタイプは \fBSHT_PROGBITS\fP
885 である。 属性タイプは使用されない。
886 .TP 
887 \&\fI.dtors\fP
888 このセクションは C++ デストラクタ関数への初期化されたポインタを保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
889 属性タイプは \fBSHF_ALLOC\fP と \fBSHF_WRITE\fP である。
890 .TP 
891 \&\fI.dynamic\fP
892 このセクションは動的リンク情報を保持する。 このセクションの属性は \fBSHF_ALLOC\fP ビットを含む。 \fBSHF_WRITE\fP
893 ビットが設定されるか否かはプロセッサによる。 このセクションのタイプは \fBSHT_DYNAMIC\fP である。 上記の属性を参照すること。
894 .TP 
895 \&\fI.dynstr\fP
896 このセクションは動的リンクに必要な文字列を保持する。 最も一般的には、この文字列はシンボルテーブルエントリと 関連づけられた名前を表す。
897 このセクションのタイプは \fBSHT_STRTAB\fP である。 使用される属性タイプは \fBSHF_ALLOC\fP である。
898 .TP 
899 \&\fI.dynsym\fP
900 このセクションは動的リンクシンボルテーブルを保持する。 このセクションのタイプは \fBSHT_DYNSYM\fP である。 使用される属性タイプは
901 \fBSHF_ALLOC\fP である。
902 .TP 
903 \&\fI.fini\fP
904 このセクションはプロセス終了コードに置かれる実行可能命令を保持する。 プロセスが正常に終了した場合、システムはこのセクションにある
905 コードを配置して実行する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。 使用される属性タイプは \fBSHF_ALLOC\fP と
906 \fBSHF_EXECINSTR\fP である。
907 .TP 
908 \&\fI.gnu.version\fP
909 このセクションはバージョン・シンボル・テーブルを保持する。 その内容は \fIElfN_Half\fP 要素の配列である。 このセクションのタイプは
910 \fBSHT_GNU_versym\fP である。 使用される属性タイプは \fBSHF_ALLOC\fP である。
911 .TP 
912 \&\fI.gnu.version_d\fP
913 このセクションはバージョンシンボルの定義を保持する。 その内容は \fIElfN_Verdef\fP 構造体のテーブルである。 このセクションのタイプは
914 \fBSHT_GNU_verdef\fP である。 使用される属性タイプは \fBSHF_ALLOC\fP である。
915 .TP 
916 \&\fI.gnu.version_r\fP
917 このセクションはバージョンシンボルが必要とする要素を保持する。 その内容は \fIElfN_Verneed\fP 構造体のテーブルである。
918 このセクションのタイプは \fBSHT_GNU_versym\fP である。 使用される属性タイプは \fBshf_alloc\fP である。
919 .TP 
920 \&\fI.got\fP
921 このセクションはグローバルオフセットテーブルを保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
922 属性はプロセッサ毎に異なる。
923 .TP 
924 \&\fI.hash\fP
925 このセクションはシンボルハッシュテーブルを保持する。 セクションのタイプは \fBSHT_HASH\fP である。 使用される属性は \fBSHF_ALLOC\fP
926 である。
927 .TP 
928 \&\fI.init\fP
929 このセクションはプロセス初期化コードに配置される実行可能命令を保持する。 プログラムが実行を開始すると、
930 システムはメインプログラムエントリポイントを呼び出す前に、 このセクションにあるコードを配置して実行する。 このセクションはのタイプは
931 \fBSHT_PROGBITS\fP である。 使用される属性は \fBSHF_ALLOC\fP と \fBSHF_EXECINSTR\fP である。
932 .TP 
933 \&\fI.interp\fP
934 このセクションはプログラムインタプリタのパス名を保持する。 ファイルにこのセクションを含むロード可能セグメントがある場合、 そのセクションの属性には
935 \fBSHF_ALLOC\fP ビットが含まれる。 それ以外の場合このビットはオフになる。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
936 .TP 
937 \&\fI.line\fP
938 このセクションはシンボリックデバッグのための行番号情報を保持する。 ここにはプログラムソースコードとマシンコードの対応関係が記述される。
939 内容は指定されていない。 このセクションのタイプは \fBSHT_PROGBITS\fP である。 属性タイプは使用されない。
940 .TP 
941 \&\fI.note\fP
942 このセクションは "Note Section" 形式で情報を保持する。このセクションのタイプ
943 は \fBSHT_NOTE\fP である。属性タイプは使用されない。通常 OpenBSD ネイティブ実行
944 可能ファイルは自身を識別するために \fI.note.openbsd.ident\fP セクションを持つ。
945 これによりカーネルは、ファイルをロードする際に 互換 ELF バイナリエミュレーショ
946 ンテストを回避できる。
947 .TP 
948 \&\fI.note.GNU\-stack\fP
949 このセクションは Linux のオブジェクトファイルで スタック属性を宣言するのに使用される。 セクションのタイプは \fBSHT_PROGBITS\fP
950 である。使用される属性は \fBSHF_EXECINSTR\fP だけである。この属性は GNU リンカに対して オブジェクトファイルが実行可能なスタック
951 (executable stack) を必要とする 示すものである。
952 .TP 
953 \&\fI.plt\fP
954 このセクションは手続き (procedure) リンクテーブルを保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
955 属性はプロセッサ毎に異なる。
956 .TP 
957 \&\fI.relNAME\fP
958 このセクションは以下に記述される再配置情報を保持する。 ファイルが再配置を含むロード可能セグメントを持っている場合、 このセクションの属性は
959 \fBSHF_ALLOC\fP ビットを含む。 それ以外の場合、そのビットはオフである。 慣例として、 "NAME"
960 は再配置が適用されるセクションが指定される。 よって \fB.text\fP についての再配置セクションは、通常は \fB.rel.text\fP
961 という名前を持つ。 このセクションのタイプは \fBSHT_REL\fP である。
962 .TP 
963 \&\fI.relaNAME\fP
964 このセクションは以下に記述される再配置情報を保持する。 ファイルが再配置を含むロード可能セグメントを持っている場合、 このセクションの属性は
965 \fBSHF_ALLOC\fP ビットを含む。 それ以外の場合、そのビットはオフである。 慣例として、 "NAME"
966 は再配置が適用されるセクションが指定される。 よって \fB.text\fP についての再配置セクションは、通常は \fB.rela.text\fP
967 という名前を持つ。 このセクションのタイプは \fBSHT_RELA\fP である。
968 .TP 
969 \&\fI.rodata\fP
970 このセクションはリードオンリーのデータを保持する。 このデータはプロセスイメージにおける書き込み不可能なセグメントに置かれる。 このセクションのタイプは
971 \fBSHT_PROGBITS\fP である。 使用される属性は \fBSHF_ALLOC\fP である。
972 .TP 
973 \&\fI.rodata1\fP
974 このセクションはリードオンリーのデータを保持する。 このデータはプロセスイメージにおける書き込み不可能なセグメントに置かれる。 このセクションのタイプは
975 \fBSHT_PROGBITS\fP である。 使用される属性は \fBSHF_ALLOC\fP である。
976 .TP 
977 \&\fI.shstrtab\fP
978 このセクションはセクション名を保持する。 このセクションのタイプは \fBSHT_STRTAB\fP である。 属性タイプは使用されない。
979 .TP 
980 \&\fI.strtab\fP
981 このセクションは文字列を保持する。 最も一般的なのは、シンボルテーブルエントリに関連づけられた 名前を表す文字列である。
982 ファイルがシンボル文字列テーブルを含むロード可能セグメントを持つ場合、 セクションの属性は \fBSHF_ALLOC\fP ビットを含む。
983 それ以外の場合、そのビットはオフである。 このセクションのタイプは \fBSHT_STRTAB\fP である。
984 .TP 
985 \&\fI.symtab\fP
986 このセクションはシンボルテーブルを保持する。 ファイルがシンボルテーブルを含むロード可能セグメントを持つ場合、 セクションの属性は
987 \fBSHF_ALLOC\fP ビットを含む。 それ以外の場合、ビットはオフである。 このセクションのタイプは \fBSHT_SYMTAB\fP である。
988 .TP 
989 \&\fI.text\fP
990 .\" .El
991 このセクションはプログラムの "テキスト" または実行可能命令を保持する。 セクションのタイプは \fBSHT_PROGBITS\fP である。
992 使用される属性は \fBSHF_ALLOC\fP と \fBSHF_EXECINSTR\fP である。
993 .PP
994 文字列テーブルセクションは NULL 文字で終端されたキャラクタ配列 (通常文字列と呼ばれるもの) を保持する。 オブジェクトファイルはこれらの文字列を
995 シンボル名とセクション名を表すために使う。 文字列は、文字列テーブルセクションへのインデックスとして参照される。 インデックス 0
996 の最初のバイトは、NULL バイト (\(aq\e0\(aq) を 保持すると定義されている。 同様に文字列テーブルの最後のバイトも NULL
997 文字を保持すると定義されている。 これは全ての文字列が NULL バイトで終端されていることを保証するためである。
998 .PP
999 オブジェクトファイルのシンボルテーブルは、 プログラムのシンボル定義と参照を配置または再配置するのに 必要な情報を保持する。
1000 .in +4n
1001 .nf
1002
1003 typedef struct {
1004     uint32_t      st_name;
1005     Elf32_Addr    st_value;
1006     uint32_t      st_size;
1007     unsigned char st_info;
1008     unsigned char st_other;
1009     uint16_t      st_shndx;
1010 } Elf32_Sym;
1011 .fi
1012 .in
1013 .in +4n
1014 .nf
1015
1016 typedef struct {
1017     uint32_t      st_name;
1018     unsigned char st_info;
1019     unsigned char st_other;
1020     uint16_t      st_shndx;
1021     Elf64_Addr    st_value;
1022     uint64_t      st_size;
1023 } Elf64_Sym;
1024 .fi
1025 .in
1026 .PP
1027 .\" .Bl -tag -width "st_value"
1028 32 ビット版と 64 ビット版は同じメンバを持ち、単に順番が異なるだけである。
1029 .TP  10
1030 \fIst_name\fP
1031 このメンバはオブジェクトファイルのシンボル文字列テーブルの インデックスを保持する。 シンボル文字列テーブルはシンボル名の文字表現を保持する。 この値が
1032 0 でない場合、シンボル名を得るための文字テーブルインデックスを表す。 それ以外の場合、シンボルテーブルは名前を持たない。
1033 .TP 
1034 \fIst_value\fP
1035 このメンバは関連づけられたシンボルの値を表す。
1036 .TP 
1037 \fIst_size\fP
1038 多くのシンボルにはそれに関連づけられたサイズがある。 シンボルがサイズを持たない場合、またはサイズが不明な場合、 このメンバは 0 である。
1039 .TP 
1040 \fIst_info\fP
1041 .\" .Bl -tag -width "STT_SECTION"
1042 このメンバはシンボルのタイプとバインディング (binding) 属性を指定する:
1043 .RS 10
1044 .TP  12
1045 \fBSTT_NOTYPE\fP
1046 シンボルのタイプが定義されていない。
1047 .TP 
1048 \fBSTT_OBJECT\fP
1049 シンボルはデータオブジェクトに関連づけられている。
1050 .TP 
1051 \fBSTT_FUNC\fP
1052 シンボルは関数またはその他の実行コードに関連づけられている。
1053 .TP 
1054 \fBSTT_SECTION\fP
1055 シンボルはセクションに関連づけられている。 このタイプのシンボルテーブルエントリは、 主として再配置のために存在し、通常は \fBSTB_LOCAL\fP
1056 バインディングを持つ。
1057 .TP 
1058 \fBSTT_FILE\fP
1059 慣例として、シンボルの名前は オブジェクトファイルに関連づけられたソースファイルの名前を指定する。 ファイルシンボルは \fBSTB_LOCAL\fP
1060 バインディングを持ち、そのセクションインデックスは \fBSHN_ABS\fP である。 ファイルシンボルは、ファイルに他の \fBSTB_LOCAL\fP
1061 シンボルがある場合は、それよりも先に来る。
1062 .TP 
1063 \fBSTT_LOPROC\fP
1064 この値以上で \fBSTT_HIPROC\fP 以下の範囲はプロセッサ固有の意味に予約されている。
1065 .TP 
1066 \fBSTT_HIPROC\fP
1067 .\" .El
1068 .\" .Bl -tag -width "STB_GLOBAL"
1069 この値以下で \fBSTT_LOPROC\fP 以上の範囲はプロセッサ固有の意味に予約されている。
1070 .TP 
1071 \fBSTB_LOCAL\fP
1072 局所的シンボルはその定義を含むオブジェクトファイルの外からは見えない。 同じ名前の局所的シンボルは、お互いに影響を受けることなく、
1073 複数のファイルに存在できる。
1074 .TP 
1075 \fBSTB_GLOBAL\fP
1076 大域的シンボルは結びつけられている全てのオブジェクトファイルから見える。 1 つのファイルで大域的シンボルが定義されていたら、
1077 他のファイルでは同じシンボルへの参照は未定義でなければならない。
1078 .TP 
1079 \fBSTB_WEAK\fP
1080 弱シンボルは大域的シンボルに似ているが、その定義は優先度が低い。
1081 .TP 
1082 \fBSTB_LOPROC\fP
1083 この値以上で \fBSTB_HIPROC\fP 以下の範囲はプロセッサ固有の意味に予約されている。
1084 .TP 
1085 \fBSTB_HIPROC\fP
1086 この値以下で \fBSTB_LOPROC\fP 以上の範囲はプロセッサ固有の意味に予約されている。
1087 .IP
1088 バインディングとタイプフィールドを パックしたりアンパックしたりするマクロがある:
1089 .IP
1090 \fBELF32_ST_BIND\fP(info)  または \fBELF64_ST_BIND\fP(info)  \fIst_info\fP
1091 の値からバインディングを取り出す。
1092 .IP
1093 \fBELF32_ST_TYPE\fP(info)  または \fBELF64_ST_TYPE\fP(info)
1094 .br
1095 \fIst_info\fP の値からタイプを取り出す。
1096 .IP
1097 \fBELF32_ST_INFO\fP(bind, type)  または \fBELF64_ST_INFO\fP(bind, type)
1098 .br
1099 バインディングとタイプを \fIst_info\fP の値に変換する。
1100 .RE
1101 .\" .El
1102 .TP 
1103 \fIst_other\fP
1104 .\" .Bl -tag -width "STV_PROTECTED"
1105 このメンバはシンボルの visibility (見える範囲) を規定する。
1106 .RS 10
1107 .TP  16
1108 .PD 0
1109 \fBSTV_DEFAULT\fP
1110 デフォルトのシンボル visibility ルール。
1111 .TP 
1112 \fBSTV_INTERNAL\fP
1113 プロセッサ固有の隠しクラス。
1114 .TP 
1115 \fBSTV_HIDDEN\fP
1116 シンボルは他のモジュールからは利用できない。
1117 .TP 
1118 \fBSTV_PROTECTED\fP
1119 横取りできず (not preemptible)、公開されない。
1120 .PD
1121 .PP
1122 visibility 種別を抽出するためのマクロがある。
1123 .PP
1124 \fBELF32_ST_VISIBILITY\fP(other)  または \fBELF64_ST_VISIBILITY\fP(other)
1125 .RE
1126 .\" .El
1127 .TP 
1128 \fIst_shndx\fP
1129 .\" .El
1130 各シンボルテーブルエントリは、いくつかのセクションに関連して "定義されている"。 このメンバは関連するセクションヘッダテーブルインデックスを保持する。
1131 .PP
1132 再配置はシンボル参照とシンボル定義を結合するプロセスである。 再配置可能ファイルはセクションの内容をどのように修正するかに関する
1133 情報を持たなければならない。 これにより、実行可能ファイルと共有オブジェクトファイルは
1134 プロセスのプログラムイメージについての正しい情報を持つことができる。 再配置エントリは以下のようなデータである。
1135 .PP
1136 加数を必要としない再配置構造体。
1137 .in +4n
1138 .nf
1139
1140 typedef struct {
1141     Elf32_Addr r_offset;
1142     uint32_t   r_info;
1143 } Elf32_Rel;
1144 .fi
1145 .in
1146 .in +4n
1147 .nf
1148
1149 typedef struct {
1150     Elf64_Addr r_offset;
1151     uint64_t   r_info;
1152 } Elf64_Rel;
1153 .fi
1154 .in
1155 .PP
1156 加数を必要とする再配置構造体。
1157 .in +4n
1158 .nf
1159
1160 typedef struct {
1161     Elf32_Addr r_offset;
1162     uint32_t   r_info;
1163     int32_t    r_addend;
1164 } Elf32_Rela;
1165 .fi
1166 .in
1167 .in +4n
1168 .nf
1169
1170 typedef struct {
1171     Elf64_Addr r_offset;
1172     uint64_t   r_info;
1173     int64_t    r_addend;
1174 } Elf64_Rela;
1175 .fi
1176 .in
1177 .\" .Bl -tag -width "r_offset"
1178 .TP  12
1179 \fIr_offset\fP
1180 このメンバは再配置動作が適用される位置を与える。 再配置可能ファイルの場合、この値はセクションの先頭から 再配置で影響を受ける格納単位 (storage
1181 unit) までのバイトオフセットである。 実行可能ファイルまたは共有オブジェクトの場合、 この値は再配置で影響を受ける格納単位の仮想アドレスである。
1182 .TP 
1183 \fIr_info\fP
1184 このメンバは、再配置が行われなければならないシンボルテーブルインデックスと、 適用される再配置のタイプの両方を与える。
1185 再配置タイプはプロセッサ毎に異なる。 テキストが再配置エントリの再配置タイプ またはシンボルテーブルインデックスを参照している場合、 それぞれエントリの
1186 \fIr_info\fP メンバに対して、それぞれ \fBELF_[32|64]_R_TYPE\fP と \fBELF[32|64]_R_SYM\fP
1187 を適用した結果を意味する。
1188 .TP 
1189 \fIr_addend\fP
1190 .\" .El
1191 このメンバは定数の加数を指定する。 この加数は再配置可能フィールドに格納される値を計算するために使われる。
1192 .PP
1193 \&.dynamic セクションは、関連する動的リンク情報を保持している 一連の構造体を保持する。 d_tag メンバは d_un の解釈を制御する。
1194 .in +4n
1195 .nf
1196
1197 typedef struct {
1198     Elf32_Sword    d_tag;
1199     union {
1200         Elf32_Word d_val;
1201         Elf32_Addr d_ptr;
1202     } d_un;
1203 } Elf32_Dyn;
1204 extern Elf32_Dyn _DYNAMIC[];
1205 .fi
1206 .in
1207 .in +4n
1208 .nf
1209
1210 typedef struct {
1211     Elf64_Sxword    d_tag;
1212     union {
1213         Elf64_Xword d_val;
1214         Elf64_Addr  d_ptr;
1215     } d_un;
1216 } Elf64_Dyn;
1217 extern Elf64_Dyn _DYNAMIC[];
1218 .fi
1219 .in
1220 .\" .Bl -tag -width "d_tag"
1221 .TP  10
1222 \fId_tag\fP
1223 .\" .Bl -tag -width "DT_SYMBOLIC"
1224 このメンバは以下の値を持つことができる:
1225 .RS 10
1226 .TP  12
1227 \fBDT_NULL\fP
1228 動的セクションの終りのマーク
1229 .TP 
1230 \fBDT_NEEDED\fP
1231 必要なライブラリの名前への文字列テーブルオフセット
1232 .TP 
1233 \fBDT_PLTRELSZ\fP
1234 PLT 再配置 (reloc) テーブルのサイズ (バイト単位)
1235 .TP 
1236 \fBDT_PLTGOT\fP
1237 PLT と GOT (または何れか一方) のアドレス
1238 .TP 
1239 \fBDT_HASH\fP
1240 シンボルハッシュテーブルのアドレス
1241 .TP 
1242 \fBDT_STRTAB\fP
1243 文字列テーブルのアドレス
1244 .TP 
1245 \fBDT_SYMTAB\fP
1246 シンボルテーブルのアドレス
1247 .TP 
1248 \fBDT_RELA\fP
1249 Rela 再配置テーブルのアドレス
1250 .TP 
1251 \fBDT_RELASZ\fP
1252 Rela テーブルのサイズ (バイト単位)
1253 .TP 
1254 \fBDT_RELAENT\fP
1255 Rela テーブルエントリのサイズ (バイト単位)
1256 .TP 
1257 \fBDT_STRSZ\fP
1258 文字列テーブルのサイズ (バイト単位)
1259 .TP 
1260 \fBDT_SYMENT\fP
1261 シンボルテーブルエントリのサイズ (バイト単位)
1262 .TP 
1263 \fBDT_INIT\fP
1264 初期化関数のアドレス
1265 .TP 
1266 \fBDT_FINI\fP
1267 終了関数のアドレス
1268 .TP 
1269 \fBDT_SONAME\fP
1270 共有オブジェクトの名前への文字列テーブルオフセット
1271 .TP 
1272 \fBDT_RPATH\fP
1273 ライブラリ検索パスへの文字列テーブルオフセット (推奨されない)
1274 .TP 
1275 \fBDT_SYMBOLIC\fP
1276 リンカがシンボルの実行可能ファイルより前に この共有オブジェクトを検索した場合は、警告を出す。
1277 .TP 
1278 \fBDT_REL\fP
1279 Rel 再配置テーブルのアドレス
1280 .TP 
1281 \fBDT_RELSZ\fP
1282 Rel テーブルのサイズ (バイト単位)
1283 .TP 
1284 \fBDT_RELENT\fP
1285 Rel テーブルエントリのサイズ (バイト単位)
1286 .TP 
1287 \fBDT_PLTREL\fP
1288 PLT が参照する再配置テーブルのタイプ (Rela または Rel)
1289 .TP 
1290 \fBDT_DEBUG\fP
1291 デバッグのために使用されている。内容は定義されていない。
1292 .TP 
1293 \fBDT_TEXTREL\fP
1294 これが指定されていない場合、 書き込み不可のセグメントには再配置は適用されない。
1295 .TP 
1296 \fBDT_JMPREL\fP
1297 PLT 専用の再配置エントリのアドレス
1298 .TP 
1299 \fBDT_BIND_NOW\fP
1300 実行可能ファイルに制御を譲る前に、 全ての再配置を処理するように動的リンカに指示する。
1301 .TP 
1302 \fBDT_RUNPATH\fP
1303 ライブラリ検索パスへの文字列テーブルオフセット
1304 .TP 
1305 \fBDT_LOPROC\fP
1306 プロセッサ固有の意味の開始
1307 .TP 
1308 \fBDT_HIPROC\fP
1309 プロセッサ固有の意味の終了
1310 .RE
1311 .\" .El
1312 .TP 
1313 \fId_val\fP
1314 このメンバは様々な意味に解釈される整数値である。
1315 .TP 
1316 \fId_ptr\fP
1317 このメンバはプログラムの仮想アドレスを表す。 これらのアドレスを解釈する際に、 実際のアドレスは元々のファイルの値と
1318 メモリの基底アドレスから計算される。 ファイルにはこれらのアドレスを修正するための 再配置エントリを含めてはならない。
1319 .TP 
1320 \fI_DYNAMIC\fP
1321 .\" .El
1322 \&.dynamic セクションにある全ての動的構造体を含む配列。 これは自動的にリンカに渡される。
1323 .SH 注意
1324 .\" OpenBSD
1325 .\" ELF support first appeared in
1326 .\" OpenBSD 1.2,
1327 .\" although not all supported platforms use it as the native
1328 .\" binary file format.
1329 ELF は System V で初めて登場した。 ELF 自体は System V で初めて登場した。 ELF フォーマットは採択された標準である。
1330 .PP
1331 .\" .SH AUTHORS
1332 .\" The original version of this manual page was written by
1333 .\" .An Jeroen Ruigrok van der Werven
1334 .\" .Aq asmodai@FreeBSD.org
1335 .\" with inspiration from BSDi's
1336 .\" .Bsx
1337 .\" .Nm elf
1338 .\" man page.
1339 \fIe_phnum\fP, \fIe_shnum\fP, \fIe_strndx\fP に対する拡張は、いずれも Linux での拡張で
1340 ある。Sun, BSD, AMD64 もこれに対応している。詳しい情報は、関連項目を参照。
1341 .SH 関連項目
1342 \fBas\fP(1), \fBgdb\fP(1), \fBld\fP(1), \fBobjdump\fP(1), \fBexecve\fP(2), \fBcore\fP(5)
1343 .PP
1344 Hewlett\-Packard, \fIElf\-64 Object File Format\fP.
1345 .PP
1346 Santa Cruz Operation, \fISystem V Application Binary Interface\fP.
1347 .PP
1348 UNIX System Laboratories, "Object Files", \fIExecutable and Linking Format
1349 (ELF)\fP.
1350 .PP
1351 Sun Microsystems, \fILinker and Libraries Guide\fP.
1352 .PP
1353 AMD64 ABI Draft, \fISystem V Application Binary Interface AMD64 Architecture
1354 Processor Supplement\fP.
1355 .PP
1356 .SH この文書について
1357 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.41 の一部
1358 である。プロジェクトの説明とバグ報告に関する情報は
1359 http://www.kernel.org/doc/man\-pages/ に書かれている。