.\" -*- coding: UTF-8 -*- .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" Portions extracted from /usr/include/sys/socket.h, which does not have .\" any authorship information in it. It is probably available under the GPL. .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" .\" Other portions are from the 6.9 (Berkeley) 3/10/91 man page: .\" .\" Copyright (c) 1983 The Regents of the University of California. .\" All rights reserved. .\" .\" SPDX-License-Identifier: BSD-4-Clause-UC .\" .\" Modified 1997-01-31 by Eric S. Raymond .\" Modified 1998, 1999 by Andi Kleen .\" Modified 2004-06-23 by Michael Kerrisk .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH connect 2 "30. März 2023" "Linux man\-pages 6.05.01" .SH BEZEICHNUNG connect \- eine Verbindung mit einem Socket starten .SH BIBLIOTHEK Standard\-C\-Bibliothek (\fIlibc\fP, \fI\-lc\fP) .SH ÜBERSICHT .nf \fB#include \fP .PP \fBint connect(int \fP\fISockdd\fP\fB, const struct sockaddr *\fP\fIAdr\fP\fB,\fP \fB socklen_t \fP\fIAdrlän\fP\fB);\fP .fi .SH BESCHREIBUNG Der Systemaufruf \fBconnect\fP() verbindet das durch den Dateideskriptor \fISockdd\fP referenzierte Socket mit der durch \fIAdr\fP angegebenen Adresse. Das Argument \fIAdrlän\fP legt die Größe von \fIAdr\fP fest. Das Format der Adresse in \fIAdr\fP wird durch den Adressraum des Sockets \fISockdd\fP festgelegt; siehe \fBsocket\fP(2) für weitere Details. .PP Falls das Socket \fISockdd\fP vom Typ \fBSOCK_DGRAM\fP ist, dann werden Datagramme standardmäßig an die Adresse \fIAdr\fP gesendet werden und auch nur von dieser Adresse empfangen. Falls das Socket vom Typ \fBSOCK_STREAM\fP oder \fBSOCK_SEQPACKET\fP ist, versucht dieser Aufruf eine Verbindung mit dem Socket herzustellen das an die angebene Adresse \fIAdr\fP gebunden ist. .PP Sockets für einige Protokolle (z.B. UNIX\-Domain\-Datenstrom\-Sockets) können nur einmal erfolgreich \fBconnect\fP() durchführen. .PP Sockets für einige Protokolle (z.B. Datagram\-Sockets in den UNIX\- und Internet\-Domains) können \fBconnect\fP() mehrfach verwenden, um ihre Zuordnung zu ändern. .PP Sockets für einige Protokolle (z.B. TCP\-Sockets sowie Datagram\-Sockets in den UNIX\- und Internet\-Domains) können ihre Zuordnung lösen, indem sie mit einer Adresse verbinden, wobei das Mitglied \fIsa_family\fP von \fIsockaddr\fP auf \fBAF_UNSPEC\fP gesetzt ist. Danach kann sich der Socket mit einer anderen Adresse verbinden (\fBAF_UNSPEC\fP wird unter Linux seit Version 2.2 unterstützt). .SH RÜCKGABEWERT Falls die Verbindung oder das Anbinden gelingt, wird Null zurückgeliefert. Im Fehlerfall wird \-1 zurückgeliefert und \fIerrno\fP gesetzt, um den Fehler anzuzeigen. .SH FEHLER Die folgenden Fehler sind nur allgemeine Socket\-Fehler. Es mag andere, domänenspezifische Fehlercodes geben. .TP \fBEACCES\fP Für UNIX\-Domain\-Sockets, die durch einen Pfadnamen identifiziert werden: Auf die Socket\-Datei wurde das Schreiben nicht gestattet oder das Suchen in einer der Dateien des Pfad\-Präfixes wurde verwehrt (siehe auch \fBpath_resolution\fP(7)). .TP \fBEACCES\fP, \fBEPERM\fP Der Benutzer versuchte eine Verbindung zu einer Broadcast\-Adresse, ohne den Socket\-Broadcast\-Schalter aktiviert zu haben oder die Verbindungsanfrage scheiterte wegen einer lokalen Firewall\-Regel. .TP \fBEACCES\fP Es kann auch zurückgegeben werden, falls eine SELinux\-Richtlinie eine Verbindung verweigerte (falls es beispielsweise eine Richtlinie gibt, die regelt, dass ein HTTP\-Proxy sich nur mit Ports verbinden kann, die einem HTTP\-Server zugeordnet sind, und der Proxy versucht, sich auf einen anderen Port zu verbinden). .TP \fBEADDRINUSE\fP Die lokale Adresse ist bereits in Benutzung. .TP \fBEADDRNOTAVAIL\fP (Internet Domain Sockets) Das durch \fIsockdd\fP referenzierte Socket war bisher nicht an eine Adresse gebunden und beim Versuch, es an einen kurzlebigen Port zu binden, wurde festgestellt, dass alle Portnummern in dem Portbereich für kurzlebige Portnummern derzeit verwendet werden. Lesen Sie die Erörterung von \fI/proc/sys/net/ipv4/ip_local_port_range\fP in \fBip\fP(7). .TP \fBEAFNOSUPPORT\fP Die übergebene Adresse hatte nicht die korrekte Adressfamilie in ihrem Feld \fIsa_family\fP. .TP \fBEAGAIN\fP Für nicht blockierende UNIX\-Domain\-Sockets ist der Socket nicht blockierend und die Verbindung kann nicht sofort vollzogen werden. Für andere Socket\-Familien gibt es unzureichende Einträge in dem Routing\-Zwischenspeicher. .TP \fBEALREADY\fP Das Socket ist nicht blockierend und ein vorhergehender Verbindungsversuch wurde noch nicht beendet. .TP \fBEBADF\fP \fISockdd\fP ist kein zulässiger offener Dateideskriptor. .TP \fBECONNREFUSED\fP Ein \fBconnect\fP() auf einem Stream\-Socket fand keinen, der auf der Adresse in der Ferne wartete. .TP \fBEFAULT\fP Die Adresse der Socket\-Struktur liegt außerhalb des Adressraums des Benutzers. .TP \fBEINPROGRESS\fP Der Socket ist nichtblockierend und die Verbindung kann nicht sofort aufgebaut werden. (UNIX\-Domain\-Sockets schlagen stattessen mit \fBEAGAIN\fP fehl.) Der Socket kann zum Schreiben ausgewählt werden und mittels \fBselect\fP(2) oder \fBpoll\fP(2) die erfolgreiche Verbindung abgefragt werden. Nachdem \fBselect\fP(2) die Beschreibbarkeit anzeigt, lesen Sie mit \fBgetsockopt\fP(2) die \fBSO_ERROR\fP\-Option auf der Ebene \fBSOL_SOCKET\fP, um festzustellen, ob \fBconnect\fP() erfolgreich (\fBSO_ERROR\fP ist Null) oder erfolglos (\fBSO_ERROR\fP ist einer der üblichen hier aufgeführten Fehlercodes, welche die Gründe für das Scheitern angeben) abgeschlossen wurde. .TP \fBEINTR\fP .\" For TCP, the connection will complete asynchronously. .\" See http://lkml.org/lkml/2005/7/12/254 Der Systemaufruf wurde durch ein abgefangenes Signal unterbrochen; siehe \fBsignal\fP(7). .TP \fBEISCONN\fP Der Socket ist bereits verbunden. .TP \fBENETUNREACH\fP Das Netz ist nicht erreichbar. .TP \fBENOTSOCK\fP Der Dateideskriptor \fIsockdd\fP zeigt nicht auf ein Socket. .TP \fBEPROTOTYPE\fP Die Socket\-Art unterstützt das angefragte Kommunikationsprotokoll nicht. Dieser Fehler kann beispielsweise bei dem Versuch auftreten, ein UNIX\-Domain\-Datagramm\-Socket mit einem Stream\-Socket zu verbinden. .TP \fBETIMEDOUT\fP Zeitüberschreitung (timeout) während des versuchten Verbindungsaufbaus. Der Server ist vielleicht zu beschäftigt, um neue Verbindungen aufzubauen. Beachten Sie, dass für IP\-Sockets das Timeout sehr lang sein kann, wenn auf dem Server »Syncookies« aktiviert sind. .SH STANDARDS POSIX.1\-2008. .SH GESCHICHTE .\" SVr4 documents the additional .\" general error codes .\" .BR EADDRNOTAVAIL , .\" .BR EINVAL , .\" .BR EAFNOSUPPORT , .\" .BR EALREADY , .\" .BR EINTR , .\" .BR EPROTOTYPE , .\" and .\" .BR ENOSR . .\" It also .\" documents many additional error conditions not described here. POSIX.1\-2001, SVr4, 4.4BSD, (\fBconnect\fP() erschien erstmalig in 4.2BSD). .SH ANMERKUNGEN Falls \fBconnect\fP() fehlschlägt, sollten Sie den Zustand des Sockets als unspezifiziert ansehen. Portable Anwendungen sollten das Socket schließen und ein neues für die Wiederverbindung erstellen. .SH BEISPIELE Ein Beispiel für die Verwendung von \fBconnect\fP() wird in \fBgetaddrinfo\fP(3) vorgestellt. .SH "SIEHE AUCH" \fBaccept\fP(2), \fBbind\fP(2), \fBgetsockname\fP(2), \fBlisten\fP(2), \fBsocket\fP(2), \fBpath_resolution\fP(7), \fBselinux\fP(8) .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer , Helge Kreutzmann und Mario Blättermann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .