名称

nlist − ネームリストからのエントリの取り出し

形式

#include <nlist.h>

nlist(filename, nl)
char ∗filename;
struct nlist nl[];

解説

nlist は、 与えられた実行可能な出力ファイルにあるネームリストを 検索し、 値リストを 選択して取り出します。 ネームリストは、 名前、 型、 および値からなる構造体の配列で構成されています。 また、 このリストは、 ナル名で終了します。 各名前がファイルのネームリストにあるかどうかが調べられ、 名前が検索された場合、 その型と値が、 次の 2つのフィールドに挿入されます。 名前がない場合、 この 2つのエントリには、 0 がセットされます。 構造体の宣言に関しては、 a.out(5) を 参照してください。

このサブルーチンは、 /vmunix に保持されるシステム名リストを 検索することに使われます。 この方法で、 プログラムは最新のシステムアドレスを 獲得できます。

関連事項

a.out(5)

診断

ファイルが検索できない場合、 または有効なネームリストがない場合、 −1 が返されます。 それ以外は、 見つからなかったネームリストのエントリ数が返されます。

シンボルが検索されなかった場合、 型のエントリには、 0 がセットされます。

NEWS-OSRelease 3.3