sockpuppet

кукла-носок

Минималистичная и простая в использовании библиотека сокетов и адресов C++.

О

Итак, вы хотите использовать сетевое взаимодействие в своей маленькой программе, но ускорение кажется слишком большим? И насколько сложными могут быть эти розетки, а? — Побывав там не раз, я пишу эту библиотеку с надеждой, что она избавит меня от дальнейшего кодирования недоделанных одноразовых сокетов.

Возможности библиотеки

• поддерживает ОС Unix, OSX и Windows
• Обработка адресов IPv6 и IPv4 (поиск с помощью getaddrinfo и хранение с помощью sockaddr_storage )
• поддержка нескольких интерфейсов (перечислите адреса интерфейсов локальных хостов, прежде чем выбирать тот, к которому будет привязываться)
• Классы сокетов UDP и TCP
• Широковещательная рассылка UDP (но не автоматически на нескольких сетевых интерфейсах)
• базовые сокеты с блокирующим и неблокирующим вводом-выводом с использованием дополнительного параметра тайм-аута
• расширенные сокеты с настраиваемым внутренним пулом ресурсов, устраняющим необходимость в предварительно выделенных буферах
• расширенные сокеты для асинхронной работы с использованием интерфейса потока драйвера (обработка событий с помощью опроса )
• TCP-сокеты могут быть дополнены шифрованием TLS.
• запланированные задачи, которые будут запускаться в определенный момент времени потоком драйвера
• исключения со значимыми сообщениями об ошибках, предоставляемыми системой
• включает в себя библиотеку, не извлекает системные или внешние заголовки
• цели сборки статических и динамических библиотек
• некоторые функциональные тесты
• примеры и демо-проект включены
• исчерпывающие модульные тесты?
• многоадресная рассылка UDP
• адресная арифметика/поиск сетевых/широковещательных адресов

Строить

Настройте и создайте библиотеку/примеры/демо/тесты с помощью CMake.

Быстрый старт

Цель установки CMake подготавливает демонстрационный проект на основе CMake, который можно использовать в качестве отправной точки для собственных приложений.

Интерфейс библиотеки

Класс Address представляет локальные или удаленные адреса UDP/TCP и используется для создания локальных сокетов и отправки/подключения к удаленным сокетам.

Классы сокетов Socket* , Socket*Buffered и Socket*Async обеспечивают различные уровни удобства представления необработанных сокетов ОС:

• SocketUdp и SocketTcp позволяют выполнять основные функции, такие как подключение, отправка и получение, в то время как Acceptor прослушивает входящие TCP-соединения.
• SocketUdpBuffered и SocketTcpBuffered добавляют внутренний пул буферов приема.
• SocketUdpAsync и SocketTcpAsync а также AcceptorAsync запускаются Driver (т. е. потоком), обеспечивающим асинхронную работу с одним или несколькими сокетами.

Если они созданы с поддержкой TLS, все классы сокетов TCP могут быть созданы с использованием сертификата SSL и файла закрытого ключа для запуска зашифрованных соединений.

Класс ToDo используется для планирования задач, которые должен выполнять Driver в заданный момент времени, например, периодические передачи контрольных пакетов или попытки повторного подключения.

Обоснование дизайна

• большинство видимых пользователю классов используют шаблон моста/PIMPL, чтобы избежать пересылки внутренних системных заголовков.
• класс адреса использует getaddrinfo при создании пользовательским вводом и sockaddr_storage при создании сокета; для пользователей это различие прозрачно
• в то время как видимые пользователю классы сокетов различают UDP/TCP, классы сокетов PIMPL предоставляют общие функции, которые могут иметь избыточность для некоторых случаев использования.
• опрос используется до ввода-вывода сокета, если задан ограниченный тайм-аут, чтобы соблюдать крайний срок
• дополняющие сокеты используют предварительно созданные базовые сокеты, чтобы избежать агрегирования всех аргументов конструктора базового сокета и передачи всех их исключений.
• потоки не создаются внутри, чтобы избежать беспорядочного завершения работы общей библиотеки в Windows.