]> ruderich.org/simon Gitweb - linux-network-namespace-labs/linux-network-namespace-labs.git/commitdiff
Rename binary linux-network-namespace-labs to lnnl
authorSimon Ruderich <simon@ruderich.org>
Wed, 15 Jul 2026 05:47:03 +0000 (07:47 +0200)
committerSimon Ruderich <simon@ruderich.org>
Wed, 15 Jul 2026 05:47:03 +0000 (07:47 +0200)
The old name was a bit too long.

.gitignore
README.adoc
ci/examples
examples/bird-ospf/README.adoc
examples/bird-ospf/lab.conf
examples/layer3/README.adoc
examples/layer3/lab.conf
examples/podman-frr/README.adoc
examples/podman-frr/run.sh
examples/readme/lab.conf
go.mod

index 7661a793d8957d6d7c51c1a8ef4c6659d49f00ae..e90d63c5c8bd6d8a20bc65692ca2ef5c8c6620c3 100644 (file)
@@ -1 +1 @@
-/linux-network-namespace-labs
+/lnnl
index acb60fabcdf0e5d8585a40e087ea3248379edd87..b5afc372ae5e1208dc38e043788a383bff19f66f 100644 (file)
@@ -1,11 +1,11 @@
 = README
 
-linux-network-namespace-labs is a small program to easily create networking
-lab setups based on Linux network namespaces. It provides a quick way to set
-up labs using a text file describing the architecture (networks, nodes, links,
-commands). This is much simpler than running each node in a separate virtual
-machine or manually allocating the IP addresses for each node. It is licensed
-under GPLv3+.
+linux-network-namespace-labs (lnnl) is a small program to easily create
+networking lab setups based on Linux network namespaces. It provides a quick
+way to set up labs using a text file describing the architecture (networks,
+nodes, links, commands). This is much simpler than running each node in a
+separate virtual machine or manually allocating the IP addresses for each
+node. It is licensed under GPLv3+.
 
 
 == Requirements
@@ -24,8 +24,7 @@ under GPLv3+.
 
     $ go build
 
-Then copy the binary `linux-network-namespace-labs` to a directory in your
-`$PATH`.
+Then copy the binary `lnnl` to a directory in your `$PATH`.
 
 
 == Usage
@@ -57,7 +56,7 @@ cmd ./setup.sh $1
 Then set up the lab by running (as root):
 
     # cd examples/readme
-    # linux-network-namespace-labs up lab.conf
+    # lnnl up lab.conf
     [...]
 
 Now you can enter the network namespace of each router and test a simple
@@ -89,18 +88,18 @@ well:
 When you change the configuration you can simply rerun "up" and it will remove
 the lab (and kill all processes inside it) before restarting it:
 
-    # linux-network-namespace-labs up lab.conf
+    # lnnl up lab.conf
     [...]
 
 When you're done you can remove the lab with:
 
-    # linux-network-namespace-labs down lab.conf
+    # lnnl down lab.conf
     [...]
 
 To get an overview of the network you can create a
 https://en.wikipedia.org/wiki/DOT_(graph_description_language)[DOT] file:
 
-    $ linux-network-namespace-labs dot lab.conf lab.dot
+    $ lnnl dot lab.conf lab.dot
     $ dot -Tpng lab.dot > lab.png
 
 image::examples/readme/lab.png[DOT style diagram of network nodes and links]
index 945cb3dab47001b0513fdd213f140224ad6e0bf0..3a04d0e5a6a34e3cc9b8fcd33aaf586b9b934ec5 100755 (executable)
@@ -29,22 +29,22 @@ test -z "$(ip netns)"
 
 
 # No `cd` here to test that relative paths work
-linux-network-namespace-labs up "$examples/bird-ospf/lab.conf"
+lnnl up "$examples/bird-ospf/lab.conf"
 # Wait until OSPF is ready
 wait_for_route r1 3fff::1
 wait_for_route r1 3fff::2
 ip netns exec r1 ping -c1 r1-loop
 ip netns exec r1 ping -c1 r2-loop
 ip netns exec r1 ping -c1 r3-loop
-linux-network-namespace-labs down "$examples/bird-ospf/lab.conf"
+lnnl down "$examples/bird-ospf/lab.conf"
 test -z "$(ip netns)"
 test "$(cd /etc/netns; find)" = "." # directory empty
 
 cd "$examples/layer3"
-linux-network-namespace-labs up lab.conf
+lnnl up lab.conf
 ip netns exec r1 ip route add 3fff::1/128 dev r2
 ip netns exec r1 ping -c1 3fff::1
-linux-network-namespace-labs down lab.conf
+lnnl down lab.conf
 test -z "$(ip netns)"
 test "$(cd /etc/netns; find)" = "." # directory empty
 
@@ -52,15 +52,15 @@ cd "$examples/podman-frr"
 ./run.sh
 wait_for_route r1 3fff::1
 ip netns exec r1 ping -c1 r1-loop
-linux-network-namespace-labs down lab.conf
+lnnl down lab.conf
 test -z "$(ip netns)"
 test "$(cd /etc/netns; find)" = "." # directory empty
 
 cd "$examples/readme"
-linux-network-namespace-labs up lab.conf
+lnnl up lab.conf
 ip netns exec r1 ping -c1 r1-loop
 ip netns exec r1 ping -c1 r2-loop
 ip netns exec r1 ping -c1 r3-loop
-linux-network-namespace-labs down lab.conf
+lnnl down lab.conf
 test -z "$(ip netns)"
 test "$(cd /etc/netns; find)" = "." # directory empty
index cba8f6d9d24b40ccf3da0c1ebf13e4c362ae795f..d693c5d1a71cac989b0f3b9f9bf2e38160f55f41 100644 (file)
@@ -10,7 +10,7 @@ directory `/run/bird/` exist.
 
 To start the lab use (as root):
 
-    # linux-network-namespace-labs up lab.conf
+    # lnnl up lab.conf
 
 You can use the following shell function to connect to the bird running on the
 current node:
@@ -26,4 +26,4 @@ For example:
 
 To stop the lab use:
 
-    # linux-network-namespace-labs down lab.conf
+    # lnnl down lab.conf
index d48610855519c3b2791acc611235662718ab8d7b..544253d498865d0f776a7c89d8e3fb786e4d0ada 100644 (file)
@@ -1,4 +1,4 @@
-# Start lab with: linux-network-namespace-labs up lab.conf
+# Start lab with: lnnl up lab.conf
 
 # r1 <-> r2 <-> r3
 
index 8ac8c490b555fa3306c5e56e2d8985de1188dd77..c1d7963ba72a23999cf0c187957b4d2441c19429 100644 (file)
@@ -7,7 +7,7 @@ You need kernel 6.7 and iproute2 6.8.
 
 Then start the lab (as root) with:
 
-    # linux-network-namespace-labs up lab.conf
+    # lnnl up lab.conf
 
 To enter the node use:
 
@@ -37,4 +37,4 @@ To enter the node use:
 
 To stop the lab use:
 
-    # linux-network-namespace-labs down lab.conf
+    # lnnl down lab.conf
index 9a67eed2a1500eb15df485de339514d46cbde254..01426f4904a5dadabb33eed15408eb4840b26221 100644 (file)
@@ -1,4 +1,4 @@
-# Start lab with: linux-network-namespace-labs up lab.conf
+# Start lab with: lnnl up lab.conf
 
 # r1 <-> r2
 
index af38be85780be9f3fbee33932eb2b45c398cb691..545baf280d6e287889183474087139790d38cb30 100644 (file)
@@ -16,4 +16,4 @@ Connect to FRR in the container with:
 
 To stop the lab use:
 
-    # linux-network-namespace-labs down lab.conf
+    # lnnl down lab.conf
index 3076556750f62cade59c98adbaed0e60bdab1cb2..a4d935f3949b4ef809184d2227496c4bb5a9c100 100755 (executable)
@@ -25,7 +25,7 @@ podman_stop() {
 podman_stop r1 || true
 podman_stop r2 || true
 
-linux-network-namespace-labs up lab.conf
+lnnl up lab.conf
 
 podman_run r1
 podman_run r2
index 3a4778722698a91b93c92839e495ad6729235d5a..dd02d7a6e52688e180e73037f6a14d8be2fac9b5 100644 (file)
@@ -1,4 +1,4 @@
-# Start lab with: linux-network-namespace-labs up lab.conf
+# Start lab with: lnnl up lab.conf
 
 
 # Network range for loopback addresses of the nodes
diff --git a/go.mod b/go.mod
index 08607773285fb040fef9903c434580382360e038..954835b636ce877f96cbcc83dd0cd0df60ac8ba6 100644 (file)
--- a/go.mod
+++ b/go.mod
@@ -1,3 +1,3 @@
-module linux-network-namespace-labs
+module lnnl
 
 go 1.26