diff options
author | Richard W.M. Jones <rjones@redhat.com> | 2011-01-06 14:34:42 +0000 |
---|---|---|
committer | Richard W.M. Jones <rjones@redhat.com> | 2011-01-06 14:35:52 +0000 |
commit | 37073166c2986a1b97bc8467ec6e1fc1bcd4f1ea (patch) | |
tree | e493088a77aaa0a262200143199b85808f3015cd | |
parent | 1f3c5a55e0dbbab20fcd23cd81689e0f6ca72669 (diff) | |
download | virt-top-37073166c2986a1b97bc8467ec6e1fc1bcd4f1ea.tar.gz virt-top-37073166c2986a1b97bc8467ec6e1fc1bcd4f1ea.tar.xz virt-top-37073166c2986a1b97bc8467ec6e1fc1bcd4f1ea.zip |
Re-add virt-top/README file.
This seems to have been dropped during the hg->git transition.
-rwxr-xr-x | virt-top/README | 57 |
1 files changed, 57 insertions, 0 deletions
diff --git a/virt-top/README b/virt-top/README new file mode 100755 index 0000000..b594f95 --- /dev/null +++ b/virt-top/README @@ -0,0 +1,57 @@ +The code is structured into these files: + + virt_top_utils.mli / virt_top_utils.ml + + String functions and other small utility functions. This is + included directly into virt_top.ml. + + virt_top.mli / virt_top.ml + + This is the virt-top program. + + The two interesting functions are called 'collect' and 'redraw'. + + 'collect' collects all the information about domains, etc. + + 'redraw' updates the display on each frame. + + Another interesting function is 'start_up' which handles all + start-up stuff, eg. command line arguments, connecting to the + hypervisor, enabling curses. + + The function 'main_loop' runs the main loop and has sub-functions + to deal with keypresses, help screens and so on. + + virt_top_xml.ml + + Any code which needs the optional xml-light library goes + in here. Mainly for parsing domain XML descriptions to get + the list of block devices and network interfaces. + + The reason for having it in a separate file is so that we + don't depend on xml-light. + + virt_top_csv.ml + + Any code which needs the optional ocaml-csv library goes + in here. This implements the --csv command line option. + + virt_top_calendar.ml + + Any code which needs the optional ocaml-calendar library + goes in here. This implements the --end-time command line + option. + + virt_top_main.ml + + This is just a small bit of code to glue the modules together + Virt_top + Virt_top_xml? + Virt_top_csv? + Virt_top_calendar? + +The man-page is generated from the single file: + + virt-top.pod + +which generates (using perldoc) the following: + + virt-top.1 + virt-top.txt |