vite.1 4.15 KB
Newer Older
1
.TH VITE "1" "April 2009" "Version 1.2" "ViTE Manual Pages"
2 3 4 5 6 7 8 9
         \fB..___________...\fP_                                             
.br
    \fB__\fPvXXX\fB=========\fPonn\fB=\fPXX\fB=\fPX\fB=\fPs\fB_.\fP.                                       
.br
_a\fB=\fPX\fB=============\fPv\fB:\fP|||||i\fB:\fPlvvn\fB=\fPXn\fB_\fP,                                    
.br
 "!XX\fB===========\fPv||||||||||||iiiv\fB=\fPXn\fB_\fP                                  
.br
THIBAULT Samuel's avatar
THIBAULT Samuel committed
10
    \-"!XX\fB======\fPv||||||||||||iii\fB:::\fPvn\fB=\fPXs                                
11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37
.br
         ""!!!Zl|||||||||||iii\fB::\fPlIlvvnXX,.                             
.br
              Jl||||||||||i\fB:\fPvvvvlIvvvvv\fB=\fPZc                             
.br
             _e|||||||||ia}"""""!\fB=\fPanvnvnnXno\fB=========\fPaa\fB_.\fP              
.br
             ]l||||||||v}'         "Xnnnnnn\fB=\fPo\fB=====\fPXXXX\fB=\fPadZ\fB=__\fP          
.br
             \fB=\fP||||||||n(           .3nnnon\fB=======\fPX\fB=\fPXs\fB..___\fPX|%!n\fB_\fP,      
.br
            )1||||||i\fB;\fP^             3\fB=\fPnoo\fB=======\fPX\fB=\fPXXXZ1v|i|||||iIs,    
.br
            X||||||a!               3\fB=\fPn\fB========\fPX\fB=\fPX\fB=\fPX\fB=\fPIi||||||||||iIs,  
.br
          .Jl|||va!                .\fB==\fPo\fB=\fPo\fB=====\fPX\fB=\fPXXX\fB=\fPli|||||||||||||i3\fB.\fP.
.br
          )na\fB:\fP!"`                   \fB=========\fPX\fB=\fPXX\fB=\fP1\fB:\fP|||||||||||||||||)a
.br
          ..                       .\fB========\fPX\fB=\fPXXIIi||||||||||||||||||v}
.br
                                    X\fB=====\fPX\fB=\fPX\fB=\fP1l|i|||||||||||||<a>}""^ 
.br
                                   .X\fB===\fPX\fB==\fP1Ii||||||||||||<a>""`:      
.br
                                    +X\fB=\fPnI\fB:\fPi|||\fB:\fPllv\fB_\fPasl}"""`            
.br
THIBAULT Samuel's avatar
THIBAULT Samuel committed
38
                                     \-ni||<c"^.                        
39
.br
THIBAULT Samuel's avatar
THIBAULT Samuel committed
40
                                      \-1%<e.                           
41 42 43 44 45 46 47 48
.br
                                        !3`                            
.br  
.SH NAME
vite \- a visual trace explorer
.SH SYNOPSIS
.B vite
.br
THIBAULT Samuel's avatar
THIBAULT Samuel committed
49
.B vite \-h
50 51 52 53 54 55 56
.br
.B vite
.B [\-f|\-a] \fIfile_path\fP
.B [\-e \fIexport_path\fP] 
.B [\-t [\fItime_init\fP]:[\fItime_end\fP]]
.BR
.SH DESCRIPTION
THIBAULT Samuel's avatar
THIBAULT Samuel committed
57
\fBViTE\fP is a visual trace explorer. It is a useful tool for profiling and debugging parallel programs (multi\(hyprocess or multi\(hycore).
58
.br
THIBAULT Samuel's avatar
THIBAULT Samuel committed
59
\fBViTE\fP reads program execution trace data from file (currently in Pajé trace format) and display it in a graphical interface. Program execution data could be a \fBstate\fP (drawn as a colored rectangle \- color depends of the kind of state), an \fBevent\fP (drawn as a green disc) or a \fBcommunication\fP between two processes (drawn as a white arrow).
60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89
.SH OPTIONS
\fBViTE\fP accepts the following options:
.TP 8
\fB\-h\fP
Display help.
.TP 8
\fB\-f\fP \fIfile_path\fP
Open the \fIfile_path\fP file.
.TP 8
\fB\-a\fP \fIfile_path\fP
Open the \fIfile_path\fP file and display it entirely.
.TP 8
\fB\-e\fP \fIexport_path\fP
Export the opened trace file (with \fB\-f\fP or \fB\-a\fP option) to the \fIexport_path\fP file in SVG format.
.TP 8
\fB\-t\fP [\fItime_init\fP]:[\fItime_end\fP]
Just parse trace from \fItime_init\fP to \fItime_end\fP.
.br
If \fItime_init\fP is missed, trace will be parsed from the minimum time to \fItime_end\fP.
.br
If \fItime_end\fP is missed, trace will be parsed from \fItime_init\fP to the maximum time.

.SH AUTHORS
\fBViTE\fP was created by a group of french engineering school students for the INRIA research center.

.SH "REPORTING BUGS"
Report bugs to ViTE developers <vite\-developpeurs@lists.gforge.inria.fr>.

.SH COPYRIGHT
.TP 8
THIBAULT Samuel's avatar
THIBAULT Samuel committed
90
\fBViTE\fP was released under the \fBCeCILL\-A\fP licence. The content can be found here: \fIhttp://www.cecill.info/licences/Licence_CeCILL_V2\-en.txt\fP.
91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108
.br
Copyright \(co 2009 Kevin COULOMB
.br
Copyright \(co 2009 Johnny JAZEIX
.br
Copyright \(co 2009 Olivier LAGRASSE
.br
Copyright \(co 2009 Jule MARCOUEILLE
.br
Copyright \(co 2009 Pascal NOISETTE
.br
Copyright \(co 2009 Arthur REDONDY
.br
Copyright \(co 2009 Clément VUCHENER
.TP 0
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.