OSDN Git Service

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