X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Flctl.lyx;h=268dc3be2e298cd8282dec7a1a8129cfbfe6744f;hb=cd49f3321b4b69bc7bbb24b0340299d4d5e6b014;hp=33b40b279d47866d6592d5bb09c86db97afef154;hpb=2e5dc5bbe9da8d3b30cf49ec7f852b7ed1a95a8f;p=fs%2Flustre-release.git

diff --git a/lustre/doc/lctl.lyx b/lustre/doc/lctl.lyx
index 33b40b2..268dc3b 100644
--- a/lustre/doc/lctl.lyx
+++ b/lustre/doc/lctl.lyx
@@ -1,5 +1,5 @@
-#LyX 1.2 created this file. For more info see http://www.lyx.org/
-\lyxformat 220
+#LyX 1.3 created this file. For more info see http://www.lyx.org/
+\lyxformat 221
 \textclass amsart-plain
 \language english
 \inputencoding auto
@@ -132,7 +132,7 @@ help
 \family default 
 \size default 
  at the lctl prompt.
-  To get basic help on the meaning and syntax of a command, type 
+ To get basic help on the meaning and syntax of a command, type 
 \family typewriter 
 \size small 
 help command
@@ -165,9 +165,9 @@ command
 --device The device number to be used for the operation.
  The value of devno is an integer, normally found by calling 
 \emph on 
-lctl name2dev 
+lctl device_list/dl
 \emph default 
-on a device name.
+.
  
 \layout Description
 
@@ -179,8 +179,14 @@ on a device name.
 devno 
 \emph default 
 option is used as above.
-\layout LyX-Code
+\layout Description
+
+--ignore_errors\SpecialChar ~
+|\SpecialChar ~
+ignore_errors Ignore errors that occur during script processing.
+\layout Description
 
+dump Save ioctl buffer to file.
 \layout LyX-Code
 
 \layout Description
@@ -190,26 +196,133 @@ Configuration
 \begin_deeper 
 \layout Description
 
+--net\SpecialChar ~
+
+\series bold 
+<tcp/elan/myrinet>
+\series default 
+\SpecialChar ~
+
+\series bold 
+<command> 
+\series default 
+Indicate the network type to be used for the operation.
+\layout Description
+
 network\SpecialChar ~
 <tcp/elans/myrinet> Indicate what kind of network applies for the
  configuration commands that follow.
 \layout Description
 
+interface_list Print the interface entries.
+\layout Description
+
+add_interface\SpecialChar ~
+
+\series bold 
+<
+\series default 
+ip>\SpecialChar ~
+[netmask] Add an interface entry.
+\layout Description
+
+del_interface\SpecialChar ~
+[ip] Delete an interface entry.
+\layout Description
+
+peer_list Print the peer entries.
+\layout Description
+
+add_peer\SpecialChar ~
+
+\series bold 
+<
+\series default 
+nid>\SpecialChar ~
+
+\series bold 
+<
+\series default 
+host>\SpecialChar ~
+
+\series bold 
+<
+\series default 
+port> 
+\series bold 
+Add a peer entry.
+\layout Description
+
+del_peer\SpecialChar ~
+[
+\series bold 
+<
+\series default 
+nid>]\SpecialChar ~
+[
+\series bold 
+<
+\series default 
+host>]\SpecialChar ~
+[ks] Remove a peer entry.
+\layout Description
+
+autoconn_list Print autoconnect entries.
+\layout Description
+
+add_autoconn\SpecialChar ~
+
+\series bold 
+nid
+\series default 
+\SpecialChar ~
+
+\series bold 
+ipaddr
+\series default 
+\SpecialChar ~
+
+\series bold 
+port
+\series default 
+\SpecialChar ~
+
+\series bold 
+[ise]
+\series default 
+ Add an autoconnect entry.
+\layout Description
+
+del_autoconn\SpecialChar ~
+
+\series bold 
+[<nid>]
+\series default 
+\SpecialChar ~
+
+\series bold 
+[<host>]
+\series default 
+\SpecialChar ~
+
+\series bold 
+[ks]
+\series default 
+ Remove an autoconnect entry.
+\layout Description
+
+conn_list Print all the connected remote nid.
+\layout Description
+
 connect\SpecialChar ~
-[[<hostname>\SpecialChar ~
-<port>]\SpecialChar ~
-|\SpecialChar ~
-<elan\SpecialChar ~
-id>] This will establish a connection to
- a remote network network 
+<hostname>\SpecialChar ~
+<port>\SpecialChar ~
+[iIOC] This will establish a connection to a remote
+ network, network 
 \emph on 
 id
 \emph default 
- given by the hostname/port combination, or the elan 
-\emph on 
-id
-\emph default 
-.
+ given by the hostname/port combination.
 \layout Description
 
 disconnect\SpecialChar ~
@@ -220,6 +333,10 @@ nid
 .
 \layout Description
 
+active_tx This command should print active transmits, and it is only used
+ for elan network type.
+\layout Description
+
 mynid\SpecialChar ~
 [nid] Informs the socknal of the local 
 \emph on 
@@ -230,15 +347,20 @@ nid
  elan/myrinet networks.
 \layout Description
 
+shownid Print the local NID.
+\layout Description
+
 add_uuid\SpecialChar ~
 <uuid>\SpecialChar ~
-<nid> Associate a given UUID with an 
+<nid>\SpecialChar ~
+<net_type> Associate a given UUID with an 
 \emph on 
 nid.
 \layout Description
 
 close_uuid\SpecialChar ~
-<uuid> Disconnect a UUID.
+<uuid>\SpecialChar ~
+<net_type> Disconnect a UUID.
 \layout Description
 
 del_uuid\SpecialChar ~
@@ -248,34 +370,52 @@ del_uuid\SpecialChar ~
 add_route\SpecialChar ~
 <gateway>\SpecialChar ~
 <target>\SpecialChar ~
-[target] Add an entry to the routing table for
- the given target.
+[<target>] Add an entry to the portals routing
+ table for the given target.
+ The arguments should be nid.
+ If only one <target> is provided, this command should only add the route
+ for this target.
+ But, if both of the <target>s are provides, this command should add the
+ route for all the target in the range specified by the two targets(from
+ low nid to high nid).
 \layout Description
 
 del_route\SpecialChar ~
-<target> Delete an entry for the target from the routing table.
+<gateway>\SpecialChar ~
+[<target>]\SpecialChar ~
+[<target>] Delete the route entry for the given
+ targets from the portals routing table.
+ The arguments should be nid.
+ 
 \layout Description
 
-route_list Print the complete routing table.
+set_route\SpecialChar ~
+<gateway>\SpecialChar ~
+<up/down>\SpecialChar ~
+[<time>] Enable/disable routes via the given
+ gateway in the protals routing table.
+ <time> is used to tell when a gateway comes back online.
 \layout Description
 
-recv_mem\SpecialChar ~
-[size] Set the socket 
-\emph on 
-receive
-\emph default 
- buffer size; if the size is omitted, the default size for the buffer is
- printed.
+route_list Print the complete portals routing table.
 \layout Description
 
-send_mem\SpecialChar ~
-[size] Set send buffer size for the socket; if size is omitted,
- the default size for the buffer is printed.
-\layout Description
+fail\SpecialChar ~
+nid|_all_\SpecialChar ~
+[count] Fail/restore communications.
+ Omitting the count implies fail indefinitely, count of zero indicates that
+ communication should be restored.
+ A non-zero count indicates the number of portals messages to be dropped
+ after which the communication is restored.
+ The argument 
+\begin_inset Quotes eld
+\end_inset 
 
-nagle\SpecialChar ~
-[on/off] Enable/disable nagle; omitting the argument will cause the
- default value to be printed.
+nid
+\begin_inset Quotes erd
+\end_inset 
+
+ is used to specify the gateway, which is one peer of the communication.
 \end_deeper 
 \layout Description
 
@@ -287,16 +427,22 @@ Selection
 newdev Create a new device.
 \layout Description
 
-name2dev This command can be used to determine a device number for the given
- device name.
+device\SpecialChar ~
+<%name|$name|devno> This will select the specified OBD device.
+  All other commands depend on the device being set.
 \layout Description
 
-device This will select the specified OBD device.
-  All other commands depend on the device being set.
- 
+cfg_device\SpecialChar ~
+<$name> Set current device being configured to <$name>.
 \layout Description
 
 device_list Show all the devices.
+\layout Description
+
+dl The same as device_list.
+\layout Description
+
+lustre_build_version Print the Lustre build version.
 \end_deeper 
 \layout Description
 
@@ -332,27 +478,47 @@ setup\SpecialChar ~
  
 \layout Description
 
-cleanup Cleanup a previously setup device.
+cleanup\SpecialChar ~
+[force|failover] Cleanup a previously setup device.
 \layout Description
 
 detach Remove driver (and name and UUID) from the current device.
 \layout Description
 
-lov_setconfig\SpecialChar ~
+lov_setup\SpecialChar ~
 lov-uuid\SpecialChar ~
-default-stripe-count\SpecialChar ~
-default-stripe-size\SpecialChar ~
+stripe-count\SpecialChar ~
+stripe-size\SpecialChar ~
 offset\SpecialChar ~
 pattern\SpecialChar ~
 UUID1\SpecialChar ~
-[U
-UID2...] Write LOV configuration to an MDS device.
+[UUID2...] Write
+ LOV configuration to an MDS device.
 \layout Description
 
 lov_getconfig\SpecialChar ~
 lov-uuid Read LOV configuration from an MDS device.
- Returns default-stripe-count, default-stripe-size, offset, pattern, and
- a list of OST UUID's.
+ Returns stripe-count, stripe-size, offset, pattern, and a list of OST UUID's.
+\layout Description
+
+record\SpecialChar ~
+cfg-uuid-name Record commands that follow in log.
+\layout Description
+
+endrecord Stop recording
+\layout Description
+
+parse\SpecialChar ~
+config-uuid-name Parse the log of recorded commands for this config.
+\layout Description
+
+dump_log\SpecialChar ~
+config-uuid-name Print log of recorded commands for this config
+ to kernel debug log.
+\layout Description
+
+clear_log\SpecialChar ~
+config-name Delete current config log of recorded commands.
 \end_deeper 
 \layout Description
 
@@ -371,6 +537,12 @@ probe\SpecialChar ~
 close
 \emph on 
  
+\emph default 
+Close the
+\emph on 
+ 
+\emph default 
+connection handle
 \layout Description
 
 getattr\SpecialChar ~
@@ -393,7 +565,9 @@ setattr\SpecialChar ~
 create\SpecialChar ~
 [num\SpecialChar ~
 [mode\SpecialChar ~
-[verbose]]] Create the specified number 
+[verbose\SpecialChar ~
+[lsm\SpecialChar ~
+data]]]] Create the specified number 
 \emph on 
 <num>
 \emph default 
@@ -405,7 +579,18 @@ create\SpecialChar ~
 \layout Description
 
 destroy\SpecialChar ~
-<objid> Destroy an OST object.
+<num>\SpecialChar ~
+starting\SpecialChar ~
+at\SpecialChar ~
+<objid> Destroy <
+\emph on 
+num
+\emph default 
+> number of objects starting from the object with object id <
+\emph on 
+objid
+\emph default 
+>.
 \layout Description
 
 test_getattr\SpecialChar ~
@@ -458,11 +643,24 @@ writes
  per I/O).
 \layout Description
 
+get_stripe\SpecialChar ~
+objid Show stripe info for an echo client object.
+\layout Description
+
+set_stripe\SpecialChar ~
+<objid>[=width!count[@offset]\SpecialChar ~
+[:id:id....] Set stripe info for an echo
+ client object.
+\layout Description
+
+unset_stripe\SpecialChar ~
+<objid> Unset stripe info for an echo client object.
+\layout Description
+
 test_ldlm Perform lock manager test.
 \layout Description
 
 ldlm_regress_start\SpecialChar ~
-%s\SpecialChar ~
 [numthreads\SpecialChar ~
 [refheld\SpecialChar ~
 [numres\SpecialChar ~
@@ -473,12 +671,101 @@ ldlm_regress_start\SpecialChar ~
 ldlm_regress_stop Stop lock manager stress test.
 \layout Description
 
-dump_ldlm Dump all lock manager state, this is very useful for debugging
+dump_ldlm Dump all lock manager state, this is very useful for debugging.
+\layout Description
+
+activate Activate an import.
+\layout Description
+
+deactivate De-activate an import.
+\layout Description
+
+recover\SpecialChar ~
+[<connection\SpecialChar ~
+UUID>] Pass the information of the new target and initialize
+ the connection to this target.
+ 
+\layout Description
+
+lookup\SpecialChar ~
+<directory>\SpecialChar ~
+<file> Print some information of the given file.
+\layout Description
+
+notransno Disable sending of committed transnumber updates.
+\layout Description
+
+readonly Disable writes to the underlying device.
+\layout Description
+
+abort_recovery Abort recovery on MDS device.
+\layout Description
+
+start\SpecialChar ~
+<profilename> Setup mds/ost from the llog file.
+\layout Description
+
+mount_option\SpecialChar ~
+profile\SpecialChar ~
+osc_name\SpecialChar ~
+[mdc_name] Add a new profile to lustre.
+\layout Description
+
+del_mount_option\SpecialChar ~
+profile Delete a specified profile.
+\layout Description
+
+set_timeout\SpecialChar ~
+<secs> Set the timeout(
+\emph on 
+obd_timeout
+\emph default 
+) for server to wait before failing recovery.
+\layout Description
+
+set_lustre_upcall\SpecialChar ~
+</full/path/to/upcall> Set the lustre upcall(obd_lustre_upcall)
+ via the lustre.upcall sysctl.
 \layout Description
 
-newconn\SpecialChar ~
-<olduuid>\SpecialChar ~
-[newuuid]
+llog_catlist List all catalog logs on current device.
+\layout Description
+
+llog_info\SpecialChar ~
+<$logname|#oid#ogr#ogen> Print log header information.
+ 
+\layout Description
+
+llog_print\SpecialChar ~
+<$logname|#oid#ogr#ogen>\SpecialChar ~
+[from]\SpecialChar ~
+[to] Print log content information.
+ It will print all records from index 1 by default.
+\layout Description
+
+llog_check\SpecialChar ~
+<$logname|#oid#ogr#ogen>\SpecialChar ~
+[from]\SpecialChar ~
+[to] Check log content information.
+ It will check all records from index 1 by default.
+\layout Description
+
+llog_cancel\SpecialChar ~
+<catalog\SpecialChar ~
+id|catalog\SpecialChar ~
+name>\SpecialChar ~
+<log\SpecialChar ~
+id>\SpecialChar ~
+<index> Cancel one record in log.
+\layout Description
+
+llog_remove\SpecialChar ~
+<catalog\SpecialChar ~
+id|catalog\SpecialChar ~
+name>\SpecialChar ~
+<log\SpecialChar ~
+id> Remove one log from catalog, erase
+ it from disk.
 \end_deeper 
 \layout Description
 
@@ -486,22 +773,32 @@ Debug
 \begin_deeper 
 \layout Description
 
+debug_daemon\SpecialChar ~
+[start\SpecialChar ~
+file\SpecialChar ~
+<#MB>|stop|pause|continue] Debug daemon control and
+ dump to a file.
+\layout Description
+
 debug_kernel\SpecialChar ~
 [file]\SpecialChar ~
 [raw] Get debug buffer and dump to a 
 \emph on 
-fileusage
+file
 \emph default 
 .
 \layout Description
 
+dk The same as debug_kernel.
+\layout Description
+
 debug_file\SpecialChar ~
 <input>\SpecialChar ~
 [output]\SpecialChar ~
 [raw] Read debug buffer from input and dump to
  
 \emph on 
-outputusage
+output
 \emph default 
 .
 \layout Description
@@ -530,7 +827,23 @@ debug_list\SpecialChar ~
 <subs/types> List all the subsystem and debug types.
 \layout Description
 
+modules\SpecialChar ~
+<path> Provide gdb-friendly module information.
+\layout Description
+
 panic Force the kernel to panic.
+\layout Description
+
+lwt\SpecialChar ~
+start/stop\SpecialChar ~
+[file] Light-weight tracing.
+\layout Description
+
+memhog\SpecialChar ~
+<page\SpecialChar ~
+count>\SpecialChar ~
+[<gfp\SpecialChar ~
+flags>] Memory pressure testing.
 \end_deeper 
 \layout Description