Provided by: lustre-utils_1.8.5+dfsg-3ubuntu1_i386 bug

NAME

       lfs  -  Lustre utility to create a file with specific striping pattern,
       find the striping pattern of existing files

SYNOPSIS

       lfs
       lfs check <mds|osts|servers>
       lfs df [-i] [-h] [--pool|-p <fsname>[.<pool>] [path]
       lfs find [[!] --atime|-A [-+]N] [[!] --mtime|-M [-+]N]
               [[!] --ctime|-C [-+]N] [--maxdepth|-D N] [--name|-n pattern]
               [--print|-p] [--print0|-P] [[!] --obd|-O <uuid[s]>]
               [[!] --size|-S [-+]N[kMGTPE]] [--type |-t {bcdflpsD}]
               [[!] --gid|-g|--group|-G <gname>|<gid>]
               [[!] --uid|-u|--user|-U <uname>|<uid>]
               <directory|filename>
       lfs osts [path]
       lfs getstripe [--obd|-O <uuid>] [--quiet|-q] [--verbose|-v]
               [--count | -c ] [--index | -i | --offset | -o ]
               [--size | -s ] [--pool | -p ] [--directory | -d ]
               [--recursive|-r] <dirname|filename> ...
       lfs setstripe [--size|-s stripe-size] [--count|-c stripe-cnt]
               [--index|-i|--offset|-o start_ost_index ] [--pool|-p <pool>]
               <directory|filename>
       lfs setstripe -d <dir>
       lfs poollist <filesystem>[.<pool>] | <pathname>
       lfs quota [-q] [-v] [-o obd_uuid] [<-u|-g>  <uname>|<uid>|<gname><gid>]
       <filesystem>
       lfs quota -t <-u|-g> <filesystem>
       lfs quotacheck [-ug] <filesystem>
       lfs quotachown [-i] <filesystem>
       lfs quotaon [-ugf] <filesystem>
       lfs quotaoff [-ug] <filesystem>
       lfs quotainv [-ug] [-f] <filesystem>
       lfs setquota <-u|--user|-g|--group> <uname|uid|gname|gid>
                    [--block-softlimit <block-softlimit>]
                    [--block-hardlimit <block-hardlimit>]
                    [--inode-softlimit <inode-softlimit>]
                    [--inode-hardlimit <inode-hardlimit>]
                    <filesystem>
       lfs setquota <-u|--user|-g|--group> <uname|uid|gname|gid>
                    [-b <block-softlimit>] [-B <block-hardlimit>]
                    [-i <inode-softlimit>] [-I <inode-hardlimit>]
                    <filesystem>
       lfs setquota -t <-u|-g>
                    [--block-grace <block-grace>]
                    [--inode-grace <inode-grace>]
                    <filesystem>
       lfs setquota -t <-u|-g>
                    [-b <block-grace>] [-i <inode-grace>]
                    <filesystem>
       lfs help

DESCRIPTION

       lfs  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, find files with
       specific attributes, list OST information, or set quota limits. It  can
       be  invoked interactively without any arguments or in a non-interactive
       mode with one of the arguments supported.

OPTIONS

       The various options supported by lctl are listed and explained below:

       check  Display the status of MDS or OSTs (as specified in the  command)
              or all the servers (MDS and OSTs)

       df [-i] [-h] [--pool|-p <fsname>[.<pool>] [path]
              Report  filesystem disk space usage or inodes usage (with -i) of
              each MDT/OST, or a subset of OSTs if a pool  is  specified  with
              -p.    By   default  print  the  usage  of  all  mounted  Lustre
              filesystems, otherwise if path is specified print only the usage
              of  that  filesystem.   If -h is given, the output is printed in
              human readable format,  using  SI  base-2  suffixes  for  Mega-,
              Giga-, Tera-, Peta-, or Exabytes.

       find   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), --mtime (file's data was last  modified
              N*24  hours ago), --obd (file has an object on a specific OST or
              OSTs), --size (file has size in bytes, or kilo-,  Mega-,  Giga-,
              Tera-,  Peta-,  or  Exabytes if a suffix is given), --type (file
              has the type: block, character, directory, pipe, file,  symlink,
              socket,  or  Door  (Solaris)),  --uid (file has specific numeric
              user ID), --user (file owned by specific user, numeric  user  ID
              allowed),  --gid  (file  has  specific  group ID), --group (file
              belongs to specific group, numeric group ID allowed). The option
              --maxdepth  limits  find to decend at most N levels of directory
              tree. The options --print and --print0  print  full  file  name,
              followed by a newline or NUL character correspondingly.  Using !
              before an option negates its meaning  (files  NOT  matching  the
              parameter).  Using + before a numeric value means files with the
              parameter OR MORE, while - before a numeric  value  means  files
              with the parameter OR LESS.

       osts   [path]  List all the OSTs for all mounted filesystems. If a path
              is provided that is located on a lustre mounted file system then
              only the OSTs belonging to that filesystem are displayed.

       getstripe [--obd|-O <uuid>] [--quiet|-q] [--verbose|-v]
                      [--count | -c ] [--size | -s ] [--index | -i ]
                      [--offset | -o ] [--pool | -p ] [--directory | -d ]
                      [--recursive|-r] <dirname|filename>
              List  the striping information for a given filename or directory
              tree.  By default the stripe count, size,  and  offset  will  be
              returned.  If  you  only want specific striping information then
              the options of --count, --size, --index, --offset, or --pool can
              be used to return only the specific fields.
              In  the case where you only want details about the files' object
              id information then  the  --quiet  option  is  used.  Additional
              information  available  about  striping  can  be  displayed with
              --verbose.  The default behavior when a directory  is  specified
              is  to  list  the  striping information for all files within the
              specified directory (like 'ls -l').  This can be  expanded  with
              --recursive  which will recurse into all subdirectories.  If you
              wish  to  get  striping  information  for  only  the   specified
              directory,   then   --directory   can   be  used  to  limit  the
              information, like 'ls -d').  You can limit the returned files to
              those with objects on a specific OST with --obd.

       setstripe [--size stripe-size] [--count stripe-cnt]
                   [--offset start-ost] [--pool <pool>] {directory|filename}
              To  create  a  new  file, or set the directory default, with the
              specified striping parameters.  The stripe_count is  the  number
              of  OSTs to stripe a file over. A stripe_count of 0 means to use
              the filesystem-wide default stripe  count  (default  1),  and  a
              stripe_count of -1 means to stripe over all available OSTs.  The
              stripe_size is the number of bytes to store on each  OST  before
              moving  to  the  next  OST.  A stripe_size of 0 means to use the
              filesystem-wide  default  stripe  size   (default   1MB).    The
              start_ost_index  is  the  OST  index (starting at 0) on which to
              start striping for this file.  A start_ost_index  of  -1  allows
              the  MDS  to  choose  the  starting  index  and  it  is strongly
              recommended, as this allows space and load balancing to be  done
              by  the MDS as needed.  The poolname is the name of a predefined
              pool of OSTs (see lctl ) that will be  used  for  striping.  The
              stripe_count,  stripe_size,  and start_ost_index will be used as
              well; the start_ost_index must be part of the pool or  an  error
              will be returned.

       setstripe -d
              Delete the default striping on the specified directory.

       poollist
              {filesystem}[.poolname]   |   {pathname}   List   the  pools  in
              filesystem or pathname, or the OSTs in filesystem.pool.

       quotachown
              To change files' owner  and  group  on  OSTs  of  the  specified
              filesystem

       quotacheck [-ugf] <filesystem>
              To  scan  the specified filesystem for disk usage, and create or
              update quota files. Options specify quota for users (-u)  groups
              (-g) and force (-f)

       quotaon [-ugf] <filesystem>
              To  turn  filesystem  quotas on. Options specify quota for users
              (-u) groups (-g) and force (-f)

       quotaoff [-ugf] <filesystem>
              To turn filesystem quotas off.  Options specify quota for  users
              (-u) groups (-g) and force (-f)

       quotainv [-ug] [-f] <filesystem>
              Clear  quota  files  (administrative quota files if used without
              -f, operational quota  files  otherwise),  all  of  their  quota
              entries,  for (-u) users or (-g) groups; after quotainv one must
              use quotacheck before using quotas.  DO  NOT  USE  THIS  COMMAND
              UNLESS  YOU  REALLY KNOW WHAT IT DOES. IT IS MAINLY FOR INTERNAL
              PURPOSES.

       setquota <-u|-g> <uname>|<uid>|<gname>|<gid> [--block-softlimit <block-
       softlimit>]  [--block-hardlimit  <block-hardlimit>]  [--inode-softlimit
       <inode-softlimit>] [--inode-hardlimit <inode-hardlimit>] <filesystem>
              To set filesystem quotas for users  or  groups.  Limits  can  be
              specified  with  -b,  -k,  -m, -g, -t, -p suffixes which specify
              units of 1, 2^10, 2^20, 2^30, 2^40 and 2^50  accordingly.  Block
              limits  unit  is kilobyte (1024) by default and block limits are
              always  kilobyte-grained  (even  if  specified  in  bytes),  see
              EXAMPLES

       setquota   -t   <-u|-g>  [--block-grace  <block-grace>]  [--inode-grace
       <inode-grace>] <filesystem>
              To set filesystem quota grace times for users or  groups.  Grace
              time  is  specified in "XXwXXdXXhXXmXXs" format or as an integer
              seconds value, see EXAMPLES

       quota  [-q]  [-v]  [-o  obd_uuid]  [  -u|-g   <uname|uid|gname|gid>   ]
       <filesystem>
              To   display   disk  usage  and  limits,  either  for  the  full
              filesystem, or for objects on a specific obd. A  user  or  group
              name  or  an  ID  can  be  specified. If both user and group are
              omitted quotas for current uid/gid are shown. -v  provides  more
              verbose  (with  per-obd statistics) output. -q disables printing
              of additional descriptions (including column titles).

       quota -t <-u|-g> <filesystem>
              To display block and inode grace times for user  (-u)  or  group
              (-g) quotas

       help   Provides brief help on the various arguments

       exit/quit
              Quit the interactive lfs session

EXAMPLES

       $ lfs setstripe -s 128k -c 2 /mnt/lustre/file1
              This  creates  a  file  striped  on  two OSTs with 128kB on each
              stripe.

       $ lfs setstripe -d /mnt/lustre/dir
              This deletes a default stripe pattern on dir. New files will use
              the default striping pattern created therein.

       $ lfs getstripe -v /mnt/lustre/file1
              Lists the detailed object allocation of a given file

       $ lfs find /mnt/lustre
              Efficiently  lists  all  files  in  a  given  directory  and its
              subdirectories

       $ lfs find /mnt/lustre -mtime +30 -type f -print
              Recursively list all regular files in given directory more  than
              30 days old

       $ lfs find --obd OST2-UUID /mnt/lustre/
              Recursively  list  all  files  in  a  given  directory that have
              objects on OST2-UUID.

       $ lfs check servers
              Check the status of all servers (MDT, OST)

       $ lfs osts
              List all the OSTs

       $ lfs df -h
              Lists space usage per OST and MDT in human readable format.

       $ lfs df -i
              Lists inode usage per OST and MDT

       $ lfs df --pool <filesystem>[.<pool>] | <pathname>
              List space or inode usage for a specific OST pool

       $ lfs quotachown -i /mnt/lustre
              Change file owner and group

       $ lfs quotacheck -ug /mnt/lustre
              Quotacheck for user and group - will turn on quotas after making
              the check.

       $ lfs quotaon -ug /mnt/lustre
              Turn quotas of user and group on

       $ lfs quotaoff -ug /mnt/lustre
              Turn quotas of user and group off

       $  lfs  setquota  -u  bob  --block-softlimit  2000000 --block-hardlimit
       1000000 /mnt/lustre
              Set quotas of user `bob': 1GB block quota  hardlimit  and  2  GB
              block quota softlimit

       $ lfs setquota -t -u --block-grace 1000 --inode-grace 1w4d /mnt/lustre
              Set  grace times for user quotas: 1000 seconds for block quotas,
              1 week and 4 days for inode quotas

       $ lfs quota -u bob /mnt/lustre
              List quotas of user `bob'

       $ lfs quota -t -u /mnt/lustre
              Show grace times for user quotas on /mnt/lustre

BUGS

       The lfs find command isn't as comprehensive as  find(1).   Report  bugs
       using http://bugzilla.lustre.org.

AUTHOR

       The   lfs   command   is   part  of  the  Lustre  filesystem.   Contact
       http://www.lustre.org/

SEE ALSO

       lctl(8), lustre(7)