GELF_GETSYMINFO(3) | FreeBSD Library Functions Manual | GELF_GETSYMINFO(3) |
名称
gelf_getsyminfo, gelf_update_syminfo — シンボル情報を読み込んで、更新するライブラリ
ELF Access Library (libelf, -lelf)書式
#include < gelf.h> GElf_Syminfo *
gelf_getsyminfo( Elf_Data *data, int ndx, GElf_Syminfo *syminfo);
int
gelf_update_syminfo( Elf_Data *data, int ndx, GElf_Syminfo *syminfo);
解説
これらの便利な関数は、ELF オブジェクトのクラス依存の Elf32_Syminfo と Elf64_Syminfo レコードを検索して更新するために使用されます。引数 data は、タイプ SHT_SUNW_syminfo のセクションに関連している Elf_Data 記述子です。引数 ndx は、検索されるか、または更新されるレコードのインデックスです。クラス独立の GElf_Syminfo 構造体は、 gelf(3) に説明されています。
関数 gelf_getsyminfo() は、データバッファ data のインデックス ndx でクラス依存のレコードを検索して、クラス独立の形式に変換した後、引数 syminfo によって指された送り先に、それをコピーします。
関数 gelf_update_syminfo() は、引数 syminfo によって指されるクラス依存のレコードをクラス独立の形式に変換して、引数 data によって記述されたデータバッファのインデックス ndx のレコードにそれを書き込みます。
戻り値
関数 gelf_getsyminfo() は、成功するなら、引数 syminfo の値を返し、エラーの場合は NULL を返します。関数 gelf_update_syminfo() は、成功すれば、0 以外の値を返し、エラーの場合は 0 を返します。エラー
これらの関数は、次のエラーで失敗するかもしれません:- [ ELF_E_ARGUMENT]
- 引数 data または syminfo が NULL でした。
- [ ELF_E_ARGUMENT]
- 引数 ndx が、0 より小さいか、またはデータ記述子のシンボルの数より大きい。
- [ ELF_E_ARGUMENT]
- データ記述子 data が、シンボル情報を含んでいるセクションに関連付けられていませんでした。
August 29, 2006 | FreeBSD |