sockpuppet

títere de calcetín

Biblioteca de direcciones y sockets C++ minimalista y fácil de usar.

Acerca de

¿Quieres tener comunicación en red en tu pequeño programa pero el impulso te parece demasiado? ¿Y qué tan difíciles pueden ser estas cosas de los enchufes, eh? - Después de estar allí más de una vez, escribo esta biblioteca con la esperanza de que me ahorre la codificación futura de enchufes de un solo uso a medias.

Funciones de la biblioteca

• Soporta sistemas operativos Unix, OSX y Windows.
• Manejo de direcciones IPv6 e IPv4 (búsqueda usando getaddrinfo y almacenamiento usando sockaddr_storage )
• compatible con múltiples interfaces (enumere las direcciones de las interfaces del host local antes de seleccionar una para vincularla)
• Clases de sockets UDP y TCP
• Transmisión UDP (pero no automáticamente en múltiples interfaces de red)
• sockets básicos con IO bloqueante y no bloqueante usando el parámetro de tiempo de espera opcional
• sockets extendidos con grupo de recursos interno configurable que elimina la necesidad de buffers preasignados
• sockets extendidos para operación asincrónica usando la interfaz de subproceso del controlador (manejo de eventos usando poll )
• Los sockets TCP se pueden aumentar con cifrado TLS
• Tareas programadas que se ejecutarán en un momento determinado mediante el hilo del controlador.
• excepciones con mensajes de error significativos proporcionados por el sistema
• La biblioteca incluye no extrae ningún sistema ni encabezados externos.
• objetivos de construcción de bibliotecas estáticas y dinámicas
• algunas pruebas funcionales
• ejemplos y proyecto de demostración incluidos
• ¿Pruebas unitarias exhaustivas?
• multidifusión UDP
• aritmética de direcciones/búsqueda de direcciones de red/difusión

Construir

Configure y cree bibliotecas/ejemplos/demostraciones/pruebas utilizando CMake.

Inicio rápido

El objetivo de instalación de CMake prepara un proyecto de demostración basado en CMake adecuado como punto de partida para sus propias aplicaciones.

Interfaz de biblioteca

La clase Address representa direcciones UDP/TCP localhost o remotas y se utiliza para crear sockets locales y enviar/conectar a remotos.

Las clases de socket Socket* , Socket*Buffered y Socket*Async proporcionan diferentes niveles de conveniencia en torno a la representación del socket del sistema operativo sin formato:

• SocketUdp y SocketTcp permiten funciones básicas como conectar, enviar y recibir, mientras que Acceptor escucha las conexiones TCP entrantes.
• SocketUdpBuffered y SocketTcpBuffered agregan un grupo de búfer de recepción interno
• SocketUdpAsync y SocketTcpAsync así como AcceptorAsync se ejecutan mediante un Driver (es decir, un subproceso) que proporciona operación asincrónica a uno o varios sockets.

Si se construye con soporte TLS, se pueden crear instancias de todas las clases de socket TCP con un certificado SSL y un archivo de clave privada para ejecutar conexiones cifradas.

La clase ToDo se utiliza para programar tareas que ejecutará un Driver en un momento determinado, por ejemplo, transmisiones periódicas de paquetes de latidos o intentos de reconexión.

Justificación del diseño

• la mayoría de las clases visibles para el usuario emplean un patrón puente/PIMPL para evitar reenviar los encabezados del sistema incluidos internamente
• la clase de dirección emplea getaddrinfo cuando se crea mediante entrada del usuario y sockaddr_storage cuando se crea mediante un socket; para los usuarios esta distinción es transparente
• Mientras que las clases de socket visibles para el usuario distinguen entre UDP/TCP, las clases de socket PIMPL proporcionan funciones genéricas que pueden tener redundancias para algunos casos de uso.
• La encuesta se utiliza antes del socket IO si se da un tiempo de espera limitado, para cumplir con la fecha límite.
• los sockets de aumento consumen sockets básicos preconstruidos para evitar agregar todos los argumentos del constructor del socket base y canalizar todas sus excepciones.
• Los subprocesos no se crean internamente para evitar el cierre desordenado de la biblioteca compartida en Windows.