man/man1/vudebug.1.html

Content-type: text/html; charset=UTF-8

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of VUDEBUG</TITLE>
</HEAD><BODY>
<H1>VUDEBUG</H1>
Section: General Commands Manual (1)<BR>Updated: December 2022<BR><A HREF="#index">Index</A>
<A HREF="/#/man/index">Return to Main Contents</A><HR>


<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>

<P>

vudebug - debug utility for umvu
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>

<P>

vudebug -help
<P>

vudebug [debarg [debarg ...]] [ -
command [args]]
<P>

where debarg has the following syntax:
<P>

+[tag[tag
...]][:colorspec]
<P>

or
<P>

-[tag[tag ...]]
<P>

or
<P>

?[tag[tag ...]]
<P>

and colorspec is a combination of the following characters:
nwrgbcmyNWRGBCMY+-_*#
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>

<P>

vudebug enables or disables debug log messages.
Log messages are classified into categories.
Each category is identified by a tag (one alphanumeric
character).
By convention lowercase letters are for logging messages of the
hypervisor, while capital letters are for modules.
<P>

When vudebug command line ends with -- followed by a
command and its command line arguments, logging is enabled for the
execution of that command (and for all the subprocesses it eventually
creates).
Otherwise vudebug changes the categories to log globally, for
all the processes.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>

<DL COMPACT>
<DT>--help<DD>
Print a short help message and exit.
<DT>debarg<DD>
each debug argument begins by +, - or ?
followed by zero, one or more
debug tags.
(+ enables log messages, - disables log messages,
? check if the
log messages are enabled).
When the debug argument has no tags, it is applied to all
the tags.
Log messages of different categories can be shown in different colors
and font effects.
When vudebug is used to enable/re-enable tags (+)
each debarg can be followed by a
semicolon (:) and a color specification.
A color specification is a string composed by the
following characters:
<DT><DD>
n w r g b c m y: set foreground color (black, white, red,
green, blue, cyan, magenta or yellow)
<DT><DD>
N W R G B C M Y: set background color (black, white, red,
green, blue, cyan, magenta or yellow)
<DT><DD>
+ - _ * #: font effect (bright, dim,underlined, blinking,
reverse video).
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>EXAMPLES</H2>

<P>

Get a list of available logging categories:
<DL COMPACT>
<DT><DD>
<PRE>

$ vudebug ?
D -   VUDEV
F -   VUFUSE
N -   VUNET
a -   ACTION
c -   CHOICE
f -   FILETABLE
m -   MODULE
n -   NESTED
p -   PATH
s -   SYSCALL
v -   VNODE

</PRE>

</DL>
<P>

the list may vary depending on the version of the hypervisor and the
modules currently loaded.
<P>

Enable path resolution logging:
<DL COMPACT>
<DT><DD>
<PRE>

$ vudebug +p

</PRE>

</DL>
<P>

List some categories to see which ones are active:
<DL COMPACT>
<DT><DD>
<PRE>

$ vudebug ?ps
p +   PATH
s -   SYSCALL

</PRE>

</DL>
<P>

PATH is active, SYSCALL is not active.
<P>

Disable all the categories:
<DL COMPACT>
<DT><DD>
<PRE>

$ vudebug -

</PRE>

</DL>
<P>

Launch a bash and log syscall requests in red, path resolution in
bold-blue, module choice in reverse green:
<DL COMPACT>
<DT><DD>
<PRE>

$ vudebug +s:r +p:b+ +c:g# -- bash

</PRE>

</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>

<P>

<A HREF="/#/man/man1/umvu.1.html">umvu</A>(1)
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHOR</H2>

<P>

VirtualSquare.
Project leader: Renzo Davoli
<P>

<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">EXAMPLES</A><DD>
<DT><A HREF="#lbAG">SEE ALSO</A><DD>
<DT><A HREF="#lbAH">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 15:22:07 GMT, November 27, 2023
</BODY>
</HTML>