名称

nlist − 名前リストからエントリを得る

形式

#include <nlist.h>

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

cc ... −lmld

解説

注意: nlist サブルーチンは、オブジェクトファイルフォーマットにおける違いにより、 標準の C ライブラリから “mld” ライブラリへ移動されました。 nlist を使用する必要のあるプログラムは、 −lmld オプションを付けてリンクしなければなりません。

nlist は与えられた実行可能な出力ファイル中の名前リストを検査し、 選択的に値のリストを抽出します。 名前リストは、名前、型および値を含んだ構造体の配列からなります。 リストはナルで終了します。 各名前は、ファイルの名前リストで調べられます。 名前が見つかった場合は、その名前の型と値が次の 2 つのフィールドに挿入されます。 名前が見つからない場合は、両方のエントリは 0 に設定されます。 構造体の宣言については、 /usr/include/nlist.h を参照してください。

このサブルーチンは、ファイル /vmunix に保持されているシステム名リストを調べるのに役立ちます。 このように、プログラムは最新のシステムアドレスを得ることができます。

関連事項

a.out(5)

診断

ファイルが見つからないか、それが有効な名前リストでない場合は、−1 が 返されます。 そうでない場合は、見つからない名前リストエントリの数が返されます。

型エントリは、シンボルが見つからない場合 0 に設定されます。

NEWS-OSRelease 4.2.1R