VITE(1)

📦 version 1.4, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 VITE — ok bestie, let's talk about vite (and its lil sibling vite-vbo)

welcome to the ViTE manual page, bestie. it's a manual page. it's in section 1. it's called VITE. and honestly? it's giving iconic. sit down, grab a strawberry 🍓, and let's get into it.

         ..___________..._
    __vXXX=========onn=XX=X=s_..
_a=X=============v:|||||i:lvvn=Xn_,
 "!XX===========v||||||||||||iiiv=Xn_
    -"!XX======v||||||||||||iii:::vn=Xs
         ""!!!Zl|||||||||||iii::lIlvvnXX,.
              Jl||||||||||i:vvvvlIvvvvv=Zc
             _e|||||||||ia}"""""!=anvnvnnXno=========aa_.
             ]l||||||||v}'         "Xnnnnnn=o=====XXXX=adZ=__
             =||||||||n(           .3nnnon=======X=Xs..___X|%!n_,
            )1||||||i;^             3=noo=======X=XXXZ1v|i|||||iIs,
            X||||||a!               3=n========X=X=X=Ii||||||||||iIs,
          .Jl|||va!                .==o=o=====X=XXX=li|||||||||||||i3..
          )na:!"`                   =========X=XX=1:|||||||||||||||||)a
          ..                       .========X=XXIIi||||||||||||||||||v}
                                    X=====X=X=1l|i|||||||||||||<a>}""^
                                   .X===X==1Ii||||||||||||<a>""`:
                                    +X=nI:i|||:llv_asl}"""`
                                     -ni||<c"^.
                                      -1%<e.
                                        !3`

look at that dragon. main character energy fr fr 🐉✨

✨ NAME ✨

vite, vite-vbo — a visual trace explorer 🌈

🦋 SYNOPSIS 🦋

ok so here's the vibe, literally copy-paste this:

vite
vite -h
vite [-f|-a] file_path [-e export_path] [-t [time_init]:[time_end]]

vite-vbo
vite-vbo -h
vite-vbo [-f|-a] file_path [-e export_path] [-t [time_init]:[time_end]]

🌸 DESCRIPTION 🌸

so ViTE is a visual trace explorer. like, that's the whole thing. it's a genuinely useful tool for profiling and debugging parallel programs — and yes, that means multi-process or multi-core, both of them, no crumbs left.

here's what it does: ViTE reads program execution trace data from a file — and rn that's currently in Pajé trace format — and then it displays it in a graphical interface. and the way it displays it?? okay so a program execution data could be:

  • a state — drawn as a colored rectangle, and the color depends of the kind of state 🎨
  • an event — drawn as a green disc 🟢
  • or a communication between two processes — drawn as a white arrow ➡️
and now the plot twist: unlike vite, vite-vbo uses OpenGL's feature VBO (Vertex Buffer Object), which can improve performance of rendering, but can require more GPU memory. so like. faster rendering, but your GPU is gonna be eating. 🍽️ pick your fighter.

💖 OPTIONS 💖

ViTE accepts the following options:

  • -h — Display help. that's it. that's the whole thing. ask and you shall receive 🫶
  • -f file_path — Open the file_path file.
  • -a file_path — Open the file_path file and display it entirely. yes, entirely. no half-measures 💅
  • -e export_path — Export the opened trace file (the one you opened with -f or -a) to the export_path file in SVG format. turning your traces into art, periodt ✨
  • -t [time_init]:[time_end] — Just parse trace from time_init to time_end. and the details matter here bestie, so:
    • If time_init is missed, trace will be parsed from the minimum time to time_end.
    • If time_end is missed, trace will be parsed from time_init to the maximum time.

👑 AUTHORS 👑

ViTE was created by a group of french engineering school students for the INRIA research center. no cap. a whole squad, in france, building a trace explorer. that's the origin story. 🧚

🙈 REPORTING BUGS 🙈

found a bug? (not me manifesting one 😭) Report bugs to ViTE developers <vite-issues@inria.fr>. they wanna hear it fr fr.

ViTE was released under the CeCILL-A licence. The content can be found here: http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt.

and now the credits, because we respect the icons who built this:

Copyright © 2009 Kevin COULOMB
Copyright © 2009 Johnny JAZEIX
Copyright © 2009 Olivier LAGRASSE
Copyright © 2009 Jule MARCOUEILLE
Copyright © 2009 Pascal NOISETTE
Copyright © 2009 Arthur REDONDY
Copyright © 2009 Clément VUCHENER
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. (say it with me: no warranty. to the extent permitted by law. 🫡)

ok that's the whole page, you ate that 💅 and for the cute sign-off bestie: this was Version 1.4, from July 2024 — VITE(1) out, love u, go profile something 🔥🦋

📦 where this page comes from