sockpuppet

marionnette

Bibliothèque de sockets et d'adresses C++ minimaliste et facile à utiliser.

À propos

Vous souhaitez donc avoir une communication réseau dans votre petit programme mais le boost vous semble tout simplement trop important ? Et à quel point ce truc de socket peut-il être difficile, de toute façon, hein ? - Après y être allé plus d'une fois, j'écris cette bibliothèque dans l'espoir qu'elle m'épargnera le futur codage de sockets à moitié à usage unique.

Fonctionnalités de la bibliothèque

• prend en charge les systèmes d'exploitation Unix, OSX et Windows
• Gestion des adresses IPv6 et IPv4 (recherche à l'aide de getaddrinfo et stockage à l'aide de sockaddr_storage )
• compatible multi-interface (répertoriez les adresses des interfaces hôtes locales avant d'en sélectionner une à laquelle se lier)
• Classes de sockets UDP et TCP
• Diffusion UDP (mais pas automatiquement sur plusieurs interfaces réseau)
• sockets de base avec E/S bloquantes et non bloquantes utilisant le paramètre de délai d'attente facultatif
• sockets étendus avec pool de ressources internes configurable éliminant le besoin de tampons pré-alloués
• sockets étendus pour un fonctionnement asynchrone à l'aide de l'interface de thread du pilote (gestion des événements à l'aide de poll )
• Les sockets TCP peuvent être augmentés avec le cryptage TLS
• tâches planifiées à exécuter à un moment donné par le thread du pilote
• exceptions avec des messages d'erreur significatifs fournis par le système
• la bibliothèque inclut ne tire aucun système ou en-tête externe
• cibles de construction de bibliothèques statiques et dynamiques
• quelques tests fonctionnels
• exemples et projet de démonstration inclus
• tests unitaires exhaustifs ?
• Multidiffusion UDP
• arithmétique d'adresse/recherche d'adresses réseau/diffusion

Construire

Configurez et créez une bibliothèque/des exemples/une démo/des tests à l'aide de CMake.

Démarrage rapide

La cible d'installation CMake prépare un projet de démonstration basé sur CMake pouvant servir de point de départ pour ses propres applications.

Interface de la bibliothèque

La classe Address représente l'hôte local ou les adresses UDP/TCP distantes et est utilisée pour créer des sockets locaux et envoyer/se connecter à des sockets distants.

Les classes de socket Socket* , Socket*Buffered et Socket*Async offrent différents niveaux de commodité autour de la représentation brute du socket du système d'exploitation :

• SocketUdp et SocketTcp autorisent des fonctions de base telles que la connexion, l'envoi et la réception, tandis que Acceptor écoute les connexions TCP entrantes.
• SocketUdpBuffered et SocketTcpBuffered ajoutent un pool de tampons de réception interne
• SocketUdpAsync et SocketTcpAsync ainsi que AcceptorAsync sont exécutés par un Driver (c'est-à-dire un thread) fournissant un fonctionnement asynchrone à un ou plusieurs sockets

Si elles sont construites avec la prise en charge de TLS, toutes les classes de socket TCP peuvent être instanciées avec un certificat SSL et un fichier de clé privée pour exécuter des connexions cryptées.

La classe ToDo est utilisée pour planifier des tâches à exécuter par un Driver à un moment donné, par exemple des transmissions périodiques de paquets de battements de cœur ou des tentatives de reconnexion.

Justification de la conception

• la plupart des classes visibles par l'utilisateur utilisent un modèle pont/PIMPL pour éviter de transmettre les en-têtes système inclus en interne
• la classe d'adresse utilise getaddrinfo lorsqu'elle est créée par une entrée utilisateur et sockaddr_storage lorsqu'elle est créée par un socket ; pour les utilisateurs, cette distinction est transparente
• tandis que les classes de socket visibles par l'utilisateur font la distinction entre UDP/TCP, les classes de socket PIMPL fournissent des fonctions génériques qui peuvent avoir des redondances pour certains cas d'utilisation.
• le sondage est utilisé avant le socket IO si un délai d'attente limité est accordé, pour respecter le délai
• les sockets augmentant consomment des sockets de base pré-construits pour éviter d'agréger tous les arguments du constructeur de socket de base et de canaliser toutes leurs exceptions
• les threads ne sont pas créés en interne pour éviter un arrêt désordonné de la bibliothèque partagée sous Windows