https://github.com/pseudomanifold/simpleserver
Simple TCP/IP server implementation in modern C++
https://github.com/pseudomanifold/simpleserver
c-plus-plus cpp11 network qotd-server simple-server tcp-server
Last synced: about 2 months ago
JSON representation
Simple TCP/IP server implementation in modern C++
- Host: GitHub
- URL: https://github.com/pseudomanifold/simpleserver
- Owner: Pseudomanifold
- License: mit
- Created: 2015-07-18T20:31:59.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2019-07-23T09:43:43.000Z (almost 6 years ago)
- Last Synced: 2025-03-24T15:47:23.167Z (2 months ago)
- Topics: c-plus-plus, cpp11, network, qotd-server, simple-server, tcp-server
- Language: C++
- Size: 166 KB
- Stars: 18
- Watchers: 4
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SimpleServer
This repository contains [my](http://bastian.rieck.ru) implementation of
a simple TCP/IP server in C++. I started fiddling with this to learn
more about UNIX network programming.
See [the initial blog post](http://bastian.rieck.ru/blog/posts/2015/sockets_ordeal_cxx11)
or [its successor](http://bastian.rieck.ru/blog/posts/2015/synchronous_multiplexing_sockets_cxx11) for
additional information and comments.
## How do I use the API?
The sources are meant to become an API when they grow up. At present
there are two server implementations:
* `qotd.cc` contains a *Quote of the Day* service implementation
* `echo.cc` contains an *echo* service implementation
## What's cool about it?
Good question. I wanted to encapsulate the C API for socket programming
and make it more modern. So far, I did not really succeed, I guess.
There is one cool thing at the moment: Requests are handled by
specifying an arbitrary function object (yay, C++11). This function is
then called asynchronously (yay, C++11 again!) whenever a new client is
accepted. You can then send stuff to the client or whatever...
## How do I run my own QOTD server?
That at least I may answer! After cloning this repository, please run
the following commands:
$ mkdir build
$ cd build
$ cmake ../
$ make
$ ./qotd ../Quotes.txt
You can exit the server with CTRL+C. You can connect to your server like
this:
$ nc localhost 1041
## Why is the QOTD server not running under port 17?
Because most Linux distributions disallow opening ports below 1024
without root access or at least configuration changes. While I think
that I am a trustworthy person, I do not presume that you want to
compile this as root...
Thus, the QOTD server runs under port 1041, which is 1024+17 and hence
quite clever.
## How do I run my own echo server?
$ mkdir build
$ cd build
$ cmake ../
$ make
$ ./echo
Note that the server runs under port 1031, which is 1024+7 and hence
quite clever as well (see the answer to the previous question).
## Acknowledgements
Thanks to [Uri London](https://github.com/uri247) for very useful
suggestions that helped improve the code.
## Licence
The code is released under an MIT licence.