cppsocket
v0.0.8
这是带有或不带有 SSL/TLS/DTLS 的 C++ 客户端/服务器的仅头文件实现。该实现使用 OpenSSL 和 BSD API 来实现底层套接字接口。
编译已经过测试:
BSD API 类方法的基础套接字类。
// default constructor - no socket created because type is unknown
Socket ();
Socket::initSocket (domain, type, protocol); // creates socket
// create socket from previously created file descriptor
Socket ( int );
// create socket of the given type - NOTE: This returns a Socket class type that is not a Tcp or Udp socket class
Socket (domain, type, protocol);
创建一个 TCP 服务器对象以接受 TCP 连接。
// default no IP/port bound but TCP socket created
TcpServer ();
// TCP socket created, IP/port bound, but not listening
TcpServer ( const uint16_t port, const std::string& ipAddr = " 0.0.0.0 " );
// TCP socket created, IP/port bound, and listening for clients
TcpServer ( const std::string& ipAddr, const uint16_t port, const int backlog);
创建 TCP 客户端对象以连接到已知的 TCP 服务器。
// default TCP socket created but no server connection
TcpClient ();
// create TcpClient with given TCP socket file descriptor
TcpClient ( const int filedescriptor);
// TcpClient connected to a TcpServer IP/port
TcpClient ( const std::string& ipAddr, const uint16_t port);
创建 SSL TCP 服务器以接受 SSL TCP 客户端。
// Create a SSL TCP Server not bound to IP/port
SecureTcpServer ( const std::string& keyFile, const std::string& certFile);
// Create a SSL TCP Server bound to a given port and IP or default IP
SecureTcpServer ( const std::string& keyFile, const std::string& certFile, const uint16_t port, const std::string& ipAddr = " 0.0.0.0 " );
创建 SSL TCP 客户端以连接到 SSL TCP 服务器。
// create a SSL TCP client with a given SSL context - used with SecureTcpServer::accept return
SecureTcpClient ( const int filedescriptor, SSL_CTX *sslctx);
// create a SSL TCP client connected to a SSL TCP server
SecureTcpClient ( const std::string& ipAddr, const uint16_t port);
// Client
// Connect to TCP server on IP 127.0.0.1 and port 54321
TcpClient client ( " 127.0.0.1 " , 54321 );
创建一个 UDP 服务器对象以接受 UDP 连接。
// default no IP/port bound but UDP socket created
UdpServer ();
// UDP server socket created, IP/port bound
UdpServer ( const uint16_t port, const std::string &ipAddr = " 0.0.0.0 " );
创建 UDP 客户端对象以连接到已知的 UDP 服务器。
// default UDP socket created but no server connection
UdpClient ();
// UdpClient connected to a UdpServer IP/port
UdpClient ( const std::string& ipAddr, const uint16_t port) noexcept ( false )
创建 SSL UDP 服务器以接受 SSL UDP 客户端。
// Create a SSL UDP Server not bound to IP/port
SecureUdpServer ( const std::string& keyFile, const std::string& certFile);
// Create a SSL UDP Server bound to a given port and IP or default IP
SecureUdpServer ( const std::string& keyFile, const std::string& certFile, const uint16_t port, const std::string& ipAddr = " 0.0.0.0 " );
创建 SSL UDP 客户端以连接到 SSL UDP 服务器。
// Create a SSL UDP Client not attempting to connect to a SSL UDP Server (need to call SecureUdpClient::connect(IP, port) to connect)
SecureUdpClient ( const std::string& keyFile, const std::string& certFile);
// create a SSL UDP client connected to a given SSL UDP server waiting in a SecureUdpServer::accept call on the given IP and port
SecureUdpClient ( const std::string& ipAddr, const uint16_t port, const std::string& keyFile, const std::string& certFile);
不要跨线程共享任何套接字对象,除非您在发送/读取和接受调用上提供自己的线程安全性。
使用源代码树中的cppsocket.hpp
文件并将其包含在需要使用它的文件中。
使用 ctest 运行单元测试:
ctest -C debug
所有贡献均受到高度赞赏。