هذا ملف رأس يتم تنفيذه فقط لعميل/خادم C++ مع أو بدون SSL/TLS/DTLS. يستخدم التنفيذ 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
جميع المساهمات محل تقدير كبير.