sockpuppet

Sockenpuppe

Minimalistische und benutzerfreundliche C++-Socket- und Adressbibliothek.

Um

Sie möchten also Netzwerkkommunikation in Ihrem kleinen Programm haben, aber Boost scheint einfach zu viel zu sein? Und wie schwer kann dieses Steckdosen-Zeug überhaupt sein, oder? - Nachdem ich mehr als einmal dort war, schreibe ich diese Bibliothek in der Hoffnung, dass sie mir das zukünftige Codieren halber Einwegsteckdosen erspart.

Bibliotheksfunktionen

• unterstützt Unix, OSX und Windows-Betriebssysteme
• Handhabung von IPv6- und IPv4-Adressen (Suche mit getaddrinfo und Speicherung mit sockaddr_storage )
• Multi-Interface-fähig (listen Sie lokale Host-Schnittstellenadressen auf, bevor Sie eine zum Binden auswählen)
• UDP- und TCP-Socket-Klassen
• UDP-Broadcast (jedoch nicht automatisch auf mehreren Netzwerkschnittstellen)
• Basis-Sockets mit blockierendem und nicht blockierendem E/A unter Verwendung des optionalen Timeout-Parameters
• Erweiterte Sockets mit konfigurierbarem internen Ressourcenpool, wodurch die Notwendigkeit vorab zugewiesener Puffer entfällt
• Erweiterte Sockets für asynchronen Betrieb mithilfe der Treiber-Thread-Schnittstelle (Ereignisbehandlung mithilfe von poll )
• TCP-Sockets können mit TLS-Verschlüsselung erweitert werden
• Geplante Aufgaben, die zu einem bestimmten Zeitpunkt vom Treiber-Thread ausgeführt werden sollen
• Ausnahmen mit aussagekräftigen, vom System bereitgestellten Fehlermeldungen
• Bibliotheks-Includes ziehen keine System- oder externen Header
• Statische und dynamische Bibliotheks-Build-Ziele
• einige Funktionstests
• Beispiele und Demoprojekt enthalten
• ausführliche Unit-Tests?
• UDP-Multicast
• Adressarithmetik/Suche nach Netzwerk-/Broadcast-Adressen

Bauen

Konfigurieren und erstellen Sie Bibliothek/Beispiele/Demo/Tests mit CMake.

Schnellstart

Das CMake-Installationsziel bereitet ein CMake-basiertes Demoprojekt vor, das als Ausgangspunkt für eigene Anwendungen geeignet ist.

Bibliotheksschnittstelle

Die Address stellt lokale Host- oder Remote-UDP/TCP-Adressen dar und wird zum Erstellen lokaler und zum Senden/Verbinden mit Remote-Sockets verwendet.

Die Socket-Klassen Socket* , Socket*Buffered und Socket*Async bieten unterschiedliche Komfortstufen rund um die rohe OS-Socket-Darstellung:

• SocketUdp und SocketTcp ermöglichen grundlegende Funktionen wie Verbinden, Senden und Empfangen, während Acceptor auf eingehende TCP-Verbindungen wartet
• SocketUdpBuffered und SocketTcpBuffered fügen einen internen Empfangspufferpool hinzu
• SocketUdpAsync und SocketTcpAsync sowie AcceptorAsync werden von einem Driver (dh einem Thread) ausgeführt, der einen asynchronen Betrieb für einen oder mehrere Sockets bereitstellt

Bei der Erstellung mit TLS-Unterstützung können alle TCP-Socket-Klassen mit einem SSL-Zertifikat und einer privaten Schlüsseldatei instanziiert werden, um verschlüsselte Verbindungen auszuführen.

Die ToDo -Klasse wird zum Planen von Aufgaben verwendet, die von einem Driver zu einem bestimmten Zeitpunkt ausgeführt werden sollen, z. B. regelmäßige Heartbeat-Paketübertragungen oder Wiederherstellungsversuche.

Designbegründung

• Die meisten vom Benutzer sichtbaren Klassen verwenden ein Bridge/PIMPL-Muster, um die Weiterleitung der intern enthaltenen Systemheader zu vermeiden
• Die Adressklasse verwendet getaddrinfo , wenn sie durch Benutzereingaben erstellt wird, und sockaddr_storage , wenn sie durch einen Socket erstellt wird. Für den Benutzer ist diese Unterscheidung transparent
• Während die für den Benutzer sichtbaren Socket-Klassen zwischen UDP/TCP unterscheiden, stellen die Socket-PIMPL-Klassen generische Funktionen bereit, die für einige Anwendungsfälle Redundanzen aufweisen können
• Die Abfrage wird vor Socket-IO verwendet, wenn ein begrenztes Timeout gegeben ist, um die Frist einzuhalten
• Die Erweiterungs-Sockets verbrauchen vorkonstruierte Basis-Sockets, um zu vermeiden, dass alle Basis-Socket-Konstruktorargumente aggregiert und alle ihre Ausnahmen weitergeleitet werden
• Threads werden nicht intern erstellt, um ein chaotisches Herunterfahren der gemeinsam genutzten Bibliothek unter Windows zu vermeiden