Requirements:

• Make
• A modern C compiler (Clang, GCC, std99)
• A UNIX environment
• ncurses

The project has multiple binaries. The default target all builds atc (a stand-alone executable), atcd-socket and atcc-socket. The transport can be changed overriding the BACKEND parameter and defaults to socket.

Examples:

make atc

Builds the stand-alone binary

make BACKEND="pipe"

Builds atc, atcd-pipe, and atcc-pipe.

For Ubuntu 14.04

apt-get install libncurses5-dev

The binaries are compiled with -O0 -g by default. GDB and Valgrind can be used for debugging.

The project is divided into six main modules and some extra support files:

• ATCC: Frontend, client side logic.
• CLI: Re-implements the ATCD functions as proxy calls to the API.
• COMM: A bi-directional communication layer, used by Protocol.
  • Pipe
  • File
  • Socket
  • Queue
  • Shmem
• SRV: Server side logic, does all the forking and client management, while child processes call the backend functions.
• ATCD: Game logic, keeps the game state and runs the simulation.
• STO: Data storage abstraction layer (w/locking + concurrency control.)
• Protocol: Common message/protocol functions and header. Backend-agnostic.

Combo table:

Make will re-compile the binaries when the follwing files get updated:

Additionally, Make will set these preprocessor variables: ATC_BACKEND_$(BACKEND_IN_UPPERCASE) and ATC_BACKEND=$(BACKEND_IN_UPPERCASE).