[Pkg-lustre-svn-commit] r412 - /trunk/debian/lfs.8

[winnie at users.alioth.debian.org]

Author: winnie
Date: Wed Jan  2 09:43:28 2008
New Revision: 412

URL: http://svn.debian.org/wsvn/pkg-lustre/?sc=1&rev=412
Log:
Add first draft for manpage

Added:
    trunk/debian/lfs.8

Added: trunk/debian/lfs.8
URL: http://svn.debian.org/wsvn/pkg-lustre/trunk/debian/lfs.8?rev=412&op=file
==============================================================================
--- trunk/debian/lfs.8 (added)
+++ trunk/debian/lfs.8 Wed Jan  2 09:43:28 2008
@@ -1,0 +1,112 @@
+.\" -*- nroff -*-
+.\" Copyright 2007 by Patrick Winnertz <winnie at debian.org>. 
+.\" This file may be copied under the terms of the GNU Public License.
+.\"
+.TH lfs 8 "2006 Jun 15" Lustre "configuration utilities"
+.SH NAME
+lfs \- helper utility to administrate lustre clusters
+.SH SYNOPSIS
+.br
+.B lfs
+<options> [values]
+.br
+where
+.B <options>
+is one of
+.TP
+.BI setstripe
+get stripe informations for a specific fs
+.TP
+.BI getstripe
+set stripe informations for a specific fs
+.TP
+.BI find
+.TP
+.BI check
+.TP
+.BI catinfo
+.TP
+.BI join
+.TP
+.BI osts
+.TP
+.BI df
+.TP
+.BI quotachown
+.TP
+.BI quotacheck
+.TP
+.BI quotaon
+.TP
+.BI quotaoff
+.TP
+.BI setquota
+.TP
+.BI quota
+.TP
+.BI help
+.TP
+.BI exit
+.TP
+.BI quit
+
+.SH DESCRIPTION
+setstripe: Create a new file with a specific striping pattern or
+set the default striping pattern on an existing directory or
+delete the default striping pattern from an existing directory
+usage: setstripe <filename|dirname> <stripe_size> <stripe_index> <stripe_count>
+       or 
+       setstripe <filename|dirname> [--size|-s stripe_size]
+                                    [--index|-i stripe_index]
+                                    [--count|-c stripe_count]
+       or 
+       setstripe -d <dirname>   (to delete default striping)
+	stripe_size:  Number of bytes on each OST (0 filesystem default)
+	              Can be specified with k, m or g (in KB, MB and GB respectively)
+	stripe_index: OST index of first stripe (-1 filesystem default)
+	stripe_count: Number of OSTs to stripe over (0 default, -1 all)
+getstripe: To list the striping info for a given filename or files in a
+directory or recursively for all files in a directory tree.
+usage: getstripe [--obd|-O <uuid>] [--quiet | -q] [--verbose | -v]
+                 [--recursive | -r] <dir|file> ...
+find: To find files that match given parameters recursively in a directory tree.
+usage: find <dir/file> ... 
+     [[!] --atime|-A [+-]N] [[!] --mtime|-M [+-]N] [[!] --ctime|-C [+-]N]
+     [--maxdepth|-D N] [[!] --name|-n <pattern>] [--print0|-P]
+     [--print|-p] [--obd|-O <uuid>] [[!] --type|-t <filetype>]
+	 !: used before an option indicates 'NOT' the requested attribute
+	 -: used before an value indicates 'AT MOST' the requested value
+	 +: used before an option indicates 'AT LEAST' the requested value
+
+check: Display the status of MDS or OSTs (as specified in the command)
+or all the servers (MDS and OSTs).
+usage: check <osts|mds|servers>
+catinfo: Show information of specified type logs.
+usage: catinfo {keyword} [node name]
+	keywords are one of followings: config, deletions.
+	node name must be provided when use keyword config.
+join: join two lustre files into one - join A, B, will be like cat B >> A & del B
+usage: join <filename_A> <filename_B>
+
+osts: osts
+df: report filesystem disk space usage or inodes usageof each MDS/OSD.
+Usage: df [-i] [-h] [path]
+quotachown: Change files' owner or group on the specified filesystem.
+usage: quotachown [-i] <filesystem>
+	-i: ignore error if file is not exist
+
+quotacheck: Scan the specified filesystem for disk usage, and create,
+or update quota files.
+usage: quotacheck [ -ug ] <filesystem>
+quotaon: Turn filesystem quotas on.
+usage: quotaon [ -ugf ] <filesystem>
+quotaoff: Turn filesystem quotas off.
+usage: quotaoff [ -ug ] <filesystem>
+setquota: Set filesystem quotas.
+usage: setquota [ -u | -g ] <name> <block-softlimit> <block-hardlimit> <inode-softlimit> <inode-hardlimit> <filesystem>
+       setquota -t [ -u | -g ] <block-grace> <inode-grace> <filesystem>
+quota: Display disk usage and limits.
+usage: quota [ -o obd_uuid ] [{-u|-g  <name>}|-t] <filesystem>
+help: help
+exit: quit
+quit: quit