<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>meanwhile: mw_debug.h File Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.4 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="classes.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
</ul>
</div>
<h1>mw_debug.h File Reference</h1>
<p>
<code>#include <stdarg.h></code><br>
<code>#include <glib.h></code><br>
<code>#include "<a class="el" href="mw__common_8h-source.html">mw_common.h</a>"</code><br>
<p>
<a href="mw__debug_8h-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#87ff3f755a735cc7b25346a35f5485d8">g_debug</a>(format...) g_log(G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, format)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#50b503ca2ab0a3f3d87f74e313f18797">g_info</a>(format...) g_log(G_LOG_DOMAIN, G_LOG_LEVEL_INFO, format)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#1cec39c7a64f20d9089d4af76797d022">MW_MAILME_ADDRESS</a> "meanwhile-devel@lists.sourceforge.net"</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">email address used in mw_debug_mailme. <a href="#1cec39c7a64f20d9089d4af76797d022"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#16e3e04fbd6c0ee72d409785e0ba4dda">MW_MAILME_CUT_START</a> "-------- begin copy --------"</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#5b3d9b93f73f924fa942c7740f19bfa0">MW_MAILME_CUT_STOP</a> "--------- end copy ---------"</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#5707b5bc15c1f40cf5bf883db2c6550a">MW_MAILME_MESSAGE</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">message used in mw_debug_mailme instructing user on what to do with the debugging output produced from that function <a href="#5707b5bc15c1f40cf5bf883db2c6550a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#a67c7289eb763a7216fbb0e718f3813d">NSTR</a>(str) ((str)? (str): "(null)")</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">replaces NULL strings with "(null)". <a href="#a67c7289eb763a7216fbb0e718f3813d"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#65a276306d40a3bbeacd14ed1e5c3861">mw_debug_data</a> (const guchar *buf, gsize len, const char *info,...)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#d33086bf1a80cc08bae07cd36d07cc7e">mw_debug_datav</a> (const guchar *buf, gsize len, const char *info, va_list args)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#bef8e11ddacd1b570281edbdd58b5eab">mw_debug_opaque</a> (struct <a class="el" href="structmwOpaque.html">mwOpaque</a> *o, const char *info,...)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#4472fe61c0e2e8af8af69b5f865c7cfe">mw_debug_opaquev</a> (struct <a class="el" href="structmwOpaque.html">mwOpaque</a> *o, const char *info, va_list args)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#5bb0e9894f0db4ba0896aa0f05c67a62">mw_mailme_data</a> (const guchar *buf, gsize len, const char *info,...)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#aa403b022606c10a581c5d328bcd7c6d">mw_mailme_datav</a> (const guchar *buf, gsize len, const char *info, va_list args)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#84b9630d04ad0fe9136bf5b04e40dfac">mw_mailme_opaque</a> (struct <a class="el" href="structmwOpaque.html">mwOpaque</a> *o, const char *info,...)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Outputs a hex dump of a <a class="el" href="structmwOpaque.html" title="A length of binary data, not null-terminated.">mwOpaque</a> with debugging info and a pre-defined message. <a href="#84b9630d04ad0fe9136bf5b04e40dfac"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="mw__debug_8h.html#b27e7529ac1cb6fa56ea42727fe739d3">mw_mailme_opaquev</a> (struct <a class="el" href="structmwOpaque.html">mwOpaque</a> *o, const char *info, va_list args)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Outputs a hex dump of a <a class="el" href="structmwOpaque.html" title="A length of binary data, not null-terminated.">mwOpaque</a> with debugging info and a pre-defined message. <a href="#b27e7529ac1cb6fa56ea42727fe739d3"></a><br></td></tr>
</table>
<hr><h2>Define Documentation</h2>
<a class="anchor" name="87ff3f755a735cc7b25346a35f5485d8"></a><!-- doxytag: member="mw_debug.h::g_debug" ref="87ff3f755a735cc7b25346a35f5485d8" args="(format...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define g_debug </td>
<td>(</td>
<td class="paramtype">format... </td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> g_log(G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, format)</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="50b503ca2ab0a3f3d87f74e313f18797"></a><!-- doxytag: member="mw_debug.h::g_info" ref="50b503ca2ab0a3f3d87f74e313f18797" args="(format...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define g_info </td>
<td>(</td>
<td class="paramtype">format... </td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> g_log(G_LOG_DOMAIN, G_LOG_LEVEL_INFO, format)</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="1cec39c7a64f20d9089d4af76797d022"></a><!-- doxytag: member="mw_debug.h::MW_MAILME_ADDRESS" ref="1cec39c7a64f20d9089d4af76797d022" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define MW_MAILME_ADDRESS "meanwhile-devel@lists.sourceforge.net" </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
email address used in mw_debug_mailme.
<p>
</div>
</div><p>
<a class="anchor" name="16e3e04fbd6c0ee72d409785e0ba4dda"></a><!-- doxytag: member="mw_debug.h::MW_MAILME_CUT_START" ref="16e3e04fbd6c0ee72d409785e0ba4dda" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define MW_MAILME_CUT_START "-------- begin copy --------" </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="5b3d9b93f73f924fa942c7740f19bfa0"></a><!-- doxytag: member="mw_debug.h::MW_MAILME_CUT_STOP" ref="5b3d9b93f73f924fa942c7740f19bfa0" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define MW_MAILME_CUT_STOP "--------- end copy ---------" </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="5707b5bc15c1f40cf5bf883db2c6550a"></a><!-- doxytag: member="mw_debug.h::MW_MAILME_MESSAGE" ref="5707b5bc15c1f40cf5bf883db2c6550a" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define MW_MAILME_MESSAGE </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<b>Value:</b><div class="fragment"><pre class="fragment"><span class="stringliteral">"\n"</span> \
<span class="stringliteral">" Greetings! It seems that you've run across protocol data that the\n"</span> \
<span class="stringliteral">"Meanwhile library does not yet know about. As such, there may be\n"</span> \
<span class="stringliteral">"some unexpected behaviour in this session. If you'd like to help\n"</span> \
<span class="stringliteral">"resolve this issue, please copy and paste the following block into\n"</span> \
<span class="stringliteral">"an email to the address listed below with a brief explanation of\n"</span> \
<span class="stringliteral">"what you were doing at the time of this message. Thanks a lot!"</span>
</pre></div>message used in mw_debug_mailme instructing user on what to do with the debugging output produced from that function
<p>
</div>
</div><p>
<a class="anchor" name="a67c7289eb763a7216fbb0e718f3813d"></a><!-- doxytag: member="mw_debug.h::NSTR" ref="a67c7289eb763a7216fbb0e718f3813d" args="(str)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define NSTR </td>
<td>(</td>
<td class="paramtype">str </td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> ((str)? (str): "(null)")</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
replaces NULL strings with "(null)".
<p>
useful for printf where you're unsure that the s will be non-NULL. Note that while the linux printf will do this automatically, not all will. The others will instead segfault
</div>
</div><p>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="65a276306d40a3bbeacd14ed1e5c3861"></a><!-- doxytag: member="mw_debug.h::mw_debug_data" ref="65a276306d40a3bbeacd14ed1e5c3861" args="(const guchar *buf, gsize len, const char *info,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void mw_debug_data </td>
<td>(</td>
<td class="paramtype">const guchar * </td>
<td class="paramname"> <em>buf</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gsize </td>
<td class="paramname"> <em>len</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="d33086bf1a80cc08bae07cd36d07cc7e"></a><!-- doxytag: member="mw_debug.h::mw_debug_datav" ref="d33086bf1a80cc08bae07cd36d07cc7e" args="(const guchar *buf, gsize len, const char *info, va_list args)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void mw_debug_datav </td>
<td>(</td>
<td class="paramtype">const guchar * </td>
<td class="paramname"> <em>buf</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gsize </td>
<td class="paramname"> <em>len</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>args</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="bef8e11ddacd1b570281edbdd58b5eab"></a><!-- doxytag: member="mw_debug.h::mw_debug_opaque" ref="bef8e11ddacd1b570281edbdd58b5eab" args="(struct mwOpaque *o, const char *info,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void mw_debug_opaque </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmwOpaque.html">mwOpaque</a> * </td>
<td class="paramname"> <em>o</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="4472fe61c0e2e8af8af69b5f865c7cfe"></a><!-- doxytag: member="mw_debug.h::mw_debug_opaquev" ref="4472fe61c0e2e8af8af69b5f865c7cfe" args="(struct mwOpaque *o, const char *info, va_list args)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void mw_debug_opaquev </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmwOpaque.html">mwOpaque</a> * </td>
<td class="paramname"> <em>o</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>args</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="5bb0e9894f0db4ba0896aa0f05c67a62"></a><!-- doxytag: member="mw_debug.h::mw_mailme_data" ref="5bb0e9894f0db4ba0896aa0f05c67a62" args="(const guchar *buf, gsize len, const char *info,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void mw_mailme_data </td>
<td>(</td>
<td class="paramtype">const guchar * </td>
<td class="paramname"> <em>buf</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gsize </td>
<td class="paramname"> <em>len</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="aa403b022606c10a581c5d328bcd7c6d"></a><!-- doxytag: member="mw_debug.h::mw_mailme_datav" ref="aa403b022606c10a581c5d328bcd7c6d" args="(const guchar *buf, gsize len, const char *info, va_list args)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void mw_mailme_datav </td>
<td>(</td>
<td class="paramtype">const guchar * </td>
<td class="paramname"> <em>buf</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gsize </td>
<td class="paramname"> <em>len</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>args</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="84b9630d04ad0fe9136bf5b04e40dfac"></a><!-- doxytag: member="mw_debug.h::mw_mailme_opaque" ref="84b9630d04ad0fe9136bf5b04e40dfac" args="(struct mwOpaque *o, const char *info,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void mw_mailme_opaque </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmwOpaque.html">mwOpaque</a> * </td>
<td class="paramname"> <em>o</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Outputs a hex dump of a <a class="el" href="structmwOpaque.html" title="A length of binary data, not null-terminated.">mwOpaque</a> with debugging info and a pre-defined message.
<p>
if MW_MAILME is undefined or false, this function acts the same as mw_mailme_opaque.<p>
<ul>
<li>block data to be printed in a hex block </li>
<li>info a printf-style format string</li>
</ul>
The resulting message is in the following format: <div class="fragment"><pre class="fragment"> <a class="code" href="mw__debug_8h.html#5707b5bc15c1f40cf5bf883db2c6550a" title="message used in mw_debug_mailme instructing user on what to do with the debugging...">MW_MAILME_MESSAGE</a>
<span class="stringliteral">" Please send mail to: "</span> <a class="code" href="mw__debug_8h.html#1cec39c7a64f20d9089d4af76797d022" title="email address used in mw_debug_mailme.">MW_MAILME_ADDRESS</a>
<a class="code" href="mw__debug_8h.html#16e3e04fbd6c0ee72d409785e0ba4dda">MW_MAILME_CUT_START</a>
info
block
<a class="code" href="mw__debug_8h.html#5b3d9b93f73f924fa942c7740f19bfa0">MW_MAILME_CUT_STOP</a>
</pre></div>
</div>
</div><p>
<a class="anchor" name="b27e7529ac1cb6fa56ea42727fe739d3"></a><!-- doxytag: member="mw_debug.h::mw_mailme_opaquev" ref="b27e7529ac1cb6fa56ea42727fe739d3" args="(struct mwOpaque *o, const char *info, va_list args)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void mw_mailme_opaquev </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structmwOpaque.html">mwOpaque</a> * </td>
<td class="paramname"> <em>o</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>args</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Outputs a hex dump of a <a class="el" href="structmwOpaque.html" title="A length of binary data, not null-terminated.">mwOpaque</a> with debugging info and a pre-defined message.
<p>
Identical to mw_mailme_opaque, but taking a va_list argument
</div>
</div><p>
<hr size="1"><address style="text-align: right;"><small>Generated on Wed Dec 19 09:10:34 2007 for meanwhile by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.4 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2008.1
>
x86_64
>
media
>
main-release
>
by-pkgid
>
d4a6745d7fbd92dfb64dce5e91e08f80
>
files
>
91
