/usr/share/doc/libnl-doc/html/index.html is in libnl-doc 1.1-8ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 | <!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"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.3.1"/>
<title>libnl: Main Page</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">libnl
 <span id="projectnumber">1.1</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.3.1 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li class="current"><a href="index.html"><span>Main Page</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">libnl Documentation</div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><h1><a class="anchor" id="remarks"></a>
Remarks</h1>
<h2><a class="anchor" id="cache_alloc"></a>
Allocation of Caches</h2>
<p>Almost all subsystem provide a function to allocate a new cache of some form. The function usually looks like this: </p>
<div class="fragment"><div class="line"><span class="keyword">struct </span>nl_cache *<<span class="keywordtype">object</span> name>_alloc_cache(<span class="keyword">struct</span> nl_handle *handle)</div>
</div><!-- fragment --><p>These functions allocate a new cache for the own object type, initializes it properly and updates it to represent the current state of their master, e.g. a link cache would include all links currently configured in the kernel.</p>
<p>Some of the allocation functions may take additional arguments to further specify what will be part of the cache.</p>
<p>All such functions return a newly allocated cache or NULL in case of an error.</p>
<h2><a class="anchor" id="addr"></a>
Setting of Addresses</h2>
<div class="fragment"><div class="line">int <object name>_set_addr(<span class="keyword">struct</span> nl_object *, <span class="keyword">struct</span> nl_addr *)</div>
</div><!-- fragment --><p>All attribute functions avaiable for assigning addresses to objects take a struct nl_addr argument. The provided address object is validated against the address family of the object if known already. The assignment fails if the address families mismatch. In case the address family has not been specified yet, the address family of the new address is elected to be the new requirement.</p>
<p>The function will acquire a new reference on the address object before assignment, the caller is NOT responsible for this.</p>
<p>All functions return 0 on success or a negative error code.</p>
<h2><a class="anchor" id="flags"></a>
Flags to Character StringTranslations</h2>
<p>All functions converting a set of flags to a character string follow the same principles, therefore, the following information applies to all functions convertings flags to a character string and vice versa.</p>
<h3><a class="anchor" id="flags2str"></a>
Flags to Character String</h3>
<div class="fragment"><div class="line"><span class="keywordtype">char</span> *<<span class="keywordtype">object</span> name>_flags2str(<span class="keywordtype">int</span> flags, <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> len)</div>
</div><!-- fragment --> <dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">flags</td><td>Flags. </td></tr>
<tr><td class="paramname">buf</td><td>Destination buffer. </td></tr>
<tr><td class="paramname">len</td><td>Buffer length.</td></tr>
</table>
</dd>
</dl>
<p>Converts the specified flags to a character string separated by commas and stores it in the specified destination buffer.</p>
<dl class="section return"><dt>Returns</dt><dd>The destination buffer</dd></dl>
<h3><a class="anchor" id="str2flags"></a>
Character String to Flags</h3>
<div class="fragment"><div class="line">int <object name>_str2flags(<span class="keyword">const</span> <span class="keywordtype">char</span> *name)</div>
</div><!-- fragment --> <dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>Name of flag.</td></tr>
</table>
</dd>
</dl>
<p>Converts the provided character string specifying a flag to the corresponding numeric value.</p>
<dl class="section return"><dt>Returns</dt><dd>Link flag or a negative value if none was found.</dd></dl>
<h3><a class="anchor" id="type2str"></a>
Type to Character String</h3>
<div class="fragment"><div class="line"><span class="keywordtype">char</span> *<<span class="keywordtype">object</span> name>_<type>2str(<span class="keywordtype">int</span> type, <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> len)</div>
</div><!-- fragment --> <dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>Type as numeric value </td></tr>
<tr><td class="paramname">buf</td><td>Destination buffer. </td></tr>
<tr><td class="paramname">len</td><td>Buffer length.</td></tr>
</table>
</dd>
</dl>
<p>Converts an identifier (type) to a character string and stores it in the specified destination buffer.</p>
<dl class="section return"><dt>Returns</dt><dd>The destination buffer or the type encoded in hexidecimal form if the identifier is unknown.</dd></dl>
<h3><a class="anchor" id="str2type"></a>
Character String to Type</h3>
<div class="fragment"><div class="line">int <object name>_str2<type>(<span class="keyword">const</span> <span class="keywordtype">char</span> *name)</div>
</div><!-- fragment --> <dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>Name of identifier (type).</td></tr>
</table>
</dd>
</dl>
<p>Converts the provided character string specifying a identifier to the corresponding numeric value.</p>
<dl class="section return"><dt>Returns</dt><dd>Identifier as numeric value or a negative value if none was found. </dd></dl>
</div></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Sun May 5 2013 18:30:48 for libnl by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.3.1
</small></address>
</body>
</html>
|