nlist(3E)                                                         nlist(3E)

NAME
     nlist - Einträge einer Namensliste lesen

SYNTAX
     cc [option ...] datei ... -lelf [bibliothek ...]

     #include <nlist.h>

     int nlist(const char *filename, struct nlist *nl);

BESCHREIBUNG
     nlist() untersucht die Namensliste der ausführbaren Datei mit dem
     Namen filename und extrahiert eine Liste von Werten in einem Feld von
     nlist-Strukturen bei nl. Die Namensliste nl setzt sich aus einem Feld
     von Strukturen zusammen, bestehend aus den Namen von Variablen, Typen
     und Werten. Die Liste wird durch einen leeren Namen beendet, d. h.
     durch eine Struktur, die als Namenskomponente eine Nullzeichenkette
     enthält. Jeder Name einer Variablen wird in der Namensliste der Datei
     gesucht. Wird der Name gefunden, so werden Typ, Wert, Speicherklasse
     und Abschnittsnummer des Namens in den anderen Komponenten eingetra-
     gen. Die Typ-Komponente kann auf 0 gesetzt werden, wenn bei der Über-
     setzung der Datei die Option -g von cc(1) nicht verwendet wurde.
     nlist() liefert immer die Informationen für ein externes Symbol zu
     einem Namen, wenn der Name in der Datei vorkommt. Existiert kein
     externes Symbol mit dem angegebenen Namen, und gibt es in der Datei
     mehr als ein (lokales) Symbol mit dem angegebenen Namen (wie zum Bei-
     spiel bei Symbolen, die in verschiedenen Dateien static definiert wur-
     den), beziehen sich die zurückgegebenen Werte auf das letzte Auftreten
     des Namens in der Datei. Wenn der Name nicht gefunden wird, werden
     alle Komponenten der Struktur mit Ausnahme von nname auf 0 gesetzt.

     Diese Funktion ist beim Zugriff auf die System-Namenstabelle in der
     Datei /stand/unix nützlich. Auf diese Weise können Programme die aktu-
     ellen Werte wichtiger Systemadressen erfahren.

ERGEBNIS
     Alle Komponenten werden auf den Wert 0 gesetzt, wenn die Datei nicht
     gelesen werden kann oder sie keine gültige Namensliste enthält.

     nlist() liefert bei Erfolg den Wert 0, bei Auftreten eines Fehlers den
     Wert -1.

SIEHE AUCH
     a.out(4).











Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98