-#LyX 1.3 created this file. For more info see http://www.lyx.org/
-\lyxformat 221
+#LyX 1.4.4 created this file. For more info see http://www.lyx.org/
+\lyxformat 245
+\begin_document
+\begin_header
\textclass amsart
\language english
\inputencoding auto
\fontscheme times
\graphics default
\paperfontsize default
-\spacing single
+\spacing single
\papersize letterpaper
-\paperpackage a4
-\use_geometry 0
-\use_amsmath 0
-\use_natbib 0
-\use_numerical_citations 0
+\use_geometry false
+\use_amsmath 1
+\cite_engine basic
+\use_bibtopic false
\paperorientation portrait
\secnumdepth 3
\tocdepth 3
\paragraph_separation skip
\defskip medskip
\quotes_language english
-\quotes_times 2
\papercolumns 1
\papersides 1
\paperpagestyle default
+\tracking_changes false
+\output_changes true
+\end_header
-\layout Section
+\begin_body
+\begin_layout Section
LFS
-\layout Subsection
+\end_layout
+\begin_layout Subsection
NAME
-\layout Description
+\end_layout
+\begin_layout Description
lfs Lustre utility to create a file with specific striping pattern and manipulat
e disk quotas
-\layout Subsection
+\end_layout
+\begin_layout Subsection
SYNOPSIS
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
+\series bold
lfs
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace ~
find [--atime|-A N] [--mtime|-M N] [--ctime|-C N] [--maxdepth|-D N] [--print0
|-P] [--print|-p] [--obd|-O <uuid>] <dir/file>
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace ~
find [--quiet|-q] [--verbose|-v] [--recursive|-r] <dir/file>
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace ~
getstripe [--obd|-O <uuid>] [--quiet|-q] [--verbose|-v] [--recursive|-r]
<dir/file>
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace ~
setstripe <filename|dirname> <stripe_size> <start_ost> <stripe_cnt>
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace \space{}
+setstripe <filename|dirname> [--size|-s stripe_size] [--index|-i start_ost]
+ [--count|-c stripe_cnt]
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+lfs\InsetSpace ~
setstripe -d <dirname>
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace ~
check <mds| osts| servers>
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace ~
quotachog [-i] <filesystem>
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace ~
quotacheck [-ug] <filesystem>
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace ~
quotaon [-ugf] <filesystem>
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace ~
quotaoff [-ug] <filesystem>
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace ~
setquota [-u|-g] <name> <block-softlimit> <block-hardlimit> <inode-softlimit>
<inode-hardlimit> <filesystem>
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace ~
quota [-o obd_uuid] [-u|-g] <name> <filesystem>
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace ~
df [-i] [-h] [path]
-\layout Standard
+\end_layout
+\begin_layout Standard
-\series bold
-lfs\SpecialChar ~
+\series bold
+lfs\InsetSpace ~
help
-\layout Subsection
+\end_layout
+\begin_layout Subsection
DESCRIPTION
-\layout Standard
+\end_layout
+\begin_layout Standard
This utility 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 location) for a specific file, and manipulate disk
quotas.
It can be invoked interactively without any arguments or in a non-interactive
mode with one of the arguements listed and explained below:
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
setstripe
-\series default
+\series default
To create a new file with a specific striping pattern
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
find
-\series default
+\series default
To search the directory tree rooted at the given dir/file name for the
files that match the given parameters: --atime (file was last accessed
N*24 hours ago), --ctime (file's status was last changed N*24 hours ago),
tree.
The options --print and --print0 print full file name, followed by a newline
and null character correspondingly.
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
find
-\series default
+\series default
To list the striping info for a given filename or files in a directory
or recursively for all files in a directory tree use one of the following
options: [--quiet|-q] [--verbose|-v] [--recursive|-r].
If one of these options is given find works in old (obsolete, please use
getstripe instead) mode.
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
getstripe
-\series default
+\series default
To list the striping info for 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.
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
check
-\series default
+\series default
Display the status of MDS or OSTs (as specified in the command) or all the
servers (MDS and OSTs)
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
osts
-\series default
+\series default
List all the OSTs for the filesystem
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
quotachog
-\series default
+\series default
Change files' owner and group on OSTs of the specified filesystem
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
quotacheck
-\series default
+\series default
Scan the specified filesystem for disk usage, and create or update quota
files
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
quotaon
-\series default
+\series default
Turn filesystem quotas on
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
quotaoff
-\series default
+\series default
Turn filesystem quotas off
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
setquota
-\series default
+\series default
Set filesystem quotas
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
quota
-\series default
+\series default
Display disk usage and limits
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
df
-\series default
+\series default
Report filesystem disk space usage or inodes usage of each MDS/OSD.
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
help
-\series default
+\series default
Provides brief help on the various arguments
-\layout List
-\labelwidthstring 00.00.0000
+\end_layout
+\begin_layout List
+\labelwidthstring 00.00.0000
-\series bold
+\series bold
exit/quit
-\series default
+\series default
Quit the interactive lfs session
-\layout Subsection
+\end_layout
+\begin_layout Subsection
EXAMPLES
-\layout Description
+\end_layout
+\begin_layout Description
This creates a file striped on one OST
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$ lfs setstripe /mnt/lustre/file1 131072 0 1
-\layout Description
+\end_layout
+\begin_layout Description
This creates a default stripe pattern on and existing dir for all new files
created therein.
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$ lfs setstripe /mnt/lustre/dir 131072 0 1
-\layout Description
+\end_layout
+\begin_layout Description
This deletes a default stripe pattern on dir.
New files will use the default striping pattern.
created therein.
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$ lfs setstripe -d /mnt/lustre/dir
-\layout Description
+\end_layout
+\begin_layout Description
Listing the extended attributes of a given file
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$ lfs find /mnt/lustre/foo1
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
OBDS:
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
0: OST_localhost_UUID
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
/mnt/lustre/foo1
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
obdidx objid objid group
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
0 1 0x1 0
-\layout Description
+\end_layout
+\begin_layout Description
Listing the extended attributes of all files in a given directory
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$ lfs find /mnt/lustre/
-\layout Description
+\end_layout
+\begin_layout Description
Recursively list the extended attributes of all files in a given directory
tree
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$ lfs find -r /mnt/lustre/
-\layout Description
+\end_layout
+\begin_layout Description
List all the files that have objects on a specific OST
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$ lfs find -r --obd OST2_UUID /mnt/lustre/
-\layout Description
+\end_layout
+\begin_layout Description
Check the status of all servers(mds, osts)
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$ lfs check servers
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
OSC_localhost.localdomain_OST_localhost_mds1 active.
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
OSC_localhost.localdomain_OST_localhost_MNT_localhost active.
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
MDC_localhost.localdomain_mds1_MNT_localhost active.
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$
-\layout Description
+\end_layout
+\begin_layout Description
List all the OSTs
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$ lfs osts
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
OBDS:
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
0: OST_localhost_UUID
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$
-\layout Description
+\end_layout
-Change\SpecialChar ~
-file\SpecialChar ~
-owner\SpecialChar ~
-and\SpecialChar ~
+\begin_layout Description
+Change\InsetSpace ~
+file\InsetSpace ~
+owner\InsetSpace ~
+and\InsetSpace ~
group
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$lfs quotachog -i /mnt/lustre
-\layout Description
+\end_layout
-Quotacheck\SpecialChar ~
-for\SpecialChar ~
-user\SpecialChar ~
-and\SpecialChar ~
+\begin_layout Description
+Quotacheck\InsetSpace ~
+for\InsetSpace ~
+user\InsetSpace ~
+and\InsetSpace ~
group
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$lfs quotacheck -ug /mnt/lustre
-\layout Description
-
-Turn\SpecialChar ~
-quotas\SpecialChar ~
-of\SpecialChar ~
-user\SpecialChar ~
-and\SpecialChar ~
-group\SpecialChar ~
+\end_layout
+
+\begin_layout Description
+Turn\InsetSpace ~
+quotas\InsetSpace ~
+of\InsetSpace ~
+user\InsetSpace ~
+and\InsetSpace ~
+group\InsetSpace ~
on
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$lfs quotaon -ug /mnt/lustre
-\layout Description
-
-Turn\SpecialChar ~
-quotas\SpecialChar ~
-of\SpecialChar ~
-user\SpecialChar ~
-and\SpecialChar ~
-group\SpecialChar ~
+\end_layout
+
+\begin_layout Description
+Turn\InsetSpace ~
+quotas\InsetSpace ~
+of\InsetSpace ~
+user\InsetSpace ~
+and\InsetSpace ~
+group\InsetSpace ~
off
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$lfs quotaoff -ug /mnt/lustre
-\layout Description
-
-Set\SpecialChar ~
-quotas\SpecialChar ~
-of\SpecialChar ~
-user\SpecialChar ~
-`bob':\SpecialChar ~
-1GB\SpecialChar ~
-block\SpecialChar ~
-quota\SpecialChar ~
-and\SpecialChar ~
-10,000\SpecialChar ~
-file\SpecialChar ~
+\end_layout
+
+\begin_layout Description
+Set\InsetSpace ~
+quotas\InsetSpace ~
+of\InsetSpace ~
+user\InsetSpace ~
+`bob':\InsetSpace ~
+1GB\InsetSpace ~
+block\InsetSpace ~
+quota\InsetSpace ~
+and\InsetSpace ~
+10,000\InsetSpace ~
+file\InsetSpace ~
quota
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$lfs setquota -u bob 0 1000000 0 10000 /mnt/lustre
-\layout Description
+\end_layout
-List\SpecialChar ~
-quotas\SpecialChar ~
-of\SpecialChar ~
-user\SpecialChar ~
+\begin_layout Description
+List\InsetSpace ~
+quotas\InsetSpace ~
+of\InsetSpace ~
+user\InsetSpace ~
`bob'
-\layout LyX-Code
+\end_layout
+\begin_layout LyX-Code
$lfs quota -u bob /mnt/lustre
-\layout Subsection
+\end_layout
+\begin_layout Subsection
BUGS
-\layout Standard
+\end_layout
+\begin_layout Standard
None are known.
-\the_end
+\end_layout
+
+\end_body
+\end_document
git://git.whamcloud.com / fs / lustre-release.git / blobdiff