t_free(3N) t_free(3N)
NAME
tfree - Bibliotheksstruktur freigeben
SYNTAX
#include <sys/tiuser.h>
int tfree(char *ptr, int structtype);
BESCHREIBUNG
Die Funktion tfree gibt allen durch talloc zuvor angelegten Spei-
cherplatz wieder frei. Die Funktion gibt den Speicherplatz der angege-
benen Struktur frei, und ebenso den Speicherplatz für Puffer, auf die
in der Struktur verwiesen wird.
ptr zeigt auf einen der sechs Strukturtypen, die für talloc beschrie-
ben sind. structtype gibt den Typ der Struktur an und kann einen der
folgende Werte annehmen:
TBIND struct tbind
TCALL struct tcall
TOPTMGMT struct toptmgmt
TDIS struct tdiscon
TUNITDATA struct tunitdata
TUDERROR struct tuderr
TINFO struct tinfo
Jede dieser Strukturen kann als Argument für eine oder mehrere Trans-
portfunktionen dienen.
tfree überprüft die Felder addr, opt und udata der gegebenen Struktur
und gibt die Puffer frei, auf die durch das buf-Feld der Struktur
netbuf verwiesen wird. Wenn buf NULL ist, versucht tfree nicht, Spei-
cher freizugeben. Nachdem alle Puffer freigegeben wurden, gibt tfree
den Speicher der Struktur frei, auf die durch ptr verwiesen wird.
Wenn ptr oder irgendeiner der Zeiger buf auf einen Speicherbereich
zeigt, der nicht durch talloc zuvor angelegt wurde, entstehen undefi-
nierte Ergebnisse.
Im Fehlerfall wird terrno auf den folgenden Wert gesetzt:
TSYSERR Während der Ausführung der Funktion ist ein Systemfeh-
ler aufgetreten.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
t_free(3N) t_free(3N)
DIAGNOSE
tfree liefert im Erfolgsfall 0 zurück. Im Fehlerfall wird -1 zurück-
gegeben und terrno gesetzt, um den Fehler anzuzeigen.
SIEHE AUCH
talloc(3N).
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98