Sophie

Sophie

distrib > Fedora > 14 > x86_64 > media > updates > by-pkgid > 87b89b73c41f4440bb86afd421c7548f > files > 273

libnl-devel-1.1-14.fc14.x86_64.rpm

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libnl: lib/utils.c Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.3 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td style="padding-left: 0.5em;">
   <div id="projectname">libnl&#160;<span id="projectnumber">1.1</span></div>
  </td>
 </tr>
 </tbody>
</table>
</div>
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&#160;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
    </ul>
  </div>
  <div id="navrow2" class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&#160;List</span></a></li>
    </ul>
  </div>
<div class="header">
  <div class="headertitle">
<h1>lib/utils.c</h1>  </div>
</div>
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
<a name="l00002"></a>00002 <span class="comment"> * lib/utils.c          Utility Functions</span>
<a name="l00003"></a>00003 <span class="comment"> *</span>
<a name="l00004"></a>00004 <span class="comment"> *      This library is free software; you can redistribute it and/or</span>
<a name="l00005"></a>00005 <span class="comment"> *      modify it under the terms of the GNU Lesser General Public</span>
<a name="l00006"></a>00006 <span class="comment"> *      License as published by the Free Software Foundation version 2.1</span>
<a name="l00007"></a>00007 <span class="comment"> *      of the License.</span>
<a name="l00008"></a>00008 <span class="comment"> *</span>
<a name="l00009"></a>00009 <span class="comment"> * Copyright (c) 2003-2006 Thomas Graf &lt;tgraf@suug.ch&gt;</span>
<a name="l00010"></a>00010 <span class="comment"> */</span>
<a name="l00011"></a>00011 <span class="comment"></span>
<a name="l00012"></a>00012 <span class="comment">/**</span>
<a name="l00013"></a>00013 <span class="comment"> * @defgroup utils Utilities</span>
<a name="l00014"></a>00014 <span class="comment"> * @{</span>
<a name="l00015"></a>00015 <span class="comment"> */</span>
<a name="l00016"></a>00016 
<a name="l00017"></a>00017 <span class="preprocessor">#include &lt;netlink-local.h&gt;</span>
<a name="l00018"></a>00018 <span class="preprocessor">#include &lt;netlink/netlink.h&gt;</span>
<a name="l00019"></a>00019 <span class="preprocessor">#include &lt;netlink/utils.h&gt;</span>
<a name="l00020"></a>00020 <span class="preprocessor">#include &lt;linux/socket.h&gt;</span>
<a name="l00021"></a>00021 <span class="comment"></span>
<a name="l00022"></a>00022 <span class="comment">/**</span>
<a name="l00023"></a>00023 <span class="comment"> * Debug level</span>
<a name="l00024"></a>00024 <span class="comment"> */</span>
<a name="l00025"></a><a class="code" href="group__utils.html#ga2e170840b2132881f543285ea6323f52">00025</a> <span class="keywordtype">int</span> <a class="code" href="group__utils.html#ga2e170840b2132881f543285ea6323f52" title="Debug level.">nl_debug</a> = 0;
<a name="l00026"></a>00026 
<a name="l00027"></a>00027 <span class="keyword">struct </span><a class="code" href="structnl__dump__params.html" title="Dumping parameters.">nl_dump_params</a> nl_debug_dp = {
<a name="l00028"></a>00028         .<a class="code" href="structnl__dump__params.html#ae36d840078202bf028a6611d2e1f4ea5" title="Specifies the type of dump that is requested.">dp_type</a> = <a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9a1445106c7af529b2c99ee289fbcd3179" title="Dump all attributes but no statistics.">NL_DUMP_FULL</a>,
<a name="l00029"></a>00029 };
<a name="l00030"></a>00030 
<a name="l00031"></a>00031 <span class="keyword">static</span> <span class="keywordtype">void</span> __init nl_debug_init(<span class="keywordtype">void</span>)
<a name="l00032"></a>00032 {
<a name="l00033"></a>00033         <span class="keywordtype">char</span> *nldbg, *end;
<a name="l00034"></a>00034         
<a name="l00035"></a>00035         <span class="keywordflow">if</span> ((nldbg = getenv(<span class="stringliteral">&quot;NLDBG&quot;</span>))) {
<a name="l00036"></a>00036                 <span class="keywordtype">long</span> level = strtol(nldbg, &amp;end, 0);
<a name="l00037"></a>00037                 <span class="keywordflow">if</span> (nldbg != end)
<a name="l00038"></a>00038                         <a class="code" href="group__utils.html#ga2e170840b2132881f543285ea6323f52" title="Debug level.">nl_debug</a> = level;
<a name="l00039"></a>00039         }
<a name="l00040"></a>00040 
<a name="l00041"></a>00041         nl_debug_dp.<a class="code" href="structnl__dump__params.html#afe6d9b7154f8f6a4fa9469e859f1f652" title="File descriptor the dumping output should go to.">dp_fd</a> = stderr;
<a name="l00042"></a>00042 }
<a name="l00043"></a>00043 <span class="comment"></span>
<a name="l00044"></a>00044 <span class="comment">/**</span>
<a name="l00045"></a>00045 <span class="comment"> * @name Error Code Helpers</span>
<a name="l00046"></a>00046 <span class="comment"> * @{</span>
<a name="l00047"></a>00047 <span class="comment"> */</span>
<a name="l00048"></a>00048 
<a name="l00049"></a>00049 <span class="keyword">static</span> <span class="keywordtype">char</span> *errbuf;
<a name="l00050"></a>00050 <span class="keyword">static</span> <span class="keywordtype">int</span> nlerrno;
<a name="l00051"></a>00051 <span class="comment"></span>
<a name="l00052"></a>00052 <span class="comment">/** @cond SKIP */</span>
<a name="l00053"></a>00053 <span class="keywordtype">int</span> __nl_error(<span class="keywordtype">int</span> err, <span class="keyword">const</span> <span class="keywordtype">char</span> *file, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> line, <span class="keyword">const</span> <span class="keywordtype">char</span> *func,
<a name="l00054"></a>00054                <span class="keyword">const</span> <span class="keywordtype">char</span> *fmt, ...)
<a name="l00055"></a>00055 {
<a name="l00056"></a>00056         <span class="keywordtype">char</span> *user_err;
<a name="l00057"></a>00057         va_list args;
<a name="l00058"></a>00058 
<a name="l00059"></a>00059         <span class="keywordflow">if</span> (errbuf) {
<a name="l00060"></a>00060                 free(errbuf);
<a name="l00061"></a>00061                 errbuf = NULL;
<a name="l00062"></a>00062         }
<a name="l00063"></a>00063 
<a name="l00064"></a>00064         nlerrno = err;
<a name="l00065"></a>00065 
<a name="l00066"></a>00066         <span class="keywordflow">if</span> (fmt) {
<a name="l00067"></a>00067                 va_start(args, fmt);
<a name="l00068"></a>00068                 vasprintf(&amp;user_err, fmt, args);
<a name="l00069"></a>00069                 va_end(args);
<a name="l00070"></a>00070         }
<a name="l00071"></a>00071 
<a name="l00072"></a>00072 <span class="preprocessor">#ifdef VERBOSE_ERRORS</span>
<a name="l00073"></a>00073 <span class="preprocessor"></span>        asprintf(&amp;errbuf, <span class="stringliteral">&quot;%s:%u:%s: %s (errno = %s)&quot;</span>,
<a name="l00074"></a>00074                  file, line, func, fmt ? user_err : <span class="stringliteral">&quot;&quot;</span>, strerror(err));
<a name="l00075"></a>00075 <span class="preprocessor">#else</span>
<a name="l00076"></a>00076 <span class="preprocessor"></span>        asprintf(&amp;errbuf, <span class="stringliteral">&quot;%s (errno = %s)&quot;</span>,
<a name="l00077"></a>00077                  fmt ? user_err : <span class="stringliteral">&quot;&quot;</span>, strerror(err));
<a name="l00078"></a>00078 <span class="preprocessor">#endif</span>
<a name="l00079"></a>00079 <span class="preprocessor"></span>
<a name="l00080"></a>00080         <span class="keywordflow">if</span> (fmt)
<a name="l00081"></a>00081                 free(user_err);
<a name="l00082"></a>00082 
<a name="l00083"></a>00083         <span class="keywordflow">return</span> -err;
<a name="l00084"></a>00084 }
<a name="l00085"></a>00085 
<a name="l00086"></a>00086 <span class="keywordtype">int</span> __nl_read_num_str_file(<span class="keyword">const</span> <span class="keywordtype">char</span> *path, <span class="keywordtype">int</span> (*cb)(<span class="keywordtype">long</span>, <span class="keyword">const</span> <span class="keywordtype">char</span> *))
<a name="l00087"></a>00087 {
<a name="l00088"></a>00088         FILE *fd;
<a name="l00089"></a>00089         <span class="keywordtype">char</span> buf[128];
<a name="l00090"></a>00090 
<a name="l00091"></a>00091         fd = fopen(path, <span class="stringliteral">&quot;r&quot;</span>);
<a name="l00092"></a>00092         <span class="keywordflow">if</span> (fd == NULL)
<a name="l00093"></a>00093                 <span class="keywordflow">return</span> nl_error(errno, <span class="stringliteral">&quot;Unable to open file %s for reading&quot;</span>,
<a name="l00094"></a>00094                                 path);
<a name="l00095"></a>00095 
<a name="l00096"></a>00096         <span class="keywordflow">while</span> (fgets(buf, <span class="keyword">sizeof</span>(buf), fd)) {
<a name="l00097"></a>00097                 <span class="keywordtype">int</span> goodlen, err;
<a name="l00098"></a>00098                 <span class="keywordtype">long</span> num;
<a name="l00099"></a>00099                 <span class="keywordtype">char</span> *end;
<a name="l00100"></a>00100 
<a name="l00101"></a>00101                 <span class="keywordflow">if</span> (*buf == <span class="charliteral">&#39;#&#39;</span> || *buf == <span class="charliteral">&#39;\n&#39;</span> || *buf == <span class="charliteral">&#39;\r&#39;</span>)
<a name="l00102"></a>00102                         <span class="keywordflow">continue</span>;
<a name="l00103"></a>00103 
<a name="l00104"></a>00104                 num = strtol(buf, &amp;end, 0);
<a name="l00105"></a>00105                 <span class="keywordflow">if</span> (end == buf)
<a name="l00106"></a>00106                         <span class="keywordflow">return</span> nl_error(EINVAL, <span class="stringliteral">&quot;Parsing error&quot;</span>);
<a name="l00107"></a>00107 
<a name="l00108"></a>00108                 <span class="keywordflow">if</span> (num == LONG_MIN || num == LONG_MAX)
<a name="l00109"></a>00109                         <span class="keywordflow">return</span> nl_error(errno, <span class="stringliteral">&quot;Number of out range&quot;</span>);
<a name="l00110"></a>00110 
<a name="l00111"></a>00111                 <span class="keywordflow">while</span> (*end == <span class="charliteral">&#39; &#39;</span> || *end == <span class="charliteral">&#39;\t&#39;</span>)
<a name="l00112"></a>00112                         end++;
<a name="l00113"></a>00113 
<a name="l00114"></a>00114                 goodlen = strcspn(end, <span class="stringliteral">&quot;#\r\n\t &quot;</span>);
<a name="l00115"></a>00115                 <span class="keywordflow">if</span> (goodlen == 0)
<a name="l00116"></a>00116                         <span class="keywordflow">return</span> nl_error(EINVAL, <span class="stringliteral">&quot;Empty string&quot;</span>);
<a name="l00117"></a>00117 
<a name="l00118"></a>00118                 end[goodlen] = <span class="charliteral">&#39;\0&#39;</span>;
<a name="l00119"></a>00119 
<a name="l00120"></a>00120                 err = cb(num, end);
<a name="l00121"></a>00121                 <span class="keywordflow">if</span> (err &lt; 0)
<a name="l00122"></a>00122                         <span class="keywordflow">return</span> err;
<a name="l00123"></a>00123         }
<a name="l00124"></a>00124 
<a name="l00125"></a>00125         fclose(fd);
<a name="l00126"></a>00126 
<a name="l00127"></a>00127         <span class="keywordflow">return</span> 0;
<a name="l00128"></a>00128 }
<a name="l00129"></a>00129 <span class="comment"></span>
<a name="l00130"></a>00130 <span class="comment">/** @endcond */</span>
<a name="l00131"></a>00131 
<a name="l00132"></a>00132 <span class="keywordtype">int</span> nl_get_errno(<span class="keywordtype">void</span>)
<a name="l00133"></a>00133 {
<a name="l00134"></a>00134         <span class="keywordflow">return</span> nlerrno;
<a name="l00135"></a>00135 }
<a name="l00136"></a>00136 
<a name="l00137"></a>00137 <span class="comment"></span>
<a name="l00138"></a>00138 <span class="comment">/**</span>
<a name="l00139"></a>00139 <span class="comment"> * Return error message for an error code</span>
<a name="l00140"></a>00140 <span class="comment"> * @return error message</span>
<a name="l00141"></a>00141 <span class="comment"> */</span>
<a name="l00142"></a><a class="code" href="group__utils.html#ga4586cbc3086399f08e42708098ea2045">00142</a> <span class="keywordtype">char</span> *<a class="code" href="group__utils.html#ga4586cbc3086399f08e42708098ea2045" title="Return error message for an error code.">nl_geterror</a>(<span class="keywordtype">void</span>)
<a name="l00143"></a>00143 {
<a name="l00144"></a>00144         <span class="keywordflow">if</span> (errbuf)
<a name="l00145"></a>00145                 <span class="keywordflow">return</span> errbuf;
<a name="l00146"></a>00146 
<a name="l00147"></a>00147         <span class="keywordflow">if</span> (nlerrno)
<a name="l00148"></a>00148                 <span class="keywordflow">return</span> strerror(nlerrno);
<a name="l00149"></a>00149 
<a name="l00150"></a>00150         <span class="keywordflow">return</span> <span class="stringliteral">&quot;Sucess\n&quot;</span>;
<a name="l00151"></a>00151 }
<a name="l00152"></a>00152 <span class="comment"></span>
<a name="l00153"></a>00153 <span class="comment">/**</span>
<a name="l00154"></a>00154 <span class="comment"> * Print a libnl error message</span>
<a name="l00155"></a>00155 <span class="comment"> * @arg s               error message prefix</span>
<a name="l00156"></a>00156 <span class="comment"> *</span>
<a name="l00157"></a>00157 <span class="comment"> * Prints the error message of the call that failed last.</span>
<a name="l00158"></a>00158 <span class="comment"> *</span>
<a name="l00159"></a>00159 <span class="comment"> * If s is not NULL and *s is not a null byte the argument</span>
<a name="l00160"></a>00160 <span class="comment"> * string is printed, followed by a colon and a blank. Then</span>
<a name="l00161"></a>00161 <span class="comment"> * the error message and a new-line.</span>
<a name="l00162"></a>00162 <span class="comment"> */</span>
<a name="l00163"></a><a class="code" href="group__utils.html#ga8c631e35dc822837a1e10354f96ea0b7">00163</a> <span class="keywordtype">void</span> <a class="code" href="group__utils.html#ga8c631e35dc822837a1e10354f96ea0b7" title="Print a libnl error message.">nl_perror</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *s)
<a name="l00164"></a>00164 {
<a name="l00165"></a>00165         <span class="keywordflow">if</span> (s &amp;&amp; *s)
<a name="l00166"></a>00166                 fprintf(stderr, <span class="stringliteral">&quot;%s: %s\n&quot;</span>, s, <a class="code" href="group__utils.html#ga4586cbc3086399f08e42708098ea2045" title="Return error message for an error code.">nl_geterror</a>());
<a name="l00167"></a>00167         <span class="keywordflow">else</span>
<a name="l00168"></a>00168                 fprintf(stderr, <span class="stringliteral">&quot;%s\n&quot;</span>, <a class="code" href="group__utils.html#ga4586cbc3086399f08e42708098ea2045" title="Return error message for an error code.">nl_geterror</a>());
<a name="l00169"></a>00169 }
<a name="l00170"></a>00170 <span class="comment"></span>
<a name="l00171"></a>00171 <span class="comment">/** @} */</span>
<a name="l00172"></a>00172 <span class="comment"></span>
<a name="l00173"></a>00173 <span class="comment">/**</span>
<a name="l00174"></a>00174 <span class="comment"> * @name Unit Pretty-Printing</span>
<a name="l00175"></a>00175 <span class="comment"> * @{</span>
<a name="l00176"></a>00176 <span class="comment"> */</span>
<a name="l00177"></a>00177 <span class="comment"></span>
<a name="l00178"></a>00178 <span class="comment">/**</span>
<a name="l00179"></a>00179 <span class="comment"> * Cancel down a byte counter</span>
<a name="l00180"></a>00180 <span class="comment"> * @arg l               byte counter</span>
<a name="l00181"></a>00181 <span class="comment"> * @arg unit            destination unit pointer</span>
<a name="l00182"></a>00182 <span class="comment"> *</span>
<a name="l00183"></a>00183 <span class="comment"> * Cancels down a byte counter until it reaches a reasonable</span>
<a name="l00184"></a>00184 <span class="comment"> * unit. The chosen unit is assigned to \a unit.</span>
<a name="l00185"></a>00185 <span class="comment"> * </span>
<a name="l00186"></a>00186 <span class="comment"> * @return The cancelled down byte counter in the new unit.</span>
<a name="l00187"></a>00187 <span class="comment"> */</span>
<a name="l00188"></a><a class="code" href="group__utils.html#ga5a280448ae9e17ff5dc7e822b9f47b11">00188</a> <span class="keywordtype">double</span> <a class="code" href="group__utils.html#ga5a280448ae9e17ff5dc7e822b9f47b11" title="Cancel down a byte counter.">nl_cancel_down_bytes</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <span class="keywordtype">long</span> l, <span class="keywordtype">char</span> **unit)
<a name="l00189"></a>00189 {
<a name="l00190"></a>00190         <span class="keywordflow">if</span> (l &gt;= 1099511627776LL) {
<a name="l00191"></a>00191                 *unit = <span class="stringliteral">&quot;TiB&quot;</span>;
<a name="l00192"></a>00192                 <span class="keywordflow">return</span> ((<span class="keywordtype">double</span>) l) / 1099511627776LL;
<a name="l00193"></a>00193         } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (l &gt;= 1073741824) {
<a name="l00194"></a>00194                 *unit = <span class="stringliteral">&quot;GiB&quot;</span>;
<a name="l00195"></a>00195                 <span class="keywordflow">return</span> ((<span class="keywordtype">double</span>) l) / 1073741824;
<a name="l00196"></a>00196         } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (l &gt;= 1048576) {
<a name="l00197"></a>00197                 *unit = <span class="stringliteral">&quot;MiB&quot;</span>;
<a name="l00198"></a>00198                 <span class="keywordflow">return</span> ((<span class="keywordtype">double</span>) l) / 1048576;
<a name="l00199"></a>00199         } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (l &gt;= 1024) {
<a name="l00200"></a>00200                 *unit = <span class="stringliteral">&quot;KiB&quot;</span>;
<a name="l00201"></a>00201                 <span class="keywordflow">return</span> ((<span class="keywordtype">double</span>) l) / 1024;
<a name="l00202"></a>00202         } <span class="keywordflow">else</span> {
<a name="l00203"></a>00203                 *unit = <span class="stringliteral">&quot;B&quot;</span>;
<a name="l00204"></a>00204                 <span class="keywordflow">return</span> (<span class="keywordtype">double</span>) l;
<a name="l00205"></a>00205         }
<a name="l00206"></a>00206 }
<a name="l00207"></a>00207 <span class="comment"></span>
<a name="l00208"></a>00208 <span class="comment">/**</span>
<a name="l00209"></a>00209 <span class="comment"> * Cancel down a bit counter</span>
<a name="l00210"></a>00210 <span class="comment"> * @arg l               bit counter</span>
<a name="l00211"></a>00211 <span class="comment"> * @arg unit            destination unit pointer</span>
<a name="l00212"></a>00212 <span class="comment"> *</span>
<a name="l00213"></a>00213 <span class="comment"> * Cancels downa bit counter until it reaches a reasonable</span>
<a name="l00214"></a>00214 <span class="comment"> * unit. The chosen unit is assigned to \a unit.</span>
<a name="l00215"></a>00215 <span class="comment"> *</span>
<a name="l00216"></a>00216 <span class="comment"> * @return The cancelled down bit counter in the new unit.</span>
<a name="l00217"></a>00217 <span class="comment"> */</span>
<a name="l00218"></a><a class="code" href="group__utils.html#ga195db70bc2c97b1eb6f40c2d60a6f823">00218</a> <span class="keywordtype">double</span> <a class="code" href="group__utils.html#ga195db70bc2c97b1eb6f40c2d60a6f823" title="Cancel down a bit counter.">nl_cancel_down_bits</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <span class="keywordtype">long</span> l, <span class="keywordtype">char</span> **unit)
<a name="l00219"></a>00219 {
<a name="l00220"></a>00220         <span class="keywordflow">if</span> (l &gt;= 1099511627776ULL) {
<a name="l00221"></a>00221                 *unit = <span class="stringliteral">&quot;Tbit&quot;</span>;
<a name="l00222"></a>00222                 <span class="keywordflow">return</span> ((<span class="keywordtype">double</span>) l) / 1099511627776ULL;
<a name="l00223"></a>00223         } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (l &gt;= 1073741824) {
<a name="l00224"></a>00224                 *unit = <span class="stringliteral">&quot;Gbit&quot;</span>;
<a name="l00225"></a>00225                 <span class="keywordflow">return</span> ((<span class="keywordtype">double</span>) l) / 1073741824;
<a name="l00226"></a>00226         } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (l &gt;= 1048576) {
<a name="l00227"></a>00227                 *unit = <span class="stringliteral">&quot;Mbit&quot;</span>;
<a name="l00228"></a>00228                 <span class="keywordflow">return</span> ((<span class="keywordtype">double</span>) l) / 1048576;
<a name="l00229"></a>00229         } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (l &gt;= 1024) {
<a name="l00230"></a>00230                 *unit = <span class="stringliteral">&quot;Kbit&quot;</span>;
<a name="l00231"></a>00231                 <span class="keywordflow">return</span> ((<span class="keywordtype">double</span>) l) / 1024;
<a name="l00232"></a>00232         } <span class="keywordflow">else</span> {
<a name="l00233"></a>00233                 *unit = <span class="stringliteral">&quot;bit&quot;</span>;
<a name="l00234"></a>00234                 <span class="keywordflow">return</span> (<span class="keywordtype">double</span>) l;
<a name="l00235"></a>00235         }
<a name="l00236"></a>00236                 
<a name="l00237"></a>00237 }
<a name="l00238"></a>00238 <span class="comment"></span>
<a name="l00239"></a>00239 <span class="comment">/**</span>
<a name="l00240"></a>00240 <span class="comment"> * Cancel down a micro second value</span>
<a name="l00241"></a>00241 <span class="comment"> * @arg l               micro seconds</span>
<a name="l00242"></a>00242 <span class="comment"> * @arg unit            destination unit pointer</span>
<a name="l00243"></a>00243 <span class="comment"> *</span>
<a name="l00244"></a>00244 <span class="comment"> * Cancels down a microsecond counter until it reaches a</span>
<a name="l00245"></a>00245 <span class="comment"> * reasonable unit. The chosen unit is assigned to \a unit.</span>
<a name="l00246"></a>00246 <span class="comment"> *</span>
<a name="l00247"></a>00247 <span class="comment"> * @return The cancelled down microsecond in the new unit</span>
<a name="l00248"></a>00248 <span class="comment"> */</span>
<a name="l00249"></a><a class="code" href="group__utils.html#ga190dcd7725dd4f6a7e635a99a0b8b0db">00249</a> <span class="keywordtype">double</span> <a class="code" href="group__utils.html#ga190dcd7725dd4f6a7e635a99a0b8b0db" title="Cancel down a micro second value.">nl_cancel_down_us</a>(uint32_t l, <span class="keywordtype">char</span> **unit)
<a name="l00250"></a>00250 {
<a name="l00251"></a>00251         <span class="keywordflow">if</span> (l &gt;= 1000000) {
<a name="l00252"></a>00252                 *unit = <span class="stringliteral">&quot;s&quot;</span>;
<a name="l00253"></a>00253                 <span class="keywordflow">return</span> ((<span class="keywordtype">double</span>) l) / 1000000;
<a name="l00254"></a>00254         } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (l &gt;= 1000) {
<a name="l00255"></a>00255                 *unit = <span class="stringliteral">&quot;ms&quot;</span>;
<a name="l00256"></a>00256                 <span class="keywordflow">return</span> ((<span class="keywordtype">double</span>) l) / 1000;
<a name="l00257"></a>00257         } <span class="keywordflow">else</span> {
<a name="l00258"></a>00258                 *unit = <span class="stringliteral">&quot;us&quot;</span>;
<a name="l00259"></a>00259                 <span class="keywordflow">return</span> (<span class="keywordtype">double</span>) l;
<a name="l00260"></a>00260         }
<a name="l00261"></a>00261 }
<a name="l00262"></a>00262 <span class="comment"></span>
<a name="l00263"></a>00263 <span class="comment">/** @} */</span>
<a name="l00264"></a>00264 <span class="comment"></span>
<a name="l00265"></a>00265 <span class="comment">/**</span>
<a name="l00266"></a>00266 <span class="comment"> * @name Generic Unit Translations</span>
<a name="l00267"></a>00267 <span class="comment"> * @{</span>
<a name="l00268"></a>00268 <span class="comment"> */</span>
<a name="l00269"></a>00269 <span class="comment"></span>
<a name="l00270"></a>00270 <span class="comment">/**</span>
<a name="l00271"></a>00271 <span class="comment"> * Convert a character string to a size</span>
<a name="l00272"></a>00272 <span class="comment"> * @arg str             size encoded as character string</span>
<a name="l00273"></a>00273 <span class="comment"> *</span>
<a name="l00274"></a>00274 <span class="comment"> * Converts the specified size as character to the corresponding</span>
<a name="l00275"></a>00275 <span class="comment"> * number of bytes.</span>
<a name="l00276"></a>00276 <span class="comment"> *</span>
<a name="l00277"></a>00277 <span class="comment"> * Supported formats are:</span>
<a name="l00278"></a>00278 <span class="comment"> *  - b,kb/k,m/mb,gb/g for bytes</span>
<a name="l00279"></a>00279 <span class="comment"> *  - bit,kbit/mbit/gbit</span>
<a name="l00280"></a>00280 <span class="comment"> *</span>
<a name="l00281"></a>00281 <span class="comment"> * @return The number of bytes or -1 if the string is unparseable</span>
<a name="l00282"></a>00282 <span class="comment"> */</span>
<a name="l00283"></a><a class="code" href="group__utils.html#ga1f10fc847364fc4f02624ba3b5b00954">00283</a> <span class="keywordtype">long</span> <a class="code" href="group__utils.html#ga1f10fc847364fc4f02624ba3b5b00954" title="Convert a character string to a size.">nl_size2int</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *str)
<a name="l00284"></a>00284 {
<a name="l00285"></a>00285         <span class="keywordtype">char</span> *p;
<a name="l00286"></a>00286         <span class="keywordtype">long</span> l = strtol(str, &amp;p, 0);
<a name="l00287"></a>00287         <span class="keywordflow">if</span> (p == str)
<a name="l00288"></a>00288                 <span class="keywordflow">return</span> -1;
<a name="l00289"></a>00289 
<a name="l00290"></a>00290         <span class="keywordflow">if</span> (*p) {
<a name="l00291"></a>00291                 <span class="keywordflow">if</span> (!strcasecmp(p, <span class="stringliteral">&quot;kb&quot;</span>) || !strcasecmp(p, <span class="stringliteral">&quot;k&quot;</span>))
<a name="l00292"></a>00292                         l *= 1024;
<a name="l00293"></a>00293                 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!strcasecmp(p, <span class="stringliteral">&quot;gb&quot;</span>) || !strcasecmp(p, <span class="stringliteral">&quot;g&quot;</span>))
<a name="l00294"></a>00294                         l *= 1024*1024*1024;
<a name="l00295"></a>00295                 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!strcasecmp(p, <span class="stringliteral">&quot;gbit&quot;</span>))
<a name="l00296"></a>00296                         l *= 1024*1024*1024/8;
<a name="l00297"></a>00297                 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!strcasecmp(p, <span class="stringliteral">&quot;mb&quot;</span>) || !strcasecmp(p, <span class="stringliteral">&quot;m&quot;</span>))
<a name="l00298"></a>00298                         l *= 1024*1024;
<a name="l00299"></a>00299                 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!strcasecmp(p, <span class="stringliteral">&quot;mbit&quot;</span>))
<a name="l00300"></a>00300                         l *= 1024*1024/8;
<a name="l00301"></a>00301                 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!strcasecmp(p, <span class="stringliteral">&quot;kbit&quot;</span>))
<a name="l00302"></a>00302                         l *= 1024/8;
<a name="l00303"></a>00303                 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!strcasecmp(p, <span class="stringliteral">&quot;bit&quot;</span>))
<a name="l00304"></a>00304                         l /= 8;
<a name="l00305"></a>00305                 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcasecmp(p, <span class="stringliteral">&quot;b&quot;</span>) != 0)
<a name="l00306"></a>00306                         <span class="keywordflow">return</span> -1;
<a name="l00307"></a>00307         }
<a name="l00308"></a>00308 
<a name="l00309"></a>00309         <span class="keywordflow">return</span> l;
<a name="l00310"></a>00310 }
<a name="l00311"></a>00311 <span class="comment"></span>
<a name="l00312"></a>00312 <span class="comment">/**</span>
<a name="l00313"></a>00313 <span class="comment"> * Convert a character string to a probability</span>
<a name="l00314"></a>00314 <span class="comment"> * @arg str             probability encoded as character string</span>
<a name="l00315"></a>00315 <span class="comment"> *</span>
<a name="l00316"></a>00316 <span class="comment"> * Converts the specified probability as character to the</span>
<a name="l00317"></a>00317 <span class="comment"> * corresponding probability number.</span>
<a name="l00318"></a>00318 <span class="comment"> *</span>
<a name="l00319"></a>00319 <span class="comment"> * Supported formats are:</span>
<a name="l00320"></a>00320 <span class="comment"> *  - 0.0-1.0</span>
<a name="l00321"></a>00321 <span class="comment"> *  - 0%-100%</span>
<a name="l00322"></a>00322 <span class="comment"> *</span>
<a name="l00323"></a>00323 <span class="comment"> * @return The probability relative to NL_PROB_MIN and NL_PROB_MAX</span>
<a name="l00324"></a>00324 <span class="comment"> */</span>
<a name="l00325"></a><a class="code" href="group__utils.html#ga60e3d95f99eba0e01e0d127653e1da6b">00325</a> <span class="keywordtype">long</span> <a class="code" href="group__utils.html#ga60e3d95f99eba0e01e0d127653e1da6b" title="Convert a character string to a probability.">nl_prob2int</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *str)
<a name="l00326"></a>00326 {
<a name="l00327"></a>00327         <span class="keywordtype">char</span> *p;
<a name="l00328"></a>00328         <span class="keywordtype">double</span> d = strtod(str, &amp;p);
<a name="l00329"></a>00329 
<a name="l00330"></a>00330         <span class="keywordflow">if</span> (p == str)
<a name="l00331"></a>00331                 <span class="keywordflow">return</span> -1;
<a name="l00332"></a>00332 
<a name="l00333"></a>00333         <span class="keywordflow">if</span> (d &gt; 1.0)
<a name="l00334"></a>00334                 d /= 100.0f;
<a name="l00335"></a>00335 
<a name="l00336"></a>00336         <span class="keywordflow">if</span> (d &gt; 1.0f || d &lt; 0.0f)
<a name="l00337"></a>00337                 <span class="keywordflow">return</span> -1;
<a name="l00338"></a>00338 
<a name="l00339"></a>00339         <span class="keywordflow">if</span> (*p &amp;&amp; strcmp(p, <span class="stringliteral">&quot;%&quot;</span>) != 0)
<a name="l00340"></a>00340                 <span class="keywordflow">return</span> -1;
<a name="l00341"></a>00341 
<a name="l00342"></a>00342         <span class="keywordflow">return</span> rint(d * <a class="code" href="group__utils.html#ga031d6bce1af7c5547c814bd7b16bb605" title="Upper probability limit.">NL_PROB_MAX</a>);
<a name="l00343"></a>00343 }
<a name="l00344"></a>00344 <span class="comment"></span>
<a name="l00345"></a>00345 <span class="comment">/** @} */</span>
<a name="l00346"></a>00346 <span class="comment"></span>
<a name="l00347"></a>00347 <span class="comment">/**</span>
<a name="l00348"></a>00348 <span class="comment"> * @name Time Translations</span>
<a name="l00349"></a>00349 <span class="comment"> * @{</span>
<a name="l00350"></a>00350 <span class="comment"> */</span>
<a name="l00351"></a>00351 
<a name="l00352"></a>00352 <span class="preprocessor">#ifdef USER_HZ</span>
<a name="l00353"></a>00353 <span class="preprocessor"></span><span class="keyword">static</span> uint32_t user_hz = USER_HZ;
<a name="l00354"></a>00354 <span class="preprocessor">#else</span>
<a name="l00355"></a>00355 <span class="preprocessor"></span><span class="keyword">static</span> uint32_t user_hz = 100;
<a name="l00356"></a>00356 <span class="preprocessor">#endif</span>
<a name="l00357"></a>00357 <span class="preprocessor"></span>
<a name="l00358"></a>00358 <span class="keyword">static</span> <span class="keywordtype">double</span> ticks_per_usec = 1.0f;
<a name="l00359"></a>00359 
<a name="l00360"></a>00360 <span class="comment">/* Retrieves the configured HZ and ticks/us value in the kernel.</span>
<a name="l00361"></a>00361 <span class="comment"> * The value is cached. Supported ways of getting it:</span>
<a name="l00362"></a>00362 <span class="comment"> *</span>
<a name="l00363"></a>00363 <span class="comment"> * 1) environment variable</span>
<a name="l00364"></a>00364 <span class="comment"> * 2) /proc/net/psched and sysconf</span>
<a name="l00365"></a>00365 <span class="comment"> *</span>
<a name="l00366"></a>00366 <span class="comment"> * Supports the environment variables:</span>
<a name="l00367"></a>00367 <span class="comment"> *   PROC_NET_PSCHED  - may point to psched file in /proc</span>
<a name="l00368"></a>00368 <span class="comment"> *   PROC_ROOT        - may point to /proc fs */</span> 
<a name="l00369"></a>00369 <span class="keyword">static</span> <span class="keywordtype">void</span> __init get_psched_settings(<span class="keywordtype">void</span>)
<a name="l00370"></a>00370 {
<a name="l00371"></a>00371         <span class="keywordtype">char</span> name[FILENAME_MAX];
<a name="l00372"></a>00372         FILE *fd;
<a name="l00373"></a>00373         <span class="keywordtype">int</span> got_hz = 0, got_tick = 0;
<a name="l00374"></a>00374 
<a name="l00375"></a>00375         <span class="keywordflow">if</span> (getenv(<span class="stringliteral">&quot;HZ&quot;</span>)) {
<a name="l00376"></a>00376                 <span class="keywordtype">long</span> hz = strtol(getenv(<span class="stringliteral">&quot;HZ&quot;</span>), NULL, 0);
<a name="l00377"></a>00377 
<a name="l00378"></a>00378                 <span class="keywordflow">if</span> (LONG_MIN != hz &amp;&amp; LONG_MAX != hz) {
<a name="l00379"></a>00379                         user_hz = hz;
<a name="l00380"></a>00380                         got_hz = 1;
<a name="l00381"></a>00381                 }
<a name="l00382"></a>00382         }
<a name="l00383"></a>00383 
<a name="l00384"></a>00384         <span class="keywordflow">if</span> (!got_hz)
<a name="l00385"></a>00385                 user_hz = sysconf(_SC_CLK_TCK);
<a name="l00386"></a>00386 
<a name="l00387"></a>00387         <span class="keywordflow">if</span> (getenv(<span class="stringliteral">&quot;TICKS_PER_USEC&quot;</span>)) {
<a name="l00388"></a>00388                 <span class="keywordtype">double</span> t = strtod(getenv(<span class="stringliteral">&quot;TICKS_PER_USEC&quot;</span>), NULL);
<a name="l00389"></a>00389 
<a name="l00390"></a>00390                 ticks_per_usec = t;
<a name="l00391"></a>00391                 got_tick = 1;
<a name="l00392"></a>00392         }
<a name="l00393"></a>00393                 
<a name="l00394"></a>00394 
<a name="l00395"></a>00395         <span class="keywordflow">if</span> (getenv(<span class="stringliteral">&quot;PROC_NET_PSCHED&quot;</span>))
<a name="l00396"></a>00396                 snprintf(name, <span class="keyword">sizeof</span>(name), <span class="stringliteral">&quot;%s&quot;</span>, getenv(<span class="stringliteral">&quot;PROC_NET_PSCHED&quot;</span>));
<a name="l00397"></a>00397         <span class="keywordflow">else</span> <span class="keywordflow">if</span> (getenv(<span class="stringliteral">&quot;PROC_ROOT&quot;</span>))
<a name="l00398"></a>00398                 snprintf(name, <span class="keyword">sizeof</span>(name), <span class="stringliteral">&quot;%s/net/psched&quot;</span>,
<a name="l00399"></a>00399                          getenv(<span class="stringliteral">&quot;PROC_ROOT&quot;</span>));
<a name="l00400"></a>00400         <span class="keywordflow">else</span>
<a name="l00401"></a>00401                 strncpy(name, <span class="stringliteral">&quot;/proc/net/psched&quot;</span>, <span class="keyword">sizeof</span>(name) - 1);
<a name="l00402"></a>00402 
<a name="l00403"></a>00403         <span class="keywordflow">if</span> ((fd = fopen(name, <span class="stringliteral">&quot;r&quot;</span>))) {
<a name="l00404"></a>00404                 uint32_t tick, us, nom;
<a name="l00405"></a>00405                 <span class="keywordtype">int</span> r = fscanf(fd, <span class="stringliteral">&quot;%08x%08x%08x%*08x&quot;</span>, &amp;tick, &amp;us, &amp;nom);
<a name="l00406"></a>00406 
<a name="l00407"></a>00407                 <span class="keywordflow">if</span> (4 == r &amp;&amp; nom == 1000000 &amp;&amp; !got_tick)
<a name="l00408"></a>00408                         ticks_per_usec = (double)tick/(<span class="keywordtype">double</span>)us;
<a name="l00409"></a>00409                         
<a name="l00410"></a>00410                 fclose(fd);
<a name="l00411"></a>00411         }
<a name="l00412"></a>00412 }
<a name="l00413"></a>00413 
<a name="l00414"></a>00414 <span class="comment"></span>
<a name="l00415"></a>00415 <span class="comment">/**</span>
<a name="l00416"></a>00416 <span class="comment"> * Return the value of HZ</span>
<a name="l00417"></a>00417 <span class="comment"> */</span>
<a name="l00418"></a><a class="code" href="group__utils.html#ga9aa52772ddedc62e60f5ecfc9a66ea89">00418</a> <span class="keywordtype">int</span> <a class="code" href="group__utils.html#ga9aa52772ddedc62e60f5ecfc9a66ea89" title="Return the value of HZ.">nl_get_hz</a>(<span class="keywordtype">void</span>)
<a name="l00419"></a>00419 {
<a name="l00420"></a>00420         <span class="keywordflow">return</span> user_hz;
<a name="l00421"></a>00421 }
<a name="l00422"></a>00422 
<a name="l00423"></a>00423 <span class="comment"></span>
<a name="l00424"></a>00424 <span class="comment">/**</span>
<a name="l00425"></a>00425 <span class="comment"> * Convert micro seconds to ticks</span>
<a name="l00426"></a>00426 <span class="comment"> * @arg us              micro seconds</span>
<a name="l00427"></a>00427 <span class="comment"> * @return number of ticks</span>
<a name="l00428"></a>00428 <span class="comment"> */</span>
<a name="l00429"></a><a class="code" href="group__utils.html#gaf630014f3b23909759921b8ef9f85d3e">00429</a> uint32_t <a class="code" href="group__utils.html#gaf630014f3b23909759921b8ef9f85d3e" title="Convert micro seconds to ticks.">nl_us2ticks</a>(uint32_t us)
<a name="l00430"></a>00430 {
<a name="l00431"></a>00431         <span class="keywordflow">return</span> us * ticks_per_usec;
<a name="l00432"></a>00432 }
<a name="l00433"></a>00433 
<a name="l00434"></a>00434 <span class="comment"></span>
<a name="l00435"></a>00435 <span class="comment">/**</span>
<a name="l00436"></a>00436 <span class="comment"> * Convert ticks to micro seconds</span>
<a name="l00437"></a>00437 <span class="comment"> * @arg ticks           number of ticks</span>
<a name="l00438"></a>00438 <span class="comment"> * @return microseconds</span>
<a name="l00439"></a>00439 <span class="comment"> */</span>
<a name="l00440"></a><a class="code" href="group__utils.html#gade35baf670a48177d9469905159089e7">00440</a> uint32_t <a class="code" href="group__utils.html#gade35baf670a48177d9469905159089e7" title="Convert ticks to micro seconds.">nl_ticks2us</a>(uint32_t ticks)
<a name="l00441"></a>00441 {
<a name="l00442"></a>00442         <span class="keywordflow">return</span> ticks / ticks_per_usec;
<a name="l00443"></a>00443 }
<a name="l00444"></a>00444 
<a name="l00445"></a>00445 <span class="keywordtype">long</span> nl_time2int(<span class="keyword">const</span> <span class="keywordtype">char</span> *str)
<a name="l00446"></a>00446 {
<a name="l00447"></a>00447         <span class="keywordtype">char</span> *p;
<a name="l00448"></a>00448         <span class="keywordtype">long</span> l = strtol(str, &amp;p, 0);
<a name="l00449"></a>00449         <span class="keywordflow">if</span> (p == str)
<a name="l00450"></a>00450                 <span class="keywordflow">return</span> -1;
<a name="l00451"></a>00451 
<a name="l00452"></a>00452         <span class="keywordflow">if</span> (*p) {
<a name="l00453"></a>00453                 <span class="keywordflow">if</span> (!strcasecmp(p, <span class="stringliteral">&quot;min&quot;</span>) == 0 || !strcasecmp(p, <span class="stringliteral">&quot;m&quot;</span>))
<a name="l00454"></a>00454                         l *= 60;
<a name="l00455"></a>00455                 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!strcasecmp(p, <span class="stringliteral">&quot;hour&quot;</span>) || !strcasecmp(p, <span class="stringliteral">&quot;h&quot;</span>))
<a name="l00456"></a>00456                         l *= 60*60;
<a name="l00457"></a>00457                 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!strcasecmp(p, <span class="stringliteral">&quot;day&quot;</span>) || !strcasecmp(p, <span class="stringliteral">&quot;d&quot;</span>))
<a name="l00458"></a>00458                         l *= 60*60*24;
<a name="l00459"></a>00459                 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (strcasecmp(p, <span class="stringliteral">&quot;s&quot;</span>) != 0)
<a name="l00460"></a>00460                         <span class="keywordflow">return</span> -1;
<a name="l00461"></a>00461         }
<a name="l00462"></a>00462 
<a name="l00463"></a>00463         <span class="keywordflow">return</span> l;
<a name="l00464"></a>00464 }
<a name="l00465"></a>00465 <span class="comment"></span>
<a name="l00466"></a>00466 <span class="comment">/**</span>
<a name="l00467"></a>00467 <span class="comment"> * Convert milliseconds to a character string</span>
<a name="l00468"></a>00468 <span class="comment"> * @arg msec            number of milliseconds</span>
<a name="l00469"></a>00469 <span class="comment"> * @arg buf             destination buffer</span>
<a name="l00470"></a>00470 <span class="comment"> * @arg len             buffer length</span>
<a name="l00471"></a>00471 <span class="comment"> *</span>
<a name="l00472"></a>00472 <span class="comment"> * Converts milliseconds to a character string split up in days, hours,</span>
<a name="l00473"></a>00473 <span class="comment"> * minutes, seconds, and milliseconds and stores it in the specified</span>
<a name="l00474"></a>00474 <span class="comment"> * destination buffer.</span>
<a name="l00475"></a>00475 <span class="comment"> *</span>
<a name="l00476"></a>00476 <span class="comment"> * @return The destination buffer.</span>
<a name="l00477"></a>00477 <span class="comment"> */</span>
<a name="l00478"></a><a class="code" href="group__utils.html#gace816c5bf9a61cd74bbb0444ffa7029f">00478</a> <span class="keywordtype">char</span> * <a class="code" href="group__utils.html#gace816c5bf9a61cd74bbb0444ffa7029f" title="Convert milliseconds to a character string.">nl_msec2str</a>(uint64_t msec, <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> len)
<a name="l00479"></a>00479 {
<a name="l00480"></a>00480         <span class="keywordtype">int</span> i, split[5];
<a name="l00481"></a>00481         <span class="keywordtype">char</span> *units[] = {<span class="stringliteral">&quot;d&quot;</span>, <span class="stringliteral">&quot;h&quot;</span>, <span class="stringliteral">&quot;m&quot;</span>, <span class="stringliteral">&quot;s&quot;</span>, <span class="stringliteral">&quot;msec&quot;</span>};
<a name="l00482"></a>00482 
<a name="l00483"></a>00483 <span class="preprocessor">#define _SPLIT(idx, unit) if ((split[idx] = msec / unit) &gt; 0) msec %= unit</span>
<a name="l00484"></a>00484 <span class="preprocessor"></span>        _SPLIT(0, 86400000);    <span class="comment">/* days */</span>
<a name="l00485"></a>00485         _SPLIT(1, 3600000);     <span class="comment">/* hours */</span>
<a name="l00486"></a>00486         _SPLIT(2, 60000);       <span class="comment">/* minutes */</span>
<a name="l00487"></a>00487         _SPLIT(3, 1000);        <span class="comment">/* seconds */</span>
<a name="l00488"></a>00488 <span class="preprocessor">#undef  _SPLIT</span>
<a name="l00489"></a>00489 <span class="preprocessor"></span>        split[4] = msec;
<a name="l00490"></a>00490 
<a name="l00491"></a>00491         memset(buf, 0, len);
<a name="l00492"></a>00492 
<a name="l00493"></a>00493         <span class="keywordflow">for</span> (i = 0; i &lt; ARRAY_SIZE(split); i++) {
<a name="l00494"></a>00494                 <span class="keywordflow">if</span> (split[i] &gt; 0) {
<a name="l00495"></a>00495                         <span class="keywordtype">char</span> t[64];
<a name="l00496"></a>00496                         snprintf(t, <span class="keyword">sizeof</span>(t), <span class="stringliteral">&quot;%s%d%s&quot;</span>,
<a name="l00497"></a>00497                                  strlen(buf) ? <span class="stringliteral">&quot; &quot;</span> : <span class="stringliteral">&quot;&quot;</span>, split[i], units[i]);
<a name="l00498"></a>00498                         strncat(buf, t, len - strlen(buf) - 1);
<a name="l00499"></a>00499                 }
<a name="l00500"></a>00500         }
<a name="l00501"></a>00501 
<a name="l00502"></a>00502         <span class="keywordflow">return</span> buf;
<a name="l00503"></a>00503 }
<a name="l00504"></a>00504 <span class="comment"></span>
<a name="l00505"></a>00505 <span class="comment">/** @} */</span>
<a name="l00506"></a>00506 <span class="comment"></span>
<a name="l00507"></a>00507 <span class="comment">/**</span>
<a name="l00508"></a>00508 <span class="comment"> * @name Link Layer Protocol Translations</span>
<a name="l00509"></a>00509 <span class="comment"> * @{</span>
<a name="l00510"></a>00510 <span class="comment"> */</span>
<a name="l00511"></a>00511 
<a name="l00512"></a>00512 <span class="keyword">static</span> <span class="keyword">struct </span>trans_tbl llprotos[] = {
<a name="l00513"></a>00513         {0, <span class="stringliteral">&quot;generic&quot;</span>},
<a name="l00514"></a>00514         __ADD(ARPHRD_ETHER,ether)
<a name="l00515"></a>00515         __ADD(ARPHRD_EETHER,eether)
<a name="l00516"></a>00516         __ADD(ARPHRD_AX25,ax25)
<a name="l00517"></a>00517         __ADD(ARPHRD_PRONET,pronet)
<a name="l00518"></a>00518         __ADD(ARPHRD_CHAOS,chaos)
<a name="l00519"></a>00519         __ADD(ARPHRD_IEEE802,ieee802)
<a name="l00520"></a>00520         __ADD(ARPHRD_ARCNET,arcnet)
<a name="l00521"></a>00521         __ADD(ARPHRD_APPLETLK,atalk)
<a name="l00522"></a>00522         __ADD(ARPHRD_DLCI,dlci)
<a name="l00523"></a>00523         __ADD(ARPHRD_ATM,atm)
<a name="l00524"></a>00524         __ADD(ARPHRD_METRICOM,metricom)
<a name="l00525"></a>00525         __ADD(ARPHRD_IEEE1394,ieee1394)
<a name="l00526"></a>00526 <span class="preprocessor">#ifdef ARPHRD_EUI64</span>
<a name="l00527"></a>00527 <span class="preprocessor"></span>        __ADD(ARPHRD_EUI64,eui64)
<a name="l00528"></a>00528 <span class="preprocessor">#endif</span>
<a name="l00529"></a>00529 <span class="preprocessor"></span>        __ADD(ARPHRD_INFINIBAND,infiniband)
<a name="l00530"></a>00530         __ADD(ARPHRD_SLIP,slip)
<a name="l00531"></a>00531         __ADD(ARPHRD_CSLIP,cslip)
<a name="l00532"></a>00532         __ADD(ARPHRD_SLIP6,slip6)
<a name="l00533"></a>00533         __ADD(ARPHRD_CSLIP6,cslip6)
<a name="l00534"></a>00534         __ADD(ARPHRD_RSRVD,rsrvd)
<a name="l00535"></a>00535         __ADD(ARPHRD_ADAPT,adapt)
<a name="l00536"></a>00536         __ADD(ARPHRD_ROSE,rose)
<a name="l00537"></a>00537         __ADD(ARPHRD_X25,x25)
<a name="l00538"></a>00538 <span class="preprocessor">#ifdef ARPHRD_HWX25</span>
<a name="l00539"></a>00539 <span class="preprocessor"></span>        __ADD(ARPHRD_HWX25,hwx25)
<a name="l00540"></a>00540 <span class="preprocessor">#endif</span>
<a name="l00541"></a>00541 <span class="preprocessor"></span>        __ADD(ARPHRD_PPP,ppp)
<a name="l00542"></a>00542         __ADD(ARPHRD_HDLC,hdlc)
<a name="l00543"></a>00543         __ADD(ARPHRD_LAPB,lapb)
<a name="l00544"></a>00544         __ADD(ARPHRD_DDCMP,ddcmp)
<a name="l00545"></a>00545         __ADD(ARPHRD_RAWHDLC,rawhdlc)
<a name="l00546"></a>00546         __ADD(ARPHRD_TUNNEL,ipip)
<a name="l00547"></a>00547         __ADD(ARPHRD_TUNNEL6,tunnel6)
<a name="l00548"></a>00548         __ADD(ARPHRD_FRAD,frad)
<a name="l00549"></a>00549         __ADD(ARPHRD_SKIP,skip)
<a name="l00550"></a>00550         __ADD(ARPHRD_LOOPBACK,loopback)
<a name="l00551"></a>00551         __ADD(ARPHRD_LOCALTLK,localtlk)
<a name="l00552"></a>00552         __ADD(ARPHRD_FDDI,fddi)
<a name="l00553"></a>00553         __ADD(ARPHRD_BIF,bif)
<a name="l00554"></a>00554         __ADD(ARPHRD_SIT,sit)
<a name="l00555"></a>00555         __ADD(ARPHRD_IPDDP,ip/ddp)
<a name="l00556"></a>00556         __ADD(ARPHRD_IPGRE,gre)
<a name="l00557"></a>00557         __ADD(ARPHRD_PIMREG,pimreg)
<a name="l00558"></a>00558         __ADD(ARPHRD_HIPPI,hippi)
<a name="l00559"></a>00559         __ADD(ARPHRD_ASH,ash)
<a name="l00560"></a>00560         __ADD(ARPHRD_ECONET,econet)
<a name="l00561"></a>00561         __ADD(ARPHRD_IRDA,irda)
<a name="l00562"></a>00562         __ADD(ARPHRD_FCPP,fcpp)
<a name="l00563"></a>00563         __ADD(ARPHRD_FCAL,fcal)
<a name="l00564"></a>00564         __ADD(ARPHRD_FCPL,fcpl)
<a name="l00565"></a>00565         __ADD(ARPHRD_FCFABRIC,fcfb_0)
<a name="l00566"></a>00566         __ADD(ARPHRD_FCFABRIC+1,fcfb_1)
<a name="l00567"></a>00567         __ADD(ARPHRD_FCFABRIC+2,fcfb_2)
<a name="l00568"></a>00568         __ADD(ARPHRD_FCFABRIC+3,fcfb_3)
<a name="l00569"></a>00569         __ADD(ARPHRD_FCFABRIC+4,fcfb_4)
<a name="l00570"></a>00570         __ADD(ARPHRD_FCFABRIC+5,fcfb_5)
<a name="l00571"></a>00571         __ADD(ARPHRD_FCFABRIC+6,fcfb_6)
<a name="l00572"></a>00572         __ADD(ARPHRD_FCFABRIC+7,fcfb_7)
<a name="l00573"></a>00573         __ADD(ARPHRD_FCFABRIC+8,fcfb_8)
<a name="l00574"></a>00574         __ADD(ARPHRD_FCFABRIC+9,fcfb_9)
<a name="l00575"></a>00575         __ADD(ARPHRD_FCFABRIC+10,fcfb_10)
<a name="l00576"></a>00576         __ADD(ARPHRD_FCFABRIC+11,fcfb_11)
<a name="l00577"></a>00577         __ADD(ARPHRD_FCFABRIC+12,fcfb_12)
<a name="l00578"></a>00578         __ADD(ARPHRD_IEEE802_TR,tr)
<a name="l00579"></a>00579         __ADD(ARPHRD_IEEE80211,ieee802.11)
<a name="l00580"></a>00580 <span class="preprocessor">#ifdef ARPHRD_IEEE80211_PRISM</span>
<a name="l00581"></a>00581 <span class="preprocessor"></span>        __ADD(ARPHRD_IEEE80211_PRISM, ieee802.11_prism)
<a name="l00582"></a>00582 <span class="preprocessor">#endif</span>
<a name="l00583"></a>00583 <span class="preprocessor"></span><span class="preprocessor">#ifdef ARPHRD_VOID</span>
<a name="l00584"></a>00584 <span class="preprocessor"></span>        __ADD(ARPHRD_VOID,<span class="keywordtype">void</span>)
<a name="l00585"></a>00585 <span class="preprocessor">#endif</span>
<a name="l00586"></a>00586 <span class="preprocessor"></span>};
<a name="l00587"></a>00587 
<a name="l00588"></a>00588 <span class="keywordtype">char</span> * nl_llproto2str(<span class="keywordtype">int</span> llproto, <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> len)
<a name="l00589"></a>00589 {
<a name="l00590"></a>00590         <span class="keywordflow">return</span> __type2str(llproto, buf, len, llprotos, ARRAY_SIZE(llprotos));
<a name="l00591"></a>00591 }
<a name="l00592"></a>00592 
<a name="l00593"></a>00593 <span class="keywordtype">int</span> nl_str2llproto(<span class="keyword">const</span> <span class="keywordtype">char</span> *name)
<a name="l00594"></a>00594 {
<a name="l00595"></a>00595         <span class="keywordflow">return</span> __str2type(name, llprotos, ARRAY_SIZE(llprotos));
<a name="l00596"></a>00596 }
<a name="l00597"></a>00597 <span class="comment"></span>
<a name="l00598"></a>00598 <span class="comment">/** @} */</span>
<a name="l00599"></a>00599 
<a name="l00600"></a>00600 <span class="comment"></span>
<a name="l00601"></a>00601 <span class="comment">/**</span>
<a name="l00602"></a>00602 <span class="comment"> * @name Ethernet Protocol Translations</span>
<a name="l00603"></a>00603 <span class="comment"> * @{</span>
<a name="l00604"></a>00604 <span class="comment"> */</span>
<a name="l00605"></a>00605 
<a name="l00606"></a>00606 <span class="keyword">static</span> <span class="keyword">struct </span>trans_tbl ether_protos[] = {
<a name="l00607"></a>00607         __ADD(ETH_P_LOOP,loop)
<a name="l00608"></a>00608         __ADD(ETH_P_PUP,pup)
<a name="l00609"></a>00609         __ADD(ETH_P_PUPAT,pupat)
<a name="l00610"></a>00610         __ADD(ETH_P_IP,ip)
<a name="l00611"></a>00611         __ADD(ETH_P_X25,x25)
<a name="l00612"></a>00612         __ADD(ETH_P_ARP,arp)
<a name="l00613"></a>00613         __ADD(ETH_P_BPQ,bpq)
<a name="l00614"></a>00614         __ADD(ETH_P_IEEEPUP,ieeepup)
<a name="l00615"></a>00615         __ADD(ETH_P_IEEEPUPAT,ieeepupat)
<a name="l00616"></a>00616         __ADD(ETH_P_DEC,dec)
<a name="l00617"></a>00617         __ADD(ETH_P_DNA_DL,dna_dl)
<a name="l00618"></a>00618         __ADD(ETH_P_DNA_RC,dna_rc)
<a name="l00619"></a>00619         __ADD(ETH_P_DNA_RT,dna_rt)
<a name="l00620"></a>00620         __ADD(ETH_P_LAT,lat)
<a name="l00621"></a>00621         __ADD(ETH_P_DIAG,diag)
<a name="l00622"></a>00622         __ADD(ETH_P_CUST,cust)
<a name="l00623"></a>00623         __ADD(ETH_P_SCA,sca)
<a name="l00624"></a>00624         __ADD(ETH_P_RARP,rarp)
<a name="l00625"></a>00625         __ADD(ETH_P_ATALK,atalk)
<a name="l00626"></a>00626         __ADD(ETH_P_AARP,aarp)
<a name="l00627"></a>00627 <span class="preprocessor">#ifdef ETH_P_8021Q</span>
<a name="l00628"></a>00628 <span class="preprocessor"></span>        __ADD(ETH_P_8021Q,802.1q)
<a name="l00629"></a>00629 <span class="preprocessor">#endif</span>
<a name="l00630"></a>00630 <span class="preprocessor"></span>        __ADD(ETH_P_IPX,ipx)
<a name="l00631"></a>00631         __ADD(ETH_P_IPV6,ipv6)
<a name="l00632"></a>00632 <span class="preprocessor">#ifdef ETH_P_WCCP</span>
<a name="l00633"></a>00633 <span class="preprocessor"></span>        __ADD(ETH_P_WCCP,wccp)
<a name="l00634"></a>00634 <span class="preprocessor">#endif</span>
<a name="l00635"></a>00635 <span class="preprocessor"></span>        __ADD(ETH_P_PPP_DISC,ppp_disc)
<a name="l00636"></a>00636         __ADD(ETH_P_PPP_SES,ppp_ses)
<a name="l00637"></a>00637         __ADD(ETH_P_MPLS_UC,mpls_uc)
<a name="l00638"></a>00638         __ADD(ETH_P_MPLS_MC,mpls_mc)
<a name="l00639"></a>00639         __ADD(ETH_P_ATMMPOA,atmmpoa)
<a name="l00640"></a>00640         __ADD(ETH_P_ATMFATE,atmfate)
<a name="l00641"></a>00641         __ADD(ETH_P_EDP2,edp2)
<a name="l00642"></a>00642         __ADD(ETH_P_802_3,802.3)
<a name="l00643"></a>00643         __ADD(ETH_P_AX25,ax25)
<a name="l00644"></a>00644         __ADD(ETH_P_ALL,all)
<a name="l00645"></a>00645         __ADD(ETH_P_802_2,802.2)
<a name="l00646"></a>00646         __ADD(ETH_P_SNAP,snap)
<a name="l00647"></a>00647         __ADD(ETH_P_DDCMP,ddcmp)
<a name="l00648"></a>00648         __ADD(ETH_P_WAN_PPP,wan_ppp)
<a name="l00649"></a>00649         __ADD(ETH_P_PPP_MP,ppp_mp)
<a name="l00650"></a>00650         __ADD(ETH_P_LOCALTALK,localtalk)
<a name="l00651"></a>00651         __ADD(ETH_P_PPPTALK,ppptalk)
<a name="l00652"></a>00652         __ADD(ETH_P_TR_802_2,tr_802.2)
<a name="l00653"></a>00653         __ADD(ETH_P_MOBITEX,mobitex)
<a name="l00654"></a>00654         __ADD(ETH_P_CONTROL,control)
<a name="l00655"></a>00655         __ADD(ETH_P_IRDA,irda)
<a name="l00656"></a>00656         __ADD(ETH_P_ECONET,econet)
<a name="l00657"></a>00657         __ADD(ETH_P_HDLC,hdlc)
<a name="l00658"></a>00658 };
<a name="l00659"></a>00659 
<a name="l00660"></a>00660 <span class="keywordtype">char</span> *nl_ether_proto2str(<span class="keywordtype">int</span> eproto, <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> len)
<a name="l00661"></a>00661 {
<a name="l00662"></a>00662         <span class="keywordflow">return</span> __type2str(eproto, buf, len, ether_protos,
<a name="l00663"></a>00663                             ARRAY_SIZE(ether_protos));
<a name="l00664"></a>00664 }
<a name="l00665"></a>00665 
<a name="l00666"></a>00666 <span class="keywordtype">int</span> nl_str2ether_proto(<span class="keyword">const</span> <span class="keywordtype">char</span> *name)
<a name="l00667"></a>00667 {
<a name="l00668"></a>00668         <span class="keywordflow">return</span> __str2type(name, ether_protos, ARRAY_SIZE(ether_protos));
<a name="l00669"></a>00669 }
<a name="l00670"></a>00670 <span class="comment"></span>
<a name="l00671"></a>00671 <span class="comment">/** @} */</span>
<a name="l00672"></a>00672 <span class="comment"></span>
<a name="l00673"></a>00673 <span class="comment">/**</span>
<a name="l00674"></a>00674 <span class="comment"> * @name IP Protocol Translations</span>
<a name="l00675"></a>00675 <span class="comment"> * @{</span>
<a name="l00676"></a>00676 <span class="comment"> */</span>
<a name="l00677"></a>00677 
<a name="l00678"></a>00678 <span class="keywordtype">char</span> *nl_ip_proto2str(<span class="keywordtype">int</span> proto, <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> len)
<a name="l00679"></a>00679 {
<a name="l00680"></a>00680         <span class="keyword">struct </span>protoent *p = getprotobynumber(proto);
<a name="l00681"></a>00681 
<a name="l00682"></a>00682         <span class="keywordflow">if</span> (p) {
<a name="l00683"></a>00683                 snprintf(buf, len, <span class="stringliteral">&quot;%s&quot;</span>, p-&gt;p_name);
<a name="l00684"></a>00684                 <span class="keywordflow">return</span> buf;
<a name="l00685"></a>00685         }
<a name="l00686"></a>00686 
<a name="l00687"></a>00687         snprintf(buf, len, <span class="stringliteral">&quot;0x%x&quot;</span>, proto);
<a name="l00688"></a>00688         <span class="keywordflow">return</span> buf;
<a name="l00689"></a>00689 }
<a name="l00690"></a>00690 
<a name="l00691"></a>00691 <span class="keywordtype">int</span> nl_str2ip_proto(<span class="keyword">const</span> <span class="keywordtype">char</span> *name)
<a name="l00692"></a>00692 {
<a name="l00693"></a>00693         <span class="keyword">struct </span>protoent *p = getprotobyname(name);
<a name="l00694"></a>00694         <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> l;
<a name="l00695"></a>00695         <span class="keywordtype">char</span> *end;
<a name="l00696"></a>00696 
<a name="l00697"></a>00697         <span class="keywordflow">if</span> (p)
<a name="l00698"></a>00698                 <span class="keywordflow">return</span> p-&gt;p_proto;
<a name="l00699"></a>00699 
<a name="l00700"></a>00700         l = strtoul(name, &amp;end, 0);
<a name="l00701"></a>00701         <span class="keywordflow">if</span> (l == ULONG_MAX || *end != <span class="charliteral">&#39;\0&#39;</span>)
<a name="l00702"></a>00702                 <span class="keywordflow">return</span> -1;
<a name="l00703"></a>00703 
<a name="l00704"></a>00704         <span class="keywordflow">return</span> (<span class="keywordtype">int</span>) l;
<a name="l00705"></a>00705 }
<a name="l00706"></a>00706 <span class="comment"></span>
<a name="l00707"></a>00707 <span class="comment">/** @} */</span>
<a name="l00708"></a>00708 <span class="comment"></span>
<a name="l00709"></a>00709 <span class="comment">/**</span>
<a name="l00710"></a>00710 <span class="comment"> * @name Dumping Helpers</span>
<a name="l00711"></a>00711 <span class="comment"> * @{</span>
<a name="l00712"></a>00712 <span class="comment"> */</span>
<a name="l00713"></a>00713 <span class="comment"></span>
<a name="l00714"></a>00714 <span class="comment">/**</span>
<a name="l00715"></a>00715 <span class="comment"> * Handle a new line while dumping</span>
<a name="l00716"></a>00716 <span class="comment"> * @arg params          Dumping parameters</span>
<a name="l00717"></a>00717 <span class="comment"> * @arg line            Number of lines dumped already.</span>
<a name="l00718"></a>00718 <span class="comment"> *</span>
<a name="l00719"></a>00719 <span class="comment"> * This function must be called before dumping any onto a</span>
<a name="l00720"></a>00720 <span class="comment"> * new line. It will ensure proper prefixing as specified</span>
<a name="l00721"></a>00721 <span class="comment"> * by the dumping parameters.</span>
<a name="l00722"></a>00722 <span class="comment"> *</span>
<a name="l00723"></a>00723 <span class="comment"> * @note This function will NOT dump any newlines itself</span>
<a name="l00724"></a>00724 <span class="comment"> */</span>
<a name="l00725"></a><a class="code" href="group__utils.html#ga8d036ba05aa233203e8d7fb79f925c2c">00725</a> <span class="keywordtype">void</span> <a class="code" href="group__utils.html#ga8d036ba05aa233203e8d7fb79f925c2c" title="Handle a new line while dumping.">nl_new_line</a>(<span class="keyword">struct</span> <a class="code" href="structnl__dump__params.html" title="Dumping parameters.">nl_dump_params</a> *params, <span class="keywordtype">int</span> line)
<a name="l00726"></a>00726 {
<a name="l00727"></a>00727         <span class="keywordflow">if</span> (params-&gt;<a class="code" href="structnl__dump__params.html#a6fd1500e450689a268d89b1ee20311cc" title="Specifies the number of whitespaces to be put in front of every new line (indentation).">dp_prefix</a>) {
<a name="l00728"></a>00728                 <span class="keywordtype">int</span> i;
<a name="l00729"></a>00729                 <span class="keywordflow">for</span> (i = 0; i &lt; params-&gt;<a class="code" href="structnl__dump__params.html#a6fd1500e450689a268d89b1ee20311cc" title="Specifies the number of whitespaces to be put in front of every new line (indentation).">dp_prefix</a>; i++) {
<a name="l00730"></a>00730                         <span class="keywordflow">if</span> (params-&gt;<a class="code" href="structnl__dump__params.html#afe6d9b7154f8f6a4fa9469e859f1f652" title="File descriptor the dumping output should go to.">dp_fd</a>)
<a name="l00731"></a>00731                                 fprintf(params-&gt;<a class="code" href="structnl__dump__params.html#afe6d9b7154f8f6a4fa9469e859f1f652" title="File descriptor the dumping output should go to.">dp_fd</a>, <span class="stringliteral">&quot; &quot;</span>);
<a name="l00732"></a>00732                         <span class="keywordflow">else</span> <span class="keywordflow">if</span> (params-&gt;<a class="code" href="structnl__dump__params.html#ad069c751442fcf74c9f1bf25f0f5af92" title="Alternatively the output may be redirected into a buffer.">dp_buf</a>)
<a name="l00733"></a>00733                                 strncat(params-&gt;<a class="code" href="structnl__dump__params.html#ad069c751442fcf74c9f1bf25f0f5af92" title="Alternatively the output may be redirected into a buffer.">dp_buf</a>, <span class="stringliteral">&quot; &quot;</span>,
<a name="l00734"></a>00734                                         params-&gt;<a class="code" href="structnl__dump__params.html#a63a511bbc4d12484ada704dcfc0818c0" title="Length of the buffer dp_buf.">dp_buflen</a> -
<a name="l00735"></a>00735                                         <span class="keyword">sizeof</span>(params-&gt;<a class="code" href="structnl__dump__params.html#ad069c751442fcf74c9f1bf25f0f5af92" title="Alternatively the output may be redirected into a buffer.">dp_buf</a>) - 1);
<a name="l00736"></a>00736                 }
<a name="l00737"></a>00737         }
<a name="l00738"></a>00738 
<a name="l00739"></a>00739         <span class="keywordflow">if</span> (params-&gt;<a class="code" href="structnl__dump__params.html#abdd722478abe803079e06cfb2a62c6a8" title="A callback invoked for every new line, can be used to customize the indentation.">dp_nl_cb</a>)
<a name="l00740"></a>00740                 params-&gt;<a class="code" href="structnl__dump__params.html#abdd722478abe803079e06cfb2a62c6a8" title="A callback invoked for every new line, can be used to customize the indentation.">dp_nl_cb</a>(params, line);
<a name="l00741"></a>00741 }
<a name="l00742"></a>00742 <span class="comment"></span>
<a name="l00743"></a>00743 <span class="comment">/**</span>
<a name="l00744"></a>00744 <span class="comment"> * Dump a formatted character string</span>
<a name="l00745"></a>00745 <span class="comment"> * @arg params          Dumping parameters</span>
<a name="l00746"></a>00746 <span class="comment"> * @arg fmt             printf style formatting string</span>
<a name="l00747"></a>00747 <span class="comment"> * @arg ...             Arguments to formatting string</span>
<a name="l00748"></a>00748 <span class="comment"> *</span>
<a name="l00749"></a>00749 <span class="comment"> * Dumps a printf style formatting string to the output device</span>
<a name="l00750"></a>00750 <span class="comment"> * as specified by the dumping parameters.</span>
<a name="l00751"></a>00751 <span class="comment"> */</span>
<a name="l00752"></a><a class="code" href="group__utils.html#ga527075856a5427170865a6f409298cdf">00752</a> <span class="keywordtype">void</span> <a class="code" href="group__utils.html#ga527075856a5427170865a6f409298cdf" title="Dump a formatted character string.">nl_dump</a>(<span class="keyword">struct</span> <a class="code" href="structnl__dump__params.html" title="Dumping parameters.">nl_dump_params</a> *params, <span class="keyword">const</span> <span class="keywordtype">char</span> *fmt, ...)
<a name="l00753"></a>00753 {
<a name="l00754"></a>00754         va_list args;
<a name="l00755"></a>00755 
<a name="l00756"></a>00756         va_start(args, fmt);
<a name="l00757"></a>00757         __dp_dump(params, fmt, args);
<a name="l00758"></a>00758         va_end(args);
<a name="l00759"></a>00759 }
<a name="l00760"></a>00760 <span class="comment"></span>
<a name="l00761"></a>00761 <span class="comment">/** @} */</span>
<a name="l00762"></a>00762 <span class="comment"></span>
<a name="l00763"></a>00763 <span class="comment">/** @} */</span>
</pre></div></div>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Mon Mar 21 2011 for libnl by&#160;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>
</body>
</html>