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.
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
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.
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
26 .\" $FreeBSD: src/share/man/man5/elf.5,v 1.21 2001/10/01 16:09:23 ru Exp $
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
33 .\"*******************************************************************
35 .\" This file was generated with po4a. Translate the source file.
37 .\"*******************************************************************
38 .TH ELF 5 2013\-04\-17 Linux "Linux Programmer's Manual"
40 elf \- 実行可能リンクフォーマット (ELF) ファイルのフォーマット
43 .\" .B #include <elf_abi.h>
44 \fB#include <elf.h>\fP
47 ヘッダファイル \fI<elf.h>\fP は ELF 実行可能バイナリファイルのフォーマットを定義する。
48 これらのファイルとしては、通常の実行可能ファイル・ 再配置可能オブジェクトファイル・コアファイル・共有ライブラリがある。
50 ELF ファイルフォーマットを使う実行可能ファイルは、 ELF ヘッダの後にプログラムヘッダテーブルまたは セクションヘッダテーブル (またはその両方)
51 が続く構成である。 ELF ヘッダは常にファイルのオフセット 0 にある。 プログラムヘッダテーブルとセクションヘッダテーブルの
52 ファイル内でのオフセットは、ELF ヘッダに定義されている。 この 2 つのテーブルはファイルの残りの部分の詳細を記述する。
54 .\" Applications which wish to process ELF binary files for their native
55 .\" architecture only should include
57 .\" in their source code.
58 .\" These applications should need to refer to
59 .\" all the types and structures by their generic names
61 .\" and to the macros by
63 .\" Applications written this way can be compiled on any architecture,
64 .\" regardless of whether the host is 32-bit or 64-bit.
66 .\" Should an application need to process ELF files of an unknown
67 .\" architecture, then the application needs to explicitly use either
71 .\" type and structure names.
72 .\" Likewise, the macros need to be identified by
77 このヘッダファイルは上記のヘッダを C 言語の構造体で記述し、 また動的セクション・再配置可能セクション・シンボルテーブルの構造体も 含んでいる。
79 以下の型は N ビットアーキテクチャで使われる (N=32,64 であり \fIElfN\fP は \fIElf32\fP または \fIElf64\fP を表し、
80 \fIuintN_t\fP は \fIuint32_t\fP または \fIuint64_t\fP を表す):
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
98 (注意: *BSD での用語は少し異なる。 \fIElf64_Half\fP は \fIElf32_Half\fP の 2 倍であり、
99 \fIElf64Quarter\fP が \fIuint16_t\fP に用いられる。 混乱を避けるため、以下では、これらの型はサイズが自明な型に置き換えてある。)
101 このファイルフォーマットが定義する全てのデータ構造体は、 関連するクラスの "自然な" サイズと配置の指針に従う。
102 必要な場合、データ構造体では明示的なパディング (padding, 詰め込み) が行なわれる。これは 4 バイトオブジェクトに対する 4
103 バイト配置を保証するためや、 構造体のサイズを 4 の倍数にするためなどである。
105 ELF ヘッダは型 \fIElf32_Ehdr\fP または \fIElf64_Ehdr\fP で記述される:
112 unsigned char e_ident[EI_NIDENT];
121 uint16_t e_phentsize;
123 uint16_t e_shentsize;
130 .\" .Bl -tag -width "e_phentsize"
134 このバイト配列は、プロセッサやファイルの他の部分には依存せずに、 ファイルを解釈 (interpret) するために指定される。
135 この配列内のすべてのものは、接頭辞 \fBEI_\fP で始まるマクロの名前が付き、接頭辞 \fBELF\fP で始まる値を持つ。 以下のマクロが定義されている:
137 .\" .Bl -tag -width "EI_VERSION" \" EI_ABIVERSION
140 マジックナンバーの第 1 バイト。 \fBELFMAG0\fP で埋めなければならない。 (0: 0x7f)
143 マジックナンバーの第 2 バイト。 \fBELFMAG1\fP で埋めなければならない。 (1: \(aqE\(aq)
146 マジックナンバーの第 3 バイト。 \fBELFMAG2\fP で埋めなければならない。 (2: \(aqL\(aq)
149 マジックナンバーの第 4 バイト。 \fBELFMAG3\fP で埋めなければならない。 (3: \(aqF\(aq)
152 第 5 バイトは、このバイナリのアーキテクチャを示す:
154 .\" .Bl -tag -width "ELFCLASSNONE" -compact
161 32 ビットアーキテクチャを定義する。 ファイルと仮想アドレス空間が 4 ギガバイトまでのマシンをサポートする。
170 .\" .Bl -tag -width "ELFDATA2LSB" -compact
171 第 6 バイトはファイル内のプロセッサ固有データの データエンコーディングを指定する。 現在のところ以下のエンコーディングがサポートされている:
189 .\" .Bl -tag -width "EV_CURRENT" -compact
190 The seventh byte is the version number of the ELF specification:
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.:
217 .\" synonym: ELFOSABI_NONE
224 \fBELFOSABI_NETBSD\fP
231 .\" .BR ELFOSABI_HURD
235 .\" .BR ELFOSABI_86OPEN
236 .\" 86Open Common IA32 ABI.
240 \fBELFOSABI_SOLARIS\fP
243 .\" .BR ELFOSABI_MONTEREY
244 .\" Monterey project ABI.
254 \fBELFOSABI_FREEBSD\fP
270 \fBELFOSABI_STANDALONE\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.
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
290 .\" Start of architecture identification.
291 パディングの開始。 これらのバイトは予約されており、0 に設定されている。 これらを読み込むプログラムは、これらのバイトを無視すべきである。
292 現在使われていないバイトに意味が与えられる場合、 \fBEI_PAD\fP の値は将来変更されるかもしれない。
296 \fIe_ident\fP 配列のサイズ。
300 この構造体のメンバはオブジェクトファイルタイプを示す:
302 .\" .Bl -tag -width "ET_NONE" -compact
324 このメンバは個々のファイルに必要とされるアーキテクチャを指定する。 例:
326 .\" .Bl -tag -width "EM_MIPS_RS4_BE" -compact
339 Sun Microsystems SPARC.
366 .\" .BR EM_MIPS_RS4_BE
367 .\" MIPS RS4000 (big-endian only). Deprecated.
369 .\" EM_MIPS_RS3_LE (MIPS R3000 little-endian)
371 MIPS RS3000 (ビッグエンディアンのみ)。
395 Advanced RISC Machines
419 .\" Compaq [DEC] Alpha.
422 .\" Compaq [DEC] Alpha with enhanced instruction set.
429 .\" .Bl -tag -width "EV_CURRENT" -compact
444 このメンバは、システムが最初に制御を渡す、 つまりプロセスを開始する仮想アドレスを指定する。 ファイルにエントリポイントが関連付けられていない場合、
448 このメンバはプログラムヘッダテーブルの ファイルオフセット (バイト単位) を保持する。 ファイルにプログラムヘッダテーブルがない場合、 このメンバには
452 このメンバはセクションヘッダテーブルの ファイルオフセット (バイト単位) を保持する。 ファイルにセクションヘッダテーブルがない場合、 このメンバには
456 このメンバはファイルに関連付けられたプロセッサ固有のフラグを保持する。 フラグの名前は EF_`machine_flag' という形式である。
460 このメンバは ELF ヘッダサイズ (バイト単位) を保持する。
463 このメンバはこのファイルのプログラムヘッダテーブルの 1 エントリあたりのサイズ (バイト単位) を保持する; 全てのエントリは同じサイズである。
466 このメンバはプログラムヘッダテーブルにあるエントリの数を保持する。 よって \fIe_phentsize\fP と \fIe_phnum\fP の積がテーブルサイズ
467 (バイト単位) になる。 ファイルにプログラムヘッダがない場合、 \fIe_phnum\fP は値 0 を保持する。
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 が格納される。
479 \fIe_phnum\fP が保持できる最大値を表し、 0xffff に定義されている。 \fIe_phnum\fP
480 はプログラムヘッダの実際の数がどこに割り当てられているかを示す。
487 このメンバはセクションヘッダのサイズ (バイト単位) を保持する。 セクションヘッダはセクションヘッダテーブルの 1 つのエントリである;
491 このメンバはセクションヘッダテーブルにあるエントリの数を保持する。 よって \fIe_shentsize\fP と \fIe_shnum\fP
492 の積はセクションヘッダテーブルのサイズ (バイト単位) になる。 ファイルにセクションヘッダテーブルがない場合、 \fIe_shnum\fP は値 0
495 セクションヘッダテーブルのエントリー数が \fBSHN_LORESERVE\fP (0xff00) 以上の場合、
496 \fIe_shnum\fP には値 0 が入り、セクションヘッダテーブルのエントリーの実際の数は
497 セクションヘッダテーブルの最初のエントリーの \fIsh_size\fP メンバに格納される。
498 それ以外の場合、セクションヘッダテーブルの最初のエントリーの \fIsh_info\fP メンバ
502 このメンバはセクション名文字列テーブルに関連付けられたエントリの セクションヘッダテーブルインデックスを保持する。
503 ファイルにセクション名文字列テーブルがない場合、 このメンバは値 \fBSHN_UNDEF\fP を保持する。 \fBSHN_UNDEF\fP.
505 セクション名前文字列テーブルのインデックスが \fBSHN_LORESERVE\fP (0xff00) 以上の
506 場合、このメンバには \fBSHN_XINDEX\fP (0xffff) が入り、セクション名前文字列
507 テーブルの実際のインデックスはセクションヘッダテーブルの最初のエントリーの
508 \fIsh_link\fP メンバに格納される。それ以外の場合、セクションヘッダテーブルの
509 最初のエントリーの \fIsh_link\fP メンバには値 0 が格納される。
511 .\" .Bl -tag -width "SHN_LORESERVE"
514 この値は未定義・存在しない・無関係その他、 意味のないセクションの参照であることを表す。 例えば、セクション番号 \fBSHN_UNDEF\fP
515 に関連づけて「定義」されたシンボルは、「未定義」なシンボルである。
518 この値は予約済みのインデックス領域の下限を指定する。
521 この値以上で \fBSHN_HIPROC\fP 以下の値はプロセッサ固有の意味に予約されている。
524 この値以下で \fBSHN_HIPROC\fP 以上の値はプロセッサ固有の意味に予約されている。
527 この値は対応する参照の絶対値を指定する。 例えば、セクション番号 \fBSHN_ABS\fP に関連づけられたシンボルは絶対値を保持し、再配置に影響されない。
530 このセクションに関連して定義されたシンボルは、 Fortran の COMMON や C の未割り当て external 変数のような、
534 この値は予約されたインデックスの範囲の上限を指定する。 \fBSHN_LORESERVE\fP と \fBSHN_HIRESERVE\fP は含まれる。
535 この値はセクションヘッダテーブルを参照しない。 つまり、セクションヘッダテーブルは 予約されたインデックスのエントリを \fI含まない 。\fP
540 実行可能ファイルまたは共有オブジェクトファイルのプログラムヘッダテーブルは、 システムによるプログラム実行準備に必要な、
541 セグメント等の情報を記述する構造体の配列である。 オブジェクトファイルの \fIセグメント\fP には 1 つ以上の \fIセクション\fP が含まれる。
542 プログラムヘッダは実行可能ファイルと共有オブジェクトファイルでのみ意味を持つ。 ファイルは自身のプログラムヘッダサイズを ELF ヘッダの
543 \fIe_phentsize\fP メンバと \fIe_phnum\fP メンバで指定する。 ELF プログラムヘッダは \fIElf32_Phdr\fP 型または
544 \fIElf64_Phdr\fP 型で記述される (どちらになるかはアーキテクチャ依存):
576 .\" .Bl -tag -width "p_offset"
577 32 ビットと 64 ビットのプログラムヘッダの主な違いは、構造体における \fIp_flags\fP メンバの位置にある。
580 .\" .Bl -tag -width "PT_DYNAMIC"
581 Phdr 構造体のこのメンバは、 この配列要素がどのような種類のセグメントを記述しているか、 またはこの配列要素の情報をどのように解釈するか、を表す。
585 この配列要素は使用されておらず、その他のメンバの値は未定義である。 これにより、このプログラムヘッダのエントリは無視される。
588 この配列要素は \fIp_filesz\fP と \fIp_memsz\fP で記述されるロード可能セグメントを指定する。
589 このファイルからのバイトデータが、このメモリセグメントの先頭からマップされる。 セグメントのメモリサイズ \fISy\fPp_memsz がファイルサイズ
590 \fISy\fPp_filesz より大きい場合、 「余った」バイトは値 0 となり、 そのセグメント初期化データの後ろに置かれると定められている。
591 ファイルサイズはメモリサイズより大きくてはいけない。 プログラムヘッダテーブルのロード可能セグメントエントリは、 \fIp_vaddr\fP
598 この配列要素は、インタプリタとして起動されるパス名 (NULL 文字終端) の位置とサイズを指定する。 このセグメント型は
599 (共有オブジェクトにもあるかも知れないが) 実行可能ファイルでのみ意味を持つ。 ただし、このセグメント型は 1 つのファイルに 2
600 回以上出現してはならない。 もし存在する場合、このセグメント型は 全てのロード可能セグメントエントリより前になければならない。
603 この配列要素は補足情報 (auxiliary information) の位置とサイズを指定する。
606 このセグメント型は予約されているが、意味は指定されていない。 この型の配列要素を保持するプログラムは ABI に準拠しない。
609 この配列要素は、もし存在しているならば、 ファイルおよびプログラムのメモリイメージ双方における プログラムヘッダテーブル自身の位置とサイズを指定する。
610 このセグメント型は 1 つのファイルに 2 回以上出現してはならない。 さらに、このセグメント型が存在してもよいのは、プログラムヘッダテーブルが
611 プログラムのメモリイメージの一部である場合のみである。 もし存在する場合、これは全てのロード可能セグメントエントリより 前になければならない。
614 この値以上で \fBPT_HIPROC\fP 以下の値はプロセッサ固有の意味に予約されている。
617 この値以下で \fBPT_LOPROC\fP 以上の値はプロセッサ固有の意味に予約されている。
621 GNU 拡張であり、Linux カーネルが \fIp_flags\fP のメンバーにセットされたフラグ経由でスタックの状態を制御するために使用する。
625 このメンバは、セグメントの先頭バイトがある (ファイル先頭からの) オフセットを保持する。
628 このメンバは、セグメントの先頭バイトがある メモリの仮想アドレスを保持する。
631 物理アドレスが意味をもつシステムでは、 このメンバはセグメントの物理アドレスとして予約されている。 BSD ではこのメンバは使用されない。0
635 このメンバはセグメントのファイルイメージのバイト数を保持する。 これは 0 でもよい。
638 このメンバはセグメントのメモリイメージのバイト数を保持する。 これは 0 でもよい。
641 .\" .Bl -tag -width "PF_X" -compact
642 このメンバはセグメントに関連するフラグのビットマスクを保持する:
658 テキストセグメントは一般にフラグ \fBPF_X\fP と \fBPF_R\fP を持つ。 データセグメントは一般に \fBPF_X\fP, \fBPF_W\fP,
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」でなければならない)。
670 ファイルのセクションヘッダテーブルには、 全てのファイルセクションの場所が記述されている。 セクションヘッダテーブルは \fIElf32_Shdr\fP
671 構造体または \fIElf64_Shdr\fP 構造体の配列である。 ELF ヘッダの \fIe_shoff\fP メンバはファイルの先頭から
672 セクションヘッダテーブルへのバイトオフセットである。 \fIe_shnum\fP はセクションヘッダテーブルに含まれるエントリの数を保持する。
673 \fIe_shentsize\fP は各エントリのサイズ (バイト単位) を保持する。
675 .\" .Bl -tag -width "SHN_LORESERVE"
676 セクションヘッダテーブルインデックスは、この配列の添字である。
677 いくつかのセクションヘッダテーブルインデックスは予約されている。予約されて
678 いるのは、最初のエントリーと、\fBSHN_LORESERVE\fP と \fBSHN_HIRESERVE\fP の間の
680 最初のエントリーは、ELF 拡張で \fIe_phnum\fP, \fIe_shnum\fP, \fIe_strndx\fP に使用
681 される。それ以外の場合、最初のエントリーの各フィールドには 0 が設定される。
682 オブジェクトファイルにはこれらの特別なインデックスに対応するセクションはない。
686 この値は未定義・不明・無関係・無意味なセクション参照の印となる。
689 この値は予約済みのインデックス領域の下限を指定する。
692 この値以上で \fBSHN_HIPROC\fP 以下の値はプロセッサ固有の意味に予約されている。
695 この値以下で \fBSHN_HIPROC\fP 以上の値はプロセッサ固有の意味に予約されている。
698 この値は対応する参照の絶対値を指定する。 例えば、セクション番号 \fBSHN_ABS\fP に関連して定義されているシンボルは、
699 絶対値を保持しているので、再配置に影響されない。
702 このセクションに関連して定義されているシンボルは、 FORTRAN の COMMON や C の未割り当て外部変数のような共通シンボルである。
705 この値は予約済みのインデックス領域の上限を指定する。 システムは \fBSHN_LORESERVE\fP と \fBSHN_HIRESERVE\fP
706 を含む範囲を予約する。 セクションヘッダテーブルは予約されたインデックスに対応するエントリを持たない。
723 uint32_t sh_addralign;
740 uint64_t sh_addralign;
746 .\" .Bl -tag -width "sh_addralign"
747 32 ビットと 64 ビットのセクションヘッダには実際の違いはない。
750 このメンバはセクション名を定める。 この値はセクションヘッダ文字列テーブルセクションのインデックスであり、 NULL
754 .\" .Bl -tag -width "SHT_PROGBITS"
755 このメンバはセクションの内容と意味が含まれるカテゴリを示す。
759 この値はセクションヘッダが不活性であることを示す。 これは関連するセクションを持たない。 このセクションヘッダの他のメンバは、未定義の値を持つ。
762 このセクションはプログラムにより定義される情報を保持する。 この情報の形式と意味は、ひとえにプログラムによって決定される。
765 このセクションはシンボルテーブルを保持する。 一般には \fBSHT_SYMTAB\fP はリンク編集のためのシンボルを提供するが、 動的リンクにも使われる。
766 完全なシンボルテーブルとして、動的リンクには不要な 多くのシンボルを保持できる。 オブジェクトファイルも \fBSHT_DYNSYM\fP
770 このセクションは文字列テーブルを保持する。 オブジェクトファイルは複数の文字列テーブルセクションを持つことができる。
773 このセクションは明示的な加数 (addend) を持つ再配置エントリを保持する。 再配置エントリの型は、オブジェクトファイルの 32 ビットクラスでは
774 \fIElf32_Rela\fP である。 オブジェクトファイルは複数の再配置セクションを持つことができる。
777 このセクションはシンボルハッシュテーブルを保持する。 動的リンクされるオブジェクトは、 シンボルハッシュテーブルを含んでいなければならない。
778 オブジェクトファイルは 1 つのハッシュテーブルのみを持つことができる。
781 このセクションは動的リンクの情報を保持する。 オブジェクトファイルは 1 つの動的セクションのみを持つことができる。
784 このセクションはファイルに何らかの印を付ける情報を保持する。
787 このタイプのセクションはファイルの領域を使わないという以外は、 \fBSHT_PROGBITS\fP と似ている。 このセクションは 1 バイトも含まないが、
788 \fIsh_offset\fP メンバは概念的なファイルオフセットを持つ。
791 このセクションは明示的な加数を持たない再配置オフセットを保持する。 再配置オフセットの型は、オブジェクトファイルの 32 ビットクラスでは
792 \fIElf32_Rel\fP である。 オブジェクトファイルは複数の再配置セクションを持つことができる。
795 このセクションは予約されているが、意味は指定されていない。
798 このセクションは動的リンクシンボルの最小セットを保持する。 オブジェクトファイルは \fBSHT_SYMTAB\fP セクションも含むことができる。
801 この値以上で \fBSHT_HIPROC\fP 以下の範囲はプロセッサ固有の意味に予約されている。
804 この値以下で \fBSHT_LOPROC\fP 以上の範囲はプロセッサ固有の意味に予約されている。
807 この値はアプリケーションプログラムのために予約される インデックス範囲の下限を指定する。
811 この値はアプリケーションプログラムのために予約される インデックス範囲の上限を指定する。 \fBSHT_LOUSER\fP から \fBSHT_HIUSER\fP
812 の間のセクションタイプは、 現在または将来のシステム定義セクションタイプと衝突することなく、 アプリケーションで使用することができる。
816 .\" .Bl -tag -width "SHF_EXECINSTR" -compact
817 様々な属性を記述するための 1 ビットのフラグをサポートするセクション。 フラグビットが \fIsh_flags\fP
818 に設定された場合、そのセクションについての属性は "オン" になる。 それ以外の場合、属性が "オフ" であるか属性が適用されない。 未定義の属性は 0
823 このセクションはプロセス実行中に書き込み可能なデータを含む。
826 このセクションはプロセス実行中にメモリを使用する。 制御セクションの中には、オブジェクトファイルのメモリイメージには 存在しないものもある。
827 そうしたセクションの場合、この属性はオフである。
830 このセクションは実行可能なマシン命令を含む。
833 このマスクに含まれる全てのビットはプロセッサ固有の意味に予約されている。
838 このセクションがプロセスのメモリイメージにある場合、 このメンバはセクションの最初のバイトが存在するアドレスを保持する。 それ以外の場合、このメンバは
842 このメンバの値は、ファイルの先頭からセクションの最初のバイトへの バイトオフセットを保持する。 セクションタイプ \fBSHT_NOBITS\fP
843 はファイルの領域を全く使用せず、このタイプの \fIsh_offset\fP メンバはファイルの概念的な位置を示す。
846 このメンバはセクションのサイズ (バイト単位) を保持する。 セクションタイプが \fBSHT_NOBITS\fP でない限り、そのセクションはファイル中の
847 \fIsh_size\fP バイトを使用する。 タイプが \fBSHT_NOBITS\fP のセクションはサイズが 0 でないが、ファイルの領域を使用しない。
850 このメンバは、セクションヘッダテーブルインデックスリンクを保持する。 この解釈はセクションタイプに依存する。
853 このメンバは追加情報を保持する。 この解釈はセクションタイプに依存する。
856 アドレス配置に制約があるセクションもある。 セクションが倍長語 (doubleword) を保持する場合、
857 システムは全てのセクションについて倍長語の配置を保証しなければならない。 つまり、 \fIsh_addr\fP の値は \fIsh_addralign\fP
858 の値を法として 0 と合同でなければならない (訳注:「sh_addr mod sh_addralign = 0 でなければならない)。 2 の 0
859 乗と正の整数乗のみが許可される。 0 または 1 はセクションの配置に制約がないことを意味する。
863 シンボルテーブルのような固定サイズエントリのテーブルを保持する セクションもある。 このようなセクションでは、 このメンバは各エントリのサイズ
864 (バイト単位) を表す。 このメンバが 0 の場合、 そのセクションは固定サイズエントリのテーブルを保持しない。
866 .\" .Bl -tag -width ".shstrtab"
867 さまざまなセクションにプログラム情報・制御情報が保持される:
870 このセクションはプログラムのメモリイメージに配置される 非初期化データを保持する。 定義上、システムはプログラムの実行開始時に、データを 0
871 で初期化する。 このセクションのタイプは \fBSHT_NOBITS\fP である。 属性タイプは \fBSHF_ALLOC\fP と \fBSHF_WRITE\fP
875 このセクションはバージョン制御情報を保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。 属性タイプは使用されない。
878 このセクションは C++ コンストラクタ関数への初期化されたポインタを保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
879 属性タイプは \fBSHF_ALLOC\fP と \fBSHF_WRITE\fP である。
882 このセクションはプログラムのメモリイメージに配置される 初期化済みデータを保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
883 属性タイプは \fBSHF_ALLOC\fP と \fBSHF_WRITE\fP である。
886 このセクションはプログラムのメモリイメージに配置される 初期化済みデータを保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
887 属性タイプは \fBSHF_ALLOC\fP と \fBSHF_WRITE\fP である。
890 このセクションはシンボリックデバッグ用の情報を保持する。 その内容は指定されていない。 このセクションのタイプは \fBSHT_PROGBITS\fP
894 このセクションは C++ デストラクタ関数への初期化されたポインタを保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
895 属性タイプは \fBSHF_ALLOC\fP と \fBSHF_WRITE\fP である。
898 このセクションは動的リンク情報を保持する。 このセクションの属性は \fBSHF_ALLOC\fP ビットを含む。 \fBSHF_WRITE\fP
899 ビットが設定されるか否かはプロセッサによる。 このセクションのタイプは \fBSHT_DYNAMIC\fP である。 上記の属性を参照すること。
902 このセクションは動的リンクに必要な文字列を保持する。 最も一般的には、この文字列はシンボルテーブルエントリと 関連づけられた名前を表す。
903 このセクションのタイプは \fBSHT_STRTAB\fP である。 使用される属性タイプは \fBSHF_ALLOC\fP である。
906 このセクションは動的リンクシンボルテーブルを保持する。 このセクションのタイプは \fBSHT_DYNSYM\fP である。 使用される属性タイプは
910 このセクションはプロセス終了コードに置かれる実行可能命令を保持する。 プロセスが正常に終了した場合、システムはこのセクションにある
911 コードを配置して実行する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。 使用される属性タイプは \fBSHF_ALLOC\fP と
912 \fBSHF_EXECINSTR\fP である。
915 このセクションはバージョン・シンボル・テーブルを保持する。 その内容は \fIElfN_Half\fP 要素の配列である。 このセクションのタイプは
916 \fBSHT_GNU_versym\fP である。 使用される属性タイプは \fBSHF_ALLOC\fP である。
918 \&\fI.gnu.version_d\fP
919 このセクションはバージョンシンボルの定義を保持する。 その内容は \fIElfN_Verdef\fP 構造体のテーブルである。 このセクションのタイプは
920 \fBSHT_GNU_verdef\fP である。 使用される属性タイプは \fBSHF_ALLOC\fP である。
922 \&\fI.gnu.version_r\fP
923 このセクションはバージョンシンボルが必要とする要素を保持する。 その内容は \fIElfN_Verneed\fP 構造体のテーブルである。
924 このセクションのタイプは \fBSHT_GNU_versym\fP である。 使用される属性タイプは \fBshf_alloc\fP である。
927 このセクションはグローバルオフセットテーブルを保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
931 このセクションはシンボルハッシュテーブルを保持する。 セクションのタイプは \fBSHT_HASH\fP である。 使用される属性は \fBSHF_ALLOC\fP
935 このセクションはプロセス初期化コードに配置される実行可能命令を保持する。 プログラムが実行を開始すると、
936 システムはメインプログラムエントリポイントを呼び出す前に、 このセクションにあるコードを配置して実行する。 このセクションはのタイプは
937 \fBSHT_PROGBITS\fP である。 使用される属性は \fBSHF_ALLOC\fP と \fBSHF_EXECINSTR\fP である。
940 このセクションはプログラムインタプリタのパス名を保持する。 ファイルにこのセクションを含むロード可能セグメントがある場合、 そのセクションの属性には
941 \fBSHF_ALLOC\fP ビットが含まれる。 それ以外の場合このビットはオフになる。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
944 このセクションはシンボリックデバッグのための行番号情報を保持する。 ここにはプログラムソースコードとマシンコードの対応関係が記述される。
945 内容は指定されていない。 このセクションのタイプは \fBSHT_PROGBITS\fP である。 属性タイプは使用されない。
948 このセクションは "Note Section" 形式で情報を保持する。このセクションのタイプ
949 は \fBSHT_NOTE\fP である。属性タイプは使用されない。通常 OpenBSD ネイティブ実行
950 可能ファイルは自身を識別するために \fI.note.openbsd.ident\fP セクションを持つ。
951 これによりカーネルは、ファイルをロードする際に 互換 ELF バイナリエミュレーショ
954 \&\fI.note.GNU\-stack\fP
955 このセクションは Linux のオブジェクトファイルで スタック属性を宣言するのに使用される。 セクションのタイプは \fBSHT_PROGBITS\fP
956 である。使用される属性は \fBSHF_EXECINSTR\fP だけである。この属性は GNU リンカに対して オブジェクトファイルが実行可能なスタック
957 (executable stack) を必要とする 示すものである。
960 このセクションは手続き (procedure) リンクテーブルを保持する。 このセクションのタイプは \fBSHT_PROGBITS\fP である。
964 このセクションは以下に記述される再配置情報を保持する。 ファイルが再配置を含むロード可能セグメントを持っている場合、 このセクションの属性は
965 \fBSHF_ALLOC\fP ビットを含む。 それ以外の場合、そのビットはオフである。 慣例として、 "NAME"
966 は再配置が適用されるセクションが指定される。 よって \fB.text\fP についての再配置セクションは、通常は \fB.rel.text\fP
967 という名前を持つ。 このセクションのタイプは \fBSHT_REL\fP である。
970 このセクションは以下に記述される再配置情報を保持する。 ファイルが再配置を含むロード可能セグメントを持っている場合、 このセクションの属性は
971 \fBSHF_ALLOC\fP ビットを含む。 それ以外の場合、そのビットはオフである。 慣例として、 "NAME"
972 は再配置が適用されるセクションが指定される。 よって \fB.text\fP についての再配置セクションは、通常は \fB.rela.text\fP
973 という名前を持つ。 このセクションのタイプは \fBSHT_RELA\fP である。
976 このセクションはリードオンリーのデータを保持する。 このデータはプロセスイメージにおける書き込み不可能なセグメントに置かれる。 このセクションのタイプは
977 \fBSHT_PROGBITS\fP である。 使用される属性は \fBSHF_ALLOC\fP である。
980 このセクションはリードオンリーのデータを保持する。 このデータはプロセスイメージにおける書き込み不可能なセグメントに置かれる。 このセクションのタイプは
981 \fBSHT_PROGBITS\fP である。 使用される属性は \fBSHF_ALLOC\fP である。
984 このセクションはセクション名を保持する。 このセクションのタイプは \fBSHT_STRTAB\fP である。 属性タイプは使用されない。
987 このセクションは文字列を保持する。 最も一般的なのは、シンボルテーブルエントリに関連づけられた 名前を表す文字列である。
988 ファイルがシンボル文字列テーブルを含むロード可能セグメントを持つ場合、 セクションの属性は \fBSHF_ALLOC\fP ビットを含む。
989 それ以外の場合、そのビットはオフである。 このセクションのタイプは \fBSHT_STRTAB\fP である。
992 このセクションはシンボルテーブルを保持する。 ファイルがシンボルテーブルを含むロード可能セグメントを持つ場合、 セクションの属性は
993 \fBSHF_ALLOC\fP ビットを含む。 それ以外の場合、ビットはオフである。 このセクションのタイプは \fBSHT_SYMTAB\fP である。
997 このセクションはプログラムの "テキスト" または実行可能命令を保持する。 セクションのタイプは \fBSHT_PROGBITS\fP である。
998 使用される属性は \fBSHF_ALLOC\fP と \fBSHF_EXECINSTR\fP である。
1000 文字列テーブルセクションは NULL 文字で終端されたキャラクタ配列 (通常文字列と呼ばれるもの) を保持する。 オブジェクトファイルはこれらの文字列を
1001 シンボル名とセクション名を表すために使う。 文字列は、文字列テーブルセクションへのインデックスとして参照される。 インデックス 0
1002 の最初のバイトは、NULL バイト (\(aq\e0\(aq) を 保持すると定義されている。 同様に文字列テーブルの最後のバイトも NULL
1003 文字を保持すると定義されている。 これは全ての文字列が NULL バイトで終端されていることを保証するためである。
1005 オブジェクトファイルのシンボルテーブルは、 プログラムのシンボル定義と参照を配置または再配置するのに 必要な情報を保持する。
1011 Elf32_Addr st_value;
1013 unsigned char st_info;
1014 unsigned char st_other;
1024 unsigned char st_info;
1025 unsigned char st_other;
1027 Elf64_Addr st_value;
1033 .\" .Bl -tag -width "st_value"
1034 32 ビット版と 64 ビット版は同じメンバを持ち、単に順番が異なるだけである。
1037 このメンバはオブジェクトファイルのシンボル文字列テーブルの インデックスを保持する。 シンボル文字列テーブルはシンボル名の文字表現を保持する。 この値が
1038 0 でない場合、シンボル名を得るための文字テーブルインデックスを表す。 それ以外の場合、シンボルテーブルは名前を持たない。
1041 このメンバは関連づけられたシンボルの値を表す。
1044 多くのシンボルにはそれに関連づけられたサイズがある。 シンボルがサイズを持たない場合、またはサイズが不明な場合、 このメンバは 0 である。
1047 .\" .Bl -tag -width "STT_SECTION"
1048 このメンバはシンボルのタイプとバインディング (binding) 属性を指定する:
1055 シンボルはデータオブジェクトに関連づけられている。
1058 シンボルは関数またはその他の実行コードに関連づけられている。
1061 シンボルはセクションに関連づけられている。 このタイプのシンボルテーブルエントリは、 主として再配置のために存在し、通常は \fBSTB_LOCAL\fP
1065 慣例として、シンボルの名前は オブジェクトファイルに関連づけられたソースファイルの名前を指定する。 ファイルシンボルは \fBSTB_LOCAL\fP
1066 バインディングを持ち、そのセクションインデックスは \fBSHN_ABS\fP である。 ファイルシンボルは、ファイルに他の \fBSTB_LOCAL\fP
1067 シンボルがある場合は、それよりも先に来る。
1070 この値以上で \fBSTT_HIPROC\fP 以下の範囲はプロセッサ固有の意味に予約されている。
1074 .\" .Bl -tag -width "STB_GLOBAL"
1075 この値以下で \fBSTT_LOPROC\fP 以上の範囲はプロセッサ固有の意味に予約されている。
1078 局所的シンボルはその定義を含むオブジェクトファイルの外からは見えない。 同じ名前の局所的シンボルは、お互いに影響を受けることなく、
1082 大域的シンボルは結びつけられている全てのオブジェクトファイルから見える。 1 つのファイルで大域的シンボルが定義されていたら、
1083 他のファイルでは同じシンボルへの参照は未定義でなければならない。
1086 弱シンボルは大域的シンボルに似ているが、その定義は優先度が低い。
1089 この値以上で \fBSTB_HIPROC\fP 以下の範囲はプロセッサ固有の意味に予約されている。
1092 この値以下で \fBSTB_LOPROC\fP 以上の範囲はプロセッサ固有の意味に予約されている。
1094 バインディングとタイプフィールドを パックしたりアンパックしたりするマクロがある:
1096 \fBELF32_ST_BIND\fP(info) または \fBELF64_ST_BIND\fP(info) \fIst_info\fP
1099 \fBELF32_ST_TYPE\fP(info) または \fBELF64_ST_TYPE\fP(info)
1101 \fIst_info\fP の値からタイプを取り出す。
1103 \fBELF32_ST_INFO\fP(bind, type) または \fBELF64_ST_INFO\fP(bind, type)
1105 バインディングとタイプを \fIst_info\fP の値に変換する。
1110 .\" .Bl -tag -width "STV_PROTECTED"
1111 このメンバはシンボルの visibility (見える範囲) を規定する。
1116 デフォルトのシンボル visibility ルール。
1122 シンボルは他のモジュールからは利用できない。
1125 横取りできず (not preemptible)、公開されない。
1128 visibility 種別を抽出するためのマクロがある。
1130 \fBELF32_ST_VISIBILITY\fP(other) または \fBELF64_ST_VISIBILITY\fP(other)
1136 各シンボルテーブルエントリは、いくつかのセクションに関連して "定義されている"。 このメンバは関連するセクションヘッダテーブルインデックスを保持する。
1138 再配置はシンボル参照とシンボル定義を結合するプロセスである。 再配置可能ファイルはセクションの内容をどのように修正するかに関する
1139 情報を持たなければならない。 これにより、実行可能ファイルと共有オブジェクトファイルは
1140 プロセスのプログラムイメージについての正しい情報を持つことができる。 再配置エントリは以下のようなデータである。
1147 Elf32_Addr r_offset;
1156 Elf64_Addr r_offset;
1167 Elf32_Addr r_offset;
1177 Elf64_Addr r_offset;
1183 .\" .Bl -tag -width "r_offset"
1186 このメンバは再配置動作が適用される位置を与える。 再配置可能ファイルの場合、この値はセクションの先頭から 再配置で影響を受ける格納単位 (storage
1187 unit) までのバイトオフセットである。 実行可能ファイルまたは共有オブジェクトの場合、 この値は再配置で影響を受ける格納単位の仮想アドレスである。
1190 このメンバは、再配置が行われなければならないシンボルテーブルインデックスと、 適用される再配置のタイプの両方を与える。
1191 再配置タイプはプロセッサ毎に異なる。 テキストが再配置エントリの再配置タイプ またはシンボルテーブルインデックスを参照している場合、 それぞれエントリの
1192 \fIr_info\fP メンバに対して、それぞれ \fBELF[32|64]_R_TYPE\fP と \fBELF[32|64]_R_SYM\fP
1197 このメンバは定数の加数を指定する。 この加数は再配置可能フィールドに格納される値を計算するために使われる。
1199 \&.dynamic セクションは、関連する動的リンク情報を保持している 一連の構造体を保持する。 d_tag メンバは d_un の解釈を制御する。
1210 extern Elf32_Dyn _DYNAMIC[];
1223 extern Elf64_Dyn _DYNAMIC[];
1226 .\" .Bl -tag -width "d_tag"
1229 .\" .Bl -tag -width "DT_SYMBOLIC"
1230 このメンバは以下の値を持つことができる:
1237 必要なライブラリの名前への文字列テーブルオフセット
1240 PLT 再配置 (reloc) テーブルのサイズ (バイト単位)
1243 PLT と GOT (または何れか一方) のアドレス
1258 Rela テーブルのサイズ (バイト単位)
1261 Rela テーブルエントリのサイズ (バイト単位)
1267 シンボルテーブルエントリのサイズ (バイト単位)
1276 共有オブジェクトの名前への文字列テーブルオフセット
1279 ライブラリ検索パスへの文字列テーブルオフセット (推奨されない)
1282 リンカがシンボルの実行可能ファイルより前に この共有オブジェクトを検索した場合は、警告を出す。
1288 Rel テーブルのサイズ (バイト単位)
1291 Rel テーブルエントリのサイズ (バイト単位)
1294 PLT が参照する再配置テーブルのタイプ (Rela または Rel)
1297 デバッグのために使用されている。内容は定義されていない。
1300 これが指定されていない場合、 書き込み不可のセグメントには再配置は適用されない。
1306 実行可能ファイルに制御を譲る前に、 全ての再配置を処理するように動的リンカに指示する。
1309 ライブラリ検索パスへの文字列テーブルオフセット
1320 このメンバは様々な意味に解釈される整数値である。
1323 このメンバはプログラムの仮想アドレスを表す。 これらのアドレスを解釈する際に、 実際のアドレスは元々のファイルの値と
1324 メモリの基底アドレスから計算される。 ファイルにはこれらのアドレスを修正するための 再配置エントリを含めてはならない。
1328 \&.dynamic セクションにある全ての動的構造体を含む配列。 これは自動的にリンカに渡される。
1331 .\" ELF support first appeared in
1333 .\" although not all supported platforms use it as the native
1334 .\" binary file format.
1335 ELF は System V で初めて登場した。 ELF 自体は System V で初めて登場した。 ELF フォーマットは採択された標準である。
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
1345 \fIe_phnum\fP, \fIe_shnum\fP, \fIe_strndx\fP に対する拡張は、いずれも Linux での拡張で
1346 ある。Sun, BSD, AMD64 もこれに対応している。詳しい情報は、関連項目を参照。
1348 \fBas\fP(1), \fBgdb\fP(1), \fBld\fP(1), \fBobjdump\fP(1), \fBexecve\fP(2), \fBcore\fP(5)
1350 Hewlett\-Packard, \fIElf\-64 Object File Format\fP.
1352 Santa Cruz Operation, \fISystem V Application Binary Interface\fP.
1354 UNIX System Laboratories, "Object Files", \fIExecutable and Linking Format
1357 Sun Microsystems, \fILinker and Libraries Guide\fP.
1359 AMD64 ABI Draft, \fISystem V Application Binary Interface AMD64 Architecture
1360 Processor Supplement\fP.
1363 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.51 の一部
1364 である。プロジェクトの説明とバグ報告に関する情報は
1365 http://www.kernel.org/doc/man\-pages/ に書かれている。