ProtocolStack

ProtocolStack

This repository is for learning network programming in Go and mainly aims to implement TCP/IP stack.

Requirements

• OS: Linux
• Go: 1.14.x or higher

Instructions

ProtocolStack needs a TAP device for its capability. For the reason, this project uses a virtual machine (Linux) to run the application. Also, you can perform debugging remotely with the VM if you use GoLand.

1. Prepare virtual machine

Software required is as follows:

• Mutagen
• Vagrant
• VirtualBox

Note: Mutagen synchronizes files between local system and virtual machine.

2. Control virtual machine

vm.sh controls the virtual machine. The available commands are as follows:

• start start the virtual machine
• stop stop the virtual machine
• restart restart the virtual machine

You can perform the commands below:

> ./vm.sh start   # Start a VM and create a Mutagen session.
> ./vm.sh stop    # Stop the VM and terminate the Mutagen session.
> ./vm.sh restart # Restart the VM and recreate the Mutagen session.

3. Remote debugging with GoLand

See the instruction for more detail.

Related information:

• What Are Run Targets & How To Run Code Anywhere
• How to use Docker to compile and run Go code from GoLand
• Compile and run Go code using WSL 2 and GoLand

4. Compile

It is able to compile the application with make as below:

> make compile

If no argument is provided, make compiles the server implicitly. When you would like to compile the other applications, specify BUILD_TYPE argument like below:

> make compile BUILD_TYPE=ping

Note: make supports the commands below:

• build build project
• clean clean up caches
• compile resolve dependencies, and build the program
• fmt run formatter
• gen generate source code
• lint run linters (golangci-lint)
• resolve resolve dependencies
• test run all tests

Supported Protocols

• Ethernet
• ARP
  • Request
  • Reply
• IP
  • v4
  • v6
• ICMP
  • Echo Request
  • Echo Reply
• TCP
• UDP

Examples

• ICMP Echo Reply

References

• Articles
  • Demystifying memory management in modern programming languages
• Blogs
  • golangspec
  • Vincent Blanchon
• Books
  • Hands-On High Performance with Go
  • Mastering Go - Second Edition
  • Multiplayer Game Programming: Architecting Networked Games
  • TCP/IP Illustrated
• Docs
  • Codecov
    • About the Codecov yaml
    • Codecov Delta
  • Docker
    • Compose file
    • Dockerfile
    • Overview of Docker Compose
  • fedora
    • DNF, the next-generation replacement for YUM
    • Understanding and administering systemd
  • GitHub Actions
    • Reference
  • Mutagen
    • File synchronization
  • Slack
    • Builder
      • Block Kit
      • Message
    • Reference guides for app features
  • UI
    • Error Message Guidelines
    • Messages: UI Text Guidelines
  • Vagrant
    • Vagrantfile
• Go
  • Articles
    • A Closer Look at Golang From an Architect’s Perspective
    • Go at Google: Language Design in the Service of Software Engineering
    • Go talks
    • Golang tips: why pointers to slices are useful and how ignoring them can lead to tricky bugs
  • Docs
    • Command compile
    • Command vet
    • Compiler And Runtime Optimizations
    • Data Race Detector
    • Effective Go
    • Frequently Asked Questions (FAQ)
      • Should I define methods on values or pointers?
        • Value vs Pointer Receivers
    • Getting Started with Code Coverage for Golang
    • Go by Example
    • Package testing
    • The Go Memory Model
    • The Go Programming Language Specification
  • Packages
    • github.com/google/go-cmp/cmp
• Makefile
  • A Good Makefile for Go
  • GNU Make Manual
• Papers
  • Fifty Shades of Congestion Control: A Performance and Interactions Evaluation
• RFC
  • 791: Internet Protocol
  • 793: Transmission Control Protocol
  • 5952: 5. Text Representation of Special Addresses
• Open Source Software
  • avelino / awesome-go
  • pandax381 / microps
  • torvalds / linux
    • net / ethernet
    • net / ipv4
• Wikipedia
  • Computer Network
    • 0.0.0.0
    • Address Resolution Protocol
    • Data link layer
    • Ethernet frame
    • Internet Protocol
    • Network Layer
    • TUN/TAP
    • TCP congestion control
    • Transmission Control Protocol
    • User Datagram Protocol
  • Memory
    • Memory barrier
    • Memory management
    • Memory model (programming)
    • Memory safety
    • Region-based memory management
  • Others
    • Architectural pattern
    • Communicating sequential processes
    • Continuation
    • Cooperative multitasking
    • Critical section
    • Ellipsis (computer programming)
    • Fair-share scheduling
    • Fork-join model
    • Generic programming
    • Monitor (synchronization)
    • Pipeline stall
    • Preemption (computing)
    • Process substitution
    • Reflective programming
    • Software design pattern
    • Task (computing)
    • Template metaprogramming
    • Thread pool
    • Threading models
    • Work stealing

Notes

• GO
  • Asynchronous Preemption
    • Go: Goroutine and Preemption
    • Goroutine preemptive scheduling with new features of go 1.14
  • Context
    • Go: Context and Cancellation by Propagation
• Programming
  • History of programming languages
• Question and answer site
  • C++ : how to close a tcp socket (server) when receiving SIGKILL
  • Understanding INADDR_ANY for socket programming
  • What is the difference between AF_INET and PF_INET in socket programming?

Memos

• Use the context types properly acording to the rubric.
  • context.Background()
  • context.TODO()
• Definition of errno in Go
  • go/src/syscall/zerrors_linux_amd64.go