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.