TorControlConnection Class Reference

Low-level handling for Tor control connection. More...

Collaboration diagram for TorControlConnection:

Public Types
typedef std::function< void(TorControlConnection &)>	ConnectionCB
typedef std::function< void(TorControlConnection &, const TorControlReply &)>	ReplyHandlerCB

Public Member Functions
	TorControlConnection (struct event_base *base)
	Create a new TorControlConnection.
	~TorControlConnection ()
bool	Connect (const std::string &tor_control_center, const ConnectionCB &connected, const ConnectionCB &disconnected)
	Connect to a Tor control port.
void	Disconnect ()
	Disconnect from Tor control port.
bool	Command (const std::string &cmd, const ReplyHandlerCB &reply_handler)
	Send a command, register a handler for the reply.

Public Attributes
boost::signals2::signal< void(TorControlConnection &, const TorControlReply &)>	async_handler
	Response handlers for async replies.

Static Private Member Functions
static void	readcb (struct bufferevent *bev, void *ctx)
	Libevent handlers: internal.
static void	eventcb (struct bufferevent *bev, short what, void *ctx)

Private Attributes
std::function< void(TorControlConnection &)>	connected
	Callback when ready for use.
std::function< void(TorControlConnection &)>	disconnected
	Callback when connection lost.
struct event_base *	base
	Libevent event base.
struct bufferevent *	b_conn
	Connection to control socket.
TorControlReply	message
	Message being received.
std::deque< ReplyHandlerCB >	reply_handlers
	Response handlers.

Detailed Description

Low-level handling for Tor control connection.

Speaks the SMTP-like protocol as defined in torspec/control-spec.txt

Definition at line 81 of file torcontrol.cpp.

Member Typedef Documentation

ConnectionCB

typedef std::function<void(TorControlConnection &)> TorControlConnection::ConnectionCB

Definition at line 83 of file torcontrol.cpp.

ReplyHandlerCB

typedef std::function<void(TorControlConnection &, const TorControlReply &)> TorControlConnection::ReplyHandlerCB

Definition at line 85 of file torcontrol.cpp.

Constructor & Destructor Documentation

TorControlConnection()

TorControlConnection::TorControlConnection ( struct event_base *  base )

explicit

Create a new TorControlConnection.

Definition at line 140 of file torcontrol.cpp.

~TorControlConnection()

TorControlConnection::~TorControlConnection

(

)

Definition at line 143 of file torcontrol.cpp.

Here is the call graph for this function:

Member Function Documentation

Command()

bool TorControlConnection::Command	(	const std::string &	cmd,
		const ReplyHandlerCB &	reply_handler
	)

Send a command, register a handler for the reply.

A trailing CRLF is automatically added. Return true on success.

Definition at line 260 of file torcontrol.cpp.

Here is the call graph for this function:

Connect()

bool TorControlConnection::Connect	(	const std::string &	tor_control_center,
		const ConnectionCB &	connected,
		const ConnectionCB &	disconnected
	)

Connect to a Tor control port.

tor_control_center is address of the form host:port. connected is the handler that is called when connection is successfully established. disconnected is a handler that is called when the connection is broken. Return true on success.

Definition at line 217 of file torcontrol.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Disconnect()

void TorControlConnection::Disconnect

(

)

Disconnect from Tor control port.

Definition at line 253 of file torcontrol.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

eventcb()

void TorControlConnection::eventcb ( struct bufferevent *  bev, short  what, void *  ctx  )

staticprivate

Definition at line 199 of file torcontrol.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

readcb()

void TorControlConnection::readcb ( struct bufferevent *  bev, void *  ctx  )

staticprivate

Libevent handlers: internal.

Definition at line 149 of file torcontrol.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

async_handler

boost::signals2::signal<void(TorControlConnection &, const TorControlReply &)> TorControlConnection::async_handler

Response handlers for async replies.

Definition at line 119 of file torcontrol.cpp.

b_conn

struct bufferevent* TorControlConnection::b_conn

private

Connection to control socket.

Definition at line 129 of file torcontrol.cpp.

base

struct event_base* TorControlConnection::base

private

Libevent event base.

Definition at line 127 of file torcontrol.cpp.

connected

std::function<void(TorControlConnection &)> TorControlConnection::connected

private

Callback when ready for use.

Definition at line 123 of file torcontrol.cpp.

disconnected

std::function<void(TorControlConnection &)> TorControlConnection::disconnected

private

Callback when connection lost.

Definition at line 125 of file torcontrol.cpp.

message

TorControlReply TorControlConnection::message

private

Message being received.

Definition at line 131 of file torcontrol.cpp.

reply_handlers

std::deque<ReplyHandlerCB> TorControlConnection::reply_handlers

private

Response handlers.

Definition at line 133 of file torcontrol.cpp.

---

The documentation for this class was generated from the following file:

• src/torcontrol.cpp