Whamcloud - gitweb
LU-925 agl: trigger async glimpse lock when statahead
[fs/lustre-release.git] / lustre / doc / llverfs.txt
1 FILESYSTEM VERIFICATION TOOL. ( ext3vt )
2 ==========================================
3
4 Building tool: 
5         To build this tool you just need to invoke make at command prompt.
6         e.g.  $ make 
7         
8         this will compile the sources and build ext3vt in this directory.
9
10 Usage: 
11 Syntax:
12
13 ./ext3vt [OPTION]... <filesystem path> ... 
14
15 [OPTION]
16         -t {seconds} for --timestamp,  set test time(default=current time())
17         -o {fileOffset}  for --fileOffset, full path of file from which tests should start
18         -r run test in read (verify) mode
19         -w run test in write (test-pattern) mode (default=r&w)
20         -v for verbose
21         -p for --partial, for partial check (1MB files)
22         -l for --long, full check (4GB file with 4k blocks)
23         -c for --chunksize, IO chunk size (default=1048576)
24         -h display this help and exit
25         --help display this help and exit
26
27 Guide lines for using this tool:
28         It is expected that ext3vt tool will be run on large size 
29 filesystem (TB), So it is always better to run ext3vt tool in verbose mode, 
30 So that one can easily restart device testing from the point at which it 
31 had stoped. 
32 for example:
33         
34         [root@Matrix ext3vt]# ./ext3vtnew -v -f -w --timestamp=1145009417 /mnt/store/
35         Timestamp: 1145009417
36         write File name: /mnt/store/dir00004/file005
37         
38 If due to some reason sombody breaks execution at this point then one can 
39 easily restart device from the same point by picking the same file offset 
40 displayed in by verbose as explained below.
41
42         [root@tucker ext3vt]# ./bdevt -v -f -w --fileOffset=/home/dir00004/file005 
43                              --timestamp=1145009417 /mnt/store/
44         Timestamp: 1145009417
45         write File name: /mnt/store/dir00008/file007
46         write complete
47         [root@tucker ext3vt]#
48 One can use similar things for read only and read write modes also.