Subroutine socks5tcp_bind

Zweck

Stellen Sie eine Verbindung zu einem SOCKSv5 -Server her und fordern Sie ein empfangsbereites Socket für eingehende ferne Verbindungen an.

Bibliothek

Standard-C-Bibliothek (libc.a)

Syntax

#include <stdlib.h>
#include <netinet/in.h>
#include <sys/socket.h>

int socks5tcp_bind(Socket, Dst, DstLen, Svr, SvrLen)
Int Socket;
struct sockaddr *Dst;
size_t DstLen;
struct sockaddr *Svr;
size_t SrvLen;

Beschreibung

Die Subroutine socks5tcp_bind fordert als Vorbereitung für eine eingehende Verbindung von einem fernen Ziel ein empfangsbereites Socket auf dem in Svrangegebenen SOCKSv5 -Server an. angegeben durch Dst. Bei Erfolg wird Svr mit der tatsächlichen Adresse des neu gebundenen empfangsbereiten Sockets überschrieben und Socket kann in einem nachfolgenden Aufruf von socks5tcp_acceptverwendet werden.

Socket muss ein offener Socketdeskriptor des Typs SOCK_STREAM sein.

Die Socketanwendungen können mit COMPAT_43 kompiliert werden. Dadurch wird die sockaddr -Struktur BSD 4.3 kompatibel. Weitere Informationen finden Sie unter socket.h.

Parameter

Rückgabewerte

Nach erfolgreicher Beendigung gibt die Subroutine socks5tcp_bind den Wert 0 zurück und ändert Svr , um die tatsächliche Adresse des neu gebundenen Listener-Sockets wiederzugeben.

Wenn die Subroutine socks5tcp_bind nicht erfolgreich ist, führt der Systemhandler die folgenden Funktionen aus:

• Gibt einen Wert von -1 an das aufrufende Programm zurück.
• Verschiebt einen Fehlercode, der den generischen Systemfehler angibt, in die globale Variable errno .
• Verschiebt einen Fehlercode, der den Fehler SOCKSv5 angibt, in die globale Variable socks5_errno .

Fehlercodes (in errno; übernommen von dem zugrunde liegenden Aufruf von connect ())

Die Subroutine socks5tcp_bindaccept ist nicht erfolgreich, wenn einer der folgenden Fehler auftritt:

Fehlercodes (in socks5_errno; SOCKSv5-specific Fehler)

Die Subroutine socks5tcp_connect ist nicht erfolgreich, wenn einer der folgenden Fehler auftritt:

Beispiele

Das folgende Programmfragment veranschaulicht die Verwendung der Subroutine socks5tcp_bind durch einen Client zum Anfordern eines empfangsbereiten Sockets von einem Server.

struct sockaddr_in svr;
struct sockaddr_in dst;
.
.
.
socks5tcp_bind(s, (struct sockaddr *)&dst, sizeof(dst), (structsockaddr *)&svr, sizeof(svr));