| ELF_GETPHDRNUM(3) |
FreeBSD Library Functions Manual |
ELF_GETPHDRNUM(3) |
名称
elf_getphdrnum —
ELF ファイルのプログラムヘッダの数を返します
ライブラリ
ELF Access Library (libelf, -lelf)
書式
#include < libelf.h>
int
elf_getphdrnum( Elf *elf, size_t *phnum);
解説
関数
elf_getphdrnum() は、記述子
elf に関連している ELF プログラムヘッダの数を検索し、引数
phnum によって指された位置にそれを格納します。
このルーチンによって、アプリケーションは、通常の ELF オブジェクトと拡張されたセクション番号を使用する ELF オブジェクトの両方を一様に処理することができます。
戻り値
関数
elf_getphdrnum() は、成功すれば、0 の値を返し、エラーの場合は、-1 を返します。
エラー
関数
elf_getphnum() は、次のエラーで失敗するかもしれません:
-
[
ELF_E_ARGUMENT]
-
NULL の値が、引数
elf のために渡されました。
-
[
ELF_E_ARGUMENT]
-
引数
elf が、ELF ファイルではありませんでした。
-
[
ELF_E_ARGUMENT]
-
引数
elf が、ELF 実行形式ヘッダを欠いています。
-
[
ELF_E_HEADER]
-
引数
elf に関連づけられた ELF 実行形式ヘッダが不正でした。
-
[
ELF_E_SECTION]
-
インデックス
SHN_UNDEF のセクションヘッダが不正でした。