Whamcloud - gitweb
Make ONLY=setup not do cleanup at the end, while we use replay-dual.sh as
[fs/lustre-release.git] / lustre / doc / lfs.1
1 .TH lfs 1 "2003 Oct 29" Lustre "configuration utilities"
2 .SH NAME
3 lfs \- Lustre utility to create a file with specific striping pattern, find the striping pattern of exiting files
4 .SH SYNOPSIS
5 .br
6 .B lfs
7 .br
8 .B lfs find [--obd <uuid>] [--quiet | --verbose] [--recursive] <dir|file>
9 .br
10 .B lfs getstripe <file-name> 
11 .br
12 .B lfs setstripe <filename> <stripe-size> <start-ost> <stripe-cnt>
13 .SH DESCRIPTION
14 .B lfs
15 can be used to create a new file with a specific striping pattern, determine the default striping pattern, gather the extended attributes (object numbers and 
16 location) for a specific file. It can be invoked interactively without any 
17 arguments or in a non-interactive mode with one of the arguements supported. 
18 .SH OPTIONS
19 The various options supported by lctl are listed and explained below:
20 .TP
21 .B setstripe 
22 To create a new file with a specific striping pattern
23 .TP
24 .B find 
25 To list the extended attributes for a given filename or files in a directory or recursively for all files in a directory tree. It can also be used to list the files that have objects on a specific OST. 
26 .TP
27 .B getstripe 
28 To list the striping pattern for given filename
29 .TP
30 .B help 
31 Provides brief help on the various arguments
32 .TP
33 .B exit/quit 
34 Quit the interactive lfs session
35
36 .SH EXAMPLES
37 .TP
38 .B $lfs setstripe /mnt/lustre/file1 131072 0 1
39 This creats a file striped on one OST
40 .TP
41 .B $lfs find /mnt/lustre/file1
42 Lists the extended attributes of a given file
43 .TP
44 .B $lfs find /mnt/lustre/
45 Lists the extended attributes of all files in a given directory
46 .TP
47 .B $lfs find -r /mnt/lustre/
48 Recursively list the extended attributes of all files in a given directory tree
49 .TP
50 .B $lfs find -r --obd OST2-UUID /mnt/lustre/
51 List all the files that have objects on a specific OST
52 .SH BUGS
53 None are known.