OSDN Git Service

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