connect

Deklaration

#include <sys/socket.h>

int connect(int sockfd, const struct sockaddr *addr, socklen_t addrlen);

Beschreibung

Mit connect() wird ein Socket verbunden, d.h. sein entfernter Endpunkt festgelegt. Für TCP-Sockets bedeutet das, dass der 3-Wege-Handshake ausgeführt wird, was eine Zeit lang dauern kann. Bei UDP-Sockets wird nur die Zieladresse festgelegt, sodass danach send() anstelle von sendto() benutzt werden kann.

Parameter

sockfd	Socket der verbunden werden soll.
addr	Zieladresse mit der verbunden werden soll. Dies ist für Sockets der Familie AF_INET eine Struktur vom Typ sockaddr_in, die jedoch auf sockaddr gecastet werden muss.
addrlen	Grösse der übergebenen Struktur, also z.B. sizeof(struct sockaddr_in) bzw. der verwendeten Variable.

Rückgabewert

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

Typische Fehler

Die Größe der übergebenen Struktur muss passen, sonst lehnt das System den Aufruf ab. Hier muss sockaddr_in benutzt werden, nicht etwa in_addr.
Die Portnummer muss in Network Byte Order angegeben werden.

Zurück