Scroll to navigation

SOCKETPAIR(2) Linux-Programmierhandbuch SOCKETPAIR(2)

BEZEICHNUNG

socketpair - zwei verbundene Sockets erstellen

ÜBERSICHT

#include <sys/types.h> /* Siehe ANMERKUNGEN */
#include <sys/socket.h>

int socketpair(int domain, int typ, int protokoll, int sv[2]);

BESCHREIBUNG

Der Aufruf socketpair() erstellt zwei unbenannte, verbundene Sockets in der angegebenen domain vom angegebenen typ und benutzt dabei das optional angegebene protokoll. Weitere Einzelheiten über diese Argumente finden Sie unter socket(2).

Die Dateideskriptoren, die auf die neuen Sockets verweisen, werden in sv[0] und sv[1] zurückgegeben. Die beiden Sockets sind nicht zu unterscheiden.

RÜCKGABEWERT

Bei Erfolg wird Null zurückgegeben. Bei einem Fehler wird -1 zurückgegeben, errno entsprechend gesetzt und sv verbleibt unverändert.

Unter Linux (und anderen Systemen) verändert socketpair() sv beim Fehlschlag nicht. Eine Anforderung, dieses Verhalten zu standardisieren, wurde in POSIX.1-2008 TC2 hinzugefügt.

FEHLER

Die angegebene Adressfamilie wird auf dieser Maschine nicht unterstützt.
Die Adresse sv gibt keinen gültigen Teil des Prozess-Adressraums an.
Die Beschränkung pro Prozess der Anzahl offener Datei-Deskriptoren wurde erreicht.
Die systemweite Beschränkung für die Gesamtzahl offener Dateien wurde erreicht.
Das angegebene Protokoll unterstützt nicht das Anlegen von Socket-Paaren.
Das angegebene Protokoll wird auf dieser Maschine nicht unterstützt.

KONFORM ZU

POSIX.1-2001, POSIX.1-2008, 4.4BSD. socketpair() erschien erstmalig in 4.2BSD. Er ist allgemein nach/von Nicht-BSD-Systemen portierbar, die das Klonen der BSD-Socket-Ebene unterstützen (einschließlich System-V-Varianten).

ANMERKUNGEN

Auf Linux sind die einzigen unterstützten Domains für diesen Aufruf AF_UNIX (oder gleichbedeutend AF_LOCAL) und (seit Linux 4.12) AF_TIPC.

Seit Linux 2.6.27 unterstützt socketpair() die in socket(2) beschriebenen Schalter SOCK_NONBLOCK und SOCK_CLOEXEC im Argument type.

POSIX.1 erfordert nicht, dass <sys/types.h> eingebunden wird. Diese Header-Datei ist in Linux nicht erforderlich. Allerdings benötigen einige historische Implementierungen (BSD) diese Header-Datei. Es wird empfohlen, sie für portierbare Anwendungen einzubinden.

SIEHE AUCH

pipe(2), read(2), socket(2), write(2), socket(7), unix(7)

KOLOPHON

Diese Seite ist Teil der Veröffentlichung 5.10 des Projekts Linux-man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Chris Leick <c.leick@vollbio.de> und Mario Blättermann <mario.blaettermann@gmail.com> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.

9. Juni 2020 Linux