integration.cpp File Reference

#include <boost/test/unit_test.hpp>
#include <websocketpp/common/thread.hpp>
#include <websocketpp/config/core.hpp>
#include <websocketpp/config/core_client.hpp>
#include <websocketpp/config/asio.hpp>
#include <websocketpp/config/asio_client.hpp>
#include <websocketpp/config/debug_asio.hpp>
#include <websocketpp/server.hpp>
#include <websocketpp/client.hpp>

Include dependency graph for integration.cpp:

Go to the source code of this file.

Classes
struct	config
struct	config::transport_config
struct	config_tls
struct	config_tls::transport_config

Macros
#define	BOOST_TEST_MODULE   transport_integration

Typedefs
typedef websocketpp::server< config >	server
typedef websocketpp::client< config >	client
typedef websocketpp::server< config_tls >	server_tls
typedef websocketpp::client< config_tls >	client_tls
typedef websocketpp::server< websocketpp::config::core >	iostream_server
typedef websocketpp::client< websocketpp::config::core_client >	iostream_client

Functions
template<typename T >
void	close_after_timeout (T &e, websocketpp::connection_hdl hdl, long timeout)
void	run_server (server *s, int port, bool log=false)
void	run_client (client &c, std::string uri, bool log=false)
void	run_client_and_mark (client *c, bool *flag, websocketpp::lib::mutex *mutex)
void	run_time_limited_client (client &c, std::string uri, long timeout, bool log)
void	run_dummy_server (int port)
void	run_dummy_client (std::string port)
bool	on_ping (server *s, websocketpp::connection_hdl, std::string)
void	cancel_on_open (server *s, websocketpp::connection_hdl)
void	stop_on_close (server *s, websocketpp::connection_hdl hdl)
template<typename T >
void	ping_on_open (T *c, std::string payload, websocketpp::connection_hdl hdl)
void	fail_on_pong (websocketpp::connection_hdl, std::string)
void	fail_on_pong_timeout (websocketpp::connection_hdl, std::string)
void	req_pong (std::string expected_payload, websocketpp::connection_hdl, std::string payload)
void	fail_on_open (websocketpp::connection_hdl)
void	delay (websocketpp::connection_hdl, long duration)
template<typename T >
void	check_ec (T *c, websocketpp::lib::error_code ec, websocketpp::connection_hdl hdl)
template<typename T >
void	check_ec_and_stop (T *e, websocketpp::lib::error_code ec, websocketpp::connection_hdl hdl)
template<typename T >
void	req_pong_timeout (T *c, std::string expected_payload, websocketpp::connection_hdl hdl, std::string payload)
template<typename T >
void	close (T *e, websocketpp::connection_hdl hdl)
void	run_test_timer (long value)
	BOOST_AUTO_TEST_CASE (pong_no_timeout)
	BOOST_AUTO_TEST_CASE (pong_timeout)
	BOOST_AUTO_TEST_CASE (client_open_handshake_timeout)
	BOOST_AUTO_TEST_CASE (server_open_handshake_timeout)
	BOOST_AUTO_TEST_CASE (client_self_initiated_close_handshake_timeout)
	BOOST_AUTO_TEST_CASE (client_peer_initiated_close_handshake_timeout)
	BOOST_AUTO_TEST_CASE (server_self_initiated_close_handshake_timeout)
	BOOST_AUTO_TEST_CASE (client_runs_out_of_work)
	BOOST_AUTO_TEST_CASE (client_is_perpetual)
	BOOST_AUTO_TEST_CASE (client_failed_connection)
	BOOST_AUTO_TEST_CASE (stop_listening)
	BOOST_AUTO_TEST_CASE (pause_reading)
	BOOST_AUTO_TEST_CASE (server_connection_cleanup)

Macro Definition Documentation

BOOST_TEST_MODULE

#define BOOST_TEST_MODULE   transport_integration

Definition at line 28 of file integration.cpp.

Typedef Documentation

client

typedef websocketpp::client<config> client

Definition at line 126 of file integration.cpp.

client_tls

typedef websocketpp::client<config_tls> client_tls

Definition at line 129 of file integration.cpp.

iostream_client

typedef websocketpp::client<websocketpp::config::core_client> iostream_client

Definition at line 132 of file integration.cpp.

iostream_server

typedef websocketpp::server<websocketpp::config::core> iostream_server

Definition at line 131 of file integration.cpp.

server

typedef websocketpp::server<config> server

Definition at line 125 of file integration.cpp.

server_tls

typedef websocketpp::server<config_tls> server_tls

Definition at line 128 of file integration.cpp.

Function Documentation

BOOST_AUTO_TEST_CASE() [1/13]

BOOST_AUTO_TEST_CASE

(

client_failed_connection

)

Definition at line 552 of file integration.cpp.

                                                 {
    client c;
 
    run_time_limited_client(c,"http://localhost:9005", 5, false);
}

Here is the call graph for this function:

BOOST_AUTO_TEST_CASE() [2/13]

BOOST_AUTO_TEST_CASE

(

client_is_perpetual

)

Definition at line 518 of file integration.cpp.

                                            {
    client c;
    bool flag = false;
    websocketpp::lib::mutex mutex;
 
    websocketpp::lib::error_code ec;
    c.init_asio(ec);
    BOOST_CHECK(!ec);
 
    c.start_perpetual();
 
    websocketpp::lib::thread cthread(websocketpp::lib::bind(&run_client_and_mark,&c,&flag,&mutex));
 
    sleep(1);
 
    {
        // Checks that the thread hasn't exited yet
        websocketpp::lib::lock_guard<websocketpp::lib::mutex> lock(mutex);
        BOOST_CHECK( !flag );
    }
 
    c.stop_perpetual();
 
    sleep(1);
 
    {
        // Checks that the thread has exited
        websocketpp::lib::lock_guard<websocketpp::lib::mutex> lock(mutex);
        BOOST_CHECK( flag );
    }
 
    cthread.join();
}

Here is the call graph for this function:

BOOST_AUTO_TEST_CASE() [3/13]

BOOST_AUTO_TEST_CASE

(

client_open_handshake_timeout

)

Definition at line 409 of file integration.cpp.

                                                      {
    client c;
 
    // set open handler to fail test
    c.set_open_handler(bind(&fail_on_open,::_1));
    // set fail hander to test for the right fail error code
    c.set_fail_handler(bind(&check_ec<client>,&c,
        websocketpp::error::open_handshake_timeout,::_1));
 
    websocketpp::lib::thread sthread(websocketpp::lib::bind(&run_dummy_server,9005));
    websocketpp::lib::thread tthread(websocketpp::lib::bind(&run_test_timer,10));
    sthread.detach();
    tthread.detach();
 
    run_client(c, "http://localhost:9005");
}

Here is the call graph for this function:

BOOST_AUTO_TEST_CASE() [4/13]

BOOST_AUTO_TEST_CASE

(

client_peer_initiated_close_handshake_timeout

)

Definition at line 467 of file integration.cpp.

                                                                      {
    // on open server sends close
    // client should ack normally and then wait
    // server leaves TCP connection open
    // client handshake timer should be triggered
 
    // TODO: how to make a mock server that leaves the TCP connection open?
}

BOOST_AUTO_TEST_CASE() [5/13]

BOOST_AUTO_TEST_CASE

(

client_runs_out_of_work

)

Definition at line 499 of file integration.cpp.

                                                {
    client c;
 
    websocketpp::lib::thread tthread(websocketpp::lib::bind(&run_test_timer,3));
    tthread.detach();
 
    websocketpp::lib::error_code ec;
    c.init_asio(ec);
    BOOST_CHECK(!ec);
 
    c.run();
 
    // This test checks that an io_service with no work ends immediately.
    BOOST_CHECK(true);
}

Here is the call graph for this function:

BOOST_AUTO_TEST_CASE() [6/13]

BOOST_AUTO_TEST_CASE

(

client_self_initiated_close_handshake_timeout

)

Definition at line 444 of file integration.cpp.

                                                                      {
    server s;
    client c;
 
    // on open server sleeps for longer than the timeout
    // on open client sends close handshake
    // client handshake timer should be triggered
    s.set_open_handler(bind(&delay,::_1,1));
    s.set_close_handler(bind(&stop_on_close,&s,::_1));
 
    c.set_open_handler(bind(&close<client>,&c,::_1));
    c.set_close_handler(bind(&check_ec<client>,&c,
        websocketpp::error::close_handshake_timeout,::_1));
 
    websocketpp::lib::thread sthread(websocketpp::lib::bind(&run_server,&s,9005,false));
    websocketpp::lib::thread tthread(websocketpp::lib::bind(&run_test_timer,10));
    tthread.detach();
 
    run_client(c, "http://localhost:9005", false);
 
    sthread.join();
}

Here is the call graph for this function:

BOOST_AUTO_TEST_CASE() [7/13]

BOOST_AUTO_TEST_CASE

(

pause_reading

)

Definition at line 577 of file integration.cpp.

                                      {
    iostream_server s;
    std::string handshake = "GET / HTTP/1.1\r\nHost: www.example.com\r\nConnection: upgrade\r\nUpgrade: websocket\r\nSec-WebSocket-Version: 13\r\nSec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\r\n\r\n";
    char buffer[2] = { char(0x81), char(0x80) };
 
    // suppress output (it needs a place to go to avoid error but we don't care what it is)
    std::stringstream null_output;
    s.register_ostream(&null_output);
 
    iostream_server::connection_ptr con = s.get_connection();
    con->start();
 
    // read handshake, should work
    BOOST_CHECK_EQUAL( con->read_some(handshake.data(), handshake.length()), handshake.length());
 
    // pause reading and try again. The first read should work, the second should return 0
    // the first read was queued already after the handshake so it will go through because
    // reading wasn't paused when it was queued. The byte it reads wont be enough to
    // complete the frame so another read will be requested. This one wont actually happen
    // because the connection is paused now.
    con->pause_reading();
    BOOST_CHECK_EQUAL( con->read_some(buffer, 1), 1);
    BOOST_CHECK_EQUAL( con->read_some(buffer+1, 1), 0);
    // resume reading and try again. Should work this time because the resume should have
    // re-queued a read.
    con->resume_reading();
    BOOST_CHECK_EQUAL( con->read_some(buffer+1, 1), 1);
}

Here is the call graph for this function:

BOOST_AUTO_TEST_CASE() [8/13]

BOOST_AUTO_TEST_CASE

(

pong_no_timeout

)

Definition at line 363 of file integration.cpp.

                                        {
    server s;
    client c;
 
    s.set_close_handler(bind(&stop_on_close,&s,::_1));
 
    // send a ping when the connection is open
    c.set_open_handler(bind(&ping_on_open<client>,&c,"foo",::_1));
    // require that a pong with matching payload is received
    c.set_pong_handler(bind(&req_pong,"foo",::_1,::_2));
    // require that a pong timeout is NOT received
    c.set_pong_timeout_handler(bind(&fail_on_pong_timeout,::_1,::_2));
 
    websocketpp::lib::thread sthread(websocketpp::lib::bind(&run_server,&s,9005,false));
 
    // Run a client that closes the connection after 1 seconds
    run_time_limited_client(c, "http://localhost:9005", 1, false);
 
    sthread.join();
}

Here is the call graph for this function:

BOOST_AUTO_TEST_CASE() [9/13]

BOOST_AUTO_TEST_CASE

(

pong_timeout

)

Definition at line 384 of file integration.cpp.

                                     {
    server s;
    client c;
 
    s.set_ping_handler(bind(&on_ping, &s,::_1,::_2));
    s.set_close_handler(bind(&stop_on_close,&s,::_1));
 
    c.set_fail_handler(bind(&check_ec<client>,&c,
        websocketpp::lib::error_code(),::_1));
 
    c.set_pong_handler(bind(&fail_on_pong,::_1,::_2));
    c.set_open_handler(bind(&ping_on_open<client>,&c,"foo",::_1));
    c.set_pong_timeout_handler(bind(&req_pong_timeout<client>,&c,"foo",::_1,::_2));
    c.set_close_handler(bind(&check_ec<client>,&c,
        websocketpp::lib::error_code(),::_1));
 
    websocketpp::lib::thread sthread(websocketpp::lib::bind(&run_server,&s,9005,false));
    websocketpp::lib::thread tthread(websocketpp::lib::bind(&run_test_timer,10));
    tthread.detach();
 
    run_client(c, "http://localhost:9005",false);
 
    sthread.join();
}

Here is the call graph for this function:

BOOST_AUTO_TEST_CASE() [10/13]

BOOST_AUTO_TEST_CASE

(

server_connection_cleanup

)

Definition at line 607 of file integration.cpp.

                                                  {
    server_tls s;
}

BOOST_AUTO_TEST_CASE() [11/13]

BOOST_AUTO_TEST_CASE

(

server_open_handshake_timeout

)

Definition at line 426 of file integration.cpp.

                                                      {
    server s;
 
    // set open handler to fail test
    s.set_open_handler(bind(&fail_on_open,::_1));
    // set fail hander to test for the right fail error code
    s.set_fail_handler(bind(&check_ec_and_stop<server>,&s,
        websocketpp::error::open_handshake_timeout,::_1));
 
    websocketpp::lib::thread sthread(websocketpp::lib::bind(&run_server,&s,9005,false));
    websocketpp::lib::thread tthread(websocketpp::lib::bind(&run_test_timer,10));
    tthread.detach();
 
    run_dummy_client("9005");
 
    sthread.join();
}

Here is the call graph for this function:

BOOST_AUTO_TEST_CASE() [12/13]

BOOST_AUTO_TEST_CASE

(

server_self_initiated_close_handshake_timeout

)

Definition at line 476 of file integration.cpp.

                                                                      {
    server s;
    client c;
 
    // on open server sends close
    // on open client sleeps for longer than the timeout
    // server handshake timer should be triggered
 
    s.set_open_handler(bind(&close<server>,&s,::_1));
    s.set_close_handler(bind(&check_ec_and_stop<server>,&s,
        websocketpp::error::close_handshake_timeout,::_1));
 
    c.set_open_handler(bind(&delay,::_1,1));
 
    websocketpp::lib::thread sthread(websocketpp::lib::bind(&run_server,&s,9005,false));
    websocketpp::lib::thread tthread(websocketpp::lib::bind(&run_test_timer,10));
    tthread.detach();
 
    run_client(c, "http://localhost:9005",false);
 
    sthread.join();
}

Here is the call graph for this function:

BOOST_AUTO_TEST_CASE() [13/13]

BOOST_AUTO_TEST_CASE

(

stop_listening

)

Definition at line 558 of file integration.cpp.

                                       {
    server s;
    client c;
 
    // the first connection stops the server from listening
    s.set_open_handler(bind(&cancel_on_open,&s,::_1));
 
    // client immediately closes after opening a connection
    c.set_open_handler(bind(&close<client>,&c,::_1));
 
    websocketpp::lib::thread sthread(websocketpp::lib::bind(&run_server,&s,9005,false));
    websocketpp::lib::thread tthread(websocketpp::lib::bind(&run_test_timer,5));
    tthread.detach();
 
    run_client(c, "http://localhost:9005",false);
 
    sthread.join();
}

Here is the call graph for this function:

cancel_on_open()

void cancel_on_open	(	server *	s,
		websocketpp::connection_hdl	)

Definition at line 281 of file integration.cpp.

                                                           {
    s->stop_listening();
}

Here is the caller graph for this function:

check_ec()

template<typename T >

void check_ec	(	T *	c,
		websocketpp::lib::error_code	ec,
		websocketpp::connection_hdl	hdl )

Definition at line 323 of file integration.cpp.

{
    typename T::connection_ptr con = c->get_con_from_hdl(hdl);
    BOOST_CHECK_EQUAL( con->get_ec(), ec );
    //BOOST_CHECK_EQUAL( con->get_local_close_code(), websocketpp::close::status::normal );
    //BOOST_CHECK_EQUAL( con->get_remote_close_code(), websocketpp::close::status::normal );
}

Here is the caller graph for this function:

check_ec_and_stop()

template<typename T >

void check_ec_and_stop	(	T *	e,
		websocketpp::lib::error_code	ec,
		websocketpp::connection_hdl	hdl )

Definition at line 333 of file integration.cpp.

{
    typename T::connection_ptr con = e->get_con_from_hdl(hdl);
    BOOST_CHECK_EQUAL( con->get_ec(), ec );
    //BOOST_CHECK_EQUAL( con->get_local_close_code(), websocketpp::close::status::normal );
    //BOOST_CHECK_EQUAL( con->get_remote_close_code(), websocketpp::close::status::normal );
    e->stop();
}

Here is the caller graph for this function:

close()

template<typename T >

void close	(	T *	e,
		websocketpp::connection_hdl	hdl )

Definition at line 353 of file integration.cpp.

                                                 {
    e->get_con_from_hdl(hdl)->close(websocketpp::close::status::normal,"");
}

Here is the caller graph for this function:

close_after_timeout()

template<typename T >

void close_after_timeout	(	T &	e,
		websocketpp::connection_hdl	hdl,
		long	timeout )

Definition at line 139 of file integration.cpp.

                                                                             {
    sleep(timeout);
 
    websocketpp::lib::error_code ec;
    e.close(hdl,websocketpp::close::status::normal,"",ec);
    BOOST_CHECK(!ec);
}

Here is the caller graph for this function:

delay()

void delay	(	websocketpp::connection_hdl	,
		long	duration )

Definition at line 318 of file integration.cpp.

                                                     {
    sleep(duration);
}

Here is the caller graph for this function:

fail_on_open()

void fail_on_open

(

websocketpp::connection_hdl

)

Definition at line 314 of file integration.cpp.

                                             {
    BOOST_FAIL( "expected no open handler" );
}

Here is the caller graph for this function:

fail_on_pong()

void fail_on_pong	(	websocketpp::connection_hdl	,
		std::string	)

Definition at line 300 of file integration.cpp.

                                                        {
    BOOST_FAIL( "expected no pong handler" );
}

Here is the caller graph for this function:

fail_on_pong_timeout()

void fail_on_pong_timeout	(	websocketpp::connection_hdl	,
		std::string	)

Definition at line 304 of file integration.cpp.

                                                                {
    BOOST_FAIL( "expected no pong timeout" );
}

Here is the caller graph for this function:

on_ping()

bool on_ping	(	server *	s,
		websocketpp::connection_hdl	,
		std::string	)

Definition at line 276 of file integration.cpp.

                                                               {
    s->get_alog().write(websocketpp::log::alevel::app,"got ping");
    return false;
}

Here is the call graph for this function:

Here is the caller graph for this function:

ping_on_open()

template<typename T >

void ping_on_open	(	T *	c,
		std::string	payload,
		websocketpp::connection_hdl	hdl )

Definition at line 293 of file integration.cpp.

                                                                           {
    typename T::connection_ptr con = c->get_con_from_hdl(hdl);
    websocketpp::lib::error_code ec;
    con->ping(payload,ec);
    BOOST_CHECK_EQUAL(ec, websocketpp::lib::error_code());
}

Here is the caller graph for this function:

req_pong()

void req_pong	(	std::string	expected_payload,
		websocketpp::connection_hdl	,
		std::string	payload )

Definition at line 308 of file integration.cpp.

{
    BOOST_CHECK_EQUAL( expected_payload, payload );
}

Here is the caller graph for this function:

req_pong_timeout()

template<typename T >

void req_pong_timeout	(	T *	c,
		std::string	expected_payload,
		websocketpp::connection_hdl	hdl,
		std::string	payload )

Definition at line 344 of file integration.cpp.

{
    typename T::connection_ptr con = c->get_con_from_hdl(hdl);
    BOOST_CHECK_EQUAL( payload, expected_payload );
    con->close(websocketpp::close::status::normal,"");
}

Here is the caller graph for this function:

run_client()

void run_client	(	client &	c,
		std::string	uri,
		bool	log = false )

Definition at line 164 of file integration.cpp.

                                                             {
    if (log) {
        c.set_access_channels(websocketpp::log::alevel::all);
        c.set_error_channels(websocketpp::log::elevel::all);
    } else {
        c.clear_access_channels(websocketpp::log::alevel::all);
        c.clear_error_channels(websocketpp::log::elevel::all);
    }
    websocketpp::lib::error_code ec;
    c.init_asio(ec);
    c.set_reuse_addr(true);
    BOOST_CHECK(!ec);
 
    client::connection_ptr con = c.get_connection(uri,ec);
    BOOST_CHECK( !ec );
    c.connect(con);
 
    c.run();
}

Here is the call graph for this function:

Here is the caller graph for this function:

run_client_and_mark()

void run_client_and_mark	(	client *	c,
		bool *	flag,
		websocketpp::lib::mutex *	mutex )

Definition at line 184 of file integration.cpp.

                                                                               {
    c->run();
    BOOST_CHECK( true );
    websocketpp::lib::lock_guard<websocketpp::lib::mutex> lock(*mutex);
    *flag = true;
    BOOST_CHECK( true );
}

Here is the call graph for this function:

Here is the caller graph for this function:

run_dummy_client()

void run_dummy_client

(

std::string

port

)

Definition at line 247 of file integration.cpp.

                                      {
    using boost::asio::ip::tcp;
 
    try {
        boost::asio::io_service io_service;
        tcp::resolver resolver(io_service);
        tcp::resolver::query query("localhost", port);
        tcp::resolver::iterator iterator = resolver.resolve(query);
        tcp::socket socket(io_service);
 
        boost::asio::connect(socket, iterator);
        for (;;) {
            char data[512];
            boost::system::error_code ec;
            socket.read_some(boost::asio::buffer(data), ec);
            if (ec == boost::asio::error::eof) {
                break;
            } else if (ec) {
                // other error
                throw ec;
            }
        }
    } catch (std::exception & e) {
        std::cout << e.what() << std::endl;
    } catch (boost::system::error_code & ec) {
        std::cout << ec.message() << std::endl;
    }
}

Here is the caller graph for this function:

run_dummy_server()

void run_dummy_server

(

int

port

)

Definition at line 220 of file integration.cpp.

                                {
    using boost::asio::ip::tcp;
 
    try {
        boost::asio::io_service io_service;
        tcp::acceptor acceptor(io_service, tcp::endpoint(tcp::v6(), port));
        tcp::socket socket(io_service);
 
        acceptor.accept(socket);
        for (;;) {
            char data[512];
            boost::system::error_code ec;
            socket.read_some(boost::asio::buffer(data), ec);
            if (ec == boost::asio::error::eof) {
                break;
            } else if (ec) {
                // other error
                throw ec;
            }
        }
    } catch (std::exception & e) {
        std::cout << e.what() << std::endl;
    } catch (boost::system::error_code & ec) {
        std::cout << ec.message() << std::endl;
    }
}

Here is the caller graph for this function:

run_server()

void run_server	(	server *	s,
		int	port,
		bool	log = false )

Definition at line 147 of file integration.cpp.

                                                        {
    if (log) {
        s->set_access_channels(websocketpp::log::alevel::all);
        s->set_error_channels(websocketpp::log::elevel::all);
    } else {
        s->clear_access_channels(websocketpp::log::alevel::all);
        s->clear_error_channels(websocketpp::log::elevel::all);
    }
 
    s->init_asio();
    s->set_reuse_addr(true);
 
    s->listen(port);
    s->start_accept();
    s->run();
}

Here is the caller graph for this function:

run_test_timer()

void run_test_timer

(

long

value

)

Definition at line 358 of file integration.cpp.

                                {
    sleep(value);
    BOOST_FAIL( "Test timed out" );
}

Here is the caller graph for this function:

run_time_limited_client()

void run_time_limited_client	(	client &	c,
		std::string	uri,
		long	timeout,
		bool	log )

Definition at line 192 of file integration.cpp.

{
    if (log) {
        c.set_access_channels(websocketpp::log::alevel::all);
        c.set_error_channels(websocketpp::log::elevel::all);
    } else {
        c.clear_access_channels(websocketpp::log::alevel::all);
        c.clear_error_channels(websocketpp::log::elevel::all);
    }
    c.init_asio();
 
    websocketpp::lib::error_code ec;
    client::connection_ptr con = c.get_connection(uri,ec);
    BOOST_CHECK( !ec );
    c.connect(con);
 
    websocketpp::lib::thread tthread(websocketpp::lib::bind(
        &close_after_timeout<client>,
        websocketpp::lib::ref(c),
        con->get_handle(),
        timeout
    ));
    tthread.detach();
 
    c.run();
}

Here is the call graph for this function:

Here is the caller graph for this function:

stop_on_close()

void stop_on_close	(	server *	s,
		websocketpp::connection_hdl	hdl )

Definition at line 285 of file integration.cpp.

                                                              {
    server::connection_ptr con = s->get_con_from_hdl(hdl);
    //BOOST_CHECK_EQUAL( con->get_local_close_code(), websocketpp::close::status::normal );
    //BOOST_CHECK_EQUAL( con->get_remote_close_code(), websocketpp::close::status::normal );
    s->stop();
}

Here is the caller graph for this function: