mirror of
https://gitlab.winehq.org/wine/wine-gecko.git
synced 2024-09-13 09:24:08 -07:00
726e9673d3
Allow necko to simultaneously track the dual concept of routed host and origin (authenticated host). The origin is given to the socket provider and the routed host is inserted at DNS lookup time as if it were a SRV or CNAME.
111 lines
4.0 KiB
Plaintext
111 lines
4.0 KiB
Plaintext
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
#include "nsISupports.idl"
|
|
|
|
[ptr] native PRFileDescStar(struct PRFileDesc);
|
|
|
|
/**
|
|
* nsISocketProvider
|
|
*/
|
|
[scriptable, uuid(00b3df92-e830-11d8-d48e-0004e22243f8)]
|
|
interface nsISocketProvider : nsISupports
|
|
{
|
|
/**
|
|
* newSocket
|
|
*
|
|
* @param aFamily
|
|
* The address family for this socket (PR_AF_INET or PR_AF_INET6).
|
|
* @param aHost
|
|
* The origin hostname for this connection.
|
|
* @param aPort
|
|
* The origin port for this connection.
|
|
* @param aProxyHost
|
|
* If non-null, the proxy hostname for this connection.
|
|
* @param aProxyPort
|
|
* The proxy port for this connection.
|
|
* @param aFlags
|
|
* Control flags that govern this connection (see below.)
|
|
* @param aFileDesc
|
|
* The resulting PRFileDesc.
|
|
* @param aSecurityInfo
|
|
* Any security info that should be associated with aFileDesc. This
|
|
* object typically implements nsITransportSecurityInfo.
|
|
*/
|
|
[noscript]
|
|
void newSocket(in long aFamily,
|
|
in string aHost,
|
|
in long aPort,
|
|
in string aProxyHost,
|
|
in long aProxyPort,
|
|
in unsigned long aFlags,
|
|
out PRFileDescStar aFileDesc,
|
|
out nsISupports aSecurityInfo);
|
|
|
|
/**
|
|
* addToSocket
|
|
*
|
|
* This function is called to allow the socket provider to layer a
|
|
* PRFileDesc on top of another PRFileDesc. For example, SSL via a SOCKS
|
|
* proxy.
|
|
*
|
|
* Parameters are the same as newSocket with the exception of aFileDesc,
|
|
* which is an in-param instead.
|
|
*/
|
|
[noscript]
|
|
void addToSocket(in long aFamily,
|
|
in string aHost,
|
|
in long aPort,
|
|
in string aProxyHost,
|
|
in long aProxyPort,
|
|
in unsigned long aFlags,
|
|
in PRFileDescStar aFileDesc,
|
|
out nsISupports aSecurityInfo);
|
|
|
|
/**
|
|
* PROXY_RESOLVES_HOST
|
|
*
|
|
* This flag is set if the proxy is to perform hostname resolution instead
|
|
* of the client. When set, the hostname parameter passed when in this
|
|
* interface will be used instead of the address structure passed for a
|
|
* later connect et al. request.
|
|
*/
|
|
const long PROXY_RESOLVES_HOST = 1 << 0;
|
|
|
|
/**
|
|
* When setting this flag, the socket will not apply any
|
|
* credentials when establishing a connection. For example,
|
|
* an SSL connection would not send any client-certificates
|
|
* if this flag is set.
|
|
*/
|
|
const long ANONYMOUS_CONNECT = 1 << 1;
|
|
|
|
/**
|
|
* If set, indicates that the connection was initiated from a source
|
|
* defined as being private in the sense of Private Browsing. Generally,
|
|
* there should be no state shared between connections that are private
|
|
* and those that are not; it is OK for multiple private connections
|
|
* to share state with each other, and it is OK for multiple non-private
|
|
* connections to share state with each other.
|
|
*/
|
|
const unsigned long NO_PERMANENT_STORAGE = 1 << 2;
|
|
|
|
/**
|
|
* This flag is an explicit opt-in that allows a normally secure socket
|
|
* provider to use, at its discretion, an insecure algorithm. e.g.
|
|
* a TLS socket without authentication.
|
|
*/
|
|
const unsigned long MITM_OK = 1 << 3;
|
|
};
|
|
|
|
%{C++
|
|
/**
|
|
* nsISocketProvider implementations should be registered with XPCOM under a
|
|
* contract ID of the form: "@mozilla.org/network/socket;2?type=foo"
|
|
*/
|
|
#define NS_NETWORK_SOCKET_CONTRACTID_PREFIX \
|
|
"@mozilla.org/network/socket;2?type="
|
|
%}
|