From 42fb218347c63001805bcfc436d294938c666d76 Mon Sep 17 00:00:00 2001
From: David Gibson <david@gibson.dropbear.id.au>
Date: Thu, 6 Apr 2023 13:28:08 +1000
Subject: nstool: Move description of its operation modes from comment to usage

Easier to see it there.

Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: Stefano Brivio <sbrivio@redhat.com>
---
 test/nstool.c | 26 +++++++++++---------------
 1 file changed, 11 insertions(+), 15 deletions(-)

diff --git a/test/nstool.c b/test/nstool.c
index 8f66c98..20fcc4c 100644
--- a/test/nstool.c
+++ b/test/nstool.c
@@ -4,20 +4,6 @@
  *
  * Copyright Red Hat
  * Author: David Gibson <david@gibson.dropbear.id.au>
- *
- * Can run in 3 modes:
- *
- *   nstool hold <path>
- *      Designed to be run inside a namespace, opens a Unix domain
- *      control socket at <path> and waits until instructed to stop
- *      with "nstool stop <path>"
- *   nstool pid <path>
- *      Prints the PID of the nstool hold process with control socket
- *      <path>.  This is given in the PID namespace where nstool pid
- *      is executed, not the one where nstool hold is running
- *   nstool stop <path>
- *      Instruct the nstool hold with control socket at <path> to
- *      exit.
  */
 
 #define _GNU_SOURCE
@@ -38,7 +24,17 @@
 
 static void usage(void)
 {
-	die("Usage: nstool hold|pid|stop <socket path>\n");
+	die("Usage:\n"
+	    "  nstool hold SOCK\n"
+	    "    Run within a set of namespaces, open a Unix domain socket\n"
+	    "    (the \"control socket\") at SOCK and wait for requests from\n"
+	    "    other nstool subcommands.\n"
+	    "  nstool pid SOCK\n"
+	    "    Print the pid of the nstool hold process with control socket\n"
+	    "    at SOCK, as seen in the caller's namespace.\n"
+	    "  nstool stop SOCK\n"
+	    "    Instruct the nstool hold with control socket at SOCK to\n"
+	    "    terminate.\n");
 }
 
 static void hold(int fd, const struct sockaddr_un *addr)
-- 
cgit v1.2.3