shutdown

Deklaration

#include <sys/socket.h>

int shutdown(int sockfd, int how);

Beschreibung

Mit shutdown() wird angekündigt, dass eine Verbindung nicht mehr zum Schreiben in eine bestimmte Richtung benutzt werden soll. Wird shutdown() in Leserichtung ausgesprochen, so können bereits gepufferte Daten noch gelesen werden, danach schlagen jedoch weitere Aufrufe von recv() fehl. Wird shutdown() in Schreibrichtung ausgesprochen wird dem Empfänger das Beenden der Verbindung signalisiert und folgende Aufrufe von send() schlagen fehl.

Weitere wichtige Hinweise:

Nur close() gibt tatsächlich die mit dem Socket verbundenen Ressourcen frei.
In Multi-Prozess-Umgebungen muss beachtet werden, dass shutdown() auf alle Benutzer der Verbindung wirkt, während close() nur den Socket des aufrufenden Prozesses freigibt.

Parameter

sockfd	Socket dessen Verbindung beendet werden soll.
how	Richtung die geschlossen werden soll, SHUT_RD, SHUT_WR oder SHUT_RDWR.

Rückgabewert

Bei erfolgreichem Aufruf ist der Rückgabewert 0, im Fehlerfall -1.

Typische Fehler

Wechselwirkung mit der gleichen Verbindung in andere Prozessen.
Ressourcenlecks wegen fehlender close()-Aufrufe.

Zurück