Whamcloud - gitweb
land v0.9.1 on HEAD, in preparation for a 1.0.x branch
[fs/lustre-release.git] / lustre / doc / lfs.lyx
1 #LyX 1.3 created this file. For more info see http://www.lyx.org/
2 \lyxformat 221
3 \textclass amsart
4 \language english
5 \inputencoding auto
6 \fontscheme times
7 \graphics default
8 \paperfontsize default
9 \spacing single 
10 \papersize letterpaper
11 \paperpackage a4
12 \use_geometry 0
13 \use_amsmath 0
14 \use_natbib 0
15 \use_numerical_citations 0
16 \paperorientation portrait
17 \secnumdepth 3
18 \tocdepth 3
19 \paragraph_separation skip
20 \defskip medskip
21 \quotes_language english
22 \quotes_times 2
23 \papercolumns 1
24 \papersides 1
25 \paperpagestyle default
26
27 \layout Section
28
29 LFS
30 \layout Subsection
31
32 NAME
33 \layout Description
34
35 lfs Lustre utility to create a file with specific striping pattern
36 \layout Subsection
37
38 SYNOPSIS
39 \layout Standard
40
41
42 \series bold 
43 lfs
44 \layout Standard
45
46
47 \series bold 
48 lfs\SpecialChar ~
49 find [--obd <uuid>] [--quiet | --verbose] [--recursive] <dir|file>
50 \layout Standard
51
52
53 \series bold 
54 lfs\SpecialChar ~
55 getstripe <file_name> 
56 \layout Standard
57
58
59 \series bold 
60 lfs\SpecialChar ~
61 setstripe <filename> <stripe_size> <start_ost> <stripe_cnt>
62 \layout Subsection
63
64 DESCRIPTION
65 \layout Standard
66
67 This utility can be used to create a new file with a specific striping pattern,
68  determine the default striping pattern, gather the extended attributes
69  (object numbers and location) for a specific file.
70  It can be invoked interactively without any arguments or in a non-interactive
71  mode with one of the arguements listed and explained below:
72 \layout List
73 \labelwidthstring 00.00.0000
74
75
76 \series bold 
77 setstripe
78 \series default 
79  To create a new file with a specific striping pattern
80 \layout List
81 \labelwidthstring 00.00.0000
82
83
84 \series bold 
85 find
86 \series default 
87  To list the extended attributes for a given filename or files in a directory
88  or recursively for all files in a directory tree.
89  It can also be used to list the files that have objects on a specific OST.
90  
91 \layout List
92 \labelwidthstring 00.00.0000
93
94
95 \series bold 
96 getstripe
97 \series default 
98  To list the striping pattern for given filename
99 \layout List
100 \labelwidthstring 00.00.0000
101
102
103 \series bold 
104 help
105 \series default 
106  Provides brief help on the various arguments
107 \layout List
108 \labelwidthstring 00.00.0000
109
110
111 \series bold 
112 exit/quit
113 \series default 
114  Quit the interactive lfs session
115 \layout Subsection
116
117 EXAMPLES
118 \layout Description
119
120 Creating\SpecialChar ~
121 a\SpecialChar ~
122 file\SpecialChar ~
123 striped\SpecialChar ~
124 on\SpecialChar ~
125 one\SpecialChar ~
126 OST
127 \layout LyX-Code
128
129    $lfs setstripe /mnt/lustre/file1 131072 0 1
130 \layout Description
131
132 Listing
133 \series bold 
134 \SpecialChar ~
135
136 \series default 
137 the
138 \series bold 
139 \SpecialChar ~
140
141 \series default 
142 extended
143 \series bold 
144 \SpecialChar ~
145
146 \series default 
147 attributes
148 \series bold 
149 \SpecialChar ~
150
151 \series default 
152 of
153 \series bold 
154 \SpecialChar ~
155
156 \series default 
157 a
158 \series bold 
159 \SpecialChar ~
160
161 \series default 
162 given
163 \series bold 
164 \SpecialChar ~
165
166 \series default 
167 file
168 \layout LyX-Code
169
170    $lfs find /mnt/lustre/file1
171 \layout Description
172
173 Listing\SpecialChar ~
174 the\SpecialChar ~
175 extended\SpecialChar ~
176 attributes\SpecialChar ~
177 of\SpecialChar ~
178 all\SpecialChar ~
179 files\SpecialChar ~
180 in\SpecialChar ~
181 a\SpecialChar ~
182 given\SpecialChar ~
183 directory
184 \layout LyX-Code
185
186    $lfs find /mnt/lustre/
187 \layout Description
188
189 Recursively\SpecialChar ~
190 list\SpecialChar ~
191 the\SpecialChar ~
192 extended\SpecialChar ~
193 attributes\SpecialChar ~
194 of\SpecialChar ~
195 all\SpecialChar ~
196 files\SpecialChar ~
197 in\SpecialChar ~
198 a\SpecialChar ~
199 given\SpecialChar ~
200 directory\SpecialChar ~
201 tree
202 \layout LyX-Code
203
204    $lfs find -r /mnt/lustre/
205 \layout Description
206
207 List\SpecialChar ~
208 all\SpecialChar ~
209 the\SpecialChar ~
210 files\SpecialChar ~
211 that\SpecialChar ~
212 have\SpecialChar ~
213 objects\SpecialChar ~
214 on\SpecialChar ~
215 a\SpecialChar ~
216 specific\SpecialChar ~
217 OST
218 \layout LyX-Code
219
220    $lfs find -r --obd OST2_UUID /mnt/lustre/
221 \layout LyX-Code
222
223 \layout Subsection
224
225 BUGS
226 \layout Standard
227
228 None are known.
229 \the_end