sockpuppet

boneco de meia

Soquete C++ minimalista e fácil de usar e biblioteca de endereços.

Sobre

Então você quer ter comunicação de rede em seu pequeno programa, mas o impulso parece demais? E quão difícil pode ser essa coisa de soquete, hein? - Depois de estar lá mais de uma vez, escrevo esta biblioteca com a esperança de que ela me poupe de futuras codificações de soquetes descartáveis ​​​​de meia-boca.

Recursos da biblioteca

• suporta Unix, OSX e sistema operacional Windows
• Tratamento de endereços IPv6 e IPv4 (pesquisa usando getaddrinfo e armazenamento usando sockaddr_storage )
• com reconhecimento de múltiplas interfaces (liste os endereços da interface do host local antes de selecionar um para vincular)
• Classes de soquete UDP e TCP
• Transmissão UDP (mas não automaticamente em múltiplas interfaces de rede)
• soquetes básicos com IO bloqueador e não bloqueador usando parâmetro de tempo limite opcional
• soquetes estendidos com pool de recursos internos configuráveis, eliminando a necessidade de buffers pré-alocados
• soquetes estendidos para operação assíncrona usando interface de thread de driver (manipulação de eventos usando poll )
• Soquetes TCP podem ser aumentados com criptografia TLS
• tarefas agendadas a serem executadas em determinado momento pelo thread do driver
• exceções com mensagens de erro significativas fornecidas pelo sistema
• a biblioteca inclui não extrai nenhum sistema ou cabeçalhos externos
• alvos de construção de biblioteca estática e dinâmica
• alguns testes funcionais
• exemplos e projeto de demonstração incluídos
• testes de unidade exaustivos?
• Multicast UDP
• aritmética de endereços/pesquisa de endereços de rede/transmissão

Construir

Configure e construa biblioteca/exemplos/demonstração/testes usando CMake.

Início rápido

O destino de instalação do CMake prepara um projeto de demonstração baseado em CMake adequado como ponto de partida para seus próprios aplicativos.

Interface da biblioteca

A classe Address representa endereços localhost ou UDP/TCP remotos e é usada para criar soquetes locais e enviar/conectar a soquetes remotos.

As classes de soquete Socket* , Socket*Buffered e Socket*Async fornecem diferentes níveis de conveniência em torno da representação bruta do soquete do sistema operacional:

• SocketUdp e SocketTcp permitem funções básicas como conectar, enviar e receber, enquanto Acceptor escuta conexões TCP de entrada
• SocketUdpBuffered e SocketTcpBuffered adicionam um buffer pool de recebimento interno
• SocketUdpAsync e SocketTcpAsync bem como AcceptorAsync são executados por um Driver (ou seja, um thread) fornecendo operação assíncrona para um ou vários soquetes

Se construídas com suporte a TLS, todas as classes de soquete TCP podem ser instanciadas com um certificado SSL e um arquivo de chave privada para executar conexões criptografadas.

A classe ToDo é usada para agendar tarefas a serem executadas por um Driver em um determinado momento, por exemplo, transmissões periódicas de pacotes de pulsação ou tentativas de reconexão.

Justificativa do projeto

• a maioria das classes visíveis ao usuário emprega um padrão bridge/PIMPL para evitar o encaminhamento dos cabeçalhos do sistema incluídos internamente
• a classe de endereço emprega getaddrinfo quando criada pela entrada do usuário e sockaddr_storage quando criada por um soquete; para os usuários esta distinção é transparente
• enquanto as classes de soquete visíveis ao usuário distinguem entre UDP/TCP, as classes de soquete PIMPL fornecem funções genéricas que podem ter redundâncias para alguns casos de uso
• poll é usado antes do soquete IO se um tempo limite for concedido, para honrar o prazo
• os soquetes aumentados consomem soquetes básicos pré-construídos para evitar agregar todos os argumentos do construtor de soquete base e canalizar todas as suas exceções
• threads não são criados internamente para evitar o desligamento confuso da biblioteca compartilhada no Windows