Skip to content

Latest commit

 

History

History
67 lines (48 loc) · 2.57 KB

README.md

File metadata and controls

67 lines (48 loc) · 2.57 KB
Raw

proxyres

API

Class Description
proxy_config Read the user's proxy configuration.
proxy_execute Executes a Proxy Auto-Configuration (PAC) script containing the JavasScript function FindProxyForURL for a particular URL to determine its proxies.
proxy_resolver Resolves proxies for a given URL based on the operating system's proxy configuration.

FindProxyForURL

Some proxy resolvers do not have support for specifying anything other than DIRECT, PROXY, and SOCKS as a type when returning from FindProxyForURL.

Specifically, both macOS and Windows do not support:

  • HTTP host:port
  • HTTPS host:port
  • SOCKS4 host:port
  • SOCKS5 host:port

Only the posix resolver in proxyres can handle these types when returning from FindProxyForURL.

More information on PAC scripts can be found in Mozilla's documentation.

Using with CMake

Run the following git commands to add a new submodule to your repository:

git submodule add [email protected]:nmoinvaz/proxyres third-party/proxyres
git submodule update --init

Add the following to your cmake:

add_subdirectory(third-party/proxyres proxyres EXCLUDE_FROM_ALL)
target_link_libraries(${PROJECT_NAME} proxyres)

Using with curl

See curl_proxyres source for a full example on using with curl.

HTTPS proxy support

It is important to check curl's feature list to ensure that HTTPS proxies are supported. It is possible to build curl without HTTPS proxy support on some platforms. When an HTTPS proxy is encountered, it may be preferrible to change the proxy URL from HTTPS to HTTP:

static curl_version_info_data *version_info = curl_version_info(CURLVERSION_NOW);
// curl is not built with HTTPS proxy support so just use HTTP proxy
if ((version_info->features & CURL_VERSION_HTTPS_PROXY) == 0) {
    // Remove s from https
    if (strncasecmp(proxy, "https:", 6) == 0)
        memmove(proxy + 4, proxy + 5, strlen(proxy) - 4);
}

Linking with V8

If you are using a project that also uses V8, it is necessary to link JavaScriptCoreGTK before linking against V8. This will prevent any conflicts when JavaScriptCoreGTK is loaded dynamically at run-time.