Whamcloud - gitweb
Should only happen with lctl, but just to be safe...
[fs/lustre-release.git] / lustre / utils / lctl.c
index 9bf5eaa..1eaf62c 100644 (file)
@@ -41,13 +41,16 @@ static int jt_noop(int argc, char **argv) {
 
 command_t cmdlist[] = {
         /* Metacommands */
-        {"--device", jt_opt_device, 0, "--device <devno> <command [args ...]>"},
+        {"--device", jt_opt_device, 0,
+         "run <command> after connecting to device <devno>\n"
+         "--device <devno> <command [args ...]>"},
         {"--threads", jt_opt_threads, 0,
-                "--threads <threads> <devno> <command [args ...]>"},
+         "run <threads> separate instances of <command> on device <devno>\n"
+         "--threads <threads> <verbose> <devno> <command [args ...]>"},
 
         /* Network configuration commands */
         {"==== network config ====", jt_noop, 0, "network config"},
-        {"network", jt_ptl_setup, 0, "commands that follow apply to net\n"
+        {"network", jt_ptl_network, 0, "commands that follow apply to net\n"
          "usage: network <tcp/elan/myrinet>"},       
         {"connect", jt_ptl_connect, 0, "connect to a remote nid\n"
          "usage: connect [[<hostname> <port>] | <elan id>]"},
@@ -57,9 +60,11 @@ command_t cmdlist[] = {
          "The nid defaults to hostname for tcp networks and is automatically "
          "setup for elan/myrinet networks.\n"
          "usage: mynid [nid]"},
-        {"add_uuid", jt_ptl_add_uuid, 0, "associate a uuid with a nid\n"
+        {"add_uuid", jt_ptl_add_uuid, 0, "associate a UUID with a nid\n"
          "usage: add_uuid <uuid> <nid>"},
-        {"del_uuid", jt_ptl_del_uuid, 0, "delete a uuid association\n"
+        {"close_uuid", jt_ptl_close_uuid, 0, "disconnect a UUID\n"
+         "usage: close_uuid <uuid>)"},
+        {"del_uuid", jt_ptl_del_uuid, 0, "delete a UUID association\n"
          "usage: del_uuid <uuid>"},
         {"add_route", jt_ptl_add_route, 0,
          "add an entry to the routing table\n"
@@ -85,27 +90,29 @@ command_t cmdlist[] = {
          "usage: newdev"},
 #if 0
         {"uuid2dev", jt_obd_uuid2dev, 0,
-         "find a uuid and make it the current device\n"
+         "find device attached with <uuid> and make it the current device\n"
          "usage: uuid2dev <uuid>"},
 #endif
         {"name2dev", jt_obd_name2dev, 0,
-         "find a name and make it the current device\n"
+         "find device attached with <name> and make it the current device\n"
          "usage: name2dev <name>"},
-        {"device", jt_obd_device, 0, "set current device to devno\n"
+        {"device", jt_obd_device, 0, "set current device to <devno>\n"
          "usage: device <devno>"},
         {"device_list", jt_obd_list, 0, "show all devices\n"
          "usage: device_list"},
          
         /* Device configuration commands */
         {"==== device config =====", jt_noop, 0, "device config"},
-        {"attach", jt_obd_attach, 0, "name and type the device\n"
+        {"attach", jt_obd_attach, 0,
+         "set the type of the current device (with <name> and <uuid>)\n"
          "usage: attach type [name [uuid]]"},
         {"setup", jt_obd_setup, 0,
          "type specific device configuration information\n"
          "usage: setup <args...>"},
-        {"cleanup", jt_obd_cleanup, 0, "cleanup setup\n"
+        {"cleanup", jt_obd_cleanup, 0, "cleanup previously setup device\n"
          "usage: cleanup"},
-        {"detach", jt_obd_detach, 0, "un-name a device\n"
+        {"detach", jt_obd_detach, 0,
+         "remove driver (and name and uuid) from current device\n"
          "usage: detach"},
         {"lovconfig", jt_obd_lov_config, 0,
          "write lov configuration to an mds device\n"
@@ -114,33 +121,44 @@ command_t cmdlist[] = {
         /* Device operations */
         {"=== device operations ==", jt_noop, 0, "device operations"},
         {"probe", jt_obd_connect, 0,
-         "build a connection handle to a device.  This command is used too "
+         "build a connection handle to a device.  This command is used to "
          "suspend configuration until lctl has ensured that the mds and osc "
          "services are available.  This is to avoid mount failures in a "
          "rebooting cluster.\n"
-         "usage: probe [<timeout]"},
-        {"close", jt_obd_disconnect, 0, "close the connection handle\n"
+         "usage: probe [timeout]"},
+        {"close", jt_obd_disconnect, 0,
+         "close the connection handle\n"
          "usage: close"},
-        {"getattr", jt_obd_getattr, 0, "get attribute for id\n"
-         "usage: getattr <id>"},
-        {"setattr", jt_obd_setattr, 0, "set attribute for id\n"
-         "usage: setattr <id> <mode>"},
+        {"getattr", jt_obd_getattr, 0,
+         "get attribute for OST object <objid>\n"
+         "usage: getattr <objid>"},
+        {"setattr", jt_obd_setattr, 0,
+         "set mode attribute for OST object <objid>\n"
+         "usage: setattr <objid> <mode>"},
+        {"create", jt_obd_create, 0,
+         "create <num> OST objects (with <mode>)\n"
+         "usage: create [num [mode [verbose]]]"},
+        {"destroy", jt_obd_destroy, 0,
+         "destroy OST object <objid>\n"
+         "usage: destroy <objid>"},
         {"test_getattr", jt_obd_test_getattr, 0,
-         "perform count number of getattr's\n"
-         "usage: test_getattr <count> [verbose]"},
+         "do <num> getattrs (on OST object <objid> (objid+1 on each thread))\n"
+         "usage: test_getattr <num> [verbose [[t]objid]]"},
         {"test_brw", jt_obd_test_brw, 0,
-         "perform count number of bulk read/writes\n"
-         "usage: test_brw <count> [write [verbose [pages [obdos]]]]"},
-        {"test_ldlm", jt_obd_test_ldlm, 0, "perform lock manager test\n"
+         "do <num> bulk read/writes (<npages> per I/O, on OST object <objid>)\n"
+         "usage: test_brw [t]<num> [write [verbose [npages [[t]objid]]]]"},
+        {"test_ldlm", jt_obd_test_ldlm, 0,
+         "perform lock manager test\n"
          "usage: test_ldlm"},
+        {"ldlm_regress_start", jt_obd_ldlm_regress_start, 0,
+         "start lock manager stress test\n"
+         "usage: %s [numthreads [refheld [numres [numext]]]]"},
+        {"ldlm_regress_stop", jt_obd_ldlm_regress_stop, 0,
+         "stop lock manager stress test (no args)\n"},
         {"dump_ldlm", jt_obd_dump_ldlm, 0,
          "dump all lock manager state (no args)"},
+        {"newconn", jt_obd_newconn, 0, "newconn <olduuid> [newuuid]"},
 
-#if 0
-        {"create", jt_create, 0, "create [count [mode [verbose]]]"},
-        {"destroy", jt_destroy, 0, "destroy <id>"},
-        {"newconn", jt_newconn, 0, "newconn [newuuid]"},
-#endif
         /* Debug commands */
         {"======== debug =========", jt_noop, 0, "debug"},
         {"debug_kernel", jt_dbg_debug_kernel, 0,
@@ -181,8 +199,7 @@ int main(int argc, char **argv)
 
         setlinebuf(stdout);
 
-        if (ptl_initialize(argc, argv) < 0)
-                exit(1);
+        ptl_initialize(argc, argv);
         if (obd_initialize(argc, argv) < 0)
                 exit(2);
         if (dbg_initialize(argc, argv) < 0)