OSDN Git Service

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