名称

elf_strptr — 文字列テーブルで文字列ポイタを検索する

ライブラリ

ELF Access Library (libelf, -lelf)

書式

#include < libelf.h>

char *
elf_strptr( Elf *elf, size_t scndx, size_t stroffset);

解説

関数 elf_strptr() によって、アプリケーションは、セクションの内容をカバーする複数の Elf_Data 記述子が存在するオフセットを正しく変換して、文字列テーブルオフセットを文字列ポインタに変換することができます。

引数 elf は、ELF オブジェクトの記述子です。引数 scndx は、ELF 文字列テーブルのセクションインデックスです。引数 stroffset は、文字列テーブルの必要な文字列のインデックスです。

戻り値

関数 elf_strptr() は、成功すれば有効なポインタを返し、エラーに遭遇する場合 NULL を返します。

エラー

[ ELF_E_ARGUMENT]

引数 elf が NULL でした。

[ ELF_E_ARGUMENT]

引数 elf が ELF オブジェクトのための記述子ではありませんでした。

[ ELF_E_ARGUMENT]

引数 scndx が、文字列テーブルのためのセクションインデックスではありませんでした。

[ ELF_E_ARGUMENT]

引数 stroffset が、文字列テーブルのサイズを超えました。

[ ELF_E_ARGUMENT]

引数 stroffset が、文字列テーブルの割り付け解放された領域にインデックス付けしています。

[ ELF_E_DATA]

オフセット stroffset が、任意の Elf_Data 記述子によってカバーされかった領域にインデックス付けしました。

[ ELF_E_DATA]

誤った Elf_Data 記述子が、引数 scndx によって指定されたセクションの一部でした。

[ ELF_E_HEADER]

ELF 記述子 elf が、無効のセクションヘッダを含んでいました。

[ ELF_E_RESOURCE]

メモリ不足状態が検出されました。

[ ELF_E_SECTION]

セクション scndx が、不正な形式のセクションヘッダを含んでいました。

[ ELF_E_SECTION]

引数 elf の ELF 記述子が、拡張された番号付けのために使用される規約を順守しませんでした。

関連項目

elf(3), elf32_getshdr(3), elf64_getshdr(3), elf_getdata(3), elf_rawdata(3), gelf(3), gelf_getshdr(3)