5 files changed, 157 insertions, 0 deletions
diff --git a/src/Makefile.am b/src/Makefile.am
index 0deabb1..e0bfe6b 100644
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -1,2 +1,5 @@
 ## [psocksxx] src/
 
+SUBDIRS = \
+	examples
+
diff --git a/src/examples/Makefile.am b/src/examples/Makefile.am
new file mode 100644
index 0000000..3155e25
--- /dev/null
+++ b/src/examples/Makefile.am
@@ -0,0 +1,5 @@
+## [psocksxx] src/examples/
+
+SUBDIRS = \
+	echo
+
diff --git a/src/examples/echo/Makefile.am b/src/examples/echo/Makefile.am
new file mode 100644
index 0000000..a1ada4b
--- /dev/null
+++ b/src/examples/echo/Makefile.am
@@ -0,0 +1,17 @@
+## [psocksxx] src/examples/echo/
+
+AM_CPPFLAGS         = -I$(top_srcdir)/lib
+noinst_PROGRAMS     = echo-server echo-client
+
+echo_server_LDADD   = \
+	$(top_builddir)/lib/psocksxx/libpsocksxx.la
+
+echo_client_LDADD   = \
+	$(top_builddir)/lib/psocksxx/libpsocksxx.la
+
+echo_server_SOURCES = \
+	server.cpp
+
+echo_client_SOURCES = \
+	client.cpp
+
diff --git a/src/examples/echo/client.cpp b/src/examples/echo/client.cpp
new file mode 100644
index 0000000..9039755
--- /dev/null
+++ b/src/examples/echo/client.cpp
@@ -0,0 +1,54 @@
+/*
+*  psocksxx - A C++ wrapper for POSIX sockets
+*  Copyright (C) 2013-2015 Uditha Atukorala
+*
+*  This file is part of psocksxx software library.
+*
+*  psocksxx software library is free software; you can redistribute it and/or modify
+*  it under the terms of the GNU Lesser General Public License as published by
+*  the Free Software Foundation; either version 3 of the License, or
+*  (at your option) any later version.
+*
+*  This software library is distributed in the hope that it will be useful,
+*  but WITHOUT ANY WARRANTY; without even the implied warranty of
+*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+*  GNU Lesser General Public License for more details.
+*
+*  You should have received a copy of the GNU Lesser General Public License
+*  along with this software library. If not, see <http://www.gnu.org/licenses/>.
+*
+*/
+
+
+#include <iostream>
+#include <string>
+#include <psocksxx/tcpnsockstream.h>
+
+
+int main() {
+
+	// tcp socket stream
+	psocksxx::tcpnsockstream ss;
+
+	// connect
+	try {
+		ss.connect( "localhost", 21555 );
+	} catch ( psocksxx::sockexception &e ) {
+		std::cerr << "[client] failed to connect to socket, exception" << e.what() << std::endl;
+		return 1;
+	}
+
+	// send a message
+	ss << "hello" << std::endl;
+
+	// get the echo back from server
+	std::string msg;
+	ss >> msg;
+
+	// print message
+	std::cout << "[server] " << msg << std::endl;
+
+	return 0;
+
+}
+
diff --git a/src/examples/echo/server.cpp b/src/examples/echo/server.cpp
new file mode 100644
index 0000000..2257847
--- /dev/null
+++ b/src/examples/echo/server.cpp
@@ -0,0 +1,78 @@
+/*
+*  psocksxx - A C++ wrapper for POSIX sockets
+*  Copyright (C) 2013-2015 Uditha Atukorala
+*
+*  This file is part of psocksxx software library.
+*
+*  psocksxx software library is free software; you can redistribute it and/or modify
+*  it under the terms of the GNU Lesser General Public License as published by
+*  the Free Software Foundation; either version 3 of the License, or
+*  (at your option) any later version.
+*
+*  This software library is distributed in the hope that it will be useful,
+*  but WITHOUT ANY WARRANTY; without even the implied warranty of
+*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+*  GNU Lesser General Public License for more details.
+*
+*  You should have received a copy of the GNU Lesser General Public License
+*  along with this software library. If not, see <http://www.gnu.org/licenses/>.
+*
+*/
+
+
+#include <iostream>
+#include <string>
+#include <psocksxx/tcpnsockstream.h>
+
+
+int main( int argc, char **argv ) {
+
+	// tcp socket stream
+	psocksxx::tcpnsockstream ss;
+
+	// network address to bind to
+	psocksxx::nsockaddr naddr( "localhost", "21555" );
+
+	// bind
+	try {
+		ss.bind( &naddr, true );
+	} catch( psocksxx::sockexception &e ) {
+		std::cerr << "[server] failed to bind to socket, exception: " << e.what() << std::endl;
+		return 1;
+	}
+
+	// listen
+	try {
+		ss.listen();
+	} catch( psocksxx::sockexception &e ) {
+		std::cerr << "[server] failed to listen on socket, exception: " << e.what() << std::endl;
+		return 1;
+	}
+
+
+	// client socket stream
+	psocksxx::nsockstream * css;
+
+	// message buffer
+	std::string msg;
+
+	for (;;) {
+
+		// accept a new client
+		css = ss.accept();
+
+		(* css) >> msg;
+		std::cout << "[client] " << msg << std::endl;
+
+		// echo back
+		(* css) << msg << std::endl;
+
+		// close/cleanup client
+		delete css;
+
+	}
+
+	return 0;
+
+}
+