login-proxy.h revision e0a049aa308a2e66044af3ef8e0fb70ce909ad41
#ifndef LOGIN_PROXY_H
#define LOGIN_PROXY_H
struct client;
struct login_proxy;
enum login_proxy_ssl_flags {
/* Use SSL/TLS enabled */
PROXY_SSL_FLAG_YES = 0x01,
/* Don't do SSL handshake immediately after connected */
PROXY_SSL_FLAG_STARTTLS = 0x02,
/* Don't require that the received certificate is valid */
PROXY_SSL_FLAG_ANY_CERT = 0x04
};
struct login_proxy_settings {
const char *host;
unsigned int port;
unsigned int connect_timeout_msecs;
enum login_proxy_ssl_flags ssl_flags;
};
/* Called when new input comes from proxy. */
typedef void proxy_callback_t(void *context);
/* Create a proxy to given host. Returns NULL if failed. Given callback is
called when new input is available from proxy. */
struct login_proxy *
login_proxy_new(struct client *client, const struct login_proxy_settings *set,
proxy_callback_t *callback, void *context);
#ifdef CONTEXT_TYPE_SAFETY
# define login_proxy_new(client, set, callback, context) \
({(void)(1 ? 0 : callback(context)); \
login_proxy_new(client, set, \
(proxy_callback_t *)callback, context); })
#else
# define login_proxy_new(client, set, callback, context) \
login_proxy_new(client, set, (proxy_callback_t *)callback, context)
#endif
/* Free the proxy. This should be called if authentication fails. */
void login_proxy_free(struct login_proxy **proxy);
/* Return TRUE if host/port/destuser combination points to same as current
connection. */
bool login_proxy_is_ourself(const struct client *client, const char *host,
unsigned int port, const char *destuser);
/* Detach proxy from client. This is done after the authentication is
successful and all that is left is the dummy proxying. */
void login_proxy_detach(struct login_proxy *proxy, struct istream *client_input,
struct ostream *client_output);
/* STARTTLS command was issued. */
int login_proxy_starttls(struct login_proxy *proxy);
struct istream *login_proxy_get_istream(struct login_proxy *proxy);
struct ostream *login_proxy_get_ostream(struct login_proxy *proxy);
const char *login_proxy_get_host(const struct login_proxy *proxy) ATTR_PURE;
unsigned int login_proxy_get_port(const struct login_proxy *proxy) ATTR_PURE;
enum login_proxy_ssl_flags
login_proxy_get_ssl_flags(const struct login_proxy *proxy) ATTR_PURE;
void login_proxy_init(void);
void login_proxy_deinit(void);
#endif