Skip to content

Latest commit

 

History

History
69 lines (55 loc) · 1.55 KB

README.md

File metadata and controls

69 lines (55 loc) · 1.55 KB
Raw

nstack

Overview

nstack is a Linux userspace TCP/IP stack. It was constructed to meet the following goals:

  • Learn TCP/IP
  • Learn Linux systems/network programming
  • Learn Linux Socket API

Current features:

  • One network interface and socket
  • Ethernet frame handling
  • ARP request/reply, simple caching
  • ICMP pings and replies
  • IPv4 packet handling, checksum
  • TCPv4 Handshake
  • TCP data transmission

Build and Test

make

Set up test environment:

sudo tools/testenv.sh start
tools/run.sh veth1

Execute ping inside test environment:

tools/ping_test.sh

Expected nstack messages:

arp_gratuitous: Announce 10.0.0.2
nstack_ingress_thread: Waiting for rx
nstack_ingress_thread: Frame received!
ether_input: proto id: 0x800
ip_input: proto id: 0x1
icmp_input: ICMP type: 8
nstack_ingress_thread: tick
nstack_ingress_thread: Waiting for rx
nstack_ingress_thread: Frame received!
ether_input: proto id: 0x800
ip_input: proto id: 0x1
icmp_input: ICMP type: 8

Ending the test environment:

sudo tools/testenv.sh stop

Licensing

nstack is freely redistributable under the two-clause BSD License. Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.

Reference