better documentation on create
[newns] / newns
diff --git a/newns b/newns
index a2233fb700b077a6933381f812ed9b5ce89919c7..39f8971f94baf6036947eb0ddc50e6503fba08c9 100755 (executable)
--- a/newns
+++ b/newns
@@ -40,7 +40,10 @@ usage() {
 usage: ${0##*/} [OPTS] start|stop NS_NAME
 Setup new or systemd created network namespace with nat and mount namespace
 
--c, --create    Create network namespace. For running outside systemd private net.
+-c, --create    Create a named network namespace. When running from
+                the same network namespace as pid 1, this is set automatically.
+                This is the case when running outside a systemd created
+                private network.
 -h, --help      Show this help and exit.
 
 From within a systemd network namespace, nat it to the outside. This
@@ -74,10 +77,10 @@ in.
 Background:
 
 This script does not make the namespace be named like ip does, because
-the naming is not necessary, although it could have with some more
-work. For debugging and joining the namespace with a bash shell, I use
-nsenter -n -m -t $(pgrep PROCESS_IN_NAMESPACE).  Note: if I knew how to
-easily ask systemd what pid a unit has, i would do that.
+the naming is not necessary, although it could have been done with some
+more work. For debugging and joining the namespace with a bash shell, I
+use nsenter -n -m -t $(pgrep PROCESS_IN_NAMESPACE).  Note: if I knew how
+to easily ask systemd what pid a unit has, i would do that.
 
 "ip netns new ..." also does a mount namespace, then bind
 mounts each file/dir in /etc/netns/NS_NAME to /etc/NS_NAME. Note,