加入libcurl
parent
e638cffc10
commit
1e1d10777d
|
|
@ -47,17 +47,17 @@ target_compile_definitions(AicsKnowledgeBase
|
||||||
PRIVATE $<$<OR:$<CONFIG:Debug>,$<CONFIG:RelWithDebInfo>>:QT_QML_DEBUG>)
|
PRIVATE $<$<OR:$<CONFIG:Debug>,$<CONFIG:RelWithDebInfo>>:QT_QML_DEBUG>)
|
||||||
|
|
||||||
target_include_directories(AicsKnowledgeBase PRIVATE
|
target_include_directories(AicsKnowledgeBase PRIVATE
|
||||||
../msquic/include)
|
../libcurl/include)
|
||||||
|
|
||||||
target_link_libraries(AicsKnowledgeBase PRIVATE
|
target_link_libraries(AicsKnowledgeBase PRIVATE
|
||||||
Qt6::Quick
|
Qt6::Quick
|
||||||
fluentuiplugin
|
fluentuiplugin
|
||||||
FramelessHelper::Core
|
FramelessHelper::Core
|
||||||
FramelessHelper::Quick
|
FramelessHelper::Quick
|
||||||
msquic
|
libcurl
|
||||||
)
|
)
|
||||||
|
|
||||||
file(GLOB MSQUIC_BIN_FILES ../msquic/bin/*)
|
file(GLOB MSQUIC_BIN_FILES ../libcurl/dll/*)
|
||||||
|
|
||||||
add_custom_command(TARGET AicsKnowledgeBase POST_BUILD
|
add_custom_command(TARGET AicsKnowledgeBase POST_BUILD
|
||||||
COMMAND ${CMAKE_COMMAND} -E copy_if_different
|
COMMAND ${CMAKE_COMMAND} -E copy_if_different
|
||||||
|
|
|
||||||
|
|
@ -81,7 +81,7 @@ Row {
|
||||||
normalColor: FluColors.Green.normal
|
normalColor: FluColors.Green.normal
|
||||||
text: "登录"
|
text: "登录"
|
||||||
onClicked: {
|
onClicked: {
|
||||||
HttpClient.doGetRequest(loginItem, "login");
|
HttpClient.doGetRequest("https://quic.aiortc.org/", loginItem, "login");
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -4,403 +4,35 @@
|
||||||
|
|
||||||
#include "HttpClient.h"
|
#include "HttpClient.h"
|
||||||
|
|
||||||
//
|
|
||||||
// The (optional) registration configuration for the app. This sets a name for
|
|
||||||
// the app (used for persistent storage and for debugging). It also configures
|
|
||||||
// the execution profile, using the default "low latency" profile.
|
|
||||||
//
|
|
||||||
const QUIC_REGISTRATION_CONFIG RegConfig = { "quicsample", QUIC_EXECUTION_PROFILE_LOW_LATENCY };
|
|
||||||
|
|
||||||
//
|
|
||||||
// The protocol name used in the Application Layer Protocol Negotiation (ALPN).
|
|
||||||
//
|
|
||||||
const QUIC_BUFFER Alpn = { sizeof("sample") - 1, (uint8_t*)"sample" };
|
|
||||||
|
|
||||||
//
|
|
||||||
// The UDP port used by the server side of the protocol.
|
|
||||||
//
|
|
||||||
const uint16_t UdpPort = 4567;
|
|
||||||
|
|
||||||
//
|
|
||||||
// The default idle timeout period (1 second) used for the protocol.
|
|
||||||
//
|
|
||||||
const uint64_t IdleTimeoutMs = 1000;
|
|
||||||
|
|
||||||
//
|
|
||||||
// The length of buffer sent over the streams in the protocol.
|
|
||||||
//
|
|
||||||
const uint32_t SendBufferLength = 100;
|
|
||||||
|
|
||||||
//
|
|
||||||
// The QUIC API/function table returned from MsQuicOpen2. It contains all the
|
|
||||||
// functions called by the app to interact with MsQuic.
|
|
||||||
//
|
|
||||||
const QUIC_API_TABLE* MsQuic;
|
|
||||||
|
|
||||||
//
|
|
||||||
// The QUIC handle to the registration object. This is the top level API object
|
|
||||||
// that represents the execution context for all work done by MsQuic on behalf
|
|
||||||
// of the app.
|
|
||||||
//
|
|
||||||
HQUIC Registration;
|
|
||||||
|
|
||||||
//
|
|
||||||
// The QUIC handle to the configuration object. This object abstracts the
|
|
||||||
// connection configuration. This includes TLS configuration and any other
|
|
||||||
// QUIC layer settings.
|
|
||||||
//
|
|
||||||
HQUIC Configuration;
|
|
||||||
|
|
||||||
//
|
|
||||||
// Helper function to convert a hex character to its decimal value.
|
|
||||||
//
|
|
||||||
uint8_t
|
|
||||||
DecodeHexChar(
|
|
||||||
_In_ char c
|
|
||||||
)
|
|
||||||
{
|
|
||||||
if (c >= '0' && c <= '9') return c - '0';
|
|
||||||
if (c >= 'A' && c <= 'F') return 10 + c - 'A';
|
|
||||||
if (c >= 'a' && c <= 'f') return 10 + c - 'a';
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Helper function to convert a string of hex characters to a byte buffer.
|
|
||||||
//
|
|
||||||
uint32_t
|
|
||||||
DecodeHexBuffer(
|
|
||||||
_In_z_ const char* HexBuffer,
|
|
||||||
_In_ uint32_t OutBufferLen,
|
|
||||||
_Out_writes_to_(OutBufferLen, return)
|
|
||||||
uint8_t* OutBuffer
|
|
||||||
)
|
|
||||||
{
|
|
||||||
uint32_t HexBufferLen = (uint32_t)strlen(HexBuffer) / 2;
|
|
||||||
if (HexBufferLen > OutBufferLen) {
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
for (uint32_t i = 0; i < HexBufferLen; i++) {
|
|
||||||
OutBuffer[i] =
|
|
||||||
(DecodeHexChar(HexBuffer[i * 2]) << 4) |
|
|
||||||
DecodeHexChar(HexBuffer[i * 2 + 1]);
|
|
||||||
}
|
|
||||||
|
|
||||||
return HexBufferLen;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// The clients's callback for stream events from MsQuic.
|
|
||||||
//
|
|
||||||
_IRQL_requires_max_(DISPATCH_LEVEL)
|
|
||||||
_Function_class_(QUIC_STREAM_CALLBACK)
|
|
||||||
QUIC_STATUS
|
|
||||||
QUIC_API
|
|
||||||
ClientStreamCallback(
|
|
||||||
_In_ HQUIC Stream,
|
|
||||||
_In_opt_ void* Context,
|
|
||||||
_Inout_ QUIC_STREAM_EVENT* Event
|
|
||||||
)
|
|
||||||
{
|
|
||||||
UNREFERENCED_PARAMETER(Context);
|
|
||||||
switch (Event->Type) {
|
|
||||||
case QUIC_STREAM_EVENT_SEND_COMPLETE:
|
|
||||||
//
|
|
||||||
// A previous StreamSend call has completed, and the context is being
|
|
||||||
// returned back to the app.
|
|
||||||
//
|
|
||||||
free(Event->SEND_COMPLETE.ClientContext);
|
|
||||||
printf("[strm][%p] Data sent\n", Stream);
|
|
||||||
break;
|
|
||||||
case QUIC_STREAM_EVENT_RECEIVE:
|
|
||||||
//
|
|
||||||
// Data was received from the peer on the stream.
|
|
||||||
//
|
|
||||||
printf("[strm][%p] Data received\n", Stream);
|
|
||||||
break;
|
|
||||||
case QUIC_STREAM_EVENT_PEER_SEND_ABORTED:
|
|
||||||
//
|
|
||||||
// The peer gracefully shut down its send direction of the stream.
|
|
||||||
//
|
|
||||||
printf("[strm][%p] Peer aborted\n", Stream);
|
|
||||||
break;
|
|
||||||
case QUIC_STREAM_EVENT_PEER_SEND_SHUTDOWN:
|
|
||||||
//
|
|
||||||
// The peer aborted its send direction of the stream.
|
|
||||||
//
|
|
||||||
printf("[strm][%p] Peer shut down\n", Stream);
|
|
||||||
break;
|
|
||||||
case QUIC_STREAM_EVENT_SHUTDOWN_COMPLETE:
|
|
||||||
//
|
|
||||||
// Both directions of the stream have been shut down and MsQuic is done
|
|
||||||
// with the stream. It can now be safely cleaned up.
|
|
||||||
//
|
|
||||||
printf("[strm][%p] All done\n", Stream);
|
|
||||||
if (!Event->SHUTDOWN_COMPLETE.AppCloseInProgress) {
|
|
||||||
MsQuic->StreamClose(Stream);
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
return QUIC_STATUS_SUCCESS;
|
|
||||||
}
|
|
||||||
|
|
||||||
void
|
|
||||||
ClientSend(
|
|
||||||
_In_ HQUIC Connection
|
|
||||||
)
|
|
||||||
{
|
|
||||||
QUIC_STATUS Status;
|
|
||||||
HQUIC Stream = NULL;
|
|
||||||
uint8_t* SendBufferRaw;
|
|
||||||
QUIC_BUFFER* SendBuffer;
|
|
||||||
|
|
||||||
//
|
|
||||||
// Create/allocate a new bidirectional stream. The stream is just allocated
|
|
||||||
// and no QUIC stream identifier is assigned until it's started.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->StreamOpen(Connection, QUIC_STREAM_OPEN_FLAG_NONE, ClientStreamCallback, NULL, &Stream))) {
|
|
||||||
printf("StreamOpen failed, 0x%x!\n", Status);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
printf("[strm][%p] Starting...\n", Stream);
|
|
||||||
|
|
||||||
//
|
|
||||||
// Starts the bidirectional stream. By default, the peer is not notified of
|
|
||||||
// the stream being started until data is sent on the stream.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->StreamStart(Stream, QUIC_STREAM_START_FLAG_NONE))) {
|
|
||||||
printf("StreamStart failed, 0x%x!\n", Status);
|
|
||||||
MsQuic->StreamClose(Stream);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Allocates and builds the buffer to send over the stream.
|
|
||||||
//
|
|
||||||
SendBufferRaw = (uint8_t*)malloc(sizeof(QUIC_BUFFER) + SendBufferLength);
|
|
||||||
if (SendBufferRaw == NULL) {
|
|
||||||
printf("SendBuffer allocation failed!\n");
|
|
||||||
Status = QUIC_STATUS_OUT_OF_MEMORY;
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
SendBuffer = (QUIC_BUFFER*)SendBufferRaw;
|
|
||||||
SendBuffer->Buffer = SendBufferRaw + sizeof(QUIC_BUFFER);
|
|
||||||
SendBuffer->Length = SendBufferLength;
|
|
||||||
|
|
||||||
printf("[strm][%p] Sending data...\n", Stream);
|
|
||||||
|
|
||||||
//
|
|
||||||
// Sends the buffer over the stream. Note the FIN flag is passed along with
|
|
||||||
// the buffer. This indicates this is the last buffer on the stream and the
|
|
||||||
// the stream is shut down (in the send direction) immediately after.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->StreamSend(Stream, SendBuffer, 1, QUIC_SEND_FLAG_FIN, SendBuffer))) {
|
|
||||||
printf("StreamSend failed, 0x%x!\n", Status);
|
|
||||||
free(SendBufferRaw);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
Error:
|
|
||||||
|
|
||||||
if (QUIC_FAILED(Status)) {
|
|
||||||
MsQuic->ConnectionShutdown(Connection, QUIC_CONNECTION_SHUTDOWN_FLAG_NONE, 0);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// The clients's callback for connection events from MsQuic.
|
|
||||||
//
|
|
||||||
_IRQL_requires_max_(DISPATCH_LEVEL)
|
|
||||||
_Function_class_(QUIC_CONNECTION_CALLBACK)
|
|
||||||
QUIC_STATUS
|
|
||||||
QUIC_API
|
|
||||||
ClientConnectionCallback(
|
|
||||||
_In_ HQUIC Connection,
|
|
||||||
_In_opt_ void* Context,
|
|
||||||
_Inout_ QUIC_CONNECTION_EVENT* Event
|
|
||||||
)
|
|
||||||
{
|
|
||||||
UNREFERENCED_PARAMETER(Context);
|
|
||||||
switch (Event->Type) {
|
|
||||||
case QUIC_CONNECTION_EVENT_CONNECTED:
|
|
||||||
//
|
|
||||||
// The handshake has completed for the connection.
|
|
||||||
//
|
|
||||||
printf("[conn][%p] Connected\n", Connection);
|
|
||||||
ClientSend(Connection);
|
|
||||||
break;
|
|
||||||
case QUIC_CONNECTION_EVENT_SHUTDOWN_INITIATED_BY_TRANSPORT:
|
|
||||||
//
|
|
||||||
// The connection has been shut down by the transport. Generally, this
|
|
||||||
// is the expected way for the connection to shut down with this
|
|
||||||
// protocol, since we let idle timeout kill the connection.
|
|
||||||
//
|
|
||||||
if (Event->SHUTDOWN_INITIATED_BY_TRANSPORT.Status == QUIC_STATUS_CONNECTION_IDLE) {
|
|
||||||
printf("[conn][%p] Successfully shut down on idle.\n", Connection);
|
|
||||||
} else {
|
|
||||||
printf("[conn][%p] Shut down by transport, 0x%x\n", Connection, Event->SHUTDOWN_INITIATED_BY_TRANSPORT.Status);
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
case QUIC_CONNECTION_EVENT_SHUTDOWN_INITIATED_BY_PEER:
|
|
||||||
//
|
|
||||||
// The connection was explicitly shut down by the peer.
|
|
||||||
//
|
|
||||||
printf("[conn][%p] Shut down by peer, 0x%llu\n", Connection, (unsigned long long)Event->SHUTDOWN_INITIATED_BY_PEER.ErrorCode);
|
|
||||||
break;
|
|
||||||
case QUIC_CONNECTION_EVENT_SHUTDOWN_COMPLETE:
|
|
||||||
//
|
|
||||||
// The connection has completed the shutdown process and is ready to be
|
|
||||||
// safely cleaned up.
|
|
||||||
//
|
|
||||||
printf("[conn][%p] All done\n", Connection);
|
|
||||||
if (!Event->SHUTDOWN_COMPLETE.AppCloseInProgress) {
|
|
||||||
MsQuic->ConnectionClose(Connection);
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
case QUIC_CONNECTION_EVENT_RESUMPTION_TICKET_RECEIVED:
|
|
||||||
//
|
|
||||||
// A resumption ticket (also called New Session Ticket or NST) was
|
|
||||||
// received from the server.
|
|
||||||
//
|
|
||||||
printf("[conn][%p] Resumption ticket received (%u bytes):\n", Connection, Event->RESUMPTION_TICKET_RECEIVED.ResumptionTicketLength);
|
|
||||||
for (uint32_t i = 0; i < Event->RESUMPTION_TICKET_RECEIVED.ResumptionTicketLength; i++) {
|
|
||||||
printf("%.2X", (uint8_t)Event->RESUMPTION_TICKET_RECEIVED.ResumptionTicket[i]);
|
|
||||||
}
|
|
||||||
printf("\n");
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
return QUIC_STATUS_SUCCESS;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Helper function to load a client configuration.
|
|
||||||
//
|
|
||||||
BOOLEAN
|
|
||||||
ClientLoadConfiguration(
|
|
||||||
BOOLEAN Unsecure
|
|
||||||
)
|
|
||||||
{
|
|
||||||
QUIC_SETTINGS Settings = {0};
|
|
||||||
//
|
|
||||||
// Configures the client's idle timeout.
|
|
||||||
//
|
|
||||||
Settings.IdleTimeoutMs = IdleTimeoutMs;
|
|
||||||
Settings.IsSet.IdleTimeoutMs = TRUE;
|
|
||||||
|
|
||||||
//
|
|
||||||
// Configures a default client configuration, optionally disabling
|
|
||||||
// server certificate validation.
|
|
||||||
//
|
|
||||||
QUIC_CREDENTIAL_CONFIG CredConfig;
|
|
||||||
memset(&CredConfig, 0, sizeof(CredConfig));
|
|
||||||
CredConfig.Type = QUIC_CREDENTIAL_TYPE_NONE;
|
|
||||||
CredConfig.Flags = QUIC_CREDENTIAL_FLAG_CLIENT;
|
|
||||||
if (Unsecure) {
|
|
||||||
CredConfig.Flags |= QUIC_CREDENTIAL_FLAG_NO_CERTIFICATE_VALIDATION;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Allocate/initialize the configuration object, with the configured ALPN
|
|
||||||
// and settings.
|
|
||||||
//
|
|
||||||
QUIC_STATUS Status = QUIC_STATUS_SUCCESS;
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->ConfigurationOpen(Registration, &Alpn, 1, &Settings, sizeof(Settings), NULL, &Configuration))) {
|
|
||||||
printf("ConfigurationOpen failed, 0x%x!\n", Status);
|
|
||||||
return FALSE;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Loads the TLS credential part of the configuration. This is required even
|
|
||||||
// on client side, to indicate if a certificate is required or not.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->ConfigurationLoadCredential(Configuration, &CredConfig))) {
|
|
||||||
printf("ConfigurationLoadCredential failed, 0x%x!\n", Status);
|
|
||||||
return FALSE;
|
|
||||||
}
|
|
||||||
|
|
||||||
return TRUE;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Runs the client side of the protocol.
|
|
||||||
//
|
|
||||||
void
|
|
||||||
RunClient(
|
|
||||||
_In_ int argc,
|
|
||||||
_In_reads_(argc) _Null_terminated_ char* argv[]
|
|
||||||
)
|
|
||||||
{
|
|
||||||
//
|
|
||||||
// Get the target / server name or IP from the command line.
|
|
||||||
//
|
|
||||||
const char* Target = "";
|
|
||||||
|
|
||||||
//
|
|
||||||
// Load the client configuration based on the "unsecure" command line option.
|
|
||||||
//
|
|
||||||
if (!ClientLoadConfiguration(true)) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
QUIC_STATUS Status;
|
|
||||||
const char* ResumptionTicketString = NULL;
|
|
||||||
HQUIC Connection = NULL;
|
|
||||||
|
|
||||||
//
|
|
||||||
// Allocate a new connection object.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->ConnectionOpen(Registration, ClientConnectionCallback, NULL, &Connection))) {
|
|
||||||
printf("ConnectionOpen failed, 0x%x!\n", Status);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
if ((ResumptionTicketString = NULL) != NULL) {
|
|
||||||
//
|
|
||||||
// If provided at the command line, set the resumption ticket that can
|
|
||||||
// be used to resume a previous session.
|
|
||||||
//
|
|
||||||
uint8_t ResumptionTicket[10240];
|
|
||||||
uint16_t TicketLength = (uint16_t)DecodeHexBuffer(ResumptionTicketString, sizeof(ResumptionTicket), ResumptionTicket);
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->SetParam(Connection, QUIC_PARAM_CONN_RESUMPTION_TICKET, TicketLength, ResumptionTicket))) {
|
|
||||||
printf("SetParam(QUIC_PARAM_CONN_RESUMPTION_TICKET) failed, 0x%x!\n", Status);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
printf("[conn][%p] Connecting...\n", Connection);
|
|
||||||
|
|
||||||
//
|
|
||||||
// Start the connection to the server.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->ConnectionStart(Connection, Configuration, QUIC_ADDRESS_FAMILY_UNSPEC, Target, UdpPort))) {
|
|
||||||
printf("ConnectionStart failed, 0x%x!\n", Status);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
Error:
|
|
||||||
|
|
||||||
if (QUIC_FAILED(Status) && Connection != NULL) {
|
|
||||||
MsQuic->ConnectionClose(Connection);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
HttpClient::HttpClient(QQmlApplicationEngine &engine, QObject *parent)
|
HttpClient::HttpClient(QQmlApplicationEngine &engine, QObject *parent)
|
||||||
: engine(engine), QObject(parent)
|
: engine(engine), QObject(parent)
|
||||||
{
|
{
|
||||||
}
|
}
|
||||||
|
|
||||||
void HttpClient::doGetRequest(QObject *object, QString callback)
|
void HttpClient::doGetRequest(QString url, QObject *object, QString callback)
|
||||||
{
|
{
|
||||||
QVariant res;
|
CURL *curl;
|
||||||
|
CURLcode res;
|
||||||
|
|
||||||
|
curl = curl_easy_init();
|
||||||
|
if(curl) {
|
||||||
|
curl_easy_setopt(curl, CURLOPT_URL, url.toStdString().c_str());
|
||||||
|
|
||||||
|
/* Use HTTP/3 but fallback to earlier HTTP if necessary */
|
||||||
|
curl_easy_setopt(curl, CURLOPT_HTTP_VERSION,
|
||||||
|
(long)CURL_HTTP_VERSION_3);
|
||||||
|
|
||||||
|
/* Perform the request, res will get the return code */
|
||||||
|
res = curl_easy_perform(curl);
|
||||||
|
|
||||||
|
QVariant r;
|
||||||
QMetaObject::invokeMethod(object, callback.toStdString().c_str(),
|
QMetaObject::invokeMethod(object, callback.toStdString().c_str(),
|
||||||
Q_RETURN_ARG(QVariant, res),
|
Q_RETURN_ARG(QVariant, r),
|
||||||
Q_ARG(QVariant, "test"));
|
Q_ARG(QVariant, res==CURLE_OK? "success":"fail"));
|
||||||
|
|
||||||
|
/* always cleanup */
|
||||||
|
curl_easy_cleanup(curl);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -5,7 +5,7 @@
|
||||||
#ifndef AICSKNOWLEDGEBASE_HTTPCLIENT_H
|
#ifndef AICSKNOWLEDGEBASE_HTTPCLIENT_H
|
||||||
#define AICSKNOWLEDGEBASE_HTTPCLIENT_H
|
#define AICSKNOWLEDGEBASE_HTTPCLIENT_H
|
||||||
|
|
||||||
#include <msquic.h>
|
#include <curl/curl.h>
|
||||||
#include <QObject>
|
#include <QObject>
|
||||||
#include <QQmlApplicationEngine>
|
#include <QQmlApplicationEngine>
|
||||||
|
|
||||||
|
|
@ -14,7 +14,7 @@ class HttpClient : public QObject
|
||||||
Q_OBJECT
|
Q_OBJECT
|
||||||
public:
|
public:
|
||||||
explicit HttpClient(QQmlApplicationEngine &engine, QObject *parent = nullptr);
|
explicit HttpClient(QQmlApplicationEngine &engine, QObject *parent = nullptr);
|
||||||
Q_INVOKABLE void doGetRequest(QObject* object, QString callback);
|
Q_INVOKABLE void doGetRequest(QString url, QObject* object, QString callback);
|
||||||
|
|
||||||
private:
|
private:
|
||||||
QQmlApplicationEngine &engine;
|
QQmlApplicationEngine &engine;
|
||||||
|
|
|
||||||
|
|
@ -3,8 +3,5 @@ cmake_minimum_required(VERSION 3.20)
|
||||||
project(AicsKnowledgeBase LANGUAGES CXX)
|
project(AicsKnowledgeBase LANGUAGES CXX)
|
||||||
|
|
||||||
add_subdirectory(FluentUI)
|
add_subdirectory(FluentUI)
|
||||||
|
link_directories(libcurl/lib)
|
||||||
link_directories(msquic/lib)
|
|
||||||
link_directories(msquic/bin)
|
|
||||||
add_subdirectory(AicsKnowledgeBase)
|
add_subdirectory(AicsKnowledgeBase)
|
||||||
add_subdirectory(MsQuicSample)
|
|
||||||
|
|
@ -1,23 +0,0 @@
|
||||||
cmake_minimum_required(VERSION 3.16)
|
|
||||||
|
|
||||||
project(MsQuicSample LANGUAGES CXX)
|
|
||||||
|
|
||||||
set(CMAKE_CXX_STANDARD_REQUIRED ON)
|
|
||||||
|
|
||||||
add_executable(MsQuicSample
|
|
||||||
sample.cpp
|
|
||||||
)
|
|
||||||
|
|
||||||
target_include_directories(MsQuicSample PRIVATE
|
|
||||||
../msquic/include)
|
|
||||||
|
|
||||||
target_link_libraries(MsQuicSample PRIVATE
|
|
||||||
msquic
|
|
||||||
)
|
|
||||||
|
|
||||||
file(GLOB MSQUIC_BIN_FILES ../msquic/bin/*)
|
|
||||||
|
|
||||||
add_custom_command(TARGET MsQuicSample POST_BUILD
|
|
||||||
COMMAND ${CMAKE_COMMAND} -E copy_if_different
|
|
||||||
${MSQUIC_BIN_FILES} ${CMAKE_CURRENT_BINARY_DIR}
|
|
||||||
)
|
|
||||||
|
|
@ -1,907 +0,0 @@
|
||||||
/*++
|
|
||||||
|
|
||||||
Copyright (c) Microsoft Corporation.
|
|
||||||
Licensed under the MIT License.
|
|
||||||
|
|
||||||
Abstract:
|
|
||||||
|
|
||||||
Provides a very simple MsQuic API sample server and client application.
|
|
||||||
|
|
||||||
The quicsample app implements a simple protocol (ALPN "sample") where the
|
|
||||||
client connects to the server, opens a single bidirectional stream, sends
|
|
||||||
some data and shuts down the stream in the send direction. On the server
|
|
||||||
side all connections, streams and data are accepted. After the stream is
|
|
||||||
shut down, the server then sends its own data and shuts down its send
|
|
||||||
direction. The connection only shuts down when the 1 second idle timeout
|
|
||||||
triggers.
|
|
||||||
|
|
||||||
A certificate needs to be available for the server to function.
|
|
||||||
|
|
||||||
On Windows, the following PowerShell command can be used to generate a self
|
|
||||||
signed certificate with the correct settings. This works for both Schannel
|
|
||||||
and OpenSSL TLS providers, assuming the KeyExportPolicy parameter is set to
|
|
||||||
Exportable. The Thumbprint received from the command is then passed to this
|
|
||||||
sample with -cert_hash:PASTE_THE_THUMBPRINT_HERE
|
|
||||||
|
|
||||||
New-SelfSignedCertificate -DnsName $env:computername,localhost -FriendlyName MsQuic-Test -KeyUsageProperty Sign -KeyUsage DigitalSignature -CertStoreLocation cert:\CurrentUser\My -HashAlgorithm SHA256 -Provider "Microsoft Software Key Storage Provider" -KeyExportPolicy Exportable
|
|
||||||
|
|
||||||
On Linux, the following command can be used to generate a self signed
|
|
||||||
certificate that works with the OpenSSL TLS Provider. This can also be used
|
|
||||||
for Windows OpenSSL, however we recommend the certificate store method above
|
|
||||||
for ease of use. Currently key files with password protections are not
|
|
||||||
supported. With these files, they can be passed to the sample with
|
|
||||||
-cert_file:path/to/server.cert -key_file path/to/server.key
|
|
||||||
|
|
||||||
openssl req -nodes -new -x509 -keyout server.key -out server.cert
|
|
||||||
|
|
||||||
--*/
|
|
||||||
|
|
||||||
#ifdef _WIN32
|
|
||||||
//
|
|
||||||
// The conformant preprocessor along with the newest SDK throws this warning for
|
|
||||||
// a macro in C mode. As users might run into this exact bug, exclude this
|
|
||||||
// warning here. This is not an MsQuic bug but a Windows SDK bug.
|
|
||||||
//
|
|
||||||
#pragma warning(disable:5105)
|
|
||||||
#endif
|
|
||||||
#include "msquic.h"
|
|
||||||
#include <stdio.h>
|
|
||||||
#include <stdlib.h>
|
|
||||||
|
|
||||||
#ifndef UNREFERENCED_PARAMETER
|
|
||||||
#define UNREFERENCED_PARAMETER(P) (void)(P)
|
|
||||||
#endif
|
|
||||||
|
|
||||||
//
|
|
||||||
// The (optional) registration configuration for the app. This sets a name for
|
|
||||||
// the app (used for persistent storage and for debugging). It also configures
|
|
||||||
// the execution profile, using the default "low latency" profile.
|
|
||||||
//
|
|
||||||
const QUIC_REGISTRATION_CONFIG RegConfig = { "quicsample", QUIC_EXECUTION_PROFILE_LOW_LATENCY };
|
|
||||||
|
|
||||||
//
|
|
||||||
// The protocol name used in the Application Layer Protocol Negotiation (ALPN).
|
|
||||||
//
|
|
||||||
const QUIC_BUFFER Alpn = { sizeof("sample") - 1, (uint8_t*)"sample" };
|
|
||||||
|
|
||||||
//
|
|
||||||
// The UDP port used by the server side of the protocol.
|
|
||||||
//
|
|
||||||
const uint16_t UdpPort = 4567;
|
|
||||||
|
|
||||||
//
|
|
||||||
// The default idle timeout period (1 second) used for the protocol.
|
|
||||||
//
|
|
||||||
const uint64_t IdleTimeoutMs = 1000;
|
|
||||||
|
|
||||||
//
|
|
||||||
// The length of buffer sent over the streams in the protocol.
|
|
||||||
//
|
|
||||||
const uint32_t SendBufferLength = 100;
|
|
||||||
|
|
||||||
//
|
|
||||||
// The QUIC API/function table returned from MsQuicOpen2. It contains all the
|
|
||||||
// functions called by the app to interact with MsQuic.
|
|
||||||
//
|
|
||||||
const QUIC_API_TABLE* MsQuic;
|
|
||||||
|
|
||||||
//
|
|
||||||
// The QUIC handle to the registration object. This is the top level API object
|
|
||||||
// that represents the execution context for all work done by MsQuic on behalf
|
|
||||||
// of the app.
|
|
||||||
//
|
|
||||||
HQUIC Registration;
|
|
||||||
|
|
||||||
//
|
|
||||||
// The QUIC handle to the configuration object. This object abstracts the
|
|
||||||
// connection configuration. This includes TLS configuration and any other
|
|
||||||
// QUIC layer settings.
|
|
||||||
//
|
|
||||||
HQUIC Configuration;
|
|
||||||
|
|
||||||
void PrintUsage()
|
|
||||||
{
|
|
||||||
printf(
|
|
||||||
"\n"
|
|
||||||
"quicsample runs a simple client or server.\n"
|
|
||||||
"\n"
|
|
||||||
"Usage:\n"
|
|
||||||
"\n"
|
|
||||||
" quicsample.exe -client -unsecure -target:{IPAddress|Hostname} [-ticket:<ticket>]\n"
|
|
||||||
" quicsample.exe -server -cert_hash:<...>\n"
|
|
||||||
" quicsample.exe -server -cert_file:<...> -key_file:<...> [-password:<...>]\n"
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Helper functions to look up a command line arguments.
|
|
||||||
//
|
|
||||||
BOOLEAN
|
|
||||||
GetFlag(
|
|
||||||
_In_ int argc,
|
|
||||||
_In_reads_(argc) _Null_terminated_ char* argv[],
|
|
||||||
_In_z_ const char* name
|
|
||||||
)
|
|
||||||
{
|
|
||||||
const size_t nameLen = strlen(name);
|
|
||||||
for (int i = 0; i < argc; i++) {
|
|
||||||
if (_strnicmp(argv[i] + 1, name, nameLen) == 0
|
|
||||||
&& strlen(argv[i]) == nameLen + 1) {
|
|
||||||
return TRUE;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return FALSE;
|
|
||||||
}
|
|
||||||
|
|
||||||
_Ret_maybenull_ _Null_terminated_ const char*
|
|
||||||
GetValue(
|
|
||||||
_In_ int argc,
|
|
||||||
_In_reads_(argc) _Null_terminated_ char* argv[],
|
|
||||||
_In_z_ const char* name
|
|
||||||
)
|
|
||||||
{
|
|
||||||
const size_t nameLen = strlen(name);
|
|
||||||
for (int i = 0; i < argc; i++) {
|
|
||||||
if (_strnicmp(argv[i] + 1, name, nameLen) == 0
|
|
||||||
&& strlen(argv[i]) > 1 + nameLen + 1
|
|
||||||
&& *(argv[i] + 1 + nameLen) == ':') {
|
|
||||||
return argv[i] + 1 + nameLen + 1;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return NULL;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Helper function to convert a hex character to its decimal value.
|
|
||||||
//
|
|
||||||
uint8_t
|
|
||||||
DecodeHexChar(
|
|
||||||
_In_ char c
|
|
||||||
)
|
|
||||||
{
|
|
||||||
if (c >= '0' && c <= '9') return c - '0';
|
|
||||||
if (c >= 'A' && c <= 'F') return 10 + c - 'A';
|
|
||||||
if (c >= 'a' && c <= 'f') return 10 + c - 'a';
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Helper function to convert a string of hex characters to a byte buffer.
|
|
||||||
//
|
|
||||||
uint32_t
|
|
||||||
DecodeHexBuffer(
|
|
||||||
_In_z_ const char* HexBuffer,
|
|
||||||
_In_ uint32_t OutBufferLen,
|
|
||||||
_Out_writes_to_(OutBufferLen, return)
|
|
||||||
uint8_t* OutBuffer
|
|
||||||
)
|
|
||||||
{
|
|
||||||
uint32_t HexBufferLen = (uint32_t)strlen(HexBuffer) / 2;
|
|
||||||
if (HexBufferLen > OutBufferLen) {
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
for (uint32_t i = 0; i < HexBufferLen; i++) {
|
|
||||||
OutBuffer[i] =
|
|
||||||
(DecodeHexChar(HexBuffer[i * 2]) << 4) |
|
|
||||||
DecodeHexChar(HexBuffer[i * 2 + 1]);
|
|
||||||
}
|
|
||||||
|
|
||||||
return HexBufferLen;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Allocates and sends some data over a QUIC stream.
|
|
||||||
//
|
|
||||||
void
|
|
||||||
ServerSend(
|
|
||||||
_In_ HQUIC Stream
|
|
||||||
)
|
|
||||||
{
|
|
||||||
//
|
|
||||||
// Allocates and builds the buffer to send over the stream.
|
|
||||||
//
|
|
||||||
void* SendBufferRaw = malloc(sizeof(QUIC_BUFFER) + SendBufferLength);
|
|
||||||
if (SendBufferRaw == NULL) {
|
|
||||||
printf("SendBuffer allocation failed!\n");
|
|
||||||
MsQuic->StreamShutdown(Stream, QUIC_STREAM_SHUTDOWN_FLAG_ABORT, 0);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
QUIC_BUFFER* SendBuffer = (QUIC_BUFFER*)SendBufferRaw;
|
|
||||||
SendBuffer->Buffer = (uint8_t*)SendBufferRaw + sizeof(QUIC_BUFFER);
|
|
||||||
SendBuffer->Length = SendBufferLength;
|
|
||||||
|
|
||||||
printf("[strm][%p] Sending data...\n", Stream);
|
|
||||||
|
|
||||||
//
|
|
||||||
// Sends the buffer over the stream. Note the FIN flag is passed along with
|
|
||||||
// the buffer. This indicates this is the last buffer on the stream and the
|
|
||||||
// the stream is shut down (in the send direction) immediately after.
|
|
||||||
//
|
|
||||||
QUIC_STATUS Status;
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->StreamSend(Stream, SendBuffer, 1, QUIC_SEND_FLAG_FIN, SendBuffer))) {
|
|
||||||
printf("StreamSend failed, 0x%x!\n", Status);
|
|
||||||
free(SendBufferRaw);
|
|
||||||
MsQuic->StreamShutdown(Stream, QUIC_STREAM_SHUTDOWN_FLAG_ABORT, 0);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// The server's callback for stream events from MsQuic.
|
|
||||||
//
|
|
||||||
_IRQL_requires_max_(DISPATCH_LEVEL)
|
|
||||||
_Function_class_(QUIC_STREAM_CALLBACK)
|
|
||||||
QUIC_STATUS
|
|
||||||
QUIC_API
|
|
||||||
ServerStreamCallback(
|
|
||||||
_In_ HQUIC Stream,
|
|
||||||
_In_opt_ void* Context,
|
|
||||||
_Inout_ QUIC_STREAM_EVENT* Event
|
|
||||||
)
|
|
||||||
{
|
|
||||||
UNREFERENCED_PARAMETER(Context);
|
|
||||||
switch (Event->Type) {
|
|
||||||
case QUIC_STREAM_EVENT_SEND_COMPLETE:
|
|
||||||
//
|
|
||||||
// A previous StreamSend call has completed, and the context is being
|
|
||||||
// returned back to the app.
|
|
||||||
//
|
|
||||||
free(Event->SEND_COMPLETE.ClientContext);
|
|
||||||
printf("[strm][%p] Data sent\n", Stream);
|
|
||||||
break;
|
|
||||||
case QUIC_STREAM_EVENT_RECEIVE:
|
|
||||||
//
|
|
||||||
// Data was received from the peer on the stream.
|
|
||||||
//
|
|
||||||
printf("[strm][%p] Data received\n", Stream);
|
|
||||||
break;
|
|
||||||
case QUIC_STREAM_EVENT_PEER_SEND_SHUTDOWN:
|
|
||||||
//
|
|
||||||
// The peer gracefully shut down its send direction of the stream.
|
|
||||||
//
|
|
||||||
printf("[strm][%p] Peer shut down\n", Stream);
|
|
||||||
ServerSend(Stream);
|
|
||||||
break;
|
|
||||||
case QUIC_STREAM_EVENT_PEER_SEND_ABORTED:
|
|
||||||
//
|
|
||||||
// The peer aborted its send direction of the stream.
|
|
||||||
//
|
|
||||||
printf("[strm][%p] Peer aborted\n", Stream);
|
|
||||||
MsQuic->StreamShutdown(Stream, QUIC_STREAM_SHUTDOWN_FLAG_ABORT, 0);
|
|
||||||
break;
|
|
||||||
case QUIC_STREAM_EVENT_SHUTDOWN_COMPLETE:
|
|
||||||
//
|
|
||||||
// Both directions of the stream have been shut down and MsQuic is done
|
|
||||||
// with the stream. It can now be safely cleaned up.
|
|
||||||
//
|
|
||||||
printf("[strm][%p] All done\n", Stream);
|
|
||||||
MsQuic->StreamClose(Stream);
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
return QUIC_STATUS_SUCCESS;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// The server's callback for connection events from MsQuic.
|
|
||||||
//
|
|
||||||
_IRQL_requires_max_(DISPATCH_LEVEL)
|
|
||||||
_Function_class_(QUIC_CONNECTION_CALLBACK)
|
|
||||||
QUIC_STATUS
|
|
||||||
QUIC_API
|
|
||||||
ServerConnectionCallback(
|
|
||||||
_In_ HQUIC Connection,
|
|
||||||
_In_opt_ void* Context,
|
|
||||||
_Inout_ QUIC_CONNECTION_EVENT* Event
|
|
||||||
)
|
|
||||||
{
|
|
||||||
UNREFERENCED_PARAMETER(Context);
|
|
||||||
switch (Event->Type) {
|
|
||||||
case QUIC_CONNECTION_EVENT_CONNECTED:
|
|
||||||
//
|
|
||||||
// The handshake has completed for the connection.
|
|
||||||
//
|
|
||||||
printf("[conn][%p] Connected\n", Connection);
|
|
||||||
MsQuic->ConnectionSendResumptionTicket(Connection, QUIC_SEND_RESUMPTION_FLAG_NONE, 0, NULL);
|
|
||||||
break;
|
|
||||||
case QUIC_CONNECTION_EVENT_SHUTDOWN_INITIATED_BY_TRANSPORT:
|
|
||||||
//
|
|
||||||
// The connection has been shut down by the transport. Generally, this
|
|
||||||
// is the expected way for the connection to shut down with this
|
|
||||||
// protocol, since we let idle timeout kill the connection.
|
|
||||||
//
|
|
||||||
if (Event->SHUTDOWN_INITIATED_BY_TRANSPORT.Status == QUIC_STATUS_CONNECTION_IDLE) {
|
|
||||||
printf("[conn][%p] Successfully shut down on idle.\n", Connection);
|
|
||||||
} else {
|
|
||||||
printf("[conn][%p] Shut down by transport, 0x%x\n", Connection, Event->SHUTDOWN_INITIATED_BY_TRANSPORT.Status);
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
case QUIC_CONNECTION_EVENT_SHUTDOWN_INITIATED_BY_PEER:
|
|
||||||
//
|
|
||||||
// The connection was explicitly shut down by the peer.
|
|
||||||
//
|
|
||||||
printf("[conn][%p] Shut down by peer, 0x%llu\n", Connection, (unsigned long long)Event->SHUTDOWN_INITIATED_BY_PEER.ErrorCode);
|
|
||||||
break;
|
|
||||||
case QUIC_CONNECTION_EVENT_SHUTDOWN_COMPLETE:
|
|
||||||
//
|
|
||||||
// The connection has completed the shutdown process and is ready to be
|
|
||||||
// safely cleaned up.
|
|
||||||
//
|
|
||||||
printf("[conn][%p] All done\n", Connection);
|
|
||||||
MsQuic->ConnectionClose(Connection);
|
|
||||||
break;
|
|
||||||
case QUIC_CONNECTION_EVENT_PEER_STREAM_STARTED:
|
|
||||||
//
|
|
||||||
// The peer has started/created a new stream. The app MUST set the
|
|
||||||
// callback handler before returning.
|
|
||||||
//
|
|
||||||
printf("[strm][%p] Peer started\n", Event->PEER_STREAM_STARTED.Stream);
|
|
||||||
MsQuic->SetCallbackHandler(Event->PEER_STREAM_STARTED.Stream, (void*)ServerStreamCallback, NULL);
|
|
||||||
break;
|
|
||||||
case QUIC_CONNECTION_EVENT_RESUMED:
|
|
||||||
//
|
|
||||||
// The connection succeeded in doing a TLS resumption of a previous
|
|
||||||
// connection's session.
|
|
||||||
//
|
|
||||||
printf("[conn][%p] Connection resumed!\n", Connection);
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
return QUIC_STATUS_SUCCESS;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// The server's callback for listener events from MsQuic.
|
|
||||||
//
|
|
||||||
_IRQL_requires_max_(PASSIVE_LEVEL)
|
|
||||||
_Function_class_(QUIC_LISTENER_CALLBACK)
|
|
||||||
QUIC_STATUS
|
|
||||||
QUIC_API
|
|
||||||
ServerListenerCallback(
|
|
||||||
_In_ HQUIC Listener,
|
|
||||||
_In_opt_ void* Context,
|
|
||||||
_Inout_ QUIC_LISTENER_EVENT* Event
|
|
||||||
)
|
|
||||||
{
|
|
||||||
UNREFERENCED_PARAMETER(Listener);
|
|
||||||
UNREFERENCED_PARAMETER(Context);
|
|
||||||
QUIC_STATUS Status = QUIC_STATUS_NOT_SUPPORTED;
|
|
||||||
switch (Event->Type) {
|
|
||||||
case QUIC_LISTENER_EVENT_NEW_CONNECTION:
|
|
||||||
//
|
|
||||||
// A new connection is being attempted by a client. For the handshake to
|
|
||||||
// proceed, the server must provide a configuration for QUIC to use. The
|
|
||||||
// app MUST set the callback handler before returning.
|
|
||||||
//
|
|
||||||
MsQuic->SetCallbackHandler(Event->NEW_CONNECTION.Connection, (void*)ServerConnectionCallback, NULL);
|
|
||||||
Status = MsQuic->ConnectionSetConfiguration(Event->NEW_CONNECTION.Connection, Configuration);
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
return Status;
|
|
||||||
}
|
|
||||||
|
|
||||||
typedef struct QUIC_CREDENTIAL_CONFIG_HELPER {
|
|
||||||
QUIC_CREDENTIAL_CONFIG CredConfig;
|
|
||||||
union {
|
|
||||||
QUIC_CERTIFICATE_HASH CertHash;
|
|
||||||
QUIC_CERTIFICATE_HASH_STORE CertHashStore;
|
|
||||||
QUIC_CERTIFICATE_FILE CertFile;
|
|
||||||
QUIC_CERTIFICATE_FILE_PROTECTED CertFileProtected;
|
|
||||||
};
|
|
||||||
} QUIC_CREDENTIAL_CONFIG_HELPER;
|
|
||||||
|
|
||||||
//
|
|
||||||
// Helper function to load a server configuration. Uses the command line
|
|
||||||
// arguments to load the credential part of the configuration.
|
|
||||||
//
|
|
||||||
BOOLEAN
|
|
||||||
ServerLoadConfiguration(
|
|
||||||
_In_ int argc,
|
|
||||||
_In_reads_(argc) _Null_terminated_ char* argv[]
|
|
||||||
)
|
|
||||||
{
|
|
||||||
QUIC_SETTINGS Settings = {0};
|
|
||||||
//
|
|
||||||
// Configures the server's idle timeout.
|
|
||||||
//
|
|
||||||
Settings.IdleTimeoutMs = IdleTimeoutMs;
|
|
||||||
Settings.IsSet.IdleTimeoutMs = TRUE;
|
|
||||||
//
|
|
||||||
// Configures the server's resumption level to allow for resumption and
|
|
||||||
// 0-RTT.
|
|
||||||
//
|
|
||||||
Settings.ServerResumptionLevel = QUIC_SERVER_RESUME_AND_ZERORTT;
|
|
||||||
Settings.IsSet.ServerResumptionLevel = TRUE;
|
|
||||||
//
|
|
||||||
// Configures the server's settings to allow for the peer to open a single
|
|
||||||
// bidirectional stream. By default connections are not configured to allow
|
|
||||||
// any streams from the peer.
|
|
||||||
//
|
|
||||||
Settings.PeerBidiStreamCount = 1;
|
|
||||||
Settings.IsSet.PeerBidiStreamCount = TRUE;
|
|
||||||
|
|
||||||
QUIC_CREDENTIAL_CONFIG_HELPER Config;
|
|
||||||
memset(&Config, 0, sizeof(Config));
|
|
||||||
Config.CredConfig.Flags = QUIC_CREDENTIAL_FLAG_NONE;
|
|
||||||
|
|
||||||
const char* Cert;
|
|
||||||
const char* KeyFile;
|
|
||||||
if ((Cert = GetValue(argc, argv, "cert_hash")) != NULL) {
|
|
||||||
//
|
|
||||||
// Load the server's certificate from the default certificate store,
|
|
||||||
// using the provided certificate hash.
|
|
||||||
//
|
|
||||||
uint32_t CertHashLen =
|
|
||||||
DecodeHexBuffer(
|
|
||||||
Cert,
|
|
||||||
sizeof(Config.CertHash.ShaHash),
|
|
||||||
Config.CertHash.ShaHash);
|
|
||||||
if (CertHashLen != sizeof(Config.CertHash.ShaHash)) {
|
|
||||||
return FALSE;
|
|
||||||
}
|
|
||||||
Config.CredConfig.Type = QUIC_CREDENTIAL_TYPE_CERTIFICATE_HASH;
|
|
||||||
Config.CredConfig.CertificateHash = &Config.CertHash;
|
|
||||||
|
|
||||||
} else if ((Cert = GetValue(argc, argv, "cert_file")) != NULL &&
|
|
||||||
(KeyFile = GetValue(argc, argv, "key_file")) != NULL) {
|
|
||||||
//
|
|
||||||
// Loads the server's certificate from the file.
|
|
||||||
//
|
|
||||||
const char* Password = GetValue(argc, argv, "password");
|
|
||||||
if (Password != NULL) {
|
|
||||||
Config.CertFileProtected.CertificateFile = (char*)Cert;
|
|
||||||
Config.CertFileProtected.PrivateKeyFile = (char*)KeyFile;
|
|
||||||
Config.CertFileProtected.PrivateKeyPassword = (char*)Password;
|
|
||||||
Config.CredConfig.Type = QUIC_CREDENTIAL_TYPE_CERTIFICATE_FILE_PROTECTED;
|
|
||||||
Config.CredConfig.CertificateFileProtected = &Config.CertFileProtected;
|
|
||||||
} else {
|
|
||||||
Config.CertFile.CertificateFile = (char*)Cert;
|
|
||||||
Config.CertFile.PrivateKeyFile = (char*)KeyFile;
|
|
||||||
Config.CredConfig.Type = QUIC_CREDENTIAL_TYPE_CERTIFICATE_FILE;
|
|
||||||
Config.CredConfig.CertificateFile = &Config.CertFile;
|
|
||||||
}
|
|
||||||
|
|
||||||
} else {
|
|
||||||
printf("Must specify ['-cert_hash'] or ['cert_file' and 'key_file' (and optionally 'password')]!\n");
|
|
||||||
return FALSE;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Allocate/initialize the configuration object, with the configured ALPN
|
|
||||||
// and settings.
|
|
||||||
//
|
|
||||||
QUIC_STATUS Status = QUIC_STATUS_SUCCESS;
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->ConfigurationOpen(Registration, &Alpn, 1, &Settings, sizeof(Settings), NULL, &Configuration))) {
|
|
||||||
printf("ConfigurationOpen failed, 0x%x!\n", Status);
|
|
||||||
return FALSE;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Loads the TLS credential part of the configuration.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->ConfigurationLoadCredential(Configuration, &Config.CredConfig))) {
|
|
||||||
printf("ConfigurationLoadCredential failed, 0x%x!\n", Status);
|
|
||||||
return FALSE;
|
|
||||||
}
|
|
||||||
|
|
||||||
return TRUE;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Runs the server side of the protocol.
|
|
||||||
//
|
|
||||||
void
|
|
||||||
RunServer(
|
|
||||||
_In_ int argc,
|
|
||||||
_In_reads_(argc) _Null_terminated_ char* argv[]
|
|
||||||
)
|
|
||||||
{
|
|
||||||
QUIC_STATUS Status;
|
|
||||||
HQUIC Listener = NULL;
|
|
||||||
|
|
||||||
//
|
|
||||||
// Configures the address used for the listener to listen on all IP
|
|
||||||
// addresses and the given UDP port.
|
|
||||||
//
|
|
||||||
QUIC_ADDR Address = {0};
|
|
||||||
QuicAddrSetFamily(&Address, QUIC_ADDRESS_FAMILY_UNSPEC);
|
|
||||||
QuicAddrSetPort(&Address, UdpPort);
|
|
||||||
|
|
||||||
//
|
|
||||||
// Load the server configuration based on the command line.
|
|
||||||
//
|
|
||||||
if (!ServerLoadConfiguration(argc, argv)) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Create/allocate a new listener object.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->ListenerOpen(Registration, ServerListenerCallback, NULL, &Listener))) {
|
|
||||||
printf("ListenerOpen failed, 0x%x!\n", Status);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Starts listening for incoming connections.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->ListenerStart(Listener, &Alpn, 1, &Address))) {
|
|
||||||
printf("ListenerStart failed, 0x%x!\n", Status);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Continue listening for connections until the Enter key is pressed.
|
|
||||||
//
|
|
||||||
printf("Press Enter to exit.\n\n");
|
|
||||||
getchar();
|
|
||||||
|
|
||||||
Error:
|
|
||||||
|
|
||||||
if (Listener != NULL) {
|
|
||||||
MsQuic->ListenerClose(Listener);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// The clients's callback for stream events from MsQuic.
|
|
||||||
//
|
|
||||||
_IRQL_requires_max_(DISPATCH_LEVEL)
|
|
||||||
_Function_class_(QUIC_STREAM_CALLBACK)
|
|
||||||
QUIC_STATUS
|
|
||||||
QUIC_API
|
|
||||||
ClientStreamCallback(
|
|
||||||
_In_ HQUIC Stream,
|
|
||||||
_In_opt_ void* Context,
|
|
||||||
_Inout_ QUIC_STREAM_EVENT* Event
|
|
||||||
)
|
|
||||||
{
|
|
||||||
UNREFERENCED_PARAMETER(Context);
|
|
||||||
switch (Event->Type) {
|
|
||||||
case QUIC_STREAM_EVENT_SEND_COMPLETE:
|
|
||||||
//
|
|
||||||
// A previous StreamSend call has completed, and the context is being
|
|
||||||
// returned back to the app.
|
|
||||||
//
|
|
||||||
free(Event->SEND_COMPLETE.ClientContext);
|
|
||||||
printf("[strm][%p] Data sent\n", Stream);
|
|
||||||
break;
|
|
||||||
case QUIC_STREAM_EVENT_RECEIVE:
|
|
||||||
//
|
|
||||||
// Data was received from the peer on the stream.
|
|
||||||
//
|
|
||||||
printf("[strm][%p] Data received\n", Stream);
|
|
||||||
break;
|
|
||||||
case QUIC_STREAM_EVENT_PEER_SEND_ABORTED:
|
|
||||||
//
|
|
||||||
// The peer gracefully shut down its send direction of the stream.
|
|
||||||
//
|
|
||||||
printf("[strm][%p] Peer aborted\n", Stream);
|
|
||||||
break;
|
|
||||||
case QUIC_STREAM_EVENT_PEER_SEND_SHUTDOWN:
|
|
||||||
//
|
|
||||||
// The peer aborted its send direction of the stream.
|
|
||||||
//
|
|
||||||
printf("[strm][%p] Peer shut down\n", Stream);
|
|
||||||
break;
|
|
||||||
case QUIC_STREAM_EVENT_SHUTDOWN_COMPLETE:
|
|
||||||
//
|
|
||||||
// Both directions of the stream have been shut down and MsQuic is done
|
|
||||||
// with the stream. It can now be safely cleaned up.
|
|
||||||
//
|
|
||||||
printf("[strm][%p] All done\n", Stream);
|
|
||||||
if (!Event->SHUTDOWN_COMPLETE.AppCloseInProgress) {
|
|
||||||
MsQuic->StreamClose(Stream);
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
return QUIC_STATUS_SUCCESS;
|
|
||||||
}
|
|
||||||
|
|
||||||
void
|
|
||||||
ClientSend(
|
|
||||||
_In_ HQUIC Connection
|
|
||||||
)
|
|
||||||
{
|
|
||||||
QUIC_STATUS Status;
|
|
||||||
HQUIC Stream = NULL;
|
|
||||||
uint8_t* SendBufferRaw;
|
|
||||||
QUIC_BUFFER* SendBuffer;
|
|
||||||
|
|
||||||
//
|
|
||||||
// Create/allocate a new bidirectional stream. The stream is just allocated
|
|
||||||
// and no QUIC stream identifier is assigned until it's started.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->StreamOpen(Connection, QUIC_STREAM_OPEN_FLAG_NONE, ClientStreamCallback, NULL, &Stream))) {
|
|
||||||
printf("StreamOpen failed, 0x%x!\n", Status);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
printf("[strm][%p] Starting...\n", Stream);
|
|
||||||
|
|
||||||
//
|
|
||||||
// Starts the bidirectional stream. By default, the peer is not notified of
|
|
||||||
// the stream being started until data is sent on the stream.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->StreamStart(Stream, QUIC_STREAM_START_FLAG_NONE))) {
|
|
||||||
printf("StreamStart failed, 0x%x!\n", Status);
|
|
||||||
MsQuic->StreamClose(Stream);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Allocates and builds the buffer to send over the stream.
|
|
||||||
//
|
|
||||||
SendBufferRaw = (uint8_t*)malloc(sizeof(QUIC_BUFFER) + SendBufferLength);
|
|
||||||
if (SendBufferRaw == NULL) {
|
|
||||||
printf("SendBuffer allocation failed!\n");
|
|
||||||
Status = QUIC_STATUS_OUT_OF_MEMORY;
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
SendBuffer = (QUIC_BUFFER*)SendBufferRaw;
|
|
||||||
SendBuffer->Buffer = SendBufferRaw + sizeof(QUIC_BUFFER);
|
|
||||||
SendBuffer->Length = SendBufferLength;
|
|
||||||
|
|
||||||
printf("[strm][%p] Sending data...\n", Stream);
|
|
||||||
|
|
||||||
//
|
|
||||||
// Sends the buffer over the stream. Note the FIN flag is passed along with
|
|
||||||
// the buffer. This indicates this is the last buffer on the stream and the
|
|
||||||
// the stream is shut down (in the send direction) immediately after.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->StreamSend(Stream, SendBuffer, 1, QUIC_SEND_FLAG_FIN, SendBuffer))) {
|
|
||||||
printf("StreamSend failed, 0x%x!\n", Status);
|
|
||||||
free(SendBufferRaw);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
Error:
|
|
||||||
|
|
||||||
if (QUIC_FAILED(Status)) {
|
|
||||||
MsQuic->ConnectionShutdown(Connection, QUIC_CONNECTION_SHUTDOWN_FLAG_NONE, 0);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// The clients's callback for connection events from MsQuic.
|
|
||||||
//
|
|
||||||
_IRQL_requires_max_(DISPATCH_LEVEL)
|
|
||||||
_Function_class_(QUIC_CONNECTION_CALLBACK)
|
|
||||||
QUIC_STATUS
|
|
||||||
QUIC_API
|
|
||||||
ClientConnectionCallback(
|
|
||||||
_In_ HQUIC Connection,
|
|
||||||
_In_opt_ void* Context,
|
|
||||||
_Inout_ QUIC_CONNECTION_EVENT* Event
|
|
||||||
)
|
|
||||||
{
|
|
||||||
UNREFERENCED_PARAMETER(Context);
|
|
||||||
switch (Event->Type) {
|
|
||||||
case QUIC_CONNECTION_EVENT_CONNECTED:
|
|
||||||
//
|
|
||||||
// The handshake has completed for the connection.
|
|
||||||
//
|
|
||||||
printf("[conn][%p] Connected\n", Connection);
|
|
||||||
ClientSend(Connection);
|
|
||||||
break;
|
|
||||||
case QUIC_CONNECTION_EVENT_SHUTDOWN_INITIATED_BY_TRANSPORT:
|
|
||||||
//
|
|
||||||
// The connection has been shut down by the transport. Generally, this
|
|
||||||
// is the expected way for the connection to shut down with this
|
|
||||||
// protocol, since we let idle timeout kill the connection.
|
|
||||||
//
|
|
||||||
if (Event->SHUTDOWN_INITIATED_BY_TRANSPORT.Status == QUIC_STATUS_CONNECTION_IDLE) {
|
|
||||||
printf("[conn][%p] Successfully shut down on idle.\n", Connection);
|
|
||||||
} else {
|
|
||||||
printf("[conn][%p] Shut down by transport, 0x%x\n", Connection, Event->SHUTDOWN_INITIATED_BY_TRANSPORT.Status);
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
case QUIC_CONNECTION_EVENT_SHUTDOWN_INITIATED_BY_PEER:
|
|
||||||
//
|
|
||||||
// The connection was explicitly shut down by the peer.
|
|
||||||
//
|
|
||||||
printf("[conn][%p] Shut down by peer, 0x%llu\n", Connection, (unsigned long long)Event->SHUTDOWN_INITIATED_BY_PEER.ErrorCode);
|
|
||||||
break;
|
|
||||||
case QUIC_CONNECTION_EVENT_SHUTDOWN_COMPLETE:
|
|
||||||
//
|
|
||||||
// The connection has completed the shutdown process and is ready to be
|
|
||||||
// safely cleaned up.
|
|
||||||
//
|
|
||||||
printf("[conn][%p] All done\n", Connection);
|
|
||||||
if (!Event->SHUTDOWN_COMPLETE.AppCloseInProgress) {
|
|
||||||
MsQuic->ConnectionClose(Connection);
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
case QUIC_CONNECTION_EVENT_RESUMPTION_TICKET_RECEIVED:
|
|
||||||
//
|
|
||||||
// A resumption ticket (also called New Session Ticket or NST) was
|
|
||||||
// received from the server.
|
|
||||||
//
|
|
||||||
printf("[conn][%p] Resumption ticket received (%u bytes):\n", Connection, Event->RESUMPTION_TICKET_RECEIVED.ResumptionTicketLength);
|
|
||||||
for (uint32_t i = 0; i < Event->RESUMPTION_TICKET_RECEIVED.ResumptionTicketLength; i++) {
|
|
||||||
printf("%.2X", (uint8_t)Event->RESUMPTION_TICKET_RECEIVED.ResumptionTicket[i]);
|
|
||||||
}
|
|
||||||
printf("\n");
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
return QUIC_STATUS_SUCCESS;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Helper function to load a client configuration.
|
|
||||||
//
|
|
||||||
BOOLEAN
|
|
||||||
ClientLoadConfiguration(
|
|
||||||
BOOLEAN Unsecure
|
|
||||||
)
|
|
||||||
{
|
|
||||||
QUIC_SETTINGS Settings = {0};
|
|
||||||
//
|
|
||||||
// Configures the client's idle timeout.
|
|
||||||
//
|
|
||||||
Settings.IdleTimeoutMs = IdleTimeoutMs;
|
|
||||||
Settings.IsSet.IdleTimeoutMs = TRUE;
|
|
||||||
|
|
||||||
//
|
|
||||||
// Configures a default client configuration, optionally disabling
|
|
||||||
// server certificate validation.
|
|
||||||
//
|
|
||||||
QUIC_CREDENTIAL_CONFIG CredConfig;
|
|
||||||
memset(&CredConfig, 0, sizeof(CredConfig));
|
|
||||||
CredConfig.Type = QUIC_CREDENTIAL_TYPE_NONE;
|
|
||||||
CredConfig.Flags = QUIC_CREDENTIAL_FLAG_CLIENT;
|
|
||||||
if (Unsecure) {
|
|
||||||
CredConfig.Flags |= QUIC_CREDENTIAL_FLAG_NO_CERTIFICATE_VALIDATION;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Allocate/initialize the configuration object, with the configured ALPN
|
|
||||||
// and settings.
|
|
||||||
//
|
|
||||||
QUIC_STATUS Status = QUIC_STATUS_SUCCESS;
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->ConfigurationOpen(Registration, &Alpn, 1, &Settings, sizeof(Settings), NULL, &Configuration))) {
|
|
||||||
printf("ConfigurationOpen failed, 0x%x!\n", Status);
|
|
||||||
return FALSE;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Loads the TLS credential part of the configuration. This is required even
|
|
||||||
// on client side, to indicate if a certificate is required or not.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->ConfigurationLoadCredential(Configuration, &CredConfig))) {
|
|
||||||
printf("ConfigurationLoadCredential failed, 0x%x!\n", Status);
|
|
||||||
return FALSE;
|
|
||||||
}
|
|
||||||
|
|
||||||
return TRUE;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Runs the client side of the protocol.
|
|
||||||
//
|
|
||||||
void
|
|
||||||
RunClient(
|
|
||||||
_In_ int argc,
|
|
||||||
_In_reads_(argc) _Null_terminated_ char* argv[]
|
|
||||||
)
|
|
||||||
{
|
|
||||||
//
|
|
||||||
// Load the client configuration based on the "unsecure" command line option.
|
|
||||||
//
|
|
||||||
if (!ClientLoadConfiguration(GetFlag(argc, argv, "unsecure"))) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
QUIC_STATUS Status;
|
|
||||||
const char* ResumptionTicketString = NULL;
|
|
||||||
HQUIC Connection = NULL;
|
|
||||||
|
|
||||||
//
|
|
||||||
// Allocate a new connection object.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->ConnectionOpen(Registration, ClientConnectionCallback, NULL, &Connection))) {
|
|
||||||
printf("ConnectionOpen failed, 0x%x!\n", Status);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
if ((ResumptionTicketString = GetValue(argc, argv, "ticket")) != NULL) {
|
|
||||||
//
|
|
||||||
// If provided at the command line, set the resumption ticket that can
|
|
||||||
// be used to resume a previous session.
|
|
||||||
//
|
|
||||||
uint8_t ResumptionTicket[10240];
|
|
||||||
uint16_t TicketLength = (uint16_t)DecodeHexBuffer(ResumptionTicketString, sizeof(ResumptionTicket), ResumptionTicket);
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->SetParam(Connection, QUIC_PARAM_CONN_RESUMPTION_TICKET, TicketLength, ResumptionTicket))) {
|
|
||||||
printf("SetParam(QUIC_PARAM_CONN_RESUMPTION_TICKET) failed, 0x%x!\n", Status);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Get the target / server name or IP from the command line.
|
|
||||||
//
|
|
||||||
const char* Target;
|
|
||||||
if ((Target = GetValue(argc, argv, "target")) == NULL) {
|
|
||||||
printf("Must specify '-target' argument!\n");
|
|
||||||
Status = QUIC_STATUS_INVALID_PARAMETER;
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
printf("[conn][%p] Connecting...\n", Connection);
|
|
||||||
|
|
||||||
//
|
|
||||||
// Start the connection to the server.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->ConnectionStart(Connection, Configuration, QUIC_ADDRESS_FAMILY_UNSPEC, Target, UdpPort))) {
|
|
||||||
printf("ConnectionStart failed, 0x%x!\n", Status);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
Error:
|
|
||||||
|
|
||||||
if (QUIC_FAILED(Status) && Connection != NULL) {
|
|
||||||
MsQuic->ConnectionClose(Connection);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
int
|
|
||||||
QUIC_MAIN_EXPORT
|
|
||||||
main(
|
|
||||||
_In_ int argc,
|
|
||||||
_In_reads_(argc) _Null_terminated_ char* argv[]
|
|
||||||
)
|
|
||||||
{
|
|
||||||
QUIC_STATUS Status = QUIC_STATUS_SUCCESS;
|
|
||||||
|
|
||||||
//
|
|
||||||
// Open a handle to the library and get the API function table.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuicOpen2(&MsQuic))) {
|
|
||||||
printf("MsQuicOpen2 failed, 0x%x!\n", Status);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Create a registration for the app's connections.
|
|
||||||
//
|
|
||||||
if (QUIC_FAILED(Status = MsQuic->RegistrationOpen(&RegConfig, &Registration))) {
|
|
||||||
printf("RegistrationOpen failed, 0x%x!\n", Status);
|
|
||||||
goto Error;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (GetFlag(argc, argv, "help") || GetFlag(argc, argv, "?")) {
|
|
||||||
PrintUsage();
|
|
||||||
} else if (GetFlag(argc, argv, "client")) {
|
|
||||||
RunClient(argc, argv);
|
|
||||||
} else if (GetFlag(argc, argv, "server")) {
|
|
||||||
RunServer(argc, argv);
|
|
||||||
} else {
|
|
||||||
PrintUsage();
|
|
||||||
}
|
|
||||||
|
|
||||||
Error:
|
|
||||||
|
|
||||||
if (MsQuic != NULL) {
|
|
||||||
if (Configuration != NULL) {
|
|
||||||
MsQuic->ConfigurationClose(Configuration);
|
|
||||||
}
|
|
||||||
if (Registration != NULL) {
|
|
||||||
//
|
|
||||||
// This will block until all outstanding child objects have been
|
|
||||||
// closed.
|
|
||||||
//
|
|
||||||
MsQuic->RegistrationClose(Registration);
|
|
||||||
}
|
|
||||||
MsQuicClose(MsQuic);
|
|
||||||
}
|
|
||||||
|
|
||||||
return (int)Status;
|
|
||||||
}
|
|
||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,79 @@
|
||||||
|
#ifndef CURLINC_CURLVER_H
|
||||||
|
#define CURLINC_CURLVER_H
|
||||||
|
/***************************************************************************
|
||||||
|
* _ _ ____ _
|
||||||
|
* Project ___| | | | _ \| |
|
||||||
|
* / __| | | | |_) | |
|
||||||
|
* | (__| |_| | _ <| |___
|
||||||
|
* \___|\___/|_| \_\_____|
|
||||||
|
*
|
||||||
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
||||||
|
*
|
||||||
|
* This software is licensed as described in the file COPYING, which
|
||||||
|
* you should have received as part of this distribution. The terms
|
||||||
|
* are also available at https://curl.se/docs/copyright.html.
|
||||||
|
*
|
||||||
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
||||||
|
* copies of the Software, and permit persons to whom the Software is
|
||||||
|
* furnished to do so, under the terms of the COPYING file.
|
||||||
|
*
|
||||||
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||||||
|
* KIND, either express or implied.
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: curl
|
||||||
|
*
|
||||||
|
***************************************************************************/
|
||||||
|
|
||||||
|
/* This header file contains nothing but libcurl version info, generated by
|
||||||
|
a script at release-time. This was made its own header file in 7.11.2 */
|
||||||
|
|
||||||
|
/* This is the global package copyright */
|
||||||
|
#define LIBCURL_COPYRIGHT "Daniel Stenberg, <daniel@haxx.se>."
|
||||||
|
|
||||||
|
/* This is the version number of the libcurl package from which this header
|
||||||
|
file origins: */
|
||||||
|
#define LIBCURL_VERSION "8.2.0-DEV"
|
||||||
|
|
||||||
|
/* The numeric version number is also available "in parts" by using these
|
||||||
|
defines: */
|
||||||
|
#define LIBCURL_VERSION_MAJOR 8
|
||||||
|
#define LIBCURL_VERSION_MINOR 2
|
||||||
|
#define LIBCURL_VERSION_PATCH 0
|
||||||
|
|
||||||
|
/* This is the numeric version of the libcurl version number, meant for easier
|
||||||
|
parsing and comparisons by programs. The LIBCURL_VERSION_NUM define will
|
||||||
|
always follow this syntax:
|
||||||
|
|
||||||
|
0xXXYYZZ
|
||||||
|
|
||||||
|
Where XX, YY and ZZ are the main version, release and patch numbers in
|
||||||
|
hexadecimal (using 8 bits each). All three numbers are always represented
|
||||||
|
using two digits. 1.2 would appear as "0x010200" while version 9.11.7
|
||||||
|
appears as "0x090b07".
|
||||||
|
|
||||||
|
This 6-digit (24 bits) hexadecimal number does not show pre-release number,
|
||||||
|
and it is always a greater number in a more recent release. It makes
|
||||||
|
comparisons with greater than and less than work.
|
||||||
|
|
||||||
|
Note: This define is the full hex number and _does not_ use the
|
||||||
|
CURL_VERSION_BITS() macro since curl's own configure script greps for it
|
||||||
|
and needs it to contain the full number.
|
||||||
|
*/
|
||||||
|
#define LIBCURL_VERSION_NUM 0x080200
|
||||||
|
|
||||||
|
/*
|
||||||
|
* This is the date and time when the full source package was created. The
|
||||||
|
* timestamp is not stored in git, as the timestamp is properly set in the
|
||||||
|
* tarballs by the maketgz script.
|
||||||
|
*
|
||||||
|
* The format of the date follows this template:
|
||||||
|
*
|
||||||
|
* "2007-11-23"
|
||||||
|
*/
|
||||||
|
#define LIBCURL_TIMESTAMP "[unreleased]"
|
||||||
|
|
||||||
|
#define CURL_VERSION_BITS(x,y,z) ((x)<<16|(y)<<8|(z))
|
||||||
|
#define CURL_AT_LEAST_VERSION(x,y,z) \
|
||||||
|
(LIBCURL_VERSION_NUM >= CURL_VERSION_BITS(x, y, z))
|
||||||
|
|
||||||
|
#endif /* CURLINC_CURLVER_H */
|
||||||
|
|
@ -0,0 +1,125 @@
|
||||||
|
#ifndef CURLINC_EASY_H
|
||||||
|
#define CURLINC_EASY_H
|
||||||
|
/***************************************************************************
|
||||||
|
* _ _ ____ _
|
||||||
|
* Project ___| | | | _ \| |
|
||||||
|
* / __| | | | |_) | |
|
||||||
|
* | (__| |_| | _ <| |___
|
||||||
|
* \___|\___/|_| \_\_____|
|
||||||
|
*
|
||||||
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
||||||
|
*
|
||||||
|
* This software is licensed as described in the file COPYING, which
|
||||||
|
* you should have received as part of this distribution. The terms
|
||||||
|
* are also available at https://curl.se/docs/copyright.html.
|
||||||
|
*
|
||||||
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
||||||
|
* copies of the Software, and permit persons to whom the Software is
|
||||||
|
* furnished to do so, under the terms of the COPYING file.
|
||||||
|
*
|
||||||
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||||||
|
* KIND, either express or implied.
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: curl
|
||||||
|
*
|
||||||
|
***************************************************************************/
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/* Flag bits in the curl_blob struct: */
|
||||||
|
#define CURL_BLOB_COPY 1 /* tell libcurl to copy the data */
|
||||||
|
#define CURL_BLOB_NOCOPY 0 /* tell libcurl to NOT copy the data */
|
||||||
|
|
||||||
|
struct curl_blob {
|
||||||
|
void *data;
|
||||||
|
size_t len;
|
||||||
|
unsigned int flags; /* bit 0 is defined, the rest are reserved and should be
|
||||||
|
left zeroes */
|
||||||
|
};
|
||||||
|
|
||||||
|
CURL_EXTERN CURL *curl_easy_init(void);
|
||||||
|
CURL_EXTERN CURLcode curl_easy_setopt(CURL *curl, CURLoption option, ...);
|
||||||
|
CURL_EXTERN CURLcode curl_easy_perform(CURL *curl);
|
||||||
|
CURL_EXTERN void curl_easy_cleanup(CURL *curl);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* NAME curl_easy_getinfo()
|
||||||
|
*
|
||||||
|
* DESCRIPTION
|
||||||
|
*
|
||||||
|
* Request internal information from the curl session with this function.
|
||||||
|
* The third argument MUST be pointing to the specific type of the used option
|
||||||
|
* which is documented in each man page of the option. The data pointed to
|
||||||
|
* will be filled in accordingly and can be relied upon only if the function
|
||||||
|
* returns CURLE_OK. This function is intended to get used *AFTER* a performed
|
||||||
|
* transfer, all results from this function are undefined until the transfer
|
||||||
|
* is completed.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ...);
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* NAME curl_easy_duphandle()
|
||||||
|
*
|
||||||
|
* DESCRIPTION
|
||||||
|
*
|
||||||
|
* Creates a new curl session handle with the same options set for the handle
|
||||||
|
* passed in. Duplicating a handle could only be a matter of cloning data and
|
||||||
|
* options, internal state info and things like persistent connections cannot
|
||||||
|
* be transferred. It is useful in multithreaded applications when you can run
|
||||||
|
* curl_easy_duphandle() for each new thread to avoid a series of identical
|
||||||
|
* curl_easy_setopt() invokes in every thread.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURL *curl_easy_duphandle(CURL *curl);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* NAME curl_easy_reset()
|
||||||
|
*
|
||||||
|
* DESCRIPTION
|
||||||
|
*
|
||||||
|
* Re-initializes a CURL handle to the default values. This puts back the
|
||||||
|
* handle to the same state as it was in when it was just created.
|
||||||
|
*
|
||||||
|
* It does keep: live connections, the Session ID cache, the DNS cache and the
|
||||||
|
* cookies.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN void curl_easy_reset(CURL *curl);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* NAME curl_easy_recv()
|
||||||
|
*
|
||||||
|
* DESCRIPTION
|
||||||
|
*
|
||||||
|
* Receives data from the connected socket. Use after successful
|
||||||
|
* curl_easy_perform() with CURLOPT_CONNECT_ONLY option.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLcode curl_easy_recv(CURL *curl, void *buffer, size_t buflen,
|
||||||
|
size_t *n);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* NAME curl_easy_send()
|
||||||
|
*
|
||||||
|
* DESCRIPTION
|
||||||
|
*
|
||||||
|
* Sends data over the connected socket. Use after successful
|
||||||
|
* curl_easy_perform() with CURLOPT_CONNECT_ONLY option.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLcode curl_easy_send(CURL *curl, const void *buffer,
|
||||||
|
size_t buflen, size_t *n);
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* NAME curl_easy_upkeep()
|
||||||
|
*
|
||||||
|
* DESCRIPTION
|
||||||
|
*
|
||||||
|
* Performs connection upkeep for the given session handle.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLcode curl_easy_upkeep(CURL *curl);
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
} /* end of extern "C" */
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
@ -0,0 +1,74 @@
|
||||||
|
#ifndef CURLINC_HEADER_H
|
||||||
|
#define CURLINC_HEADER_H
|
||||||
|
/***************************************************************************
|
||||||
|
* _ _ ____ _
|
||||||
|
* Project ___| | | | _ \| |
|
||||||
|
* / __| | | | |_) | |
|
||||||
|
* | (__| |_| | _ <| |___
|
||||||
|
* \___|\___/|_| \_\_____|
|
||||||
|
*
|
||||||
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
||||||
|
*
|
||||||
|
* This software is licensed as described in the file COPYING, which
|
||||||
|
* you should have received as part of this distribution. The terms
|
||||||
|
* are also available at https://curl.se/docs/copyright.html.
|
||||||
|
*
|
||||||
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
||||||
|
* copies of the Software, and permit persons to whom the Software is
|
||||||
|
* furnished to do so, under the terms of the COPYING file.
|
||||||
|
*
|
||||||
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||||||
|
* KIND, either express or implied.
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: curl
|
||||||
|
*
|
||||||
|
***************************************************************************/
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
|
||||||
|
struct curl_header {
|
||||||
|
char *name; /* this might not use the same case */
|
||||||
|
char *value;
|
||||||
|
size_t amount; /* number of headers using this name */
|
||||||
|
size_t index; /* ... of this instance, 0 or higher */
|
||||||
|
unsigned int origin; /* see bits below */
|
||||||
|
void *anchor; /* handle privately used by libcurl */
|
||||||
|
};
|
||||||
|
|
||||||
|
/* 'origin' bits */
|
||||||
|
#define CURLH_HEADER (1<<0) /* plain server header */
|
||||||
|
#define CURLH_TRAILER (1<<1) /* trailers */
|
||||||
|
#define CURLH_CONNECT (1<<2) /* CONNECT headers */
|
||||||
|
#define CURLH_1XX (1<<3) /* 1xx headers */
|
||||||
|
#define CURLH_PSEUDO (1<<4) /* pseudo headers */
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
CURLHE_OK,
|
||||||
|
CURLHE_BADINDEX, /* header exists but not with this index */
|
||||||
|
CURLHE_MISSING, /* no such header exists */
|
||||||
|
CURLHE_NOHEADERS, /* no headers at all exist (yet) */
|
||||||
|
CURLHE_NOREQUEST, /* no request with this number was used */
|
||||||
|
CURLHE_OUT_OF_MEMORY, /* out of memory while processing */
|
||||||
|
CURLHE_BAD_ARGUMENT, /* a function argument was not okay */
|
||||||
|
CURLHE_NOT_BUILT_IN /* if API was disabled in the build */
|
||||||
|
} CURLHcode;
|
||||||
|
|
||||||
|
CURL_EXTERN CURLHcode curl_easy_header(CURL *easy,
|
||||||
|
const char *name,
|
||||||
|
size_t index,
|
||||||
|
unsigned int origin,
|
||||||
|
int request,
|
||||||
|
struct curl_header **hout);
|
||||||
|
|
||||||
|
CURL_EXTERN struct curl_header *curl_easy_nextheader(CURL *easy,
|
||||||
|
unsigned int origin,
|
||||||
|
int request,
|
||||||
|
struct curl_header *prev);
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
} /* end of extern "C" */
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#endif /* CURLINC_HEADER_H */
|
||||||
|
|
@ -0,0 +1,52 @@
|
||||||
|
#ifndef CURLINC_MPRINTF_H
|
||||||
|
#define CURLINC_MPRINTF_H
|
||||||
|
/***************************************************************************
|
||||||
|
* _ _ ____ _
|
||||||
|
* Project ___| | | | _ \| |
|
||||||
|
* / __| | | | |_) | |
|
||||||
|
* | (__| |_| | _ <| |___
|
||||||
|
* \___|\___/|_| \_\_____|
|
||||||
|
*
|
||||||
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
||||||
|
*
|
||||||
|
* This software is licensed as described in the file COPYING, which
|
||||||
|
* you should have received as part of this distribution. The terms
|
||||||
|
* are also available at https://curl.se/docs/copyright.html.
|
||||||
|
*
|
||||||
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
||||||
|
* copies of the Software, and permit persons to whom the Software is
|
||||||
|
* furnished to do so, under the terms of the COPYING file.
|
||||||
|
*
|
||||||
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||||||
|
* KIND, either express or implied.
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: curl
|
||||||
|
*
|
||||||
|
***************************************************************************/
|
||||||
|
|
||||||
|
#include <stdarg.h>
|
||||||
|
#include <stdio.h> /* needed for FILE */
|
||||||
|
#include "curl.h" /* for CURL_EXTERN */
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
|
||||||
|
CURL_EXTERN int curl_mprintf(const char *format, ...);
|
||||||
|
CURL_EXTERN int curl_mfprintf(FILE *fd, const char *format, ...);
|
||||||
|
CURL_EXTERN int curl_msprintf(char *buffer, const char *format, ...);
|
||||||
|
CURL_EXTERN int curl_msnprintf(char *buffer, size_t maxlength,
|
||||||
|
const char *format, ...);
|
||||||
|
CURL_EXTERN int curl_mvprintf(const char *format, va_list args);
|
||||||
|
CURL_EXTERN int curl_mvfprintf(FILE *fd, const char *format, va_list args);
|
||||||
|
CURL_EXTERN int curl_mvsprintf(char *buffer, const char *format, va_list args);
|
||||||
|
CURL_EXTERN int curl_mvsnprintf(char *buffer, size_t maxlength,
|
||||||
|
const char *format, va_list args);
|
||||||
|
CURL_EXTERN char *curl_maprintf(const char *format, ...);
|
||||||
|
CURL_EXTERN char *curl_mvaprintf(const char *format, va_list args);
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
} /* end of extern "C" */
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#endif /* CURLINC_MPRINTF_H */
|
||||||
|
|
@ -0,0 +1,460 @@
|
||||||
|
#ifndef CURLINC_MULTI_H
|
||||||
|
#define CURLINC_MULTI_H
|
||||||
|
/***************************************************************************
|
||||||
|
* _ _ ____ _
|
||||||
|
* Project ___| | | | _ \| |
|
||||||
|
* / __| | | | |_) | |
|
||||||
|
* | (__| |_| | _ <| |___
|
||||||
|
* \___|\___/|_| \_\_____|
|
||||||
|
*
|
||||||
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
||||||
|
*
|
||||||
|
* This software is licensed as described in the file COPYING, which
|
||||||
|
* you should have received as part of this distribution. The terms
|
||||||
|
* are also available at https://curl.se/docs/copyright.html.
|
||||||
|
*
|
||||||
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
||||||
|
* copies of the Software, and permit persons to whom the Software is
|
||||||
|
* furnished to do so, under the terms of the COPYING file.
|
||||||
|
*
|
||||||
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||||||
|
* KIND, either express or implied.
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: curl
|
||||||
|
*
|
||||||
|
***************************************************************************/
|
||||||
|
/*
|
||||||
|
This is an "external" header file. Don't give away any internals here!
|
||||||
|
|
||||||
|
GOALS
|
||||||
|
|
||||||
|
o Enable a "pull" interface. The application that uses libcurl decides where
|
||||||
|
and when to ask libcurl to get/send data.
|
||||||
|
|
||||||
|
o Enable multiple simultaneous transfers in the same thread without making it
|
||||||
|
complicated for the application.
|
||||||
|
|
||||||
|
o Enable the application to select() on its own file descriptors and curl's
|
||||||
|
file descriptors simultaneous easily.
|
||||||
|
|
||||||
|
*/
|
||||||
|
|
||||||
|
/*
|
||||||
|
* This header file should not really need to include "curl.h" since curl.h
|
||||||
|
* itself includes this file and we expect user applications to do #include
|
||||||
|
* <curl/curl.h> without the need for especially including multi.h.
|
||||||
|
*
|
||||||
|
* For some reason we added this include here at one point, and rather than to
|
||||||
|
* break existing (wrongly written) libcurl applications, we leave it as-is
|
||||||
|
* but with this warning attached.
|
||||||
|
*/
|
||||||
|
#include "curl.h"
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#if defined(BUILDING_LIBCURL) || defined(CURL_STRICTER)
|
||||||
|
typedef struct Curl_multi CURLM;
|
||||||
|
#else
|
||||||
|
typedef void CURLM;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
CURLM_CALL_MULTI_PERFORM = -1, /* please call curl_multi_perform() or
|
||||||
|
curl_multi_socket*() soon */
|
||||||
|
CURLM_OK,
|
||||||
|
CURLM_BAD_HANDLE, /* the passed-in handle is not a valid CURLM handle */
|
||||||
|
CURLM_BAD_EASY_HANDLE, /* an easy handle was not good/valid */
|
||||||
|
CURLM_OUT_OF_MEMORY, /* if you ever get this, you're in deep sh*t */
|
||||||
|
CURLM_INTERNAL_ERROR, /* this is a libcurl bug */
|
||||||
|
CURLM_BAD_SOCKET, /* the passed in socket argument did not match */
|
||||||
|
CURLM_UNKNOWN_OPTION, /* curl_multi_setopt() with unsupported option */
|
||||||
|
CURLM_ADDED_ALREADY, /* an easy handle already added to a multi handle was
|
||||||
|
attempted to get added - again */
|
||||||
|
CURLM_RECURSIVE_API_CALL, /* an api function was called from inside a
|
||||||
|
callback */
|
||||||
|
CURLM_WAKEUP_FAILURE, /* wakeup is unavailable or failed */
|
||||||
|
CURLM_BAD_FUNCTION_ARGUMENT, /* function called with a bad parameter */
|
||||||
|
CURLM_ABORTED_BY_CALLBACK,
|
||||||
|
CURLM_UNRECOVERABLE_POLL,
|
||||||
|
CURLM_LAST
|
||||||
|
} CURLMcode;
|
||||||
|
|
||||||
|
/* just to make code nicer when using curl_multi_socket() you can now check
|
||||||
|
for CURLM_CALL_MULTI_SOCKET too in the same style it works for
|
||||||
|
curl_multi_perform() and CURLM_CALL_MULTI_PERFORM */
|
||||||
|
#define CURLM_CALL_MULTI_SOCKET CURLM_CALL_MULTI_PERFORM
|
||||||
|
|
||||||
|
/* bitmask bits for CURLMOPT_PIPELINING */
|
||||||
|
#define CURLPIPE_NOTHING 0L
|
||||||
|
#define CURLPIPE_HTTP1 1L
|
||||||
|
#define CURLPIPE_MULTIPLEX 2L
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
CURLMSG_NONE, /* first, not used */
|
||||||
|
CURLMSG_DONE, /* This easy handle has completed. 'result' contains
|
||||||
|
the CURLcode of the transfer */
|
||||||
|
CURLMSG_LAST /* last, not used */
|
||||||
|
} CURLMSG;
|
||||||
|
|
||||||
|
struct CURLMsg {
|
||||||
|
CURLMSG msg; /* what this message means */
|
||||||
|
CURL *easy_handle; /* the handle it concerns */
|
||||||
|
union {
|
||||||
|
void *whatever; /* message-specific data */
|
||||||
|
CURLcode result; /* return code for transfer */
|
||||||
|
} data;
|
||||||
|
};
|
||||||
|
typedef struct CURLMsg CURLMsg;
|
||||||
|
|
||||||
|
/* Based on poll(2) structure and values.
|
||||||
|
* We don't use pollfd and POLL* constants explicitly
|
||||||
|
* to cover platforms without poll(). */
|
||||||
|
#define CURL_WAIT_POLLIN 0x0001
|
||||||
|
#define CURL_WAIT_POLLPRI 0x0002
|
||||||
|
#define CURL_WAIT_POLLOUT 0x0004
|
||||||
|
|
||||||
|
struct curl_waitfd {
|
||||||
|
curl_socket_t fd;
|
||||||
|
short events;
|
||||||
|
short revents; /* not supported yet */
|
||||||
|
};
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_init()
|
||||||
|
*
|
||||||
|
* Desc: initialize multi-style curl usage
|
||||||
|
*
|
||||||
|
* Returns: a new CURLM handle to use in all 'curl_multi' functions.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLM *curl_multi_init(void);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_add_handle()
|
||||||
|
*
|
||||||
|
* Desc: add a standard curl handle to the multi stack
|
||||||
|
*
|
||||||
|
* Returns: CURLMcode type, general multi error code.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLMcode curl_multi_add_handle(CURLM *multi_handle,
|
||||||
|
CURL *curl_handle);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_remove_handle()
|
||||||
|
*
|
||||||
|
* Desc: removes a curl handle from the multi stack again
|
||||||
|
*
|
||||||
|
* Returns: CURLMcode type, general multi error code.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLMcode curl_multi_remove_handle(CURLM *multi_handle,
|
||||||
|
CURL *curl_handle);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_fdset()
|
||||||
|
*
|
||||||
|
* Desc: Ask curl for its fd_set sets. The app can use these to select() or
|
||||||
|
* poll() on. We want curl_multi_perform() called as soon as one of
|
||||||
|
* them are ready.
|
||||||
|
*
|
||||||
|
* Returns: CURLMcode type, general multi error code.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLMcode curl_multi_fdset(CURLM *multi_handle,
|
||||||
|
fd_set *read_fd_set,
|
||||||
|
fd_set *write_fd_set,
|
||||||
|
fd_set *exc_fd_set,
|
||||||
|
int *max_fd);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_wait()
|
||||||
|
*
|
||||||
|
* Desc: Poll on all fds within a CURLM set as well as any
|
||||||
|
* additional fds passed to the function.
|
||||||
|
*
|
||||||
|
* Returns: CURLMcode type, general multi error code.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLMcode curl_multi_wait(CURLM *multi_handle,
|
||||||
|
struct curl_waitfd extra_fds[],
|
||||||
|
unsigned int extra_nfds,
|
||||||
|
int timeout_ms,
|
||||||
|
int *ret);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_poll()
|
||||||
|
*
|
||||||
|
* Desc: Poll on all fds within a CURLM set as well as any
|
||||||
|
* additional fds passed to the function.
|
||||||
|
*
|
||||||
|
* Returns: CURLMcode type, general multi error code.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLMcode curl_multi_poll(CURLM *multi_handle,
|
||||||
|
struct curl_waitfd extra_fds[],
|
||||||
|
unsigned int extra_nfds,
|
||||||
|
int timeout_ms,
|
||||||
|
int *ret);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_wakeup()
|
||||||
|
*
|
||||||
|
* Desc: wakes up a sleeping curl_multi_poll call.
|
||||||
|
*
|
||||||
|
* Returns: CURLMcode type, general multi error code.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLMcode curl_multi_wakeup(CURLM *multi_handle);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_perform()
|
||||||
|
*
|
||||||
|
* Desc: When the app thinks there's data available for curl it calls this
|
||||||
|
* function to read/write whatever there is right now. This returns
|
||||||
|
* as soon as the reads and writes are done. This function does not
|
||||||
|
* require that there actually is data available for reading or that
|
||||||
|
* data can be written, it can be called just in case. It returns
|
||||||
|
* the number of handles that still transfer data in the second
|
||||||
|
* argument's integer-pointer.
|
||||||
|
*
|
||||||
|
* Returns: CURLMcode type, general multi error code. *NOTE* that this only
|
||||||
|
* returns errors etc regarding the whole multi stack. There might
|
||||||
|
* still have occurred problems on individual transfers even when
|
||||||
|
* this returns OK.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLMcode curl_multi_perform(CURLM *multi_handle,
|
||||||
|
int *running_handles);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_cleanup()
|
||||||
|
*
|
||||||
|
* Desc: Cleans up and removes a whole multi stack. It does not free or
|
||||||
|
* touch any individual easy handles in any way. We need to define
|
||||||
|
* in what state those handles will be if this function is called
|
||||||
|
* in the middle of a transfer.
|
||||||
|
*
|
||||||
|
* Returns: CURLMcode type, general multi error code.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLMcode curl_multi_cleanup(CURLM *multi_handle);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_info_read()
|
||||||
|
*
|
||||||
|
* Desc: Ask the multi handle if there's any messages/informationals from
|
||||||
|
* the individual transfers. Messages include informationals such as
|
||||||
|
* error code from the transfer or just the fact that a transfer is
|
||||||
|
* completed. More details on these should be written down as well.
|
||||||
|
*
|
||||||
|
* Repeated calls to this function will return a new struct each
|
||||||
|
* time, until a special "end of msgs" struct is returned as a signal
|
||||||
|
* that there is no more to get at this point.
|
||||||
|
*
|
||||||
|
* The data the returned pointer points to will not survive calling
|
||||||
|
* curl_multi_cleanup().
|
||||||
|
*
|
||||||
|
* The 'CURLMsg' struct is meant to be very simple and only contain
|
||||||
|
* very basic information. If more involved information is wanted,
|
||||||
|
* we will provide the particular "transfer handle" in that struct
|
||||||
|
* and that should/could/would be used in subsequent
|
||||||
|
* curl_easy_getinfo() calls (or similar). The point being that we
|
||||||
|
* must never expose complex structs to applications, as then we'll
|
||||||
|
* undoubtably get backwards compatibility problems in the future.
|
||||||
|
*
|
||||||
|
* Returns: A pointer to a filled-in struct, or NULL if it failed or ran out
|
||||||
|
* of structs. It also writes the number of messages left in the
|
||||||
|
* queue (after this read) in the integer the second argument points
|
||||||
|
* to.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLMsg *curl_multi_info_read(CURLM *multi_handle,
|
||||||
|
int *msgs_in_queue);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_strerror()
|
||||||
|
*
|
||||||
|
* Desc: The curl_multi_strerror function may be used to turn a CURLMcode
|
||||||
|
* value into the equivalent human readable error string. This is
|
||||||
|
* useful for printing meaningful error messages.
|
||||||
|
*
|
||||||
|
* Returns: A pointer to a null-terminated error message.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN const char *curl_multi_strerror(CURLMcode);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_socket() and
|
||||||
|
* curl_multi_socket_all()
|
||||||
|
*
|
||||||
|
* Desc: An alternative version of curl_multi_perform() that allows the
|
||||||
|
* application to pass in one of the file descriptors that have been
|
||||||
|
* detected to have "action" on them and let libcurl perform.
|
||||||
|
* See man page for details.
|
||||||
|
*/
|
||||||
|
#define CURL_POLL_NONE 0
|
||||||
|
#define CURL_POLL_IN 1
|
||||||
|
#define CURL_POLL_OUT 2
|
||||||
|
#define CURL_POLL_INOUT 3
|
||||||
|
#define CURL_POLL_REMOVE 4
|
||||||
|
|
||||||
|
#define CURL_SOCKET_TIMEOUT CURL_SOCKET_BAD
|
||||||
|
|
||||||
|
#define CURL_CSELECT_IN 0x01
|
||||||
|
#define CURL_CSELECT_OUT 0x02
|
||||||
|
#define CURL_CSELECT_ERR 0x04
|
||||||
|
|
||||||
|
typedef int (*curl_socket_callback)(CURL *easy, /* easy handle */
|
||||||
|
curl_socket_t s, /* socket */
|
||||||
|
int what, /* see above */
|
||||||
|
void *userp, /* private callback
|
||||||
|
pointer */
|
||||||
|
void *socketp); /* private socket
|
||||||
|
pointer */
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_timer_callback
|
||||||
|
*
|
||||||
|
* Desc: Called by libcurl whenever the library detects a change in the
|
||||||
|
* maximum number of milliseconds the app is allowed to wait before
|
||||||
|
* curl_multi_socket() or curl_multi_perform() must be called
|
||||||
|
* (to allow libcurl's timed events to take place).
|
||||||
|
*
|
||||||
|
* Returns: The callback should return zero.
|
||||||
|
*/
|
||||||
|
typedef int (*curl_multi_timer_callback)(CURLM *multi, /* multi handle */
|
||||||
|
long timeout_ms, /* see above */
|
||||||
|
void *userp); /* private callback
|
||||||
|
pointer */
|
||||||
|
|
||||||
|
CURL_EXTERN CURLMcode CURL_DEPRECATED(7.19.5, "Use curl_multi_socket_action()")
|
||||||
|
curl_multi_socket(CURLM *multi_handle, curl_socket_t s, int *running_handles);
|
||||||
|
|
||||||
|
CURL_EXTERN CURLMcode curl_multi_socket_action(CURLM *multi_handle,
|
||||||
|
curl_socket_t s,
|
||||||
|
int ev_bitmask,
|
||||||
|
int *running_handles);
|
||||||
|
|
||||||
|
CURL_EXTERN CURLMcode CURL_DEPRECATED(7.19.5, "Use curl_multi_socket_action()")
|
||||||
|
curl_multi_socket_all(CURLM *multi_handle, int *running_handles);
|
||||||
|
|
||||||
|
#ifndef CURL_ALLOW_OLD_MULTI_SOCKET
|
||||||
|
/* This macro below was added in 7.16.3 to push users who recompile to use
|
||||||
|
the new curl_multi_socket_action() instead of the old curl_multi_socket()
|
||||||
|
*/
|
||||||
|
#define curl_multi_socket(x,y,z) curl_multi_socket_action(x,y,0,z)
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_timeout()
|
||||||
|
*
|
||||||
|
* Desc: Returns the maximum number of milliseconds the app is allowed to
|
||||||
|
* wait before curl_multi_socket() or curl_multi_perform() must be
|
||||||
|
* called (to allow libcurl's timed events to take place).
|
||||||
|
*
|
||||||
|
* Returns: CURLM error code.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLMcode curl_multi_timeout(CURLM *multi_handle,
|
||||||
|
long *milliseconds);
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
/* This is the socket callback function pointer */
|
||||||
|
CURLOPT(CURLMOPT_SOCKETFUNCTION, CURLOPTTYPE_FUNCTIONPOINT, 1),
|
||||||
|
|
||||||
|
/* This is the argument passed to the socket callback */
|
||||||
|
CURLOPT(CURLMOPT_SOCKETDATA, CURLOPTTYPE_OBJECTPOINT, 2),
|
||||||
|
|
||||||
|
/* set to 1 to enable pipelining for this multi handle */
|
||||||
|
CURLOPT(CURLMOPT_PIPELINING, CURLOPTTYPE_LONG, 3),
|
||||||
|
|
||||||
|
/* This is the timer callback function pointer */
|
||||||
|
CURLOPT(CURLMOPT_TIMERFUNCTION, CURLOPTTYPE_FUNCTIONPOINT, 4),
|
||||||
|
|
||||||
|
/* This is the argument passed to the timer callback */
|
||||||
|
CURLOPT(CURLMOPT_TIMERDATA, CURLOPTTYPE_OBJECTPOINT, 5),
|
||||||
|
|
||||||
|
/* maximum number of entries in the connection cache */
|
||||||
|
CURLOPT(CURLMOPT_MAXCONNECTS, CURLOPTTYPE_LONG, 6),
|
||||||
|
|
||||||
|
/* maximum number of (pipelining) connections to one host */
|
||||||
|
CURLOPT(CURLMOPT_MAX_HOST_CONNECTIONS, CURLOPTTYPE_LONG, 7),
|
||||||
|
|
||||||
|
/* maximum number of requests in a pipeline */
|
||||||
|
CURLOPT(CURLMOPT_MAX_PIPELINE_LENGTH, CURLOPTTYPE_LONG, 8),
|
||||||
|
|
||||||
|
/* a connection with a content-length longer than this
|
||||||
|
will not be considered for pipelining */
|
||||||
|
CURLOPT(CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE, CURLOPTTYPE_OFF_T, 9),
|
||||||
|
|
||||||
|
/* a connection with a chunk length longer than this
|
||||||
|
will not be considered for pipelining */
|
||||||
|
CURLOPT(CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE, CURLOPTTYPE_OFF_T, 10),
|
||||||
|
|
||||||
|
/* a list of site names(+port) that are blocked from pipelining */
|
||||||
|
CURLOPT(CURLMOPT_PIPELINING_SITE_BL, CURLOPTTYPE_OBJECTPOINT, 11),
|
||||||
|
|
||||||
|
/* a list of server types that are blocked from pipelining */
|
||||||
|
CURLOPT(CURLMOPT_PIPELINING_SERVER_BL, CURLOPTTYPE_OBJECTPOINT, 12),
|
||||||
|
|
||||||
|
/* maximum number of open connections in total */
|
||||||
|
CURLOPT(CURLMOPT_MAX_TOTAL_CONNECTIONS, CURLOPTTYPE_LONG, 13),
|
||||||
|
|
||||||
|
/* This is the server push callback function pointer */
|
||||||
|
CURLOPT(CURLMOPT_PUSHFUNCTION, CURLOPTTYPE_FUNCTIONPOINT, 14),
|
||||||
|
|
||||||
|
/* This is the argument passed to the server push callback */
|
||||||
|
CURLOPT(CURLMOPT_PUSHDATA, CURLOPTTYPE_OBJECTPOINT, 15),
|
||||||
|
|
||||||
|
/* maximum number of concurrent streams to support on a connection */
|
||||||
|
CURLOPT(CURLMOPT_MAX_CONCURRENT_STREAMS, CURLOPTTYPE_LONG, 16),
|
||||||
|
|
||||||
|
CURLMOPT_LASTENTRY /* the last unused */
|
||||||
|
} CURLMoption;
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_setopt()
|
||||||
|
*
|
||||||
|
* Desc: Sets options for the multi handle.
|
||||||
|
*
|
||||||
|
* Returns: CURLM error code.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLMcode curl_multi_setopt(CURLM *multi_handle,
|
||||||
|
CURLMoption option, ...);
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_multi_assign()
|
||||||
|
*
|
||||||
|
* Desc: This function sets an association in the multi handle between the
|
||||||
|
* given socket and a private pointer of the application. This is
|
||||||
|
* (only) useful for curl_multi_socket uses.
|
||||||
|
*
|
||||||
|
* Returns: CURLM error code.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLMcode curl_multi_assign(CURLM *multi_handle,
|
||||||
|
curl_socket_t sockfd, void *sockp);
|
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Name: curl_push_callback
|
||||||
|
*
|
||||||
|
* Desc: This callback gets called when a new stream is being pushed by the
|
||||||
|
* server. It approves or denies the new stream. It can also decide
|
||||||
|
* to completely fail the connection.
|
||||||
|
*
|
||||||
|
* Returns: CURL_PUSH_OK, CURL_PUSH_DENY or CURL_PUSH_ERROROUT
|
||||||
|
*/
|
||||||
|
#define CURL_PUSH_OK 0
|
||||||
|
#define CURL_PUSH_DENY 1
|
||||||
|
#define CURL_PUSH_ERROROUT 2 /* added in 7.72.0 */
|
||||||
|
|
||||||
|
struct curl_pushheaders; /* forward declaration only */
|
||||||
|
|
||||||
|
CURL_EXTERN char *curl_pushheader_bynum(struct curl_pushheaders *h,
|
||||||
|
size_t num);
|
||||||
|
CURL_EXTERN char *curl_pushheader_byname(struct curl_pushheaders *h,
|
||||||
|
const char *name);
|
||||||
|
|
||||||
|
typedef int (*curl_push_callback)(CURL *parent,
|
||||||
|
CURL *easy,
|
||||||
|
size_t num_headers,
|
||||||
|
struct curl_pushheaders *headers,
|
||||||
|
void *userp);
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
} /* end of extern "C" */
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
@ -0,0 +1,70 @@
|
||||||
|
#ifndef CURLINC_OPTIONS_H
|
||||||
|
#define CURLINC_OPTIONS_H
|
||||||
|
/***************************************************************************
|
||||||
|
* _ _ ____ _
|
||||||
|
* Project ___| | | | _ \| |
|
||||||
|
* / __| | | | |_) | |
|
||||||
|
* | (__| |_| | _ <| |___
|
||||||
|
* \___|\___/|_| \_\_____|
|
||||||
|
*
|
||||||
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
||||||
|
*
|
||||||
|
* This software is licensed as described in the file COPYING, which
|
||||||
|
* you should have received as part of this distribution. The terms
|
||||||
|
* are also available at https://curl.se/docs/copyright.html.
|
||||||
|
*
|
||||||
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
||||||
|
* copies of the Software, and permit persons to whom the Software is
|
||||||
|
* furnished to do so, under the terms of the COPYING file.
|
||||||
|
*
|
||||||
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||||||
|
* KIND, either express or implied.
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: curl
|
||||||
|
*
|
||||||
|
***************************************************************************/
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
CURLOT_LONG, /* long (a range of values) */
|
||||||
|
CURLOT_VALUES, /* (a defined set or bitmask) */
|
||||||
|
CURLOT_OFF_T, /* curl_off_t (a range of values) */
|
||||||
|
CURLOT_OBJECT, /* pointer (void *) */
|
||||||
|
CURLOT_STRING, /* (char * to null-terminated buffer) */
|
||||||
|
CURLOT_SLIST, /* (struct curl_slist *) */
|
||||||
|
CURLOT_CBPTR, /* (void * passed as-is to a callback) */
|
||||||
|
CURLOT_BLOB, /* blob (struct curl_blob *) */
|
||||||
|
CURLOT_FUNCTION /* function pointer */
|
||||||
|
} curl_easytype;
|
||||||
|
|
||||||
|
/* Flag bits */
|
||||||
|
|
||||||
|
/* "alias" means it is provided for old programs to remain functional,
|
||||||
|
we prefer another name */
|
||||||
|
#define CURLOT_FLAG_ALIAS (1<<0)
|
||||||
|
|
||||||
|
/* The CURLOPTTYPE_* id ranges can still be used to figure out what type/size
|
||||||
|
to use for curl_easy_setopt() for the given id */
|
||||||
|
struct curl_easyoption {
|
||||||
|
const char *name;
|
||||||
|
CURLoption id;
|
||||||
|
curl_easytype type;
|
||||||
|
unsigned int flags;
|
||||||
|
};
|
||||||
|
|
||||||
|
CURL_EXTERN const struct curl_easyoption *
|
||||||
|
curl_easy_option_by_name(const char *name);
|
||||||
|
|
||||||
|
CURL_EXTERN const struct curl_easyoption *
|
||||||
|
curl_easy_option_by_id(CURLoption id);
|
||||||
|
|
||||||
|
CURL_EXTERN const struct curl_easyoption *
|
||||||
|
curl_easy_option_next(const struct curl_easyoption *prev);
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
} /* end of extern "C" */
|
||||||
|
#endif
|
||||||
|
#endif /* CURLINC_OPTIONS_H */
|
||||||
|
|
@ -0,0 +1,35 @@
|
||||||
|
#ifndef CURLINC_STDCHEADERS_H
|
||||||
|
#define CURLINC_STDCHEADERS_H
|
||||||
|
/***************************************************************************
|
||||||
|
* _ _ ____ _
|
||||||
|
* Project ___| | | | _ \| |
|
||||||
|
* / __| | | | |_) | |
|
||||||
|
* | (__| |_| | _ <| |___
|
||||||
|
* \___|\___/|_| \_\_____|
|
||||||
|
*
|
||||||
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
||||||
|
*
|
||||||
|
* This software is licensed as described in the file COPYING, which
|
||||||
|
* you should have received as part of this distribution. The terms
|
||||||
|
* are also available at https://curl.se/docs/copyright.html.
|
||||||
|
*
|
||||||
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
||||||
|
* copies of the Software, and permit persons to whom the Software is
|
||||||
|
* furnished to do so, under the terms of the COPYING file.
|
||||||
|
*
|
||||||
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||||||
|
* KIND, either express or implied.
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: curl
|
||||||
|
*
|
||||||
|
***************************************************************************/
|
||||||
|
|
||||||
|
#include <sys/types.h>
|
||||||
|
|
||||||
|
size_t fread(void *, size_t, size_t, FILE *);
|
||||||
|
size_t fwrite(const void *, size_t, size_t, FILE *);
|
||||||
|
|
||||||
|
int strcasecmp(const char *, const char *);
|
||||||
|
int strncasecmp(const char *, const char *, size_t);
|
||||||
|
|
||||||
|
#endif /* CURLINC_STDCHEADERS_H */
|
||||||
|
|
@ -0,0 +1,503 @@
|
||||||
|
#ifndef CURLINC_SYSTEM_H
|
||||||
|
#define CURLINC_SYSTEM_H
|
||||||
|
/***************************************************************************
|
||||||
|
* _ _ ____ _
|
||||||
|
* Project ___| | | | _ \| |
|
||||||
|
* / __| | | | |_) | |
|
||||||
|
* | (__| |_| | _ <| |___
|
||||||
|
* \___|\___/|_| \_\_____|
|
||||||
|
*
|
||||||
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
||||||
|
*
|
||||||
|
* This software is licensed as described in the file COPYING, which
|
||||||
|
* you should have received as part of this distribution. The terms
|
||||||
|
* are also available at https://curl.se/docs/copyright.html.
|
||||||
|
*
|
||||||
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
||||||
|
* copies of the Software, and permit persons to whom the Software is
|
||||||
|
* furnished to do so, under the terms of the COPYING file.
|
||||||
|
*
|
||||||
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||||||
|
* KIND, either express or implied.
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: curl
|
||||||
|
*
|
||||||
|
***************************************************************************/
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Try to keep one section per platform, compiler and architecture, otherwise,
|
||||||
|
* if an existing section is reused for a different one and later on the
|
||||||
|
* original is adjusted, probably the piggybacking one can be adversely
|
||||||
|
* changed.
|
||||||
|
*
|
||||||
|
* In order to differentiate between platforms/compilers/architectures use
|
||||||
|
* only compiler built in predefined preprocessor symbols.
|
||||||
|
*
|
||||||
|
* curl_off_t
|
||||||
|
* ----------
|
||||||
|
*
|
||||||
|
* For any given platform/compiler curl_off_t must be typedef'ed to a 64-bit
|
||||||
|
* wide signed integral data type. The width of this data type must remain
|
||||||
|
* constant and independent of any possible large file support settings.
|
||||||
|
*
|
||||||
|
* As an exception to the above, curl_off_t shall be typedef'ed to a 32-bit
|
||||||
|
* wide signed integral data type if there is no 64-bit type.
|
||||||
|
*
|
||||||
|
* As a general rule, curl_off_t shall not be mapped to off_t. This rule shall
|
||||||
|
* only be violated if off_t is the only 64-bit data type available and the
|
||||||
|
* size of off_t is independent of large file support settings. Keep your
|
||||||
|
* build on the safe side avoiding an off_t gating. If you have a 64-bit
|
||||||
|
* off_t then take for sure that another 64-bit data type exists, dig deeper
|
||||||
|
* and you will find it.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
|
||||||
|
#if defined(__DJGPP__) || defined(__GO32__)
|
||||||
|
# if defined(__DJGPP__) && (__DJGPP__ > 1)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# else
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# endif
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T int
|
||||||
|
|
||||||
|
#elif defined(__SALFORDC__)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T int
|
||||||
|
|
||||||
|
#elif defined(__BORLANDC__)
|
||||||
|
# if (__BORLANDC__ < 0x520)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# else
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T __int64
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "I64d"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "I64u"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T i64
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ui64
|
||||||
|
# endif
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T int
|
||||||
|
|
||||||
|
#elif defined(__TURBOC__)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T int
|
||||||
|
|
||||||
|
#elif defined(__POCC__)
|
||||||
|
# if (__POCC__ < 280)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# elif defined(_MSC_VER)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T __int64
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "I64d"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "I64u"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T i64
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ui64
|
||||||
|
# else
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# endif
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T int
|
||||||
|
|
||||||
|
#elif defined(__LCC__)
|
||||||
|
# if defined(__MCST__) /* MCST eLbrus Compiler Collection */
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T socklen_t
|
||||||
|
# define CURL_PULL_SYS_TYPES_H 1
|
||||||
|
# define CURL_PULL_SYS_SOCKET_H 1
|
||||||
|
# else /* Local (or Little) C Compiler */
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T int
|
||||||
|
# endif
|
||||||
|
|
||||||
|
#elif defined(__SYMBIAN32__)
|
||||||
|
# if defined(__EABI__) /* Treat all ARM compilers equally */
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# elif defined(__CW32__)
|
||||||
|
# pragma longlong on
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# elif defined(__VC32__)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T __int64
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# endif
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T unsigned int
|
||||||
|
|
||||||
|
#elif defined(macintosh)
|
||||||
|
# include <ConditionalMacros.h>
|
||||||
|
# if TYPE_LONGLONG
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# else
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# endif
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T unsigned int
|
||||||
|
|
||||||
|
#elif defined(__TANDEM)
|
||||||
|
# if ! defined(__LP64)
|
||||||
|
/* Required for 32-bit NonStop builds only. */
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T int
|
||||||
|
# endif
|
||||||
|
|
||||||
|
#elif defined(_WIN32_WCE)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T __int64
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "I64d"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "I64u"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T i64
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ui64
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T int
|
||||||
|
|
||||||
|
#elif defined(__MINGW32__)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "I64d"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "I64u"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T socklen_t
|
||||||
|
# define CURL_PULL_SYS_TYPES_H 1
|
||||||
|
# define CURL_PULL_WS2TCPIP_H 1
|
||||||
|
|
||||||
|
#elif defined(__VMS)
|
||||||
|
# if defined(__VAX)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# else
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# endif
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T unsigned int
|
||||||
|
|
||||||
|
#elif defined(__OS400__)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T socklen_t
|
||||||
|
# define CURL_PULL_SYS_TYPES_H 1
|
||||||
|
# define CURL_PULL_SYS_SOCKET_H 1
|
||||||
|
|
||||||
|
#elif defined(__MVS__)
|
||||||
|
# if defined(_LONG_LONG)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# elif defined(_LP64)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# else
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# endif
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T socklen_t
|
||||||
|
# define CURL_PULL_SYS_TYPES_H 1
|
||||||
|
# define CURL_PULL_SYS_SOCKET_H 1
|
||||||
|
|
||||||
|
#elif defined(__370__)
|
||||||
|
# if defined(__IBMC__) || defined(__IBMCPP__)
|
||||||
|
# if defined(_ILP32)
|
||||||
|
# elif defined(_LP64)
|
||||||
|
# endif
|
||||||
|
# if defined(_LONG_LONG)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# elif defined(_LP64)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# else
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# endif
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T socklen_t
|
||||||
|
# define CURL_PULL_SYS_TYPES_H 1
|
||||||
|
# define CURL_PULL_SYS_SOCKET_H 1
|
||||||
|
# endif
|
||||||
|
|
||||||
|
#elif defined(TPF)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T int
|
||||||
|
|
||||||
|
#elif defined(__TINYC__) /* also known as tcc */
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T socklen_t
|
||||||
|
# define CURL_PULL_SYS_TYPES_H 1
|
||||||
|
# define CURL_PULL_SYS_SOCKET_H 1
|
||||||
|
|
||||||
|
#elif defined(__SUNPRO_C) || defined(__SUNPRO_CC) /* Oracle Solaris Studio */
|
||||||
|
# if !defined(__LP64) && (defined(__ILP32) || \
|
||||||
|
defined(__i386) || \
|
||||||
|
defined(__sparcv8) || \
|
||||||
|
defined(__sparcv8plus))
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# elif defined(__LP64) || \
|
||||||
|
defined(__amd64) || defined(__sparcv9)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# endif
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T socklen_t
|
||||||
|
# define CURL_PULL_SYS_TYPES_H 1
|
||||||
|
# define CURL_PULL_SYS_SOCKET_H 1
|
||||||
|
|
||||||
|
#elif defined(__xlc__) /* IBM xlc compiler */
|
||||||
|
# if !defined(_LP64)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# else
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# endif
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T socklen_t
|
||||||
|
# define CURL_PULL_SYS_TYPES_H 1
|
||||||
|
# define CURL_PULL_SYS_SOCKET_H 1
|
||||||
|
|
||||||
|
/* ===================================== */
|
||||||
|
/* KEEP MSVC THE PENULTIMATE ENTRY */
|
||||||
|
/* ===================================== */
|
||||||
|
|
||||||
|
#elif defined(_MSC_VER)
|
||||||
|
# if (_MSC_VER >= 900) && (_INTEGRAL_MAX_BITS >= 64)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T __int64
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "I64d"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "I64u"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T i64
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ui64
|
||||||
|
# else
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# endif
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T int
|
||||||
|
|
||||||
|
/* ===================================== */
|
||||||
|
/* KEEP GENERIC GCC THE LAST ENTRY */
|
||||||
|
/* ===================================== */
|
||||||
|
|
||||||
|
#elif defined(__GNUC__) && !defined(_SCO_DS)
|
||||||
|
# if !defined(__LP64__) && \
|
||||||
|
(defined(__ILP32__) || defined(__i386__) || defined(__hppa__) || \
|
||||||
|
defined(__ppc__) || defined(__powerpc__) || defined(__arm__) || \
|
||||||
|
defined(__sparc__) || defined(__mips__) || defined(__sh__) || \
|
||||||
|
defined(__XTENSA__) || \
|
||||||
|
(defined(__SIZEOF_LONG__) && __SIZEOF_LONG__ == 4) || \
|
||||||
|
(defined(__LONG_MAX__) && __LONG_MAX__ == 2147483647L))
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "lld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "llu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T LL
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU ULL
|
||||||
|
# elif defined(__LP64__) || \
|
||||||
|
defined(__x86_64__) || defined(__ppc64__) || defined(__sparc64__) || \
|
||||||
|
defined(__e2k__) || \
|
||||||
|
(defined(__SIZEOF_LONG__) && __SIZEOF_LONG__ == 8) || \
|
||||||
|
(defined(__LONG_MAX__) && __LONG_MAX__ == 9223372036854775807L)
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# endif
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T socklen_t
|
||||||
|
# define CURL_PULL_SYS_TYPES_H 1
|
||||||
|
# define CURL_PULL_SYS_SOCKET_H 1
|
||||||
|
|
||||||
|
#else
|
||||||
|
/* generic "safe guess" on old 32 bit style */
|
||||||
|
# define CURL_TYPEOF_CURL_OFF_T long
|
||||||
|
# define CURL_FORMAT_CURL_OFF_T "ld"
|
||||||
|
# define CURL_FORMAT_CURL_OFF_TU "lu"
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_T L
|
||||||
|
# define CURL_SUFFIX_CURL_OFF_TU UL
|
||||||
|
# define CURL_TYPEOF_CURL_SOCKLEN_T int
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifdef _AIX
|
||||||
|
/* AIX needs <sys/poll.h> */
|
||||||
|
#define CURL_PULL_SYS_POLL_H
|
||||||
|
#endif
|
||||||
|
|
||||||
|
|
||||||
|
/* CURL_PULL_WS2TCPIP_H is defined above when inclusion of header file */
|
||||||
|
/* ws2tcpip.h is required here to properly make type definitions below. */
|
||||||
|
#ifdef CURL_PULL_WS2TCPIP_H
|
||||||
|
# include <winsock2.h>
|
||||||
|
# include <windows.h>
|
||||||
|
# include <ws2tcpip.h>
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/* CURL_PULL_SYS_TYPES_H is defined above when inclusion of header file */
|
||||||
|
/* sys/types.h is required here to properly make type definitions below. */
|
||||||
|
#ifdef CURL_PULL_SYS_TYPES_H
|
||||||
|
# include <sys/types.h>
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/* CURL_PULL_SYS_SOCKET_H is defined above when inclusion of header file */
|
||||||
|
/* sys/socket.h is required here to properly make type definitions below. */
|
||||||
|
#ifdef CURL_PULL_SYS_SOCKET_H
|
||||||
|
# include <sys/socket.h>
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/* CURL_PULL_SYS_POLL_H is defined above when inclusion of header file */
|
||||||
|
/* sys/poll.h is required here to properly make type definitions below. */
|
||||||
|
#ifdef CURL_PULL_SYS_POLL_H
|
||||||
|
# include <sys/poll.h>
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/* Data type definition of curl_socklen_t. */
|
||||||
|
#ifdef CURL_TYPEOF_CURL_SOCKLEN_T
|
||||||
|
typedef CURL_TYPEOF_CURL_SOCKLEN_T curl_socklen_t;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/* Data type definition of curl_off_t. */
|
||||||
|
|
||||||
|
#ifdef CURL_TYPEOF_CURL_OFF_T
|
||||||
|
typedef CURL_TYPEOF_CURL_OFF_T curl_off_t;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/*
|
||||||
|
* CURL_ISOCPP and CURL_OFF_T_C definitions are done here in order to allow
|
||||||
|
* these to be visible and exported by the external libcurl interface API,
|
||||||
|
* while also making them visible to the library internals, simply including
|
||||||
|
* curl_setup.h, without actually needing to include curl.h internally.
|
||||||
|
* If some day this section would grow big enough, all this should be moved
|
||||||
|
* to its own header file.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Figure out if we can use the ## preprocessor operator, which is supported
|
||||||
|
* by ISO/ANSI C and C++. Some compilers support it without setting __STDC__
|
||||||
|
* or __cplusplus so we need to carefully check for them too.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#if defined(__STDC__) || defined(_MSC_VER) || defined(__cplusplus) || \
|
||||||
|
defined(__HP_aCC) || defined(__BORLANDC__) || defined(__LCC__) || \
|
||||||
|
defined(__POCC__) || defined(__SALFORDC__) || defined(__HIGHC__) || \
|
||||||
|
defined(__ILEC400__)
|
||||||
|
/* This compiler is believed to have an ISO compatible preprocessor */
|
||||||
|
#define CURL_ISOCPP
|
||||||
|
#else
|
||||||
|
/* This compiler is believed NOT to have an ISO compatible preprocessor */
|
||||||
|
#undef CURL_ISOCPP
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Macros for minimum-width signed and unsigned curl_off_t integer constants.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#if defined(__BORLANDC__) && (__BORLANDC__ == 0x0551)
|
||||||
|
# define CURLINC_OFF_T_C_HLPR2(x) x
|
||||||
|
# define CURLINC_OFF_T_C_HLPR1(x) CURLINC_OFF_T_C_HLPR2(x)
|
||||||
|
# define CURL_OFF_T_C(Val) CURLINC_OFF_T_C_HLPR1(Val) ## \
|
||||||
|
CURLINC_OFF_T_C_HLPR1(CURL_SUFFIX_CURL_OFF_T)
|
||||||
|
# define CURL_OFF_TU_C(Val) CURLINC_OFF_T_C_HLPR1(Val) ## \
|
||||||
|
CURLINC_OFF_T_C_HLPR1(CURL_SUFFIX_CURL_OFF_TU)
|
||||||
|
#else
|
||||||
|
# ifdef CURL_ISOCPP
|
||||||
|
# define CURLINC_OFF_T_C_HLPR2(Val,Suffix) Val ## Suffix
|
||||||
|
# else
|
||||||
|
# define CURLINC_OFF_T_C_HLPR2(Val,Suffix) Val/**/Suffix
|
||||||
|
# endif
|
||||||
|
# define CURLINC_OFF_T_C_HLPR1(Val,Suffix) CURLINC_OFF_T_C_HLPR2(Val,Suffix)
|
||||||
|
# define CURL_OFF_T_C(Val) CURLINC_OFF_T_C_HLPR1(Val,CURL_SUFFIX_CURL_OFF_T)
|
||||||
|
# define CURL_OFF_TU_C(Val) CURLINC_OFF_T_C_HLPR1(Val,CURL_SUFFIX_CURL_OFF_TU)
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#endif /* CURLINC_SYSTEM_H */
|
||||||
|
|
@ -0,0 +1,717 @@
|
||||||
|
#ifndef CURLINC_TYPECHECK_GCC_H
|
||||||
|
#define CURLINC_TYPECHECK_GCC_H
|
||||||
|
/***************************************************************************
|
||||||
|
* _ _ ____ _
|
||||||
|
* Project ___| | | | _ \| |
|
||||||
|
* / __| | | | |_) | |
|
||||||
|
* | (__| |_| | _ <| |___
|
||||||
|
* \___|\___/|_| \_\_____|
|
||||||
|
*
|
||||||
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
||||||
|
*
|
||||||
|
* This software is licensed as described in the file COPYING, which
|
||||||
|
* you should have received as part of this distribution. The terms
|
||||||
|
* are also available at https://curl.se/docs/copyright.html.
|
||||||
|
*
|
||||||
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
||||||
|
* copies of the Software, and permit persons to whom the Software is
|
||||||
|
* furnished to do so, under the terms of the COPYING file.
|
||||||
|
*
|
||||||
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||||||
|
* KIND, either express or implied.
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: curl
|
||||||
|
*
|
||||||
|
***************************************************************************/
|
||||||
|
|
||||||
|
/* wraps curl_easy_setopt() with typechecking */
|
||||||
|
|
||||||
|
/* To add a new kind of warning, add an
|
||||||
|
* if(curlcheck_sometype_option(_curl_opt))
|
||||||
|
* if(!curlcheck_sometype(value))
|
||||||
|
* _curl_easy_setopt_err_sometype();
|
||||||
|
* block and define curlcheck_sometype_option, curlcheck_sometype and
|
||||||
|
* _curl_easy_setopt_err_sometype below
|
||||||
|
*
|
||||||
|
* NOTE: We use two nested 'if' statements here instead of the && operator, in
|
||||||
|
* order to work around gcc bug #32061. It affects only gcc 4.3.x/4.4.x
|
||||||
|
* when compiling with -Wlogical-op.
|
||||||
|
*
|
||||||
|
* To add an option that uses the same type as an existing option, you'll just
|
||||||
|
* need to extend the appropriate _curl_*_option macro
|
||||||
|
*/
|
||||||
|
#define curl_easy_setopt(handle, option, value) \
|
||||||
|
__extension__({ \
|
||||||
|
CURLoption _curl_opt = (option); \
|
||||||
|
if(__builtin_constant_p(_curl_opt)) { \
|
||||||
|
CURL_IGNORE_DEPRECATION( \
|
||||||
|
if(curlcheck_long_option(_curl_opt)) \
|
||||||
|
if(!curlcheck_long(value)) \
|
||||||
|
_curl_easy_setopt_err_long(); \
|
||||||
|
if(curlcheck_off_t_option(_curl_opt)) \
|
||||||
|
if(!curlcheck_off_t(value)) \
|
||||||
|
_curl_easy_setopt_err_curl_off_t(); \
|
||||||
|
if(curlcheck_string_option(_curl_opt)) \
|
||||||
|
if(!curlcheck_string(value)) \
|
||||||
|
_curl_easy_setopt_err_string(); \
|
||||||
|
if(curlcheck_write_cb_option(_curl_opt)) \
|
||||||
|
if(!curlcheck_write_cb(value)) \
|
||||||
|
_curl_easy_setopt_err_write_callback(); \
|
||||||
|
if((_curl_opt) == CURLOPT_RESOLVER_START_FUNCTION) \
|
||||||
|
if(!curlcheck_resolver_start_callback(value)) \
|
||||||
|
_curl_easy_setopt_err_resolver_start_callback(); \
|
||||||
|
if((_curl_opt) == CURLOPT_READFUNCTION) \
|
||||||
|
if(!curlcheck_read_cb(value)) \
|
||||||
|
_curl_easy_setopt_err_read_cb(); \
|
||||||
|
if((_curl_opt) == CURLOPT_IOCTLFUNCTION) \
|
||||||
|
if(!curlcheck_ioctl_cb(value)) \
|
||||||
|
_curl_easy_setopt_err_ioctl_cb(); \
|
||||||
|
if((_curl_opt) == CURLOPT_SOCKOPTFUNCTION) \
|
||||||
|
if(!curlcheck_sockopt_cb(value)) \
|
||||||
|
_curl_easy_setopt_err_sockopt_cb(); \
|
||||||
|
if((_curl_opt) == CURLOPT_OPENSOCKETFUNCTION) \
|
||||||
|
if(!curlcheck_opensocket_cb(value)) \
|
||||||
|
_curl_easy_setopt_err_opensocket_cb(); \
|
||||||
|
if((_curl_opt) == CURLOPT_PROGRESSFUNCTION) \
|
||||||
|
if(!curlcheck_progress_cb(value)) \
|
||||||
|
_curl_easy_setopt_err_progress_cb(); \
|
||||||
|
if((_curl_opt) == CURLOPT_DEBUGFUNCTION) \
|
||||||
|
if(!curlcheck_debug_cb(value)) \
|
||||||
|
_curl_easy_setopt_err_debug_cb(); \
|
||||||
|
if((_curl_opt) == CURLOPT_SSL_CTX_FUNCTION) \
|
||||||
|
if(!curlcheck_ssl_ctx_cb(value)) \
|
||||||
|
_curl_easy_setopt_err_ssl_ctx_cb(); \
|
||||||
|
if(curlcheck_conv_cb_option(_curl_opt)) \
|
||||||
|
if(!curlcheck_conv_cb(value)) \
|
||||||
|
_curl_easy_setopt_err_conv_cb(); \
|
||||||
|
if((_curl_opt) == CURLOPT_SEEKFUNCTION) \
|
||||||
|
if(!curlcheck_seek_cb(value)) \
|
||||||
|
_curl_easy_setopt_err_seek_cb(); \
|
||||||
|
if(curlcheck_cb_data_option(_curl_opt)) \
|
||||||
|
if(!curlcheck_cb_data(value)) \
|
||||||
|
_curl_easy_setopt_err_cb_data(); \
|
||||||
|
if((_curl_opt) == CURLOPT_ERRORBUFFER) \
|
||||||
|
if(!curlcheck_error_buffer(value)) \
|
||||||
|
_curl_easy_setopt_err_error_buffer(); \
|
||||||
|
if((_curl_opt) == CURLOPT_STDERR) \
|
||||||
|
if(!curlcheck_FILE(value)) \
|
||||||
|
_curl_easy_setopt_err_FILE(); \
|
||||||
|
if(curlcheck_postfields_option(_curl_opt)) \
|
||||||
|
if(!curlcheck_postfields(value)) \
|
||||||
|
_curl_easy_setopt_err_postfields(); \
|
||||||
|
if((_curl_opt) == CURLOPT_HTTPPOST) \
|
||||||
|
if(!curlcheck_arr((value), struct curl_httppost)) \
|
||||||
|
_curl_easy_setopt_err_curl_httpost(); \
|
||||||
|
if((_curl_opt) == CURLOPT_MIMEPOST) \
|
||||||
|
if(!curlcheck_ptr((value), curl_mime)) \
|
||||||
|
_curl_easy_setopt_err_curl_mimepost(); \
|
||||||
|
if(curlcheck_slist_option(_curl_opt)) \
|
||||||
|
if(!curlcheck_arr((value), struct curl_slist)) \
|
||||||
|
_curl_easy_setopt_err_curl_slist(); \
|
||||||
|
if((_curl_opt) == CURLOPT_SHARE) \
|
||||||
|
if(!curlcheck_ptr((value), CURLSH)) \
|
||||||
|
_curl_easy_setopt_err_CURLSH(); \
|
||||||
|
) \
|
||||||
|
} \
|
||||||
|
curl_easy_setopt(handle, _curl_opt, value); \
|
||||||
|
})
|
||||||
|
|
||||||
|
/* wraps curl_easy_getinfo() with typechecking */
|
||||||
|
#define curl_easy_getinfo(handle, info, arg) \
|
||||||
|
__extension__({ \
|
||||||
|
CURLINFO _curl_info = (info); \
|
||||||
|
if(__builtin_constant_p(_curl_info)) { \
|
||||||
|
CURL_IGNORE_DEPRECATION( \
|
||||||
|
if(curlcheck_string_info(_curl_info)) \
|
||||||
|
if(!curlcheck_arr((arg), char *)) \
|
||||||
|
_curl_easy_getinfo_err_string(); \
|
||||||
|
if(curlcheck_long_info(_curl_info)) \
|
||||||
|
if(!curlcheck_arr((arg), long)) \
|
||||||
|
_curl_easy_getinfo_err_long(); \
|
||||||
|
if(curlcheck_double_info(_curl_info)) \
|
||||||
|
if(!curlcheck_arr((arg), double)) \
|
||||||
|
_curl_easy_getinfo_err_double(); \
|
||||||
|
if(curlcheck_slist_info(_curl_info)) \
|
||||||
|
if(!curlcheck_arr((arg), struct curl_slist *)) \
|
||||||
|
_curl_easy_getinfo_err_curl_slist(); \
|
||||||
|
if(curlcheck_tlssessioninfo_info(_curl_info)) \
|
||||||
|
if(!curlcheck_arr((arg), struct curl_tlssessioninfo *)) \
|
||||||
|
_curl_easy_getinfo_err_curl_tlssesssioninfo(); \
|
||||||
|
if(curlcheck_certinfo_info(_curl_info)) \
|
||||||
|
if(!curlcheck_arr((arg), struct curl_certinfo *)) \
|
||||||
|
_curl_easy_getinfo_err_curl_certinfo(); \
|
||||||
|
if(curlcheck_socket_info(_curl_info)) \
|
||||||
|
if(!curlcheck_arr((arg), curl_socket_t)) \
|
||||||
|
_curl_easy_getinfo_err_curl_socket(); \
|
||||||
|
if(curlcheck_off_t_info(_curl_info)) \
|
||||||
|
if(!curlcheck_arr((arg), curl_off_t)) \
|
||||||
|
_curl_easy_getinfo_err_curl_off_t(); \
|
||||||
|
) \
|
||||||
|
} \
|
||||||
|
curl_easy_getinfo(handle, _curl_info, arg); \
|
||||||
|
})
|
||||||
|
|
||||||
|
/*
|
||||||
|
* For now, just make sure that the functions are called with three arguments
|
||||||
|
*/
|
||||||
|
#define curl_share_setopt(share,opt,param) curl_share_setopt(share,opt,param)
|
||||||
|
#define curl_multi_setopt(handle,opt,param) curl_multi_setopt(handle,opt,param)
|
||||||
|
|
||||||
|
|
||||||
|
/* the actual warnings, triggered by calling the _curl_easy_setopt_err*
|
||||||
|
* functions */
|
||||||
|
|
||||||
|
/* To define a new warning, use _CURL_WARNING(identifier, "message") */
|
||||||
|
#define CURLWARNING(id, message) \
|
||||||
|
static void __attribute__((__warning__(message))) \
|
||||||
|
__attribute__((__unused__)) __attribute__((__noinline__)) \
|
||||||
|
id(void) { __asm__(""); }
|
||||||
|
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_long,
|
||||||
|
"curl_easy_setopt expects a long argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_curl_off_t,
|
||||||
|
"curl_easy_setopt expects a curl_off_t argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_string,
|
||||||
|
"curl_easy_setopt expects a "
|
||||||
|
"string ('char *' or char[]) argument for this option"
|
||||||
|
)
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_write_callback,
|
||||||
|
"curl_easy_setopt expects a curl_write_callback argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_resolver_start_callback,
|
||||||
|
"curl_easy_setopt expects a "
|
||||||
|
"curl_resolver_start_callback argument for this option"
|
||||||
|
)
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_read_cb,
|
||||||
|
"curl_easy_setopt expects a curl_read_callback argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_ioctl_cb,
|
||||||
|
"curl_easy_setopt expects a curl_ioctl_callback argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_sockopt_cb,
|
||||||
|
"curl_easy_setopt expects a curl_sockopt_callback argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_opensocket_cb,
|
||||||
|
"curl_easy_setopt expects a "
|
||||||
|
"curl_opensocket_callback argument for this option"
|
||||||
|
)
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_progress_cb,
|
||||||
|
"curl_easy_setopt expects a curl_progress_callback argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_debug_cb,
|
||||||
|
"curl_easy_setopt expects a curl_debug_callback argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_ssl_ctx_cb,
|
||||||
|
"curl_easy_setopt expects a curl_ssl_ctx_callback argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_conv_cb,
|
||||||
|
"curl_easy_setopt expects a curl_conv_callback argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_seek_cb,
|
||||||
|
"curl_easy_setopt expects a curl_seek_callback argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_cb_data,
|
||||||
|
"curl_easy_setopt expects a "
|
||||||
|
"private data pointer as argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_error_buffer,
|
||||||
|
"curl_easy_setopt expects a "
|
||||||
|
"char buffer of CURL_ERROR_SIZE as argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_FILE,
|
||||||
|
"curl_easy_setopt expects a 'FILE *' argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_postfields,
|
||||||
|
"curl_easy_setopt expects a 'void *' or 'char *' argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_curl_httpost,
|
||||||
|
"curl_easy_setopt expects a 'struct curl_httppost *' "
|
||||||
|
"argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_curl_mimepost,
|
||||||
|
"curl_easy_setopt expects a 'curl_mime *' "
|
||||||
|
"argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_curl_slist,
|
||||||
|
"curl_easy_setopt expects a 'struct curl_slist *' argument for this option")
|
||||||
|
CURLWARNING(_curl_easy_setopt_err_CURLSH,
|
||||||
|
"curl_easy_setopt expects a CURLSH* argument for this option")
|
||||||
|
|
||||||
|
CURLWARNING(_curl_easy_getinfo_err_string,
|
||||||
|
"curl_easy_getinfo expects a pointer to 'char *' for this info")
|
||||||
|
CURLWARNING(_curl_easy_getinfo_err_long,
|
||||||
|
"curl_easy_getinfo expects a pointer to long for this info")
|
||||||
|
CURLWARNING(_curl_easy_getinfo_err_double,
|
||||||
|
"curl_easy_getinfo expects a pointer to double for this info")
|
||||||
|
CURLWARNING(_curl_easy_getinfo_err_curl_slist,
|
||||||
|
"curl_easy_getinfo expects a pointer to 'struct curl_slist *' for this info")
|
||||||
|
CURLWARNING(_curl_easy_getinfo_err_curl_tlssesssioninfo,
|
||||||
|
"curl_easy_getinfo expects a pointer to "
|
||||||
|
"'struct curl_tlssessioninfo *' for this info")
|
||||||
|
CURLWARNING(_curl_easy_getinfo_err_curl_certinfo,
|
||||||
|
"curl_easy_getinfo expects a pointer to "
|
||||||
|
"'struct curl_certinfo *' for this info")
|
||||||
|
CURLWARNING(_curl_easy_getinfo_err_curl_socket,
|
||||||
|
"curl_easy_getinfo expects a pointer to curl_socket_t for this info")
|
||||||
|
CURLWARNING(_curl_easy_getinfo_err_curl_off_t,
|
||||||
|
"curl_easy_getinfo expects a pointer to curl_off_t for this info")
|
||||||
|
|
||||||
|
/* groups of curl_easy_setops options that take the same type of argument */
|
||||||
|
|
||||||
|
/* To add a new option to one of the groups, just add
|
||||||
|
* (option) == CURLOPT_SOMETHING
|
||||||
|
* to the or-expression. If the option takes a long or curl_off_t, you don't
|
||||||
|
* have to do anything
|
||||||
|
*/
|
||||||
|
|
||||||
|
/* evaluates to true if option takes a long argument */
|
||||||
|
#define curlcheck_long_option(option) \
|
||||||
|
(0 < (option) && (option) < CURLOPTTYPE_OBJECTPOINT)
|
||||||
|
|
||||||
|
#define curlcheck_off_t_option(option) \
|
||||||
|
(((option) > CURLOPTTYPE_OFF_T) && ((option) < CURLOPTTYPE_BLOB))
|
||||||
|
|
||||||
|
/* evaluates to true if option takes a char* argument */
|
||||||
|
#define curlcheck_string_option(option) \
|
||||||
|
((option) == CURLOPT_ABSTRACT_UNIX_SOCKET || \
|
||||||
|
(option) == CURLOPT_ACCEPT_ENCODING || \
|
||||||
|
(option) == CURLOPT_ALTSVC || \
|
||||||
|
(option) == CURLOPT_CAINFO || \
|
||||||
|
(option) == CURLOPT_CAPATH || \
|
||||||
|
(option) == CURLOPT_COOKIE || \
|
||||||
|
(option) == CURLOPT_COOKIEFILE || \
|
||||||
|
(option) == CURLOPT_COOKIEJAR || \
|
||||||
|
(option) == CURLOPT_COOKIELIST || \
|
||||||
|
(option) == CURLOPT_CRLFILE || \
|
||||||
|
(option) == CURLOPT_CUSTOMREQUEST || \
|
||||||
|
(option) == CURLOPT_DEFAULT_PROTOCOL || \
|
||||||
|
(option) == CURLOPT_DNS_INTERFACE || \
|
||||||
|
(option) == CURLOPT_DNS_LOCAL_IP4 || \
|
||||||
|
(option) == CURLOPT_DNS_LOCAL_IP6 || \
|
||||||
|
(option) == CURLOPT_DNS_SERVERS || \
|
||||||
|
(option) == CURLOPT_DOH_URL || \
|
||||||
|
(option) == CURLOPT_EGDSOCKET || \
|
||||||
|
(option) == CURLOPT_FTP_ACCOUNT || \
|
||||||
|
(option) == CURLOPT_FTP_ALTERNATIVE_TO_USER || \
|
||||||
|
(option) == CURLOPT_FTPPORT || \
|
||||||
|
(option) == CURLOPT_HSTS || \
|
||||||
|
(option) == CURLOPT_HAPROXY_CLIENT_IP || \
|
||||||
|
(option) == CURLOPT_INTERFACE || \
|
||||||
|
(option) == CURLOPT_ISSUERCERT || \
|
||||||
|
(option) == CURLOPT_KEYPASSWD || \
|
||||||
|
(option) == CURLOPT_KRBLEVEL || \
|
||||||
|
(option) == CURLOPT_LOGIN_OPTIONS || \
|
||||||
|
(option) == CURLOPT_MAIL_AUTH || \
|
||||||
|
(option) == CURLOPT_MAIL_FROM || \
|
||||||
|
(option) == CURLOPT_NETRC_FILE || \
|
||||||
|
(option) == CURLOPT_NOPROXY || \
|
||||||
|
(option) == CURLOPT_PASSWORD || \
|
||||||
|
(option) == CURLOPT_PINNEDPUBLICKEY || \
|
||||||
|
(option) == CURLOPT_PRE_PROXY || \
|
||||||
|
(option) == CURLOPT_PROTOCOLS_STR || \
|
||||||
|
(option) == CURLOPT_PROXY || \
|
||||||
|
(option) == CURLOPT_PROXY_CAINFO || \
|
||||||
|
(option) == CURLOPT_PROXY_CAPATH || \
|
||||||
|
(option) == CURLOPT_PROXY_CRLFILE || \
|
||||||
|
(option) == CURLOPT_PROXY_ISSUERCERT || \
|
||||||
|
(option) == CURLOPT_PROXY_KEYPASSWD || \
|
||||||
|
(option) == CURLOPT_PROXY_PINNEDPUBLICKEY || \
|
||||||
|
(option) == CURLOPT_PROXY_SERVICE_NAME || \
|
||||||
|
(option) == CURLOPT_PROXY_SSL_CIPHER_LIST || \
|
||||||
|
(option) == CURLOPT_PROXY_SSLCERT || \
|
||||||
|
(option) == CURLOPT_PROXY_SSLCERTTYPE || \
|
||||||
|
(option) == CURLOPT_PROXY_SSLKEY || \
|
||||||
|
(option) == CURLOPT_PROXY_SSLKEYTYPE || \
|
||||||
|
(option) == CURLOPT_PROXY_TLS13_CIPHERS || \
|
||||||
|
(option) == CURLOPT_PROXY_TLSAUTH_PASSWORD || \
|
||||||
|
(option) == CURLOPT_PROXY_TLSAUTH_TYPE || \
|
||||||
|
(option) == CURLOPT_PROXY_TLSAUTH_USERNAME || \
|
||||||
|
(option) == CURLOPT_PROXYPASSWORD || \
|
||||||
|
(option) == CURLOPT_PROXYUSERNAME || \
|
||||||
|
(option) == CURLOPT_PROXYUSERPWD || \
|
||||||
|
(option) == CURLOPT_RANDOM_FILE || \
|
||||||
|
(option) == CURLOPT_RANGE || \
|
||||||
|
(option) == CURLOPT_REDIR_PROTOCOLS_STR || \
|
||||||
|
(option) == CURLOPT_REFERER || \
|
||||||
|
(option) == CURLOPT_REQUEST_TARGET || \
|
||||||
|
(option) == CURLOPT_RTSP_SESSION_ID || \
|
||||||
|
(option) == CURLOPT_RTSP_STREAM_URI || \
|
||||||
|
(option) == CURLOPT_RTSP_TRANSPORT || \
|
||||||
|
(option) == CURLOPT_SASL_AUTHZID || \
|
||||||
|
(option) == CURLOPT_SERVICE_NAME || \
|
||||||
|
(option) == CURLOPT_SOCKS5_GSSAPI_SERVICE || \
|
||||||
|
(option) == CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 || \
|
||||||
|
(option) == CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256 || \
|
||||||
|
(option) == CURLOPT_SSH_KNOWNHOSTS || \
|
||||||
|
(option) == CURLOPT_SSH_PRIVATE_KEYFILE || \
|
||||||
|
(option) == CURLOPT_SSH_PUBLIC_KEYFILE || \
|
||||||
|
(option) == CURLOPT_SSLCERT || \
|
||||||
|
(option) == CURLOPT_SSLCERTTYPE || \
|
||||||
|
(option) == CURLOPT_SSLENGINE || \
|
||||||
|
(option) == CURLOPT_SSLKEY || \
|
||||||
|
(option) == CURLOPT_SSLKEYTYPE || \
|
||||||
|
(option) == CURLOPT_SSL_CIPHER_LIST || \
|
||||||
|
(option) == CURLOPT_TLS13_CIPHERS || \
|
||||||
|
(option) == CURLOPT_TLSAUTH_PASSWORD || \
|
||||||
|
(option) == CURLOPT_TLSAUTH_TYPE || \
|
||||||
|
(option) == CURLOPT_TLSAUTH_USERNAME || \
|
||||||
|
(option) == CURLOPT_UNIX_SOCKET_PATH || \
|
||||||
|
(option) == CURLOPT_URL || \
|
||||||
|
(option) == CURLOPT_USERAGENT || \
|
||||||
|
(option) == CURLOPT_USERNAME || \
|
||||||
|
(option) == CURLOPT_AWS_SIGV4 || \
|
||||||
|
(option) == CURLOPT_USERPWD || \
|
||||||
|
(option) == CURLOPT_XOAUTH2_BEARER || \
|
||||||
|
(option) == CURLOPT_SSL_EC_CURVES || \
|
||||||
|
0)
|
||||||
|
|
||||||
|
/* evaluates to true if option takes a curl_write_callback argument */
|
||||||
|
#define curlcheck_write_cb_option(option) \
|
||||||
|
((option) == CURLOPT_HEADERFUNCTION || \
|
||||||
|
(option) == CURLOPT_WRITEFUNCTION)
|
||||||
|
|
||||||
|
/* evaluates to true if option takes a curl_conv_callback argument */
|
||||||
|
#define curlcheck_conv_cb_option(option) \
|
||||||
|
((option) == CURLOPT_CONV_TO_NETWORK_FUNCTION || \
|
||||||
|
(option) == CURLOPT_CONV_FROM_NETWORK_FUNCTION || \
|
||||||
|
(option) == CURLOPT_CONV_FROM_UTF8_FUNCTION)
|
||||||
|
|
||||||
|
/* evaluates to true if option takes a data argument to pass to a callback */
|
||||||
|
#define curlcheck_cb_data_option(option) \
|
||||||
|
((option) == CURLOPT_CHUNK_DATA || \
|
||||||
|
(option) == CURLOPT_CLOSESOCKETDATA || \
|
||||||
|
(option) == CURLOPT_DEBUGDATA || \
|
||||||
|
(option) == CURLOPT_FNMATCH_DATA || \
|
||||||
|
(option) == CURLOPT_HEADERDATA || \
|
||||||
|
(option) == CURLOPT_HSTSREADDATA || \
|
||||||
|
(option) == CURLOPT_HSTSWRITEDATA || \
|
||||||
|
(option) == CURLOPT_INTERLEAVEDATA || \
|
||||||
|
(option) == CURLOPT_IOCTLDATA || \
|
||||||
|
(option) == CURLOPT_OPENSOCKETDATA || \
|
||||||
|
(option) == CURLOPT_PREREQDATA || \
|
||||||
|
(option) == CURLOPT_PROGRESSDATA || \
|
||||||
|
(option) == CURLOPT_READDATA || \
|
||||||
|
(option) == CURLOPT_SEEKDATA || \
|
||||||
|
(option) == CURLOPT_SOCKOPTDATA || \
|
||||||
|
(option) == CURLOPT_SSH_KEYDATA || \
|
||||||
|
(option) == CURLOPT_SSL_CTX_DATA || \
|
||||||
|
(option) == CURLOPT_WRITEDATA || \
|
||||||
|
(option) == CURLOPT_RESOLVER_START_DATA || \
|
||||||
|
(option) == CURLOPT_TRAILERDATA || \
|
||||||
|
(option) == CURLOPT_SSH_HOSTKEYDATA || \
|
||||||
|
0)
|
||||||
|
|
||||||
|
/* evaluates to true if option takes a POST data argument (void* or char*) */
|
||||||
|
#define curlcheck_postfields_option(option) \
|
||||||
|
((option) == CURLOPT_POSTFIELDS || \
|
||||||
|
(option) == CURLOPT_COPYPOSTFIELDS || \
|
||||||
|
0)
|
||||||
|
|
||||||
|
/* evaluates to true if option takes a struct curl_slist * argument */
|
||||||
|
#define curlcheck_slist_option(option) \
|
||||||
|
((option) == CURLOPT_HTTP200ALIASES || \
|
||||||
|
(option) == CURLOPT_HTTPHEADER || \
|
||||||
|
(option) == CURLOPT_MAIL_RCPT || \
|
||||||
|
(option) == CURLOPT_POSTQUOTE || \
|
||||||
|
(option) == CURLOPT_PREQUOTE || \
|
||||||
|
(option) == CURLOPT_PROXYHEADER || \
|
||||||
|
(option) == CURLOPT_QUOTE || \
|
||||||
|
(option) == CURLOPT_RESOLVE || \
|
||||||
|
(option) == CURLOPT_TELNETOPTIONS || \
|
||||||
|
(option) == CURLOPT_CONNECT_TO || \
|
||||||
|
0)
|
||||||
|
|
||||||
|
/* groups of curl_easy_getinfo infos that take the same type of argument */
|
||||||
|
|
||||||
|
/* evaluates to true if info expects a pointer to char * argument */
|
||||||
|
#define curlcheck_string_info(info) \
|
||||||
|
(CURLINFO_STRING < (info) && (info) < CURLINFO_LONG && \
|
||||||
|
(info) != CURLINFO_PRIVATE)
|
||||||
|
|
||||||
|
/* evaluates to true if info expects a pointer to long argument */
|
||||||
|
#define curlcheck_long_info(info) \
|
||||||
|
(CURLINFO_LONG < (info) && (info) < CURLINFO_DOUBLE)
|
||||||
|
|
||||||
|
/* evaluates to true if info expects a pointer to double argument */
|
||||||
|
#define curlcheck_double_info(info) \
|
||||||
|
(CURLINFO_DOUBLE < (info) && (info) < CURLINFO_SLIST)
|
||||||
|
|
||||||
|
/* true if info expects a pointer to struct curl_slist * argument */
|
||||||
|
#define curlcheck_slist_info(info) \
|
||||||
|
(((info) == CURLINFO_SSL_ENGINES) || ((info) == CURLINFO_COOKIELIST))
|
||||||
|
|
||||||
|
/* true if info expects a pointer to struct curl_tlssessioninfo * argument */
|
||||||
|
#define curlcheck_tlssessioninfo_info(info) \
|
||||||
|
(((info) == CURLINFO_TLS_SSL_PTR) || ((info) == CURLINFO_TLS_SESSION))
|
||||||
|
|
||||||
|
/* true if info expects a pointer to struct curl_certinfo * argument */
|
||||||
|
#define curlcheck_certinfo_info(info) ((info) == CURLINFO_CERTINFO)
|
||||||
|
|
||||||
|
/* true if info expects a pointer to struct curl_socket_t argument */
|
||||||
|
#define curlcheck_socket_info(info) \
|
||||||
|
(CURLINFO_SOCKET < (info) && (info) < CURLINFO_OFF_T)
|
||||||
|
|
||||||
|
/* true if info expects a pointer to curl_off_t argument */
|
||||||
|
#define curlcheck_off_t_info(info) \
|
||||||
|
(CURLINFO_OFF_T < (info))
|
||||||
|
|
||||||
|
|
||||||
|
/* typecheck helpers -- check whether given expression has requested type */
|
||||||
|
|
||||||
|
/* For pointers, you can use the curlcheck_ptr/curlcheck_arr macros,
|
||||||
|
* otherwise define a new macro. Search for __builtin_types_compatible_p
|
||||||
|
* in the GCC manual.
|
||||||
|
* NOTE: these macros MUST NOT EVALUATE their arguments! The argument is
|
||||||
|
* the actual expression passed to the curl_easy_setopt macro. This
|
||||||
|
* means that you can only apply the sizeof and __typeof__ operators, no
|
||||||
|
* == or whatsoever.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/* XXX: should evaluate to true if expr is a pointer */
|
||||||
|
#define curlcheck_any_ptr(expr) \
|
||||||
|
(sizeof(expr) == sizeof(void *))
|
||||||
|
|
||||||
|
/* evaluates to true if expr is NULL */
|
||||||
|
/* XXX: must not evaluate expr, so this check is not accurate */
|
||||||
|
#define curlcheck_NULL(expr) \
|
||||||
|
(__builtin_types_compatible_p(__typeof__(expr), __typeof__(NULL)))
|
||||||
|
|
||||||
|
/* evaluates to true if expr is type*, const type* or NULL */
|
||||||
|
#define curlcheck_ptr(expr, type) \
|
||||||
|
(curlcheck_NULL(expr) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), type *) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), const type *))
|
||||||
|
|
||||||
|
/* evaluates to true if expr is one of type[], type*, NULL or const type* */
|
||||||
|
#define curlcheck_arr(expr, type) \
|
||||||
|
(curlcheck_ptr((expr), type) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), type []))
|
||||||
|
|
||||||
|
/* evaluates to true if expr is a string */
|
||||||
|
#define curlcheck_string(expr) \
|
||||||
|
(curlcheck_arr((expr), char) || \
|
||||||
|
curlcheck_arr((expr), signed char) || \
|
||||||
|
curlcheck_arr((expr), unsigned char))
|
||||||
|
|
||||||
|
/* evaluates to true if expr is a long (no matter the signedness)
|
||||||
|
* XXX: for now, int is also accepted (and therefore short and char, which
|
||||||
|
* are promoted to int when passed to a variadic function) */
|
||||||
|
#define curlcheck_long(expr) \
|
||||||
|
(__builtin_types_compatible_p(__typeof__(expr), long) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), signed long) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), unsigned long) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), int) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), signed int) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), unsigned int) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), short) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), signed short) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), unsigned short) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), char) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), signed char) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), unsigned char))
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type curl_off_t */
|
||||||
|
#define curlcheck_off_t(expr) \
|
||||||
|
(__builtin_types_compatible_p(__typeof__(expr), curl_off_t))
|
||||||
|
|
||||||
|
/* evaluates to true if expr is abuffer suitable for CURLOPT_ERRORBUFFER */
|
||||||
|
/* XXX: also check size of an char[] array? */
|
||||||
|
#define curlcheck_error_buffer(expr) \
|
||||||
|
(curlcheck_NULL(expr) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), char *) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(expr), char[]))
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type (const) void* or (const) FILE* */
|
||||||
|
#if 0
|
||||||
|
#define curlcheck_cb_data(expr) \
|
||||||
|
(curlcheck_ptr((expr), void) || \
|
||||||
|
curlcheck_ptr((expr), FILE))
|
||||||
|
#else /* be less strict */
|
||||||
|
#define curlcheck_cb_data(expr) \
|
||||||
|
curlcheck_any_ptr(expr)
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type FILE* */
|
||||||
|
#define curlcheck_FILE(expr) \
|
||||||
|
(curlcheck_NULL(expr) || \
|
||||||
|
(__builtin_types_compatible_p(__typeof__(expr), FILE *)))
|
||||||
|
|
||||||
|
/* evaluates to true if expr can be passed as POST data (void* or char*) */
|
||||||
|
#define curlcheck_postfields(expr) \
|
||||||
|
(curlcheck_ptr((expr), void) || \
|
||||||
|
curlcheck_arr((expr), char) || \
|
||||||
|
curlcheck_arr((expr), unsigned char))
|
||||||
|
|
||||||
|
/* helper: __builtin_types_compatible_p distinguishes between functions and
|
||||||
|
* function pointers, hide it */
|
||||||
|
#define curlcheck_cb_compatible(func, type) \
|
||||||
|
(__builtin_types_compatible_p(__typeof__(func), type) || \
|
||||||
|
__builtin_types_compatible_p(__typeof__(func) *, type))
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type curl_resolver_start_callback */
|
||||||
|
#define curlcheck_resolver_start_callback(expr) \
|
||||||
|
(curlcheck_NULL(expr) || \
|
||||||
|
curlcheck_cb_compatible((expr), curl_resolver_start_callback))
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type curl_read_callback or "similar" */
|
||||||
|
#define curlcheck_read_cb(expr) \
|
||||||
|
(curlcheck_NULL(expr) || \
|
||||||
|
curlcheck_cb_compatible((expr), __typeof__(fread) *) || \
|
||||||
|
curlcheck_cb_compatible((expr), curl_read_callback) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_read_callback1) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_read_callback2) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_read_callback3) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_read_callback4) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_read_callback5) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_read_callback6))
|
||||||
|
typedef size_t (*_curl_read_callback1)(char *, size_t, size_t, void *);
|
||||||
|
typedef size_t (*_curl_read_callback2)(char *, size_t, size_t, const void *);
|
||||||
|
typedef size_t (*_curl_read_callback3)(char *, size_t, size_t, FILE *);
|
||||||
|
typedef size_t (*_curl_read_callback4)(void *, size_t, size_t, void *);
|
||||||
|
typedef size_t (*_curl_read_callback5)(void *, size_t, size_t, const void *);
|
||||||
|
typedef size_t (*_curl_read_callback6)(void *, size_t, size_t, FILE *);
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type curl_write_callback or "similar" */
|
||||||
|
#define curlcheck_write_cb(expr) \
|
||||||
|
(curlcheck_read_cb(expr) || \
|
||||||
|
curlcheck_cb_compatible((expr), __typeof__(fwrite) *) || \
|
||||||
|
curlcheck_cb_compatible((expr), curl_write_callback) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_write_callback1) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_write_callback2) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_write_callback3) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_write_callback4) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_write_callback5) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_write_callback6))
|
||||||
|
typedef size_t (*_curl_write_callback1)(const char *, size_t, size_t, void *);
|
||||||
|
typedef size_t (*_curl_write_callback2)(const char *, size_t, size_t,
|
||||||
|
const void *);
|
||||||
|
typedef size_t (*_curl_write_callback3)(const char *, size_t, size_t, FILE *);
|
||||||
|
typedef size_t (*_curl_write_callback4)(const void *, size_t, size_t, void *);
|
||||||
|
typedef size_t (*_curl_write_callback5)(const void *, size_t, size_t,
|
||||||
|
const void *);
|
||||||
|
typedef size_t (*_curl_write_callback6)(const void *, size_t, size_t, FILE *);
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type curl_ioctl_callback or "similar" */
|
||||||
|
#define curlcheck_ioctl_cb(expr) \
|
||||||
|
(curlcheck_NULL(expr) || \
|
||||||
|
curlcheck_cb_compatible((expr), curl_ioctl_callback) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_ioctl_callback1) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_ioctl_callback2) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_ioctl_callback3) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_ioctl_callback4))
|
||||||
|
typedef curlioerr (*_curl_ioctl_callback1)(CURL *, int, void *);
|
||||||
|
typedef curlioerr (*_curl_ioctl_callback2)(CURL *, int, const void *);
|
||||||
|
typedef curlioerr (*_curl_ioctl_callback3)(CURL *, curliocmd, void *);
|
||||||
|
typedef curlioerr (*_curl_ioctl_callback4)(CURL *, curliocmd, const void *);
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type curl_sockopt_callback or "similar" */
|
||||||
|
#define curlcheck_sockopt_cb(expr) \
|
||||||
|
(curlcheck_NULL(expr) || \
|
||||||
|
curlcheck_cb_compatible((expr), curl_sockopt_callback) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_sockopt_callback1) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_sockopt_callback2))
|
||||||
|
typedef int (*_curl_sockopt_callback1)(void *, curl_socket_t, curlsocktype);
|
||||||
|
typedef int (*_curl_sockopt_callback2)(const void *, curl_socket_t,
|
||||||
|
curlsocktype);
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type curl_opensocket_callback or
|
||||||
|
"similar" */
|
||||||
|
#define curlcheck_opensocket_cb(expr) \
|
||||||
|
(curlcheck_NULL(expr) || \
|
||||||
|
curlcheck_cb_compatible((expr), curl_opensocket_callback) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_opensocket_callback1) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_opensocket_callback2) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_opensocket_callback3) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_opensocket_callback4))
|
||||||
|
typedef curl_socket_t (*_curl_opensocket_callback1)
|
||||||
|
(void *, curlsocktype, struct curl_sockaddr *);
|
||||||
|
typedef curl_socket_t (*_curl_opensocket_callback2)
|
||||||
|
(void *, curlsocktype, const struct curl_sockaddr *);
|
||||||
|
typedef curl_socket_t (*_curl_opensocket_callback3)
|
||||||
|
(const void *, curlsocktype, struct curl_sockaddr *);
|
||||||
|
typedef curl_socket_t (*_curl_opensocket_callback4)
|
||||||
|
(const void *, curlsocktype, const struct curl_sockaddr *);
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type curl_progress_callback or "similar" */
|
||||||
|
#define curlcheck_progress_cb(expr) \
|
||||||
|
(curlcheck_NULL(expr) || \
|
||||||
|
curlcheck_cb_compatible((expr), curl_progress_callback) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_progress_callback1) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_progress_callback2))
|
||||||
|
typedef int (*_curl_progress_callback1)(void *,
|
||||||
|
double, double, double, double);
|
||||||
|
typedef int (*_curl_progress_callback2)(const void *,
|
||||||
|
double, double, double, double);
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type curl_debug_callback or "similar" */
|
||||||
|
#define curlcheck_debug_cb(expr) \
|
||||||
|
(curlcheck_NULL(expr) || \
|
||||||
|
curlcheck_cb_compatible((expr), curl_debug_callback) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_debug_callback1) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_debug_callback2) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_debug_callback3) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_debug_callback4) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_debug_callback5) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_debug_callback6) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_debug_callback7) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_debug_callback8))
|
||||||
|
typedef int (*_curl_debug_callback1) (CURL *,
|
||||||
|
curl_infotype, char *, size_t, void *);
|
||||||
|
typedef int (*_curl_debug_callback2) (CURL *,
|
||||||
|
curl_infotype, char *, size_t, const void *);
|
||||||
|
typedef int (*_curl_debug_callback3) (CURL *,
|
||||||
|
curl_infotype, const char *, size_t, void *);
|
||||||
|
typedef int (*_curl_debug_callback4) (CURL *,
|
||||||
|
curl_infotype, const char *, size_t, const void *);
|
||||||
|
typedef int (*_curl_debug_callback5) (CURL *,
|
||||||
|
curl_infotype, unsigned char *, size_t, void *);
|
||||||
|
typedef int (*_curl_debug_callback6) (CURL *,
|
||||||
|
curl_infotype, unsigned char *, size_t, const void *);
|
||||||
|
typedef int (*_curl_debug_callback7) (CURL *,
|
||||||
|
curl_infotype, const unsigned char *, size_t, void *);
|
||||||
|
typedef int (*_curl_debug_callback8) (CURL *,
|
||||||
|
curl_infotype, const unsigned char *, size_t, const void *);
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type curl_ssl_ctx_callback or "similar" */
|
||||||
|
/* this is getting even messier... */
|
||||||
|
#define curlcheck_ssl_ctx_cb(expr) \
|
||||||
|
(curlcheck_NULL(expr) || \
|
||||||
|
curlcheck_cb_compatible((expr), curl_ssl_ctx_callback) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_ssl_ctx_callback1) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_ssl_ctx_callback2) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_ssl_ctx_callback3) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_ssl_ctx_callback4) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_ssl_ctx_callback5) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_ssl_ctx_callback6) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_ssl_ctx_callback7) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_ssl_ctx_callback8))
|
||||||
|
typedef CURLcode (*_curl_ssl_ctx_callback1)(CURL *, void *, void *);
|
||||||
|
typedef CURLcode (*_curl_ssl_ctx_callback2)(CURL *, void *, const void *);
|
||||||
|
typedef CURLcode (*_curl_ssl_ctx_callback3)(CURL *, const void *, void *);
|
||||||
|
typedef CURLcode (*_curl_ssl_ctx_callback4)(CURL *, const void *,
|
||||||
|
const void *);
|
||||||
|
#ifdef HEADER_SSL_H
|
||||||
|
/* hack: if we included OpenSSL's ssl.h, we know about SSL_CTX
|
||||||
|
* this will of course break if we're included before OpenSSL headers...
|
||||||
|
*/
|
||||||
|
typedef CURLcode (*_curl_ssl_ctx_callback5)(CURL *, SSL_CTX *, void *);
|
||||||
|
typedef CURLcode (*_curl_ssl_ctx_callback6)(CURL *, SSL_CTX *, const void *);
|
||||||
|
typedef CURLcode (*_curl_ssl_ctx_callback7)(CURL *, const SSL_CTX *, void *);
|
||||||
|
typedef CURLcode (*_curl_ssl_ctx_callback8)(CURL *, const SSL_CTX *,
|
||||||
|
const void *);
|
||||||
|
#else
|
||||||
|
typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback5;
|
||||||
|
typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback6;
|
||||||
|
typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback7;
|
||||||
|
typedef _curl_ssl_ctx_callback1 _curl_ssl_ctx_callback8;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type curl_conv_callback or "similar" */
|
||||||
|
#define curlcheck_conv_cb(expr) \
|
||||||
|
(curlcheck_NULL(expr) || \
|
||||||
|
curlcheck_cb_compatible((expr), curl_conv_callback) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_conv_callback1) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_conv_callback2) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_conv_callback3) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_conv_callback4))
|
||||||
|
typedef CURLcode (*_curl_conv_callback1)(char *, size_t length);
|
||||||
|
typedef CURLcode (*_curl_conv_callback2)(const char *, size_t length);
|
||||||
|
typedef CURLcode (*_curl_conv_callback3)(void *, size_t length);
|
||||||
|
typedef CURLcode (*_curl_conv_callback4)(const void *, size_t length);
|
||||||
|
|
||||||
|
/* evaluates to true if expr is of type curl_seek_callback or "similar" */
|
||||||
|
#define curlcheck_seek_cb(expr) \
|
||||||
|
(curlcheck_NULL(expr) || \
|
||||||
|
curlcheck_cb_compatible((expr), curl_seek_callback) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_seek_callback1) || \
|
||||||
|
curlcheck_cb_compatible((expr), _curl_seek_callback2))
|
||||||
|
typedef CURLcode (*_curl_seek_callback1)(void *, curl_off_t, int);
|
||||||
|
typedef CURLcode (*_curl_seek_callback2)(const void *, curl_off_t, int);
|
||||||
|
|
||||||
|
|
||||||
|
#endif /* CURLINC_TYPECHECK_GCC_H */
|
||||||
|
|
@ -0,0 +1,149 @@
|
||||||
|
#ifndef CURLINC_URLAPI_H
|
||||||
|
#define CURLINC_URLAPI_H
|
||||||
|
/***************************************************************************
|
||||||
|
* _ _ ____ _
|
||||||
|
* Project ___| | | | _ \| |
|
||||||
|
* / __| | | | |_) | |
|
||||||
|
* | (__| |_| | _ <| |___
|
||||||
|
* \___|\___/|_| \_\_____|
|
||||||
|
*
|
||||||
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
||||||
|
*
|
||||||
|
* This software is licensed as described in the file COPYING, which
|
||||||
|
* you should have received as part of this distribution. The terms
|
||||||
|
* are also available at https://curl.se/docs/copyright.html.
|
||||||
|
*
|
||||||
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
||||||
|
* copies of the Software, and permit persons to whom the Software is
|
||||||
|
* furnished to do so, under the terms of the COPYING file.
|
||||||
|
*
|
||||||
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||||||
|
* KIND, either express or implied.
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: curl
|
||||||
|
*
|
||||||
|
***************************************************************************/
|
||||||
|
|
||||||
|
#include "curl.h"
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/* the error codes for the URL API */
|
||||||
|
typedef enum {
|
||||||
|
CURLUE_OK,
|
||||||
|
CURLUE_BAD_HANDLE, /* 1 */
|
||||||
|
CURLUE_BAD_PARTPOINTER, /* 2 */
|
||||||
|
CURLUE_MALFORMED_INPUT, /* 3 */
|
||||||
|
CURLUE_BAD_PORT_NUMBER, /* 4 */
|
||||||
|
CURLUE_UNSUPPORTED_SCHEME, /* 5 */
|
||||||
|
CURLUE_URLDECODE, /* 6 */
|
||||||
|
CURLUE_OUT_OF_MEMORY, /* 7 */
|
||||||
|
CURLUE_USER_NOT_ALLOWED, /* 8 */
|
||||||
|
CURLUE_UNKNOWN_PART, /* 9 */
|
||||||
|
CURLUE_NO_SCHEME, /* 10 */
|
||||||
|
CURLUE_NO_USER, /* 11 */
|
||||||
|
CURLUE_NO_PASSWORD, /* 12 */
|
||||||
|
CURLUE_NO_OPTIONS, /* 13 */
|
||||||
|
CURLUE_NO_HOST, /* 14 */
|
||||||
|
CURLUE_NO_PORT, /* 15 */
|
||||||
|
CURLUE_NO_QUERY, /* 16 */
|
||||||
|
CURLUE_NO_FRAGMENT, /* 17 */
|
||||||
|
CURLUE_NO_ZONEID, /* 18 */
|
||||||
|
CURLUE_BAD_FILE_URL, /* 19 */
|
||||||
|
CURLUE_BAD_FRAGMENT, /* 20 */
|
||||||
|
CURLUE_BAD_HOSTNAME, /* 21 */
|
||||||
|
CURLUE_BAD_IPV6, /* 22 */
|
||||||
|
CURLUE_BAD_LOGIN, /* 23 */
|
||||||
|
CURLUE_BAD_PASSWORD, /* 24 */
|
||||||
|
CURLUE_BAD_PATH, /* 25 */
|
||||||
|
CURLUE_BAD_QUERY, /* 26 */
|
||||||
|
CURLUE_BAD_SCHEME, /* 27 */
|
||||||
|
CURLUE_BAD_SLASHES, /* 28 */
|
||||||
|
CURLUE_BAD_USER, /* 29 */
|
||||||
|
CURLUE_LACKS_IDN, /* 30 */
|
||||||
|
CURLUE_LAST
|
||||||
|
} CURLUcode;
|
||||||
|
|
||||||
|
typedef enum {
|
||||||
|
CURLUPART_URL,
|
||||||
|
CURLUPART_SCHEME,
|
||||||
|
CURLUPART_USER,
|
||||||
|
CURLUPART_PASSWORD,
|
||||||
|
CURLUPART_OPTIONS,
|
||||||
|
CURLUPART_HOST,
|
||||||
|
CURLUPART_PORT,
|
||||||
|
CURLUPART_PATH,
|
||||||
|
CURLUPART_QUERY,
|
||||||
|
CURLUPART_FRAGMENT,
|
||||||
|
CURLUPART_ZONEID /* added in 7.65.0 */
|
||||||
|
} CURLUPart;
|
||||||
|
|
||||||
|
#define CURLU_DEFAULT_PORT (1<<0) /* return default port number */
|
||||||
|
#define CURLU_NO_DEFAULT_PORT (1<<1) /* act as if no port number was set,
|
||||||
|
if the port number matches the
|
||||||
|
default for the scheme */
|
||||||
|
#define CURLU_DEFAULT_SCHEME (1<<2) /* return default scheme if
|
||||||
|
missing */
|
||||||
|
#define CURLU_NON_SUPPORT_SCHEME (1<<3) /* allow non-supported scheme */
|
||||||
|
#define CURLU_PATH_AS_IS (1<<4) /* leave dot sequences */
|
||||||
|
#define CURLU_DISALLOW_USER (1<<5) /* no user+password allowed */
|
||||||
|
#define CURLU_URLDECODE (1<<6) /* URL decode on get */
|
||||||
|
#define CURLU_URLENCODE (1<<7) /* URL encode on set */
|
||||||
|
#define CURLU_APPENDQUERY (1<<8) /* append a form style part */
|
||||||
|
#define CURLU_GUESS_SCHEME (1<<9) /* legacy curl-style guessing */
|
||||||
|
#define CURLU_NO_AUTHORITY (1<<10) /* Allow empty authority when the
|
||||||
|
scheme is unknown. */
|
||||||
|
#define CURLU_ALLOW_SPACE (1<<11) /* Allow spaces in the URL */
|
||||||
|
#define CURLU_PUNYCODE (1<<12) /* get the host name in pynycode */
|
||||||
|
|
||||||
|
typedef struct Curl_URL CURLU;
|
||||||
|
|
||||||
|
/*
|
||||||
|
* curl_url() creates a new CURLU handle and returns a pointer to it.
|
||||||
|
* Must be freed with curl_url_cleanup().
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLU *curl_url(void);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* curl_url_cleanup() frees the CURLU handle and related resources used for
|
||||||
|
* the URL parsing. It will not free strings previously returned with the URL
|
||||||
|
* API.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN void curl_url_cleanup(CURLU *handle);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* curl_url_dup() duplicates a CURLU handle and returns a new copy. The new
|
||||||
|
* handle must also be freed with curl_url_cleanup().
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLU *curl_url_dup(const CURLU *in);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* curl_url_get() extracts a specific part of the URL from a CURLU
|
||||||
|
* handle. Returns error code. The returned pointer MUST be freed with
|
||||||
|
* curl_free() afterwards.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLUcode curl_url_get(const CURLU *handle, CURLUPart what,
|
||||||
|
char **part, unsigned int flags);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* curl_url_set() sets a specific part of the URL in a CURLU handle. Returns
|
||||||
|
* error code. The passed in string will be copied. Passing a NULL instead of
|
||||||
|
* a part string, clears that part.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLUcode curl_url_set(CURLU *handle, CURLUPart what,
|
||||||
|
const char *part, unsigned int flags);
|
||||||
|
|
||||||
|
/*
|
||||||
|
* curl_url_strerror() turns a CURLUcode value into the equivalent human
|
||||||
|
* readable error string. This is useful for printing meaningful error
|
||||||
|
* messages.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN const char *curl_url_strerror(CURLUcode);
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
} /* end of extern "C" */
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#endif /* CURLINC_URLAPI_H */
|
||||||
|
|
@ -0,0 +1,84 @@
|
||||||
|
#ifndef CURLINC_WEBSOCKETS_H
|
||||||
|
#define CURLINC_WEBSOCKETS_H
|
||||||
|
/***************************************************************************
|
||||||
|
* _ _ ____ _
|
||||||
|
* Project ___| | | | _ \| |
|
||||||
|
* / __| | | | |_) | |
|
||||||
|
* | (__| |_| | _ <| |___
|
||||||
|
* \___|\___/|_| \_\_____|
|
||||||
|
*
|
||||||
|
* Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
||||||
|
*
|
||||||
|
* This software is licensed as described in the file COPYING, which
|
||||||
|
* you should have received as part of this distribution. The terms
|
||||||
|
* are also available at https://curl.se/docs/copyright.html.
|
||||||
|
*
|
||||||
|
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
||||||
|
* copies of the Software, and permit persons to whom the Software is
|
||||||
|
* furnished to do so, under the terms of the COPYING file.
|
||||||
|
*
|
||||||
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||||||
|
* KIND, either express or implied.
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: curl
|
||||||
|
*
|
||||||
|
***************************************************************************/
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
|
||||||
|
struct curl_ws_frame {
|
||||||
|
int age; /* zero */
|
||||||
|
int flags; /* See the CURLWS_* defines */
|
||||||
|
curl_off_t offset; /* the offset of this data into the frame */
|
||||||
|
curl_off_t bytesleft; /* number of pending bytes left of the payload */
|
||||||
|
size_t len; /* size of the current data chunk */
|
||||||
|
};
|
||||||
|
|
||||||
|
/* flag bits */
|
||||||
|
#define CURLWS_TEXT (1<<0)
|
||||||
|
#define CURLWS_BINARY (1<<1)
|
||||||
|
#define CURLWS_CONT (1<<2)
|
||||||
|
#define CURLWS_CLOSE (1<<3)
|
||||||
|
#define CURLWS_PING (1<<4)
|
||||||
|
#define CURLWS_OFFSET (1<<5)
|
||||||
|
|
||||||
|
/*
|
||||||
|
* NAME curl_ws_recv()
|
||||||
|
*
|
||||||
|
* DESCRIPTION
|
||||||
|
*
|
||||||
|
* Receives data from the websocket connection. Use after successful
|
||||||
|
* curl_easy_perform() with CURLOPT_CONNECT_ONLY option.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLcode curl_ws_recv(CURL *curl, void *buffer, size_t buflen,
|
||||||
|
size_t *recv,
|
||||||
|
const struct curl_ws_frame **metap);
|
||||||
|
|
||||||
|
/* sendflags for curl_ws_send() */
|
||||||
|
#define CURLWS_PONG (1<<6)
|
||||||
|
|
||||||
|
/*
|
||||||
|
* NAME curl_easy_send()
|
||||||
|
*
|
||||||
|
* DESCRIPTION
|
||||||
|
*
|
||||||
|
* Sends data over the websocket connection. Use after successful
|
||||||
|
* curl_easy_perform() with CURLOPT_CONNECT_ONLY option.
|
||||||
|
*/
|
||||||
|
CURL_EXTERN CURLcode curl_ws_send(CURL *curl, const void *buffer,
|
||||||
|
size_t buflen, size_t *sent,
|
||||||
|
curl_off_t framesize,
|
||||||
|
unsigned int sendflags);
|
||||||
|
|
||||||
|
/* bits for the CURLOPT_WS_OPTIONS bitmask: */
|
||||||
|
#define CURLWS_RAW_MODE (1<<0)
|
||||||
|
|
||||||
|
CURL_EXTERN const struct curl_ws_frame *curl_ws_meta(CURL *curl);
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#endif /* CURLINC_WEBSOCKETS_H */
|
||||||
Binary file not shown.
Binary file not shown.
|
|
@ -1,21 +0,0 @@
|
||||||
Copyright (c) Microsoft Corporation.
|
|
||||||
|
|
||||||
MIT License
|
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
||||||
of this software and associated documentation files (the "Software"), to deal
|
|
||||||
in the Software without restriction, including without limitation the rights
|
|
||||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
||||||
copies of the Software, and to permit persons to whom the Software is
|
|
||||||
furnished to do so, subject to the following conditions:
|
|
||||||
|
|
||||||
The above copyright notice and this permission notice shall be included in all
|
|
||||||
copies or substantial portions of the Software.
|
|
||||||
|
|
||||||
THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
||||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
||||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
||||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
||||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
||||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
||||||
SOFTWARE.
|
|
||||||
|
|
@ -1,187 +0,0 @@
|
||||||
In some configuration, MsQuic uses third-party libraries or other resources
|
|
||||||
that may be distributed under licenses different than the MsQuic software.
|
|
||||||
|
|
||||||
In the event that we accidentally failed to list a required notice, please
|
|
||||||
bring it to our attention by posting a GitHub issue or Discussion item.
|
|
||||||
|
|
||||||
The attached notices are provided for information only.
|
|
||||||
|
|
||||||
License notice for OpenSSL
|
|
||||||
-------------------------------
|
|
||||||
|
|
||||||
Apache License
|
|
||||||
Version 2.0, January 2004
|
|
||||||
https://www.apache.org/licenses/
|
|
||||||
|
|
||||||
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
||||||
|
|
||||||
1. Definitions.
|
|
||||||
|
|
||||||
"License" shall mean the terms and conditions for use, reproduction,
|
|
||||||
and distribution as defined by Sections 1 through 9 of this document.
|
|
||||||
|
|
||||||
"Licensor" shall mean the copyright owner or entity authorized by
|
|
||||||
the copyright owner that is granting the License.
|
|
||||||
|
|
||||||
"Legal Entity" shall mean the union of the acting entity and all
|
|
||||||
other entities that control, are controlled by, or are under common
|
|
||||||
control with that entity. For the purposes of this definition,
|
|
||||||
"control" means (i) the power, direct or indirect, to cause the
|
|
||||||
direction or management of such entity, whether by contract or
|
|
||||||
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
||||||
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
||||||
|
|
||||||
"You" (or "Your") shall mean an individual or Legal Entity
|
|
||||||
exercising permissions granted by this License.
|
|
||||||
|
|
||||||
"Source" form shall mean the preferred form for making modifications,
|
|
||||||
including but not limited to software source code, documentation
|
|
||||||
source, and configuration files.
|
|
||||||
|
|
||||||
"Object" form shall mean any form resulting from mechanical
|
|
||||||
transformation or translation of a Source form, including but
|
|
||||||
not limited to compiled object code, generated documentation,
|
|
||||||
and conversions to other media types.
|
|
||||||
|
|
||||||
"Work" shall mean the work of authorship, whether in Source or
|
|
||||||
Object form, made available under the License, as indicated by a
|
|
||||||
copyright notice that is included in or attached to the work
|
|
||||||
(an example is provided in the Appendix below).
|
|
||||||
|
|
||||||
"Derivative Works" shall mean any work, whether in Source or Object
|
|
||||||
form, that is based on (or derived from) the Work and for which the
|
|
||||||
editorial revisions, annotations, elaborations, or other modifications
|
|
||||||
represent, as a whole, an original work of authorship. For the purposes
|
|
||||||
of this License, Derivative Works shall not include works that remain
|
|
||||||
separable from, or merely link (or bind by name) to the interfaces of,
|
|
||||||
the Work and Derivative Works thereof.
|
|
||||||
|
|
||||||
"Contribution" shall mean any work of authorship, including
|
|
||||||
the original version of the Work and any modifications or additions
|
|
||||||
to that Work or Derivative Works thereof, that is intentionally
|
|
||||||
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
||||||
or by an individual or Legal Entity authorized to submit on behalf of
|
|
||||||
the copyright owner. For the purposes of this definition, "submitted"
|
|
||||||
means any form of electronic, verbal, or written communication sent
|
|
||||||
to the Licensor or its representatives, including but not limited to
|
|
||||||
communication on electronic mailing lists, source code control systems,
|
|
||||||
and issue tracking systems that are managed by, or on behalf of, the
|
|
||||||
Licensor for the purpose of discussing and improving the Work, but
|
|
||||||
excluding communication that is conspicuously marked or otherwise
|
|
||||||
designated in writing by the copyright owner as "Not a Contribution."
|
|
||||||
|
|
||||||
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
||||||
on behalf of whom a Contribution has been received by Licensor and
|
|
||||||
subsequently incorporated within the Work.
|
|
||||||
|
|
||||||
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
||||||
copyright license to reproduce, prepare Derivative Works of,
|
|
||||||
publicly display, publicly perform, sublicense, and distribute the
|
|
||||||
Work and such Derivative Works in Source or Object form.
|
|
||||||
|
|
||||||
3. Grant of Patent License. Subject to the terms and conditions of
|
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
||||||
(except as stated in this section) patent license to make, have made,
|
|
||||||
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
||||||
where such license applies only to those patent claims licensable
|
|
||||||
by such Contributor that are necessarily infringed by their
|
|
||||||
Contribution(s) alone or by combination of their Contribution(s)
|
|
||||||
with the Work to which such Contribution(s) was submitted. If You
|
|
||||||
institute patent litigation against any entity (including a
|
|
||||||
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
||||||
or a Contribution incorporated within the Work constitutes direct
|
|
||||||
or contributory patent infringement, then any patent licenses
|
|
||||||
granted to You under this License for that Work shall terminate
|
|
||||||
as of the date such litigation is filed.
|
|
||||||
|
|
||||||
4. Redistribution. You may reproduce and distribute copies of the
|
|
||||||
Work or Derivative Works thereof in any medium, with or without
|
|
||||||
modifications, and in Source or Object form, provided that You
|
|
||||||
meet the following conditions:
|
|
||||||
|
|
||||||
(a) You must give any other recipients of the Work or
|
|
||||||
Derivative Works a copy of this License; and
|
|
||||||
|
|
||||||
(b) You must cause any modified files to carry prominent notices
|
|
||||||
stating that You changed the files; and
|
|
||||||
|
|
||||||
(c) You must retain, in the Source form of any Derivative Works
|
|
||||||
that You distribute, all copyright, patent, trademark, and
|
|
||||||
attribution notices from the Source form of the Work,
|
|
||||||
excluding those notices that do not pertain to any part of
|
|
||||||
the Derivative Works; and
|
|
||||||
|
|
||||||
(d) If the Work includes a "NOTICE" text file as part of its
|
|
||||||
distribution, then any Derivative Works that You distribute must
|
|
||||||
include a readable copy of the attribution notices contained
|
|
||||||
within such NOTICE file, excluding those notices that do not
|
|
||||||
pertain to any part of the Derivative Works, in at least one
|
|
||||||
of the following places: within a NOTICE text file distributed
|
|
||||||
as part of the Derivative Works; within the Source form or
|
|
||||||
documentation, if provided along with the Derivative Works; or,
|
|
||||||
within a display generated by the Derivative Works, if and
|
|
||||||
wherever such third-party notices normally appear. The contents
|
|
||||||
of the NOTICE file are for informational purposes only and
|
|
||||||
do not modify the License. You may add Your own attribution
|
|
||||||
notices within Derivative Works that You distribute, alongside
|
|
||||||
or as an addendum to the NOTICE text from the Work, provided
|
|
||||||
that such additional attribution notices cannot be construed
|
|
||||||
as modifying the License.
|
|
||||||
|
|
||||||
You may add Your own copyright statement to Your modifications and
|
|
||||||
may provide additional or different license terms and conditions
|
|
||||||
for use, reproduction, or distribution of Your modifications, or
|
|
||||||
for any such Derivative Works as a whole, provided Your use,
|
|
||||||
reproduction, and distribution of the Work otherwise complies with
|
|
||||||
the conditions stated in this License.
|
|
||||||
|
|
||||||
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
||||||
any Contribution intentionally submitted for inclusion in the Work
|
|
||||||
by You to the Licensor shall be under the terms and conditions of
|
|
||||||
this License, without any additional terms or conditions.
|
|
||||||
Notwithstanding the above, nothing herein shall supersede or modify
|
|
||||||
the terms of any separate license agreement you may have executed
|
|
||||||
with Licensor regarding such Contributions.
|
|
||||||
|
|
||||||
6. Trademarks. This License does not grant permission to use the trade
|
|
||||||
names, trademarks, service marks, or product names of the Licensor,
|
|
||||||
except as required for reasonable and customary use in describing the
|
|
||||||
origin of the Work and reproducing the content of the NOTICE file.
|
|
||||||
|
|
||||||
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
||||||
agreed to in writing, Licensor provides the Work (and each
|
|
||||||
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
||||||
implied, including, without limitation, any warranties or conditions
|
|
||||||
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
||||||
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
||||||
appropriateness of using or redistributing the Work and assume any
|
|
||||||
risks associated with Your exercise of permissions under this License.
|
|
||||||
|
|
||||||
8. Limitation of Liability. In no event and under no legal theory,
|
|
||||||
whether in tort (including negligence), contract, or otherwise,
|
|
||||||
unless required by applicable law (such as deliberate and grossly
|
|
||||||
negligent acts) or agreed to in writing, shall any Contributor be
|
|
||||||
liable to You for damages, including any direct, indirect, special,
|
|
||||||
incidental, or consequential damages of any character arising as a
|
|
||||||
result of this License or out of the use or inability to use the
|
|
||||||
Work (including but not limited to damages for loss of goodwill,
|
|
||||||
work stoppage, computer failure or malfunction, or any and all
|
|
||||||
other commercial damages or losses), even if such Contributor
|
|
||||||
has been advised of the possibility of such damages.
|
|
||||||
|
|
||||||
9. Accepting Warranty or Additional Liability. While redistributing
|
|
||||||
the Work or Derivative Works thereof, You may choose to offer,
|
|
||||||
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
||||||
or other liability obligations and/or rights consistent with this
|
|
||||||
License. However, in accepting such obligations, You may act only
|
|
||||||
on Your own behalf and on Your sole responsibility, not on behalf
|
|
||||||
of any other Contributor, and only if You agree to indemnify,
|
|
||||||
defend, and hold each Contributor harmless for any liability
|
|
||||||
incurred by, or claims asserted against, such Contributor by reason
|
|
||||||
of your accepting any such warranty or additional liability.
|
|
||||||
|
|
||||||
END OF TERMS AND CONDITIONS
|
|
||||||
Binary file not shown.
File diff suppressed because it is too large
Load Diff
|
|
@ -1,376 +0,0 @@
|
||||||
/*++
|
|
||||||
|
|
||||||
Copyright (c) Microsoft Corporation.
|
|
||||||
Licensed under the MIT License.
|
|
||||||
|
|
||||||
Abstract:
|
|
||||||
|
|
||||||
This file contains the platform specific definitions for MsQuic structures
|
|
||||||
and error codes.
|
|
||||||
|
|
||||||
Environment:
|
|
||||||
|
|
||||||
Windows User mode
|
|
||||||
|
|
||||||
--*/
|
|
||||||
|
|
||||||
#pragma once
|
|
||||||
|
|
||||||
#ifndef _MSQUIC_WINUSER_
|
|
||||||
#define _MSQUIC_WINUSER_
|
|
||||||
|
|
||||||
#ifndef WIN32_LEAN_AND_MEAN
|
|
||||||
#define WIN32_LEAN_AND_MEAN
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#pragma warning(push)
|
|
||||||
#pragma warning(disable:6553) // Annotation does not apply to value type.
|
|
||||||
#include <windows.h>
|
|
||||||
#pragma warning(pop)
|
|
||||||
#include <winsock2.h>
|
|
||||||
#include <ws2ipdef.h>
|
|
||||||
#pragma warning(push)
|
|
||||||
#pragma warning(disable:6385) // Invalid data: accessing [buffer-name], the readable size is size1 bytes but size2 bytes may be read
|
|
||||||
#pragma warning(disable:6101) // Returning uninitialized memory
|
|
||||||
#include <ws2tcpip.h>
|
|
||||||
#include <mstcpip.h>
|
|
||||||
#pragma warning(pop)
|
|
||||||
|
|
||||||
#include <stdint.h>
|
|
||||||
|
|
||||||
#define SUCCESS_HRESULT_FROM_WIN32(x) \
|
|
||||||
((HRESULT)(((x) & 0x0000FFFF) | (FACILITY_WIN32 << 16)))
|
|
||||||
|
|
||||||
#ifndef ERROR_QUIC_HANDSHAKE_FAILURE
|
|
||||||
#define ERROR_QUIC_HANDSHAKE_FAILURE _HRESULT_TYPEDEF_(0x80410000L)
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifndef ERROR_QUIC_VER_NEG_FAILURE
|
|
||||||
#define ERROR_QUIC_VER_NEG_FAILURE _HRESULT_TYPEDEF_(0x80410001L)
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifndef ERROR_QUIC_USER_CANCELED
|
|
||||||
#define ERROR_QUIC_USER_CANCELED _HRESULT_TYPEDEF_(0x80410002L)
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifndef ERROR_QUIC_INTERNAL_ERROR
|
|
||||||
#define ERROR_QUIC_INTERNAL_ERROR _HRESULT_TYPEDEF_(0x80410003L)
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifndef ERROR_QUIC_PROTOCOL_VIOLATION
|
|
||||||
#define ERROR_QUIC_PROTOCOL_VIOLATION _HRESULT_TYPEDEF_(0x80410004L)
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifndef ERROR_QUIC_CONNECTION_IDLE
|
|
||||||
#define ERROR_QUIC_CONNECTION_IDLE _HRESULT_TYPEDEF_(0x80410005L)
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifndef ERROR_QUIC_CONNECTION_TIMEOUT
|
|
||||||
#define ERROR_QUIC_CONNECTION_TIMEOUT _HRESULT_TYPEDEF_(0x80410006L)
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifndef ERROR_QUIC_ALPN_NEG_FAILURE
|
|
||||||
#define ERROR_QUIC_ALPN_NEG_FAILURE _HRESULT_TYPEDEF_(0x80410007L)
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifndef ERROR_QUIC_STREAM_LIMIT_REACHED
|
|
||||||
#define ERROR_QUIC_STREAM_LIMIT_REACHED _HRESULT_TYPEDEF_(0x80410008L)
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifndef ERROR_QUIC_ALPN_IN_USE
|
|
||||||
#define ERROR_QUIC_ALPN_IN_USE _HRESULT_TYPEDEF_(0x80410009L)
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifndef QUIC_TLS_ALERT_HRESULT_PREFIX
|
|
||||||
#define QUIC_TLS_ALERT_HRESULT_PREFIX _HRESULT_TYPEDEF_(0x80410100L)
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#define QUIC_API __cdecl
|
|
||||||
#define QUIC_MAIN_EXPORT __cdecl
|
|
||||||
#define QUIC_STATUS HRESULT
|
|
||||||
#define QUIC_FAILED(X) FAILED(X)
|
|
||||||
#define QUIC_SUCCEEDED(X) SUCCEEDED(X)
|
|
||||||
|
|
||||||
#define QUIC_STATUS_SUCCESS S_OK // 0x0
|
|
||||||
#define QUIC_STATUS_PENDING SUCCESS_HRESULT_FROM_WIN32(ERROR_IO_PENDING) // 0x703e5
|
|
||||||
#define QUIC_STATUS_CONTINUE SUCCESS_HRESULT_FROM_WIN32(ERROR_CONTINUE) // 0x704de
|
|
||||||
#define QUIC_STATUS_OUT_OF_MEMORY E_OUTOFMEMORY // 0x8007000e
|
|
||||||
#define QUIC_STATUS_INVALID_PARAMETER E_INVALIDARG // 0x80070057
|
|
||||||
#define QUIC_STATUS_INVALID_STATE E_NOT_VALID_STATE // 0x8007139f
|
|
||||||
#define QUIC_STATUS_NOT_SUPPORTED E_NOINTERFACE // 0x80004002
|
|
||||||
#define QUIC_STATUS_NOT_FOUND HRESULT_FROM_WIN32(ERROR_NOT_FOUND) // 0x80070490
|
|
||||||
#define QUIC_STATUS_BUFFER_TOO_SMALL E_NOT_SUFFICIENT_BUFFER // 0x8007007a
|
|
||||||
#define QUIC_STATUS_HANDSHAKE_FAILURE ERROR_QUIC_HANDSHAKE_FAILURE // 0x80410000
|
|
||||||
#define QUIC_STATUS_ABORTED E_ABORT // 0x80004004
|
|
||||||
#define QUIC_STATUS_ADDRESS_IN_USE HRESULT_FROM_WIN32(WSAEADDRINUSE) // 0x80072740
|
|
||||||
#define QUIC_STATUS_INVALID_ADDRESS HRESULT_FROM_WIN32(WSAEADDRNOTAVAIL) // 0x80072741
|
|
||||||
#define QUIC_STATUS_CONNECTION_TIMEOUT ERROR_QUIC_CONNECTION_TIMEOUT // 0x80410006
|
|
||||||
#define QUIC_STATUS_CONNECTION_IDLE ERROR_QUIC_CONNECTION_IDLE // 0x80410005
|
|
||||||
#define QUIC_STATUS_UNREACHABLE HRESULT_FROM_WIN32(ERROR_HOST_UNREACHABLE) // 0x800704d0
|
|
||||||
#define QUIC_STATUS_INTERNAL_ERROR ERROR_QUIC_INTERNAL_ERROR // 0x80410003
|
|
||||||
#define QUIC_STATUS_CONNECTION_REFUSED HRESULT_FROM_WIN32(ERROR_CONNECTION_REFUSED) // 0x800704c9
|
|
||||||
#define QUIC_STATUS_PROTOCOL_ERROR ERROR_QUIC_PROTOCOL_VIOLATION // 0x80410004
|
|
||||||
#define QUIC_STATUS_VER_NEG_ERROR ERROR_QUIC_VER_NEG_FAILURE // 0x80410001
|
|
||||||
#define QUIC_STATUS_TLS_ERROR HRESULT_FROM_WIN32(WSA_SECURE_HOST_NOT_FOUND) // 0x80072b18
|
|
||||||
#define QUIC_STATUS_USER_CANCELED ERROR_QUIC_USER_CANCELED // 0x80410002
|
|
||||||
#define QUIC_STATUS_ALPN_NEG_FAILURE ERROR_QUIC_ALPN_NEG_FAILURE // 0x80410007
|
|
||||||
#define QUIC_STATUS_STREAM_LIMIT_REACHED ERROR_QUIC_STREAM_LIMIT_REACHED // 0x80410008
|
|
||||||
#define QUIC_STATUS_ALPN_IN_USE ERROR_QUIC_ALPN_IN_USE // 0x80410009
|
|
||||||
|
|
||||||
#define QUIC_STATUS_TLS_ALERT(Alert) (QUIC_TLS_ALERT_HRESULT_PREFIX | (0xff & Alert))
|
|
||||||
|
|
||||||
#define QUIC_STATUS_CLOSE_NOTIFY QUIC_STATUS_TLS_ALERT(0) // Close notify
|
|
||||||
#define QUIC_STATUS_BAD_CERTIFICATE QUIC_STATUS_TLS_ALERT(42) // Bad Certificate
|
|
||||||
#define QUIC_STATUS_UNSUPPORTED_CERTIFICATE QUIC_STATUS_TLS_ALERT(43) // Unsupported Certficiate
|
|
||||||
#define QUIC_STATUS_REVOKED_CERTIFICATE QUIC_STATUS_TLS_ALERT(44) // Revoked Certificate
|
|
||||||
#define QUIC_STATUS_EXPIRED_CERTIFICATE QUIC_STATUS_TLS_ALERT(45) // Expired Certificate
|
|
||||||
#define QUIC_STATUS_UNKNOWN_CERTIFICATE QUIC_STATUS_TLS_ALERT(46) // Unknown Certificate
|
|
||||||
#define QUIC_STATUS_REQUIRED_CERTIFICATE QUIC_STATUS_TLS_ALERT(116) // Required Certificate
|
|
||||||
|
|
||||||
#define QUIC_STATUS_CERT_EXPIRED CERT_E_EXPIRED
|
|
||||||
#define QUIC_STATUS_CERT_UNTRUSTED_ROOT CERT_E_UNTRUSTEDROOT
|
|
||||||
#define QUIC_STATUS_CERT_NO_CERT SEC_E_NO_CREDENTIALS
|
|
||||||
|
|
||||||
//
|
|
||||||
// Swaps byte orders between host and network endianness.
|
|
||||||
//
|
|
||||||
#ifdef htons
|
|
||||||
#define QuicNetByteSwapShort(x) htons(x)
|
|
||||||
#else
|
|
||||||
#define QuicNetByteSwapShort(x) ((uint16_t)((((x) & 0x00ff) << 8) | (((x) & 0xff00) >> 8)))
|
|
||||||
#endif
|
|
||||||
|
|
||||||
//
|
|
||||||
// IP Address Abstraction Helpers
|
|
||||||
//
|
|
||||||
|
|
||||||
typedef ADDRESS_FAMILY QUIC_ADDRESS_FAMILY;
|
|
||||||
typedef SOCKADDR_INET QUIC_ADDR;
|
|
||||||
|
|
||||||
#define QUIC_ADDR_V4_PORT_OFFSET FIELD_OFFSET(SOCKADDR_IN, sin_port)
|
|
||||||
#define QUIC_ADDR_V4_IP_OFFSET FIELD_OFFSET(SOCKADDR_IN, sin_addr)
|
|
||||||
|
|
||||||
#define QUIC_ADDR_V6_PORT_OFFSET FIELD_OFFSET(SOCKADDR_IN6, sin6_port)
|
|
||||||
#define QUIC_ADDR_V6_IP_OFFSET FIELD_OFFSET(SOCKADDR_IN6, sin6_addr)
|
|
||||||
|
|
||||||
#define QUIC_ADDRESS_FAMILY_UNSPEC AF_UNSPEC
|
|
||||||
#define QUIC_ADDRESS_FAMILY_INET AF_INET
|
|
||||||
#define QUIC_ADDRESS_FAMILY_INET6 AF_INET6
|
|
||||||
|
|
||||||
inline
|
|
||||||
BOOLEAN
|
|
||||||
QuicAddrIsValid(
|
|
||||||
_In_ const QUIC_ADDR* const Addr
|
|
||||||
)
|
|
||||||
{
|
|
||||||
return
|
|
||||||
Addr->si_family == QUIC_ADDRESS_FAMILY_UNSPEC ||
|
|
||||||
Addr->si_family == QUIC_ADDRESS_FAMILY_INET ||
|
|
||||||
Addr->si_family == QUIC_ADDRESS_FAMILY_INET6;
|
|
||||||
}
|
|
||||||
|
|
||||||
inline
|
|
||||||
BOOLEAN
|
|
||||||
QuicAddrCompareIp(
|
|
||||||
_In_ const QUIC_ADDR* const Addr1,
|
|
||||||
_In_ const QUIC_ADDR* const Addr2
|
|
||||||
)
|
|
||||||
{
|
|
||||||
if (Addr1->si_family == QUIC_ADDRESS_FAMILY_INET) {
|
|
||||||
return memcmp(&Addr1->Ipv4.sin_addr, &Addr2->Ipv4.sin_addr, sizeof(IN_ADDR)) == 0;
|
|
||||||
} else {
|
|
||||||
return memcmp(&Addr1->Ipv6.sin6_addr, &Addr2->Ipv6.sin6_addr, sizeof(IN6_ADDR)) == 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
inline
|
|
||||||
BOOLEAN
|
|
||||||
QuicAddrCompare(
|
|
||||||
_In_ const QUIC_ADDR* const Addr1,
|
|
||||||
_In_ const QUIC_ADDR* const Addr2
|
|
||||||
)
|
|
||||||
{
|
|
||||||
if (Addr1->si_family != Addr2->si_family ||
|
|
||||||
Addr1->Ipv4.sin_port != Addr2->Ipv4.sin_port) {
|
|
||||||
return FALSE;
|
|
||||||
}
|
|
||||||
return QuicAddrCompareIp(Addr1, Addr2);
|
|
||||||
}
|
|
||||||
|
|
||||||
inline
|
|
||||||
BOOLEAN
|
|
||||||
QuicAddrIsWildCard(
|
|
||||||
_In_ const QUIC_ADDR* const Addr
|
|
||||||
)
|
|
||||||
{
|
|
||||||
if (Addr->si_family == QUIC_ADDRESS_FAMILY_UNSPEC) {
|
|
||||||
return TRUE;
|
|
||||||
} else if (Addr->si_family == QUIC_ADDRESS_FAMILY_INET) {
|
|
||||||
const IN_ADDR ZeroAddr = {0};
|
|
||||||
return memcmp(&Addr->Ipv4.sin_addr, &ZeroAddr, sizeof(IN_ADDR)) == 0;
|
|
||||||
} else {
|
|
||||||
const IN6_ADDR ZeroAddr = {0};
|
|
||||||
return memcmp(&Addr->Ipv6.sin6_addr, &ZeroAddr, sizeof(IN6_ADDR)) == 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
inline
|
|
||||||
QUIC_ADDRESS_FAMILY
|
|
||||||
QuicAddrGetFamily(
|
|
||||||
_In_ const QUIC_ADDR* const Addr
|
|
||||||
)
|
|
||||||
{
|
|
||||||
return (QUIC_ADDRESS_FAMILY)Addr->si_family;
|
|
||||||
}
|
|
||||||
|
|
||||||
inline
|
|
||||||
void
|
|
||||||
QuicAddrSetFamily(
|
|
||||||
_Inout_ QUIC_ADDR* Addr,
|
|
||||||
_In_ QUIC_ADDRESS_FAMILY Family
|
|
||||||
)
|
|
||||||
{
|
|
||||||
Addr->si_family = (ADDRESS_FAMILY)Family;
|
|
||||||
}
|
|
||||||
|
|
||||||
inline
|
|
||||||
uint16_t // Returns in host byte order.
|
|
||||||
QuicAddrGetPort(
|
|
||||||
_In_ const QUIC_ADDR* const Addr
|
|
||||||
)
|
|
||||||
{
|
|
||||||
return QuicNetByteSwapShort(Addr->Ipv4.sin_port);
|
|
||||||
}
|
|
||||||
|
|
||||||
inline
|
|
||||||
void
|
|
||||||
QuicAddrSetPort(
|
|
||||||
_Out_ QUIC_ADDR* Addr,
|
|
||||||
_In_ uint16_t Port // Host byte order
|
|
||||||
)
|
|
||||||
{
|
|
||||||
Addr->Ipv4.sin_port = QuicNetByteSwapShort(Port);
|
|
||||||
}
|
|
||||||
|
|
||||||
inline
|
|
||||||
void
|
|
||||||
QuicAddrSetToLoopback(
|
|
||||||
_Inout_ QUIC_ADDR* Addr
|
|
||||||
)
|
|
||||||
{
|
|
||||||
if (Addr->si_family == QUIC_ADDRESS_FAMILY_INET) {
|
|
||||||
Addr->Ipv4.sin_addr.S_un.S_un_b.s_b1 = 127;
|
|
||||||
Addr->Ipv4.sin_addr.S_un.S_un_b.s_b4 = 1;
|
|
||||||
} else {
|
|
||||||
Addr->Ipv6.sin6_addr.u.Byte[15] = 1;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Test only API to increment the IP address value.
|
|
||||||
//
|
|
||||||
inline
|
|
||||||
void
|
|
||||||
QuicAddrIncrement(
|
|
||||||
_Inout_ QUIC_ADDR* Addr
|
|
||||||
)
|
|
||||||
{
|
|
||||||
if (Addr->si_family == QUIC_ADDRESS_FAMILY_INET) {
|
|
||||||
Addr->Ipv4.sin_addr.S_un.S_un_b.s_b4++;
|
|
||||||
} else {
|
|
||||||
Addr->Ipv6.sin6_addr.u.Byte[15]++;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
inline
|
|
||||||
uint32_t
|
|
||||||
QuicAddrHash(
|
|
||||||
_In_ const QUIC_ADDR* Addr
|
|
||||||
)
|
|
||||||
{
|
|
||||||
uint32_t Hash = 5387; // A random prime number.
|
|
||||||
#define UPDATE_HASH(byte) Hash = ((Hash << 5) - Hash) + (byte)
|
|
||||||
if (Addr->si_family == QUIC_ADDRESS_FAMILY_INET) {
|
|
||||||
UPDATE_HASH(Addr->Ipv4.sin_port & 0xFF);
|
|
||||||
UPDATE_HASH(Addr->Ipv4.sin_port >> 8);
|
|
||||||
for (uint8_t i = 0; i < sizeof(Addr->Ipv4.sin_addr); ++i) {
|
|
||||||
UPDATE_HASH(((uint8_t*)&Addr->Ipv4.sin_addr)[i]);
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
UPDATE_HASH(Addr->Ipv6.sin6_port & 0xFF);
|
|
||||||
UPDATE_HASH(Addr->Ipv6.sin6_port >> 8);
|
|
||||||
for (uint8_t i = 0; i < sizeof(Addr->Ipv6.sin6_addr); ++i) {
|
|
||||||
UPDATE_HASH(((uint8_t*)&Addr->Ipv6.sin6_addr)[i]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return Hash;
|
|
||||||
}
|
|
||||||
|
|
||||||
#define QUIC_LOCALHOST_FOR_AF(Af) "localhost"
|
|
||||||
|
|
||||||
//
|
|
||||||
// Rtl String API's are not allowed in gamecore
|
|
||||||
//
|
|
||||||
#if WINAPI_FAMILY != WINAPI_FAMILY_GAMES
|
|
||||||
|
|
||||||
inline
|
|
||||||
_Success_(return != FALSE)
|
|
||||||
BOOLEAN
|
|
||||||
QuicAddrFromString(
|
|
||||||
_In_z_ const char* AddrStr,
|
|
||||||
_In_ uint16_t Port, // Host byte order
|
|
||||||
_Out_ QUIC_ADDR* Addr
|
|
||||||
)
|
|
||||||
{
|
|
||||||
if (RtlIpv4StringToAddressExA(AddrStr, FALSE, &Addr->Ipv4.sin_addr, &Addr->Ipv4.sin_port) == NO_ERROR) {
|
|
||||||
Addr->si_family = QUIC_ADDRESS_FAMILY_INET;
|
|
||||||
} else if (RtlIpv6StringToAddressExA(AddrStr, &Addr->Ipv6.sin6_addr, &Addr->Ipv6.sin6_scope_id, &Addr->Ipv6.sin6_port) == NO_ERROR) {
|
|
||||||
Addr->si_family = QUIC_ADDRESS_FAMILY_INET6;
|
|
||||||
} else {
|
|
||||||
return FALSE;
|
|
||||||
}
|
|
||||||
if (Addr->Ipv4.sin_port == 0) {
|
|
||||||
Addr->Ipv4.sin_port = QuicNetByteSwapShort(Port);
|
|
||||||
}
|
|
||||||
return TRUE;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Represents an IP address and (optionally) port number as a string.
|
|
||||||
//
|
|
||||||
typedef struct QUIC_ADDR_STR {
|
|
||||||
char Address[64];
|
|
||||||
} QUIC_ADDR_STR;
|
|
||||||
|
|
||||||
inline
|
|
||||||
_Success_(return != FALSE)
|
|
||||||
BOOLEAN
|
|
||||||
QuicAddrToString(
|
|
||||||
_In_ const QUIC_ADDR* Addr,
|
|
||||||
_Out_ QUIC_ADDR_STR* AddrStr
|
|
||||||
)
|
|
||||||
{
|
|
||||||
LONG Status;
|
|
||||||
ULONG AddrStrLen = ARRAYSIZE(AddrStr->Address);
|
|
||||||
if (Addr->si_family == QUIC_ADDRESS_FAMILY_INET) {
|
|
||||||
Status =
|
|
||||||
RtlIpv4AddressToStringExA(
|
|
||||||
&Addr->Ipv4.sin_addr,
|
|
||||||
Addr->Ipv4.sin_port,
|
|
||||||
AddrStr->Address,
|
|
||||||
&AddrStrLen);
|
|
||||||
} else {
|
|
||||||
Status =
|
|
||||||
RtlIpv6AddressToStringExA(
|
|
||||||
&Addr->Ipv6.sin6_addr,
|
|
||||||
0,
|
|
||||||
Addr->Ipv6.sin6_port,
|
|
||||||
AddrStr->Address,
|
|
||||||
&AddrStrLen);
|
|
||||||
}
|
|
||||||
return Status == NO_ERROR;
|
|
||||||
}
|
|
||||||
|
|
||||||
#endif // WINAPI_FAMILY != WINAPI_FAMILY_GAMES
|
|
||||||
|
|
||||||
#endif // _MSQUIC_WINUSER_
|
|
||||||
Binary file not shown.
Loading…
Reference in New Issue