1 #LyX 1.2 created this file. For more info see http://www.lyx.org/
3 \textclass amsart-plain
10 \papersize letterpaper
15 \use_numerical_citations 0
16 \paperorientation portrait
19 \paragraph_separation skip
21 \quotes_language english
25 \paperpagestyle default
35 lctl Low level Lustre filesystem configuration utility.
49 --device\SpecialChar ~
50 <devno> <command\SpecialChar ~
57 --threads\SpecialChar ~
58 <numthreads>\SpecialChar ~
59 <verbose>\SpecialChar ~
67 The program can be invoked in interactive mode by issuing
72 After that, commands are issued as below.
73 The most common commands in lctl are (in matching pairs)
128 To get a complete listing of available commands, type
135 To get basic help on the meaning and syntax of a command, type
142 Command completion is activated with the
148 key, and command history is available via the up- and down-arrow keys.
152 For non-interactive single threaded use, one uses the second invocation,
157 after connecting to the device
165 --device The device number to be used for the operation.
166 The value of devno is an integer, normally found by calling
174 --threads How many threads should be forked doing the command specified.
175 The numthreads variable is a strictly positive integer indicating how many
176 threads should be started.
181 option is used as above.
184 --ignore_errors\SpecialChar ~
186 ignore_errors Ignore errors during script processing
189 dump Save ioctls to a file
194 Network\SpecialChar ~
199 network\SpecialChar ~
200 <tcp/elans/myrinet> Indicate what kind of network applies for the
201 configuration commands that follow.
204 connect\SpecialChar ~
205 [[<hostname>\SpecialChar ~
206 <port>]\SpecialChar ~
209 id>] This will establish a connection to
210 a remote network network
214 given by the hostname/port combination, or the elan
221 disconnect\SpecialChar ~
222 <nid> Disconnect from a remote
230 [nid] Informs the socknal of the local
235 It defaults to hostname for tcp networks and is automatically setup for
236 elan/myrinet networks.
239 add_uuid\SpecialChar ~
241 <nid> Associate a given UUID with an
246 close_uuid\SpecialChar ~
247 <uuid> Disconnect a UUID.
250 del_uuid\SpecialChar ~
251 <uuid> Delete a UUID association.
254 add_route\SpecialChar ~
255 <gateway>\SpecialChar ~
256 <target>\SpecialChar ~
257 [target] Add an entry to the routing table for
261 del_route\SpecialChar ~
262 <target> Delete an entry for the target from the routing table.
265 route_list Print the complete routing table.
268 recv_mem\SpecialChar ~
269 [size] Set the socket
273 buffer size; if the size is omitted, the default size for the buffer is
277 send_mem\SpecialChar ~
278 [size] Set send buffer size for the socket; if size is omitted,
279 the default size for the buffer is printed.
283 [on/off] Enable/disable nagle; omitting the argument will cause the
284 default value to be printed.
288 nid|all\SpecialChar ~
289 [count] Fail/restore communications.
290 Ommiting tha count implies fail indefinitely, count of zero indicates that
291 communication should be restored.
292 A non-zero count indicates the number of portals messages to be dropped
293 after which the communication is restored.
302 newdev Create a new device.
305 name2dev This command can be used to determine a device number for the given
309 device This will select the specified OBD device.
310 All other commands depend on the device being set.
314 device_list Show all the devices.
317 lustre_build_version Print the Lustre build version.
335 a type to the current device (which you need to set using the
341 command) and give that device a name and UUID.
342 This allows us to identify the device for use later, and also tells us
343 what type of device we will have.
347 <args...> Type specific device setup commands.
348 For obdfilter, a setup command tells the driver which block device it should
349 use for storage and what type of filesystem is on that device.
353 cleanup Cleanup a previously setup device.
356 detach Remove driver (and name and UUID) from the current device.
359 lov_setconfig\SpecialChar ~
360 lov-uuid\SpecialChar ~
361 stripe-count\SpecialChar ~
362 default-stripe-size\SpecialChar ~
364 pattern\SpecialChar ~
367 Write LOV configuration to an MDS device.
370 lov_getconfig\SpecialChar ~
371 lov-uuid Read LOV configuration from an MDS device.
372 Returns default-stripe-count, default-stripe-size, offset, pattern, and
373 a list of OST UUID's.
383 [timeout] Build a connection handle to a device.
384 This command is used to suspend configuration until the lctl command has
385 ensured that the MDS and OSC services are available.
386 This is to avoid mount failures in a rebooting cluster.
400 getattr\SpecialChar ~
401 <objid> Get attributes for an OST object
408 setattr\SpecialChar ~
409 <objid>\SpecialChar ~
410 <mode> Set mode attribute for OST object
420 [verbose]]] Create the specified number
424 of OST objects with the given
431 destroy\SpecialChar ~
433 starting\SpecialChar ~
439 > number of objects starting from the object with object id <
446 test_getattr\SpecialChar ~
448 [verbose\SpecialChar ~
468 test_brw\SpecialChar ~
469 [t]<num>\SpecialChar ~
471 [verbose\SpecialChar ~
472 [npages\SpecialChar ~
496 test_ldlm Perform lock manager test.
499 ldlm_regress_start\SpecialChar ~
501 [numthreads\SpecialChar ~
502 [refheld\SpecialChar ~
503 [numres\SpecialChar ~
504 [numext]]]] Start lock manager
508 ldlm_regress_stop Stop lock manager stress test.
511 dump_ldlm Dump all lock manager state, this is very useful for debugging
514 activate Activate an import
517 deacttivate De-activate an import
520 recover\SpecialChar ~
525 <directory>\SpecialChar ~
529 notransno Disable sending of committed transnumber updates
532 readonly Disable writes to the underlying device
535 abort_recovery Abort recovery on MDS device
538 mount_option Dump mount options to a file
541 get_stripe show stripe info for an echo client object.
544 set_stripe\SpecialChar ~
545 <objid>[\SpecialChar ~
546 width!count[@offset]\SpecialChar ~
547 [:id:id....] set stripe info for an echo
551 unset_stripe\SpecialChar ~
552 <objid> unset stripe info for an echo client object.
560 debug_daemon debug daemon control and dump to a file
563 debug_kernel\SpecialChar ~
565 [raw] Get debug buffer and dump to a
572 debug_file\SpecialChar ~
573 <input>\SpecialChar ~
574 [output]\SpecialChar ~
575 [raw] Read debug buffer from input and dump to
583 clear Clear kernel debug buffer.
587 <text> Insert marker text in kernel debug buffer.
591 <subsystem\SpecialChar ~
592 id/debug\SpecialChar ~
593 mask> Filter message type from the kernel debug
598 <subsystem\SpecialChar ~
599 id/debug\SpecialChar ~
600 mask> Show specific type of messages.
603 debug_list\SpecialChar ~
604 <subs/types> List all the subsystem and debug types.
607 panic Force the kernel to panic.
615 help Show a complete list of commands;
619 can be used to get help on specific command.
622 exit Close the lctl session.
625 quit Close the lctl session.
641 lctl > attach obdfilter OBDDEV OBDUUID
653 lctl > name2dev OSCDEV
721 lctl > setup /dev/loop0 extN