elf_end(3E)                                                     elf_end(3E)

NAME
     elfend - Benutzung einer Objektdatei beenden

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

     #include <libelf.h>

     int elfend(Elf *elf);

BESCHREIBUNG
     Ein Programm verwendet elfend(), um den ELF-Deskriptor elf und die
     mit ihm verknüpften Daten freizugeben. Solange das Programm einen
     Deskriptor noch nicht freigegeben hat, bleiben die mit dem Deskriptor
     verknüpften Daten allokiert. elf sollte ein Wert sein, der zuvor durch
     elfbegin() zurückgegeben wurde; ein Nullzeiger ist zur Erleichterung
     der Fehlerbehandlung als Argument erlaubt. Sollen durch ein Programm
     Daten, die mit dem ELF-Deskriptor verknüpft sind, in die Datei
     geschrieben werden, muß elfupdate() vor dem Aufruf elfend() verwen-
     det werden.

     Wie unter elfbegin(3E) schon angeführt wurde, kann ein Deskriptor
     mehr als eine Aktivierung besitzen. Der Aufruf von elfend() entfernt
     eine Aktivierung und liefert den resultierenden Wert des Aktivierungs-
     zählers zurück. Die Bibliothek gibt einen Deskriptor erst frei, wenn
     der Aktivierungszähler gleich Null wird. Ein Rückgabewert von Null
     zeigt daher an, daß ein ELF-Deskriptor nicht länger gültig ist.

SIEHE AUCH
     elf(3E), elfbegin(3E), elfupdate(3E).

























Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98