X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Futils%2Flctl.c;h=1765661f6aec38dc8b75e579c7e1129ca6fac613;hb=1121816c4a4e1bb2ef097c4a9802362181c43800;hp=9b1d0a31b6c241711553035f1ce8548b24666111;hpb=3b84a1ee5213563945225854a50e9037bb9646db;p=fs%2Flustre-release.git diff --git a/lustre/utils/lctl.c b/lustre/utils/lctl.c index 9b1d0a3..1765661 100644 --- a/lustre/utils/lctl.c +++ b/lustre/utils/lctl.c @@ -15,11 +15,7 @@ * * You should have received a copy of the GNU General Public License * version 2 along with this program; If not, see - * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf - * - * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, - * CA 95054 USA or visit www.sun.com if you need additional information or - * have any questions. + * http://www.gnu.org/licenses/gpl-2.0.html * * GPL HEADER END */ @@ -27,11 +23,10 @@ * Copyright (c) 2002, 2010, Oracle and/or its affiliates. All rights reserved. * Use is subject to license terms. * - * Copyright (c) 2012, 2014, Intel Corporation. + * Copyright (c) 2012, 2017, Intel Corporation. */ /* * This file is part of Lustre, http://www.lustre.org/ - * Lustre is a trademark of Sun Microsystems, Inc. * * lustre/utils/lctl.c * @@ -40,83 +35,120 @@ * Author: Robert Read */ +#include +#include #include #include +#include #include -#include +#include #include "obdctl.h" -#include +#include +#include -static int jt_noop(int argc, char **argv) { - return 0; -} +static int lctl_list_commands(int argc, char **argv); -static int jt_opt_ignore_errors(int argc, char **argv) { - Parser_ignore_errors(1); - return 0; +static int jt_opt_ignore_errors(int argc, char **argv) +{ + Parser_ignore_errors(1); + return 0; } +static int jt_pcc_list_commands(int argc, char **argv); +static int jt_pcc(int argc, char **argv); + +/** + * command_t pccdev_cmdlist - lctl pcc commands. + */ +command_t pccdev_cmdlist[] = { + { .pc_name = "add", .pc_func = jt_pcc_add, + .pc_help = "Add a PCC backend to a client.\n" + "usage: lctl pcc add [--param|-p ]\n" + "\tmntpath: Lustre mount point.\n" + "\tpccpath: Path of the PCC backend.\n" + "\tparam: Setting parameters for PCC backend.\n" }, + { .pc_name = "del", .pc_func = jt_pcc_del, + .pc_help = "Delete the specified PCC backend on a client.\n" + "usage: clt pcc del \n" }, + { .pc_name = "clear", .pc_func = jt_pcc_clear, + .pc_help = "Remove all PCC backend on a client.\n" + "usage: lctl pcc clear \n" }, + { .pc_name = "list", .pc_func = jt_pcc_list, + .pc_help = "List all PCC backends on a client.\n" + "usage: lctl pcc list \n" }, + { .pc_name = "list-commands", .pc_func = jt_pcc_list_commands, + .pc_help = "list commands supported by lctl pcc"}, + { .pc_name = "help", .pc_func = Parser_help, .pc_help = "help" }, + { .pc_name = "exit", .pc_func = Parser_quit, .pc_help = "quit" }, + { .pc_name = "quit", .pc_func = Parser_quit, .pc_help = "quit" }, + { .pc_help = NULL } +}; + command_t cmdlist[] = { - /* Metacommands */ - {"===== metacommands =======", jt_noop, 0, "metacommands"}, - {"--device", jt_opt_device, 0, - "run after connecting to device \n" - "--device "}, - {"--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"}, - - /* User interface commands */ - {"======== control =========", jt_noop, 0, "control commands"}, - {"help", Parser_help, 0, "help"}, - {"lustre_build_version", jt_get_version, 0, - "print the build version of lustre\n" - "usage: lustre_build_version"}, + /* Metacommands */ + {"===== metacommands =======", NULL, 0, "metacommands"}, + {"--device", jt_opt_device, 0, + "run after connecting to device \n" + "--device "}, + {"--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"}, + + /* User interface commands */ + {"======== control =========", NULL, 0, "control commands"}, + {"help", Parser_help, 0, "help"}, + {"lustre_build_version", jt_get_version, 0, + "print version of Lustre modules\n" + "usage: lustre_build_version"}, {"exit", Parser_quit, 0, "quit"}, {"quit", Parser_quit, 0, "quit"}, {"--version", Parser_version, 0, - "output build version of the utility and exit"}, + "print build version of this utility and exit"}, + {"--list-commands", lctl_list_commands, 0, + "list commands supported by this utility and exit"}, /* Network configuration commands */ - {"===== network config =====", jt_noop, 0, "network config"}, - {"--net", jt_opt_net, 0,"run after setting network to \n" - "usage: --net "}, - {"network", jt_ptl_network, 0, "configure LNET" - "usage: network up|down"}, - {"net", jt_ptl_network, 0, "configure LNET" - "usage: net up|down"}, - {"list_nids", jt_ptl_list_nids, 0, "list local NIDs" - "usage: list_nids [all]"}, - {"which_nid", jt_ptl_which_nid, 0, "choose a NID" - "usage: which_nid NID [NID...]"}, + {"===== network config =====", NULL, 0, "network config"}, + {"--net", jt_opt_net, 0, "run after selecting network \n" + "usage: --net "}, + {"network", jt_ptl_network, 0, "configure LNET\n" + "usage: network up|down"}, + {"net", jt_ptl_network, 0, "configure LNET\n" + "usage: net up|down"}, + {"list_nids", jt_ptl_list_nids, 0, "list local NIDs\n" + "usage: list_nids [all]"}, + {"which_nid", jt_ptl_which_nid, 0, "choose a NID\n" + "usage: which_nid NID [NID...]"}, {"replace_nids", jt_replace_nids, 0, "replace primary NIDs for a device\n" - "usage: replace_nids [,nid2,nid3]"}, - {"interface_list", jt_ptl_print_interfaces,0,"print interface entries\n" - "usage: interface_list"}, - {"peer_list", jt_ptl_print_peers, 0, "print peer entries\n" - "usage: peer_list"}, - {"conn_list", jt_ptl_print_connections, 0, - "print all the connected remote nid\n" - "usage: conn_list"}, - {"route_list", jt_ptl_print_routes, 0, - "print the portals routing table, same as show_route\n" - "usage: route_list"}, - {"show_route", jt_ptl_print_routes, 0, - "print the portals routing table, same as route_list\n" - "usage: show_route"}, - {"ping", jt_ptl_ping, 0, "Check LNET connectivity\n" - "usage: ping nid [timeout] [pid]"}, + "usage: replace_nids [,nid2,nid3:nid4,nid5:nid6]"}, + {"interface_list", jt_ptl_print_interfaces, 0, + "print network interface entries\n" + "usage: interface_list"}, + {"peer_list", jt_ptl_print_peers, 0, "print peer LNet NIDs\n" + "usage: peer_list"}, + {"conn_list", jt_ptl_print_connections, 0, + "print all the remote LNet connections\n" + "usage: conn_list"}, + {"route_list", jt_ptl_print_routes, 0, + "print the LNet routing table, same as 'show_route'\n" + "usage: route_list"}, + {"show_route", jt_ptl_print_routes, 0, + "print the LNet routing table, same as 'route_list'\n" + "usage: show_route"}, + {"ping", jt_ptl_ping, 0, "Check LNET connectivity\n" + "usage: ping nid [timeout] [pid]"}, {"net_drop_add", jt_ptl_drop_add, 0, "Add LNet drop rule\n" "usage: net_drop_add <-s | --source NID>\n" " <-d | --dest NID>\n" " <<-r | --rate DROP_RATE> |\n" - " <-i | --interval SECONDS>>\n" + " <-i | --interval SECONDS>>\n" " [<-p | --portal> PORTAL...]\n" - " [<-m | --message> ...]\n"}, + " [<-m | --message> ...]\n" + " [< -e | --health_error]\n"}, {"net_drop_del", jt_ptl_drop_del, 0, "remove LNet drop rule\n" "usage: net_drop_del <[-a | --all] |\n" " <-s | --source NID>\n" @@ -129,7 +161,7 @@ command_t cmdlist[] = { "usage: net_delay_add <-s | --source NID>\n" " <-d | --dest NID>\n" " <<-r | --rate DROP_RATE> |\n" - " <-i | --interval SECONDS>>\n" + " <-i | --interval SECONDS>>\n" " <-l | --latency SECONDS>\n" " [<-p | --portal> PORTAL...]\n" " [<-m | --message> ...]\n"}, @@ -142,124 +174,187 @@ command_t cmdlist[] = { {"net_delay_list", jt_ptl_delay_list, 0, "list LNet delay rules\n" "usage: net_delay_list"}, - /* Device selection commands */ - {"==== obd device selection ====", jt_noop, 0, "device selection"}, - {"device", jt_obd_device, 0, - "set current device to \n" - "usage: device <%name|$name|devno>"}, - {"device_list", jt_obd_list, 0, "show all devices\n" - "usage: device_list"}, - {"dl", jt_obd_list, 0, "show all devices\n" - "usage: dl [-t]"}, - - /* Device operations */ - {"==== obd device operations ====", jt_noop, 0, "device operations"}, - {"activate", jt_obd_activate, 0, "activate an import\n"}, - {"deactivate", jt_obd_deactivate, 0, "deactivate an import. " - "This command should be used on failed OSC devices in an MDT LOV.\n"}, - {"abort_recovery", jt_obd_abort_recovery, 0, - "abort recovery on a restarting MDT or OST device\n"}, - {"set_timeout", jt_lcfg_set_timeout, 0, - "usage: conf_param obd_timeout=\n"}, + /* Device selection commands */ + {"==== obd device selection ====", NULL, 0, "device selection"}, + {"device", jt_obd_device, 0, + "set current device to \n" + "usage: device <%name|$name|devno>"}, + {"cfg_device", jt_obd_device, 0, + "set current device to , same as 'device'\n" + "usage: cfg_device "}, + {"device_list", jt_obd_list, 0, "show all devices\n" + "usage: device_list"}, + {"dl", jt_obd_list, 0, "show all devices, same as 'device_list'\n" + "usage: dl [-t]"}, + + /* Device operations */ + {"==== obd device operations ====", NULL, 0, "device operations"}, + {"activate", jt_obd_activate, 0, "activate an import\n"}, + {"deactivate", jt_obd_deactivate, 0, "deactivate an import. " + "This command should be used on failed OSC devices in an MDT LOV.\n"}, + {"abort_recovery", jt_obd_abort_recovery, 0, + "abort recovery on a restarting MDT or OST device\n"}, + {"abort_recovery_mdt", jt_obd_abort_recovery_mdt, 0, + "abort recovery between MDTs\n"}, + {"recover", jt_obd_recover, 0, + "try to restore a lost connection immediately\n" + "usage: recover [MDC/OSC device]"}, + {"set_timeout", jt_lcfg_set_timeout, 0, + "usage: conf_param obd_timeout=\n"}, #if LUSTRE_VERSION_CODE < OBD_OCD_VERSION(3, 0, 53, 0) - {"conf_param", jt_lcfg_mgsparam, 0,"set a permanent config parameter.\n" - "This command must be run on the MGS node\n" - "usage: conf_param [-d] \n" - " -d Remove the permanent setting."}, + {"conf_param", jt_lcfg_confparam, 0, + "set a permanent config parameter.\n" + "This command must be run on the MGS node\n" + "usage: conf_param [-d] \n" + " -d Delete the permanent setting from the configuration."}, #endif - {"local_param", jt_lcfg_param, 0, "set a temporary, local param\n" - "usage: local_param \n"}, - {"get_param", jt_lcfg_getparam, 0, "get the Lustre or LNET parameter\n" - "usage: get_param [-n|-N|-F] \n" - "Get the value of Lustre or LNET parameter from the specified path.\n" - "The path can contain shell-style filename patterns.\n" - " -n Print only the value and not parameter name.\n" - " -N Print only matched parameter names and not the values.\n" - " (Especially useful when using patterns.)\n" - " -F When -N specified, add '/', '@' or '=' for directories,\n" - " symlinks and writeable files, respectively."}, - {"set_param", jt_lcfg_setparam, 0, "set the Lustre or LNET parameter\n" - "usage: set_param [-n] [-P] [-d]" + {"local_param", jt_lcfg_param, 0, "set a temporary, local param\n" + "usage: local_param \n"}, + {"get_param", jt_lcfg_getparam, 0, "get the Lustre or LNET parameter\n" + "usage: get_param [-F|n|-N|-R] \n" + "Get the value of Lustre or LNET parameter from the specified path.\n" + "The path can contain shell-style filename patterns.\n" + " -F When -N specified, add '/', '@' or '=' for directories,\n" + " symlinks and writeable files, respectively.\n" + " -n Print only the value and not parameter name.\n" + " -N Print only matched parameter names and not the values.\n" + " (Especially useful when using patterns.)\n" + " -R Get parameters recursively from the specified entry.\n"}, + {"set_param", jt_lcfg_setparam, 0, "set the Lustre or LNET parameter\n" + "usage: set_param [-n] [-P] [-d] [-F]" "\n" "Set the value of the Lustre or LNET parameter at the specified path.\n" " -n Disable printing of the key name when printing values.\n" " -P Set the parameter permanently, filesystem-wide.\n" - " -d Remove the permanent setting (only with -P option).\n"}, + " -d Remove the permanent setting (only with -P option).\n" + " -F Read permanent configuration from a YAML file.\n"}, {"list_param", jt_lcfg_listparam, 0, - "list the Lustre or LNET parameter name\n" - "usage: list_param [-F|-R] \n" - "List the name of Lustre or LNET parameter from the specified path.\n" - " -F Add '/', '@' or '=' for dirs, symlinks and writeable files,\n" - "respectively.\n" - " -R Recursively list all parameters under the specified path.\n"}, - - /* Debug commands */ - {"==== debugging control ====", jt_noop, 0, "debug"}, - {"debug_daemon", jt_dbg_debug_daemon, 0, - "debug daemon control and dump to a file\n" - "usage: debug_daemon {start file [#MB]|stop}"}, - {"debug_kernel", jt_dbg_debug_kernel, 0, - "get debug buffer and dump to a file, same as dk\n" - "usage: debug_kernel [file] [raw]"}, - {"dk", jt_dbg_debug_kernel, 0, - "get debug buffer and dump to a file, same as debug_kernel\n" - "usage: dk [file] [raw]"}, - {"debug_file", jt_dbg_debug_file, 0, - "convert a binary debug file dumped by the kernel to ASCII text\n" - "usage: debug_file [output]"}, - {"df", jt_dbg_debug_file, 0, - "read debug buffer from input and dump to output, same as debug_file\n" - "usage: df [output]"}, - {"clear", jt_dbg_clear_debug_buf, 0, "clear kernel debug buffer\n" - "usage: clear"}, - {"mark", jt_dbg_mark_debug_buf, 0, - "insert marker text in kernel debug buffer\n" - "usage: mark "}, - {"filter", jt_dbg_filter, 0, "filter message type\n" - "usage: filter "}, - {"show", jt_dbg_show, 0, "Show specific type of messages\n" - "usage: show "}, - {"debug_list", jt_dbg_list, 0, "list subsystem and debug types\n" - "usage: debug_list "}, - {"modules", jt_dbg_modules, 0, - "provide gdb-friendly module information\n" - "usage: modules "}, - - /* virtual block operations */ - {"==== virtual block device ====", jt_noop, 0, "virtual block device"}, - {"blockdev_attach", jt_blockdev_attach, 0, - "attach a lustre regular file to a virtual block device\n" - "usage: blockdev_attach "}, - {"blockdev_detach", jt_blockdev_detach, 0, - "detach a lustre regular file from a virtual block device\n" - "usage: blockdev_detach "}, - {"blockdev_info", jt_blockdev_info, 0, - "get the device info of an attached file\n" - "usage: blockdev_info "}, - - /* Pool commands */ - {"=== Pools ==", jt_noop, 0, "pool management"}, - {"pool_new", jt_pool_cmd, 0, - "add a new pool\n" + "list the Lustre or LNET parameter name\n" + "usage: list_param [-F|-R|-D] \n" + "List the name of Lustre or LNET parameter from the specified path.\n" + " -F Add '/', '@' or '=' for dirs, symlinks and writeable files,\n" + "respectively.\n" + " -D Only list directories.\n" + " -R Recursively list all parameters under the specified path.\n"}, + {"del_ost", jt_del_ost, 0, "permanently delete OST records\n" + "usage: del_ost [--dryrun] --target <$fsname-OSTxxxx>\n" + "Cancel the config records for a specific OST to forget about it.\n"}, + + /* Debug commands */ + {"==== debugging control ====", NULL, 0, "debug"}, + {"debug_daemon", jt_dbg_debug_daemon, 0, + "debug daemon control and dump to a file\n" + "usage: debug_daemon {start file [#MB]|stop}"}, + {"debug_kernel", jt_dbg_debug_kernel, 0, + "get debug buffer and dump to a file, same as 'dk'\n" + "usage: debug_kernel [file] [raw]"}, + {"dk", jt_dbg_debug_kernel, 0, + "get debug buffer and dump to a file, same as 'debug_kernel'\n" + "usage: dk [file] [raw]"}, + {"debug_file", jt_dbg_debug_file, 0, + "convert a binary debug file dumped by the kernel to ASCII text\n" + "usage: debug_file [output]"}, + {"df", jt_dbg_debug_file, 0, + "read debug log from input convert to ASCII, same as 'debug_file'\n" + "usage: df [output]"}, + {"clear", jt_dbg_clear_debug_buf, 0, "clear kernel debug buffer\n" + "usage: clear"}, + {"mark", jt_dbg_mark_debug_buf, 0, + "insert marker text in kernel debug buffer\n" + "usage: mark "}, + {"filter", jt_dbg_filter, 0, "filter message type\n" + "usage: filter "}, + {"show", jt_dbg_show, 0, "Show specific type of messages\n" + "usage: show "}, + {"debug_list", jt_dbg_list, 0, "list subsystem and debug types\n" + "usage: debug_list "}, + {"modules", jt_dbg_modules, 0, + "provide gdb-friendly module information\n" + "usage: modules "}, + + /* Pool commands */ + {"=== Pools ==", NULL, 0, "pool management"}, + {"pool_new", jt_pool_cmd, 0, + "add a new pool\n" "usage: pool_new ."}, {"pool_add", jt_pool_cmd, 0, - "add the named OSTs to the pool\n" + "add the named OSTs to the pool\n" "usage: pool_add . "}, - {"pool_remove", jt_pool_cmd, 0, - "remove the named OST from the pool\n" + {"pool_remove", jt_pool_cmd, 0, + "remove the named OST from the pool\n" "usage: pool_remove . "}, - {"pool_destroy", jt_pool_cmd, 0, - "destroy a pool\n" + {"pool_destroy", jt_pool_cmd, 0, + "destroy a pool\n" "usage: pool_destroy ."}, - {"pool_list", jt_pool_cmd, 0, - "list pools and pools members\n" + {"pool_list", jt_pool_cmd, 0, + "list pools and pools members\n" "usage: pool_list [.] | "}, +#ifdef HAVE_SERVER_SUPPORT + /* Barrier commands */ + {"=== Barrier ==", NULL, 0, "barrier management"}, + {"barrier_freeze", jt_barrier_freeze, 0, + "freeze write barrier on MDTs\n" + "usage: barrier_freeze [timeout (in seconds)]"}, + {"barrier_thaw", jt_barrier_thaw, 0, + "thaw write barrier on MDTs\n" + "usage: barrier_thaw "}, + {"barrier_stat", jt_barrier_stat, 0, + "query write barrier status on MDTs\n" + "usage: barrier_stat [--state|-s] [--timeout|-t] "}, + {"barrier_rescan", jt_barrier_rescan, 0, + "rescan the system to filter out inactive MDT(s) for barrier\n" + "usage: barrier_rescan [timeout (in seconds)]"}, + + /* Snapshot commands */ + {"=== Snapshot ==", NULL, 0, "Snapshot management"}, + {"snapshot_create", jt_snapshot_create, 0, + "create the snapshot\n" + "usage: snapshot_create [-b | --barrier [on | off]]\n" + " [-c | --comment comment]\n" + " <-F | --fsname fsname>\n" + " [-h | --help] <-n | --name ssname>\n" + " [-r | --rsh remote_shell]\n" + " [-t | --timeout timeout]"}, + {"snapshot_destroy", jt_snapshot_destroy, 0, + "destroy the snapshot\n" + "usage: snapshot_destroy [-f | --force]\n" + " <-F | --fsname fsname> [-h | --help]\n" + " <-n | --name ssname>\n" + " [-r | --rsh remote_shell]"}, + {"snapshot_modify", jt_snapshot_modify, 0, + "modify the snapshot\n" + "usage: snapshot_modify [-c | --comment comment]\n" + " <-F | --fsname fsname> [-h | --help]\n" + " <-n | --name ssname> [-N | --new new_ssname]\n" + " [-r | --rsh remote_shell]"}, + {"snapshot_list", jt_snapshot_list, 0, + "query the snapshot(s)\n" + "usage: snapshot_list [-d | --detail]\n" + " <-F | --fsname fsname> [-h | --help]\n" + " [-n | --name ssname] [-r | --rsh remote_shell]"}, + {"snapshot_mount", jt_snapshot_mount, 0, + "mount the snapshot\n" + "usage: snapshot_mount <-F | --fsname fsname> [-h | --help]\n" + " <-n | --name ssname>\n" + " [-r | --rsh remote_shell]"}, + {"snapshot_umount", jt_snapshot_umount, 0, + "umount the snapshot\n" + "usage: snapshot_umount <-F | --fsname fsname> [-h | --help]\n" + " <-n | --name ssname>\n" + " [-r | --rsh remote_shell]"}, + {"fork_lcfg", jt_lcfg_fork, 0, + "copy configuration files for named filesystem with given name\n" + "usage: fork_lcfg "}, + {"erase_lcfg", jt_lcfg_erase, 0, + "permanently erase configuration for the named filesystem\n" + "usage: erase_lcfg "}, +#endif /* HAVE_SERVER_SUPPORT */ /* Nodemap commands */ - {"=== Nodemap ===", jt_noop, 0, "nodemap management"}, + {"=== Nodemap ===", NULL, 0, "nodemap management"}, {"nodemap_activate", jt_nodemap_activate, 0, "activate nodemap idmapping functions\n" - "usage: nodemap_activate"}, + "usage: nodemap_activate {0|1}"}, {"nodemap_add", jt_nodemap_add, 0, "add a new nodemap\n" "usage: nodemap_add "}, @@ -268,244 +363,329 @@ command_t cmdlist[] = { "usage: nodemap_del "}, {"nodemap_add_range", jt_nodemap_add_range, 0, "add a range to a nodemap\n" - "usage: nodemap_add_range "}, + "usage: nodemap_add_range "}, {"nodemap_del_range", jt_nodemap_del_range, 0, "add a range to a nodemap\n" - "usage: nodemap_del_range "}, + "usage: nodemap_del_range "}, {"nodemap_modify", jt_nodemap_modify, 0, - "modify a nodemap parameters" + "modify a nodemap parameters\n" "usage: nodemap_modify nodemap_name param value"}, {"nodemap_add_idmap", jt_nodemap_add_idmap, 0, "add a UID or GID mapping to a nodemap"}, {"nodemap_del_idmap", jt_nodemap_del_idmap, 0, "delete a UID or GID mapping from a nodemap"}, + {"nodemap_set_fileset", jt_nodemap_set_fileset, 0, + "set a fileset on a nodemap\n" + "usage: nodemap_set_fileset "}, + {"nodemap_set_sepol", jt_nodemap_set_sepol, 0, + "set SELinux policy info on a nodemap\n" + "usage: nodemap_set_sepol "}, {"nodemap_test_nid", jt_nodemap_test_nid, 0, "usage: nodemap_test_nid "}, {"nodemap_test_id", jt_nodemap_test_id, 0, "Usage: nodemap_test_id --nid --idtype [uid|gid] --id "}, + {"nodemap_info", jt_nodemap_info, 0, + "Usage: nodemap_info [list|nodemap_name|all]"}, - /* Changelog commands */ - {"=== Changelogs ==", jt_noop, 0, "changelog user management"}, - {"changelog_register", jt_changelog_register, 0, - "register a new persistent changelog user, returns id\n" - "usage:\tdevice \n\tchangelog_register [-n]"}, - {"changelog_deregister", jt_changelog_deregister, 0, - "deregister an existing changelog user\n" - "usage:\tdevice \n\tchangelog_deregister "}, - - /* Device configuration commands */ - {"== device setup (these are not normally used post 1.4) ==", - jt_noop, 0, "device config"}, - {"attach", jt_lcfg_attach, 0, - "set the type, name, and uuid of the current device\n" - "usage: attach type name uuid"}, - {"detach", jt_obd_detach, 0, - "remove driver (and name and uuid) from current device\n" - "usage: detach"}, - {"setup", jt_lcfg_setup, 0, - "type specific device configuration information\n" - "usage: setup "}, - {"cleanup", jt_obd_cleanup, 0, "cleanup previously setup device\n" - "usage: cleanup [force | failover]"}, - {"dump_cfg", jt_cfg_dump_log, 0, - "print log of recorded commands for this config to kernel debug log\n" - "usage: dump_cfg config-uuid-name"}, - - /* Test only commands */ - {"==== testing (DANGEROUS) ====", jt_noop, 0, "testing (DANGEROUS)"}, - {"--threads", jt_opt_threads, 0, - "run separate instances of on device \n" - "--threads "}, - {"lookup", jt_obd_mdc_lookup, 0, "report file mode info\n" - "usage: lookup "}, - {"readonly", jt_obd_set_readonly, 0, - "disable writes to the underlying device\n"}, - {"notransno", jt_obd_no_transno, 0, - "disable sending of committed-transno updates\n"}, - {"add_uuid", jt_lcfg_add_uuid, 0, "associate a UUID with a nid\n" - "usage: add_uuid "}, - {"del_uuid", jt_lcfg_del_uuid, 0, "delete a UUID association\n" - "usage: del_uuid "}, - {"add_peer", jt_ptl_add_peer, 0, "add an peer entry\n" - "usage: add_peer "}, - {"del_peer", jt_ptl_del_peer, 0, "remove an peer entry\n" - "usage: del_peer [] []"}, - {"add_conn ", jt_lcfg_add_conn, 0, - "usage: add_conn [priority]\n"}, - {"del_conn ", jt_lcfg_del_conn, 0, - "usage: del_conn \n"}, - {"disconnect", jt_ptl_disconnect, 0, "disconnect from a remote nid\n" - "usage: disconnect []"}, - {"push", jt_ptl_push_connection, 0, "flush connection to a remote nid\n" - "usage: push []"}, - {"mynid", jt_ptl_mynid, 0, "inform the socknal of the local nid. " - "The nid defaults to hostname for tcp networks and is automatically " - "setup for elan/myrinet networks.\n" - "usage: mynid []"}, - {"fail", jt_ptl_fail_nid, 0, "fail/restore communications.\n" - "Omitting the count means indefinitely, 0 means restore, " - "otherwise fail 'count' messages.\n" - "usage: fail nid|_all_ [count]"}, - - /*Test commands for echo client*/ - {"test_create", jt_obd_test_create, 0, - "create files on MDT by echo client\n" - "usage: test_create [-d parent_basedir] <-D parent_count> " - "[-b child_base_id] <-c stripe_count> <-n count> <-t time>\n"}, - {"test_mkdir", jt_obd_test_mkdir, 0, - "mkdir on MDT by echo client\n" - "usage: test_mkdir [-d parent_basedir] <-D parent_count>" - "[-b child_base_id] [-n count] <-t time>\n"}, - {"test_destroy", jt_obd_test_destroy, 0, - "Destroy files on MDT by echo client\n" - "usage: test_destroy [-d parent_basedir] <-D parent_count>" - "[-b child_base_id] [-n count] <-t time>\n"}, - {"test_rmdir", jt_obd_test_rmdir, 0, - "rmdir on MDT by echo client\n" - "usage: test_rmdir [-d parent_basedir] <-D parent_count>" - "[-b child_base_id] [-n count] <-t time>\n"}, - {"test_lookup", jt_obd_test_lookup, 0, - "lookup files on MDT by echo client\n" - "usage: test_lookup [-d parent_basedir] <-D parent_count>" - "[-b child_base_id] [-n count] <-t time>\n"}, - {"test_setxattr", jt_obd_test_setxattr, 0, - "Set EA for files/directory on MDT by echo client\n" - "usage: test_setxattr [-d parent_baseid] <-D parent_count>" - "[-b child_base_id] [-n count] <-t time>\n"}, - {"test_md_getattr", jt_obd_test_md_getattr, 0, - "getattr files on MDT by echo client\n" - "usage: test_md_getattr [-d parent_basedir] <-D parent_count>" - "[-b child_base_id] [-n count] <-t time>\n"}, - {"getattr", jt_obd_getattr, 0, - "get attribute for OST object \n" - "usage: getattr "}, - {"setattr", jt_obd_setattr, 0, - "set mode attribute for OST object \n" - "usage: setattr "}, - {"create", jt_obd_create, 0, - "create OST objects (with )\n" - "usage: create [num [mode [verbose [lsm data]]]]"}, - {"destroy", jt_obd_destroy, 0, - "destroy OST object [num [verbose]]\n" - "usage: destroy objects, starting at objid "}, - {"test_getattr", jt_obd_test_getattr, 0, - "do getattrs (on OST object (objid+1 on each thread))\n" - "usage: test_getattr [verbose [[t]objid]]"}, - {"test_setattr", jt_obd_test_setattr, 0, - "do setattrs (on OST object (objid+1 on each thread))\n" - "usage: test_setattr [verbose [[t]objid]]"}, - {"test_brw", jt_obd_test_brw, 0, - "do bulk read/writes ( per I/O, on OST object )\n" - "usage: test_brw [t] [write [verbose [npages [[t]objid]]]]"}, - {"memhog", jt_ptl_memhog, 0, - "memory pressure testing\n" - "usage: memhog []"}, - {"getobjversion", jt_get_obj_version, 0, - "get the version of an object on servers\n" - "usage: getobjversion \n" - " getobjversion -i -g "}, + /* Changelog commands */ + {"=== Changelogs ==", NULL, 0, "changelog user management"}, + {"changelog_register", jt_changelog_register, 0, + "register a new persistent changelog user, returns id\n" + "usage: --device changelog_register [--help|-h]\n" + " [--mask|-m <[+|-]mask1[<,|+|->mask2...]>]\n" + " [--nameonly|-n]\n" + " [--user|-u ]"}, + {"changelog_deregister", jt_changelog_deregister, 0, + "deregister an existing changelog user\n" + "usage: --device changelog_deregister [|cl...]\n" + " [--help|-h]\n" + " [--user|-u ]\n"}, + /* Persistent Client Cache (PCC) commands */ + {"=== Persistent Client Cache ===", NULL, 0, "PCC user management"}, + {"pcc", jt_pcc, pccdev_cmdlist, + "lctl commands used to interact with PCC features:\n" + "lctl pcc add - add a PCC backend to a client\n" + "lctl pcc del - delete a PCC backend on a client\n" + "lctl pcc clear - remove all PCC backends on a client\n" + "lctl pcc list - list all PCC backends on a client\n"}, + + /* Device configuration commands */ + {"== device setup (these are not normally used post 1.4) ==", + NULL, 0, "device config"}, + {"attach", jt_lcfg_attach, 0, + "set the type, name, and uuid of the current device\n" + "usage: attach type name uuid"}, + {"detach", jt_obd_detach, 0, + "remove driver (and name and uuid) from current device\n" + "usage: detach"}, + {"setup", jt_lcfg_setup, 0, + "type specific device configuration information\n" + "usage: setup "}, + {"cleanup", jt_obd_cleanup, 0, "cleanup previously setup device\n" + "usage: cleanup [force | failover]"}, + {"clear_conf", jt_lcfg_clear, 0, + "drop unused config logs for a device or filesystem\n" + "usage: clear_conf "}, + {"fork_lcfg", jt_lcfg_fork, 0, + "copy configuration files for named filesystem with given name\n" + "usage: fork_lcfg "}, + {"erase_lcfg", jt_lcfg_erase, 0, + "permanently erase configuration for the named filesystem\n" + "usage: erase_lcfg "}, + +#ifdef HAVE_SERVER_SUPPORT /* LFSCK commands */ - {"==== LFSCK ====", jt_noop, 0, "LFSCK"}, + {"==== LFSCK ====", NULL, 0, "LFSCK"}, {"lfsck_start", jt_lfsck_start, 0, "start LFSCK\n" - "usage: lfsck_start <-M | --device [MDT,OST]_device>\n" - " [-A | --all] [-c | --create_ostobj [on | off]]\n" - " [-C | --create_mdtobj [on | off]]\n" - " [-e | --error {continue | abort}] [-h | --help]\n" - " [-n | --dryrun [on | off]] [-o | --orphan]\n" - " [-r | --reset] [-s | --speed speed_limit]\n" - " [-t | --type lfsck_type[,lfsck_type...]]\n" - " [-w | --window_size size]"}, + "usage: lfsck_start [--device|-M [MDT,OST]_device]\n" + " [--all|-A] [--create-ostobj|-c [on | off]]\n" + " [--create-mdtobj|-C [on | off]]\n" + " [--delay-create-ostobj|-d [on | off]]\n" + " [--error|-e {continue | abort}] [--help|-h]\n" + " [--dryrun|-n [on | off]] [--orphan|-o]\n" + " [--reset|-r] [--speed|-s speed_limit]\n" + " [--type|-t lfsck_type[,lfsck_type...]]\n" + " [--window-size|-w size]"}, {"lfsck_stop", jt_lfsck_stop, 0, "stop lfsck(s)\n" - "usage: lfsck_stop <-M | --device [MDT,OST]_device>\n" - " [-A | --all] [-h | --help]"}, + "usage: lfsck_stop [--device|-M [MDT,OST]_device]\n" + " [--all|-A] [--help|-h]"}, + {"lfsck_query", jt_lfsck_query, 0, "check lfsck(s) status\n" + "usage: lfsck_query [--device|-M MDT_device] [--help|-h]\n" + " [--type|-t lfsck_type[,lfsck_type...]]\n" + " [--wait|-w]"}, +#endif /* HAVE_SERVER_SUPPORT */ - {"==== obsolete (DANGEROUS) ====", jt_noop, 0, "obsolete (DANGEROUS)"}, - /* some test scripts still use these */ - {"cfg_device", jt_obd_device, 0, - "set current device to \n" - "usage: device "}, - {"recover", jt_obd_recover, 0, - "try to restore a lost connection immediately\n" - "usage: recover [MDC/OSC device]"}, - /* saving for sanity 44a */ - {"lov_getconfig", jt_obd_lov_getconfig, 0, - "read lov configuration from an mds device\n" - "usage: lov_getconfig "}, /* Llog operations */ + {"==== LLOG ====", NULL, 0, "LLOG"}, {"llog_catlist", jt_llog_catlist, 0, - "list all catalog logs on current device.\n" + "list all catalog files on current device. If current device is not\n" + "set, MGS device is used by default.\n" "usage: llog_catlist"}, {"llog_info", jt_llog_info, 0, "print log header information.\n" - "usage: llog_info <$logname|#oid#ogr#ogen>\n" - " oid, ogr and ogen are hexadecimal."}, + "usage: llog_info \n"}, {"llog_print", jt_llog_print, 0, - "print log content information.\n" - "usage: llog_print <$logname|#oid#ogr#ogen> [from] [to]\n" - " oid, ogr and ogen are hexadecimal.\n" - " print all records from index 1 by default."}, + "print all effective log records by default, or within given range.\n" + "With --raw option skipped records are printed as well.\n" + "usage: llog_print [--start ] [--end j]\n" + " [--raw]\n"}, + {"llog_cancel", jt_llog_cancel, 0, + "cancel one record in specified log.\n" + "usage:llog_cancel --log_idx \n"}, {"llog_check", jt_llog_check, 0, - "print log content information.\n" - "usage: llog_check <$logname|#oid#ogr#ogen> [from] [to]\n" - " oid, ogr and ogen are hexadecimal.\n" + "verify that log content is valid.\n" + "usage: llog_check [--start ] [--end j]\n" " check all records from index 1 by default."}, - {"llog_cancel", jt_llog_cancel, 0, - "cancel one record in log.\n" - "This command supports both positional and optional arguments\n" - "usage (positional args): " - "llog_cancel [log id] \n" - "usage (optional args): " - "llog_cancel --catalog --log_id " - "--log_idx "}, {"llog_remove", jt_llog_remove, 0, "remove one log from catalog or plain log, erase it from disk.\n" - "usage: llog_remove "}, + "usage: llog_remove [--log_id ]"}, + + {"==== obsolete (DANGEROUS) ====", NULL, 0, "obsolete (DANGEROUS)"}, /* network operations */ {"add_interface", jt_ptl_add_interface, 0, "add interface entry\n" "usage: add_interface ip [netmask]"}, {"del_interface", jt_ptl_del_interface, 0, "del interface entry\n" "usage: del_interface [ip]"}, {"add_route", jt_ptl_add_route, 0, - "add an entry to the portals routing table\n" + "add an entry to the LNet routing table\n" "usage: add_route [ []]"}, {"del_route", jt_ptl_del_route, 0, - "delete route via gateway to targets from the portals routing table\n" + "delete route via gateway to targets from the LNet routing table\n" "usage: del_route [] []"}, {"set_route", jt_ptl_notify_router, 0, - "enable/disable routes via gateway in the portals routing table\n" + "enable/disable routes via gateway in the LNet routing table\n" "usage: set_route [