名称

elf_getshstrndx, elf_setshstrndx — セクション名の文字列テーブルのインデックスを検索する/更新する

ライブラリ

ELF Access Library (libelf, -lelf)

書式

#include < libelf.h>

int
elf_getshstrndx( Elf *elf, size_t *ndxptr);

int
elf_setshstrndx( Elf *elf, size_t ndx);

解説

関数 elf_getshstrndx() は、記述子 elf でセクション名を含む文字列テーブルのセクションインデックスを検索して、引数 ndxptr によって指された位置にそれを格納します。関数 elf_getshstrndx() は、推奨されません。 elf_getshdrstrndx(3) を代わりに使用してください。

関数 elf_setshstrndx() は、引数 ndx にセクション名文字列テーブルのインデックスを設定します。

このルーチンによって、アプリケーションは、通常の ELF オブジェクトと拡張セクション番号付けを使用する ELF オブジェクトの両方を一様に処理します。

戻り値

これらの関数は、成功すれば 0 以外を返し、エラーの場合は 0 を返します。

エラー

これらの関数は、次のエラーで失敗します:

[ ELF_E_ARGUMENT]

引数 elf に、NULL 値が渡されました。

[ ELF_E_ARGUMENT]

引数 elf は、ELF ファイル用ではありません。

[ ELF_E_ARGUMENT]

引数 elf には、ELF 実行形式のヘッダが足りません。

[ ELF_E_ARGUMENT]

引数 ndx は、予約されたセクションインデックスの範囲の値を含んでいます。

関連項目

elf(3), elf32_getehdr(3), elf64_getehdr(3), elf_getident(3), elf_getphdrnum(3), elf_getshdrnum(3), gelf(3), gelf_getehdr(3)