名称

ldgetname − オブジェクトファイルのシンボルテーブルエントリに対する シンボル名を検索する

形式

#include <stdio.h>
#include <filehdr.h>
#include <sym.h>
#include <ldfcn.h>

char ∗ldgetname (ldptr, symbol)
LDFILE ∗ ldptr ;
pSYMR symbol ;

解説

ldgetname は、文字列として symbol と対応付けられている名前を指すポインタを 返します。 その文字列は静的バッファに含まれます。 バッファはそれ以降の ldgetname への呼び出しで上書きされてしまうので、 名前をセーブする場合は、呼び出し側はそのバッファをコピーしなければ なりません。

名前が検索できない場合は、ldgetname はオブジェクトファイル に対して NULL （<stdio.h> で定義されます）を返します。 このことは、以下の場合に生じます。

•文字列テーブルが見つからない場合

•文字列テーブルへの名前のオフセットが、 文字列テーブルの終わりを超えてしまった場合

通常、ldgetname は ldtbread への呼び出しが成功した後すぐに 呼び出されます。 ldgetname は、ldtbread により満たされたシンボルテーブル エントリと対応付けられた名前を検索します。

プログラムはオブジェクトファイルのアクセスルーチン ライブラリ libmld.a とともにロードされなければなりません。

関連事項

ldclose(3X), ldopen(3X), ldtbseek(3X), ldtbread(3X), ldfcn(3X)

NEWS-OSRelease 4.2.1R