Whamcloud - gitweb
Merge b_md to HEAD for 0.5.19 release.
[fs/lustre-release.git] / lustre / utils / lctl.c
index 8197dc8..2217058 100644 (file)
@@ -4,7 +4,7 @@
  *  Copyright (C) 2002 Cluster File Systems, Inc.
  *   Author: Peter J. Braam <braam@clusterfs.com>
  *   Author: Phil Schwan <phil@clusterfs.com>
- *   Author: Robert Read <rread@clusterfs.com> 
+ *   Author: Robert Read <rread@clusterfs.com>
  *
  *   This file is part of Lustre, http://www.lustre.org.
  *
@@ -39,16 +39,30 @@ static int jt_noop(int argc, char **argv) {
         return 0;
 }
 
+static int jt_opt_ignore_errors(int argc, char **argv) {
+        Parser_ignore_errors(1);
+        return 0;
+}
+
 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 ...]>"},
+        {"--ignore_errors", jt_opt_ignore_errors, 0,
+         "ignore errors that occur during script processing\n"
+         "--ignore_errors"},
+        {"ignore_errors", jt_opt_ignore_errors, 0,
+         "ignore errors that occur during script processing\n"
+         "ignore_errors"},
 
         /* Network configuration commands */
         {"==== network config ====", jt_noop, 0, "network config"},
-        {"network", jt_ptl_setup, 0, "commands that follow apply to net\n"
-         "usage: network <tcp/elan/myrinet>"},       
+        {"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>]"},
         {"disconnect", jt_ptl_disconnect, 0, "disconnect from a remote nid\n"
@@ -57,9 +71,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"
@@ -76,76 +92,95 @@ command_t cmdlist[] = {
          "if size is omited the current size is reported.\n"
          "usage: send_mem [size]"},
         {"nagle", jt_ptl_nagle, 0, "enable/disable nagle, omiting the "
-         "argument will cause the current nagle setting to be reported.\n" 
-         "usage: nagle [on/off]"},       
-                
+         "argument will cause the current nagle setting to be reported.\n"
+         "usage: nagle [on/off]"},
+
         /* Device selection commands */
         {"=== device selection ===", jt_noop, 0, "device selection"},
         {"newdev", jt_obd_newdev, 0, "create a new device\n"
          "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"},
-         
+        {"lustre_build_version", jt_get_version, 0,
+         "print the build version of lustre\n"
+         "usage: lustre_build_version"},
+
         /* 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,
+        {"lov_setconfig", jt_obd_lov_setconfig, 0,
          "write lov configuration to an mds device\n"
-         "usage: lovconfig lov-uuid stripe-count stripe-size offset pattern UUID1 [UUID2 ...]"},
+         "usage: lov_setconfig lov-uuid stripe-count stripe-size offset pattern UUID1 [UUID2 ...]"},
+        {"lov_getconfig", jt_obd_lov_getconfig, 0,
+         "read lov configuration from an mds device\n"
+         "usage: lov_getconfig lov-uuid"},
 
         /* 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> [num [verbose]]\n"
+         "usage: destroy <num> objects, starting at objid <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 [objid]]]]"},
-        {"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 (usage: ldlm_regress_start "
-         "[numthreads])\n"},
+         "start lock manager stress test\n"
+         "usage: ldlm_regress_start [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)"},
+        {"lov_set_osc_active", jt_obd_lov_set_osc_active, 0,
+         "(de)activate an OSC in a LOV\n"
+         "usage: lov_set_osc_active <OSC UUID> <1|0 (active|inactive)>"},
+        {"newconn", jt_obd_newconn, 0, "newconn <olduuid> [newuuid]"},
+        {"failconn", jt_obd_failconn, 0, "failconn <uuid>"},
+        {"lookup", jt_obd_mdc_lookup, 0, "usage: lookup <directory> <file>"},
 
-#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,
@@ -169,7 +204,7 @@ command_t cmdlist[] = {
          "usage: modules <path>"},
         {"panic", jt_dbg_panic, 0, "force the kernel to panic\n"
          "usage: panic"},
-         
+
         /* User interface commands */
         {"======= control ========", jt_noop, 0, "control commands"},
         {"help", Parser_help, 0, "help"},
@@ -180,7 +215,7 @@ command_t cmdlist[] = {
 
 
 
-int main(int argc, char **argv) 
+int main(int argc, char **argv)
 {
         int rc;
 
@@ -191,7 +226,7 @@ int main(int argc, char **argv)
                 exit(2);
         if (dbg_initialize(argc, argv) < 0)
                 exit(3);
-        
+
         if (argc > 1) {
                 rc = Parser_execarg(argc - 1, argv + 1, cmdlist);
         } else {