Sophie

Sophie

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

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/route/link.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/route/link.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/route/link.c     Links (Interfaces)</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"> * @ingroup rtnl</span>
<a name="l00014"></a>00014 <span class="comment"> * @defgroup link Links (Interfaces)</span>
<a name="l00015"></a>00015 <span class="comment"> * @brief</span>
<a name="l00016"></a>00016 <span class="comment"> *</span>
<a name="l00017"></a>00017 <span class="comment"> * @par Link Identification</span>
<a name="l00018"></a>00018 <span class="comment"> * A link can be identified by either its interface index or by its</span>
<a name="l00019"></a>00019 <span class="comment"> * name. The kernel favours the interface index but falls back to the</span>
<a name="l00020"></a>00020 <span class="comment"> * interface name if the interface index is lesser-than 0 for kernels</span>
<a name="l00021"></a>00021 <span class="comment"> * &gt;= 2.6.11. Therefore you can request changes without mapping a</span>
<a name="l00022"></a>00022 <span class="comment"> * interface name to the corresponding index first.</span>
<a name="l00023"></a>00023 <span class="comment"> *</span>
<a name="l00024"></a>00024 <span class="comment"> * @par Changeable Attributes</span>
<a name="l00025"></a>00025 <span class="comment"> * @anchor link_changeable</span>
<a name="l00026"></a>00026 <span class="comment"> *  - Link layer address</span>
<a name="l00027"></a>00027 <span class="comment"> *  - Link layer broadcast address</span>
<a name="l00028"></a>00028 <span class="comment"> *  - device mapping (ifmap) (&gt;= 2.6.9)</span>
<a name="l00029"></a>00029 <span class="comment"> *  - MTU (&gt;= 2.6.9)</span>
<a name="l00030"></a>00030 <span class="comment"> *  - Transmission queue length (&gt;= 2.6.9)</span>
<a name="l00031"></a>00031 <span class="comment"> *  - Weight (&gt;= 2.6.9)</span>
<a name="l00032"></a>00032 <span class="comment"> *  - Link name (only via access through interface index) (&gt;= 2.6.9)</span>
<a name="l00033"></a>00033 <span class="comment"> *  - Flags (&gt;= 2.6.9)</span>
<a name="l00034"></a>00034 <span class="comment"> *    - IFF_DEBUG</span>
<a name="l00035"></a>00035 <span class="comment"> *    - IFF_NOTRAILERS</span>
<a name="l00036"></a>00036 <span class="comment"> *    - IFF_NOARP</span>
<a name="l00037"></a>00037 <span class="comment"> *    - IFF_DYNAMIC</span>
<a name="l00038"></a>00038 <span class="comment"> *    - IFF_MULTICAST</span>
<a name="l00039"></a>00039 <span class="comment"> *    - IFF_PORTSEL</span>
<a name="l00040"></a>00040 <span class="comment"> *    - IFF_AUTOMEDIA</span>
<a name="l00041"></a>00041 <span class="comment"> *    - IFF_UP</span>
<a name="l00042"></a>00042 <span class="comment"> *    - IFF_PROMISC</span>
<a name="l00043"></a>00043 <span class="comment"> *    - IFF_ALLMULTI</span>
<a name="l00044"></a>00044 <span class="comment"> *</span>
<a name="l00045"></a>00045 <span class="comment"> * @par Link Flags (linux/if.h)</span>
<a name="l00046"></a>00046 <span class="comment"> * @anchor link_flags</span>
<a name="l00047"></a>00047 <span class="comment"> * @code</span>
<a name="l00048"></a>00048 <span class="comment"> *   IFF_UP            Status of link (up|down)</span>
<a name="l00049"></a>00049 <span class="comment"> *   IFF_BROADCAST     Indicates this link allows broadcasting</span>
<a name="l00050"></a>00050 <span class="comment"> *   IFF_MULTICAST     Indicates this link allows multicasting</span>
<a name="l00051"></a>00051 <span class="comment"> *   IFF_ALLMULTI      Indicates this link is doing multicast routing</span>
<a name="l00052"></a>00052 <span class="comment"> *   IFF_DEBUG         Tell the driver to do debugging (currently unused)</span>
<a name="l00053"></a>00053 <span class="comment"> *   IFF_LOOPBACK      This is the loopback link</span>
<a name="l00054"></a>00054 <span class="comment"> *   IFF_POINTOPOINT   Point-to-point link</span>
<a name="l00055"></a>00055 <span class="comment"> *   IFF_NOARP         Link is unable to perform ARP</span>
<a name="l00056"></a>00056 <span class="comment"> *   IFF_PROMISC       Status of promiscious mode flag</span>
<a name="l00057"></a>00057 <span class="comment"> *   IFF_MASTER        Used by teql</span>
<a name="l00058"></a>00058 <span class="comment"> *   IFF_SLAVE         Used by teql</span>
<a name="l00059"></a>00059 <span class="comment"> *   IFF_PORTSEL       Indicates this link allows port selection</span>
<a name="l00060"></a>00060 <span class="comment"> *   IFF_AUTOMEDIA     Indicates this link selects port automatically</span>
<a name="l00061"></a>00061 <span class="comment"> *   IFF_DYNAMIC       Indicates the address of this link is dynamic</span>
<a name="l00062"></a>00062 <span class="comment"> *   IFF_RUNNING       Link is running and carrier is ok.</span>
<a name="l00063"></a>00063 <span class="comment"> *   IFF_NOTRAILERS    Unused, BSD compat.</span>
<a name="l00064"></a>00064 <span class="comment"> * @endcode</span>
<a name="l00065"></a>00065 <span class="comment"> *</span>
<a name="l00066"></a>00066 <span class="comment"> * @par Notes on IFF_PROMISC and IFF_ALLMULTI flags</span>
<a name="l00067"></a>00067 <span class="comment"> * Although you can query the status of IFF_PROMISC and IFF_ALLMULTI</span>
<a name="l00068"></a>00068 <span class="comment"> * they do not represent the actual state in the kernel but rather</span>
<a name="l00069"></a>00069 <span class="comment"> * whether the flag has been enabled/disabled by userspace. The link</span>
<a name="l00070"></a>00070 <span class="comment"> * may be in promiscious mode even if IFF_PROMISC is not set in a link</span>
<a name="l00071"></a>00071 <span class="comment"> * dump request response because promiscity might be needed by the driver</span>
<a name="l00072"></a>00072 <span class="comment"> * for a period of time.</span>
<a name="l00073"></a>00073 <span class="comment"> *</span>
<a name="l00074"></a>00074 <span class="comment"> * @note The unit of the transmission queue length depends on the</span>
<a name="l00075"></a>00075 <span class="comment"> *       link type, a common unit is \a packets.</span>
<a name="l00076"></a>00076 <span class="comment"> *</span>
<a name="l00077"></a>00077 <span class="comment"> * @par 1) Retrieving information about available links</span>
<a name="l00078"></a>00078 <span class="comment"> * @code</span>
<a name="l00079"></a>00079 <span class="comment"> * // The first step is to retrieve a list of all available interfaces within</span>
<a name="l00080"></a>00080 <span class="comment"> * // the kernel and put them into a cache.</span>
<a name="l00081"></a>00081 <span class="comment"> * struct nl_cache *cache = rtnl_link_alloc_cache(nl_handle);</span>
<a name="l00082"></a>00082 <span class="comment"> *</span>
<a name="l00083"></a>00083 <span class="comment"> * // In a second step, a specific link may be looked up by either interface</span>
<a name="l00084"></a>00084 <span class="comment"> * // index or interface name.</span>
<a name="l00085"></a>00085 <span class="comment"> * struct rtnl_link *link = rtnl_link_get_by_name(cache, &quot;lo&quot;);</span>
<a name="l00086"></a>00086 <span class="comment"> *</span>
<a name="l00087"></a>00087 <span class="comment"> * // rtnl_link_get_by_name() is the short version for translating the</span>
<a name="l00088"></a>00088 <span class="comment"> * // interface name to an interface index first like this:</span>
<a name="l00089"></a>00089 <span class="comment"> * int ifindex = rtnl_link_name2i(cache, &quot;lo&quot;);</span>
<a name="l00090"></a>00090 <span class="comment"> * struct rtnl_link *link = rtnl_link_get(cache, ifindex);</span>
<a name="l00091"></a>00091 <span class="comment"> *</span>
<a name="l00092"></a>00092 <span class="comment"> * // After successful usage, the object must be given back to the cache</span>
<a name="l00093"></a>00093 <span class="comment"> * rtnl_link_put(link);</span>
<a name="l00094"></a>00094 <span class="comment"> * @endcode</span>
<a name="l00095"></a>00095 <span class="comment"> *</span>
<a name="l00096"></a>00096 <span class="comment"> * @par 2) Changing link attributes</span>
<a name="l00097"></a>00097 <span class="comment"> * @code</span>
<a name="l00098"></a>00098 <span class="comment"> * // In order to change any attributes of an existing link, we must allocate</span>
<a name="l00099"></a>00099 <span class="comment"> * // a new link to hold the change requests:</span>
<a name="l00100"></a>00100 <span class="comment"> * struct rtnl_link *request = rtnl_link_alloc();</span>
<a name="l00101"></a>00101 <span class="comment"> *</span>
<a name="l00102"></a>00102 <span class="comment"> * // Now we can go on and specify the attributes we want to change:</span>
<a name="l00103"></a>00103 <span class="comment"> * rtnl_link_set_weight(request, 300);</span>
<a name="l00104"></a>00104 <span class="comment"> * rtnl_link_set_mtu(request, 1360);</span>
<a name="l00105"></a>00105 <span class="comment"> *</span>
<a name="l00106"></a>00106 <span class="comment"> * // We can also shut an interface down administratively</span>
<a name="l00107"></a>00107 <span class="comment"> * rtnl_link_unset_flags(request, rtnl_link_str2flags(&quot;up&quot;));</span>
<a name="l00108"></a>00108 <span class="comment"> *</span>
<a name="l00109"></a>00109 <span class="comment"> * // Actually, we should know which link to change, so let&#39;s look it up</span>
<a name="l00110"></a>00110 <span class="comment"> * struct rtnl_link *old = rtnl_link_get(cache, &quot;eth0&quot;);</span>
<a name="l00111"></a>00111 <span class="comment"> *</span>
<a name="l00112"></a>00112 <span class="comment"> * // Two ways exist to commit this change request, the first one is to</span>
<a name="l00113"></a>00113 <span class="comment"> * // build the required netlink message and send it out in one single</span>
<a name="l00114"></a>00114 <span class="comment"> * // step:</span>
<a name="l00115"></a>00115 <span class="comment"> * rtnl_link_change(nl_handle, old, request);</span>
<a name="l00116"></a>00116 <span class="comment"> *</span>
<a name="l00117"></a>00117 <span class="comment"> * // An alternative way is to build the netlink message and send it</span>
<a name="l00118"></a>00118 <span class="comment"> * // out yourself using nl_send_auto_complete()</span>
<a name="l00119"></a>00119 <span class="comment"> * struct nl_msg *msg = rtnl_link_build_change_request(old, request);</span>
<a name="l00120"></a>00120 <span class="comment"> * nl_send_auto_complete(nl_handle, nlmsg_hdr(msg));</span>
<a name="l00121"></a>00121 <span class="comment"> * nlmsg_free(msg);</span>
<a name="l00122"></a>00122 <span class="comment"> *</span>
<a name="l00123"></a>00123 <span class="comment"> * // Don&#39;t forget to give back the link object ;-&gt;</span>
<a name="l00124"></a>00124 <span class="comment"> * rtnl_link_put(old);</span>
<a name="l00125"></a>00125 <span class="comment"> * @endcode</span>
<a name="l00126"></a>00126 <span class="comment"> *</span>
<a name="l00127"></a>00127 <span class="comment"> * @par 3) Link Type Specific Attributes</span>
<a name="l00128"></a>00128 <span class="comment"> * @code</span>
<a name="l00129"></a>00129 <span class="comment"> * // Some link types offer additional parameters and statistics specific</span>
<a name="l00130"></a>00130 <span class="comment"> * // to their type. F.e. a VLAN link can be configured like this:</span>
<a name="l00131"></a>00131 <span class="comment"> * //</span>
<a name="l00132"></a>00132 <span class="comment"> * // Allocate a new link and set the info type to &quot;vlan&quot;. This is required</span>
<a name="l00133"></a>00133 <span class="comment"> * // to prepare the link to hold vlan specific attributes.</span>
<a name="l00134"></a>00134 <span class="comment"> * struct rtnl_link *request = rtnl_link_alloc();</span>
<a name="l00135"></a>00135 <span class="comment"> * rtnl_link_set_info_type(request, &quot;vlan&quot;);</span>
<a name="l00136"></a>00136 <span class="comment"> *</span>
<a name="l00137"></a>00137 <span class="comment"> * // Now vlan specific attributes can be set:</span>
<a name="l00138"></a>00138 <span class="comment"> * rtnl_link_vlan_set_id(request, 10);</span>
<a name="l00139"></a>00139 <span class="comment"> * rtnl_link_vlan_set_ingress_map(request, 2, 8);</span>
<a name="l00140"></a>00140 <span class="comment"> *</span>
<a name="l00141"></a>00141 <span class="comment"> * // Of course the attributes can also be read, check the info type</span>
<a name="l00142"></a>00142 <span class="comment"> * // to make sure you are using the right access functions:</span>
<a name="l00143"></a>00143 <span class="comment"> * char *type = rtnl_link_get_info_type(link);</span>
<a name="l00144"></a>00144 <span class="comment"> * if (!strcmp(type, &quot;vlan&quot;))</span>
<a name="l00145"></a>00145 <span class="comment"> *      int id = rtnl_link_vlan_get_id(link);</span>
<a name="l00146"></a>00146 <span class="comment"> * @endcode</span>
<a name="l00147"></a>00147 <span class="comment"> * @{</span>
<a name="l00148"></a>00148 <span class="comment"> */</span>
<a name="l00149"></a>00149 
<a name="l00150"></a>00150 <span class="preprocessor">#include &lt;netlink-local.h&gt;</span>
<a name="l00151"></a>00151 <span class="preprocessor">#include &lt;netlink/netlink.h&gt;</span>
<a name="l00152"></a>00152 <span class="preprocessor">#include &lt;netlink/attr.h&gt;</span>
<a name="l00153"></a>00153 <span class="preprocessor">#include &lt;netlink/utils.h&gt;</span>
<a name="l00154"></a>00154 <span class="preprocessor">#include &lt;netlink/object.h&gt;</span>
<a name="l00155"></a>00155 <span class="preprocessor">#include &lt;netlink/route/rtnl.h&gt;</span>
<a name="l00156"></a>00156 <span class="preprocessor">#include &lt;netlink/route/link.h&gt;</span>
<a name="l00157"></a>00157 <span class="preprocessor">#include &lt;netlink/route/link/info-api.h&gt;</span>
<a name="l00158"></a>00158 <span class="comment"></span>
<a name="l00159"></a>00159 <span class="comment">/** @cond SKIP */</span>
<a name="l00160"></a>00160 <span class="preprocessor">#define LINK_ATTR_MTU     0x0001</span>
<a name="l00161"></a>00161 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_LINK    0x0002</span>
<a name="l00162"></a>00162 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_TXQLEN  0x0004</span>
<a name="l00163"></a>00163 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_WEIGHT  0x0008</span>
<a name="l00164"></a>00164 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_MASTER  0x0010</span>
<a name="l00165"></a>00165 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_QDISC   0x0020</span>
<a name="l00166"></a>00166 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_MAP     0x0040</span>
<a name="l00167"></a>00167 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_ADDR    0x0080</span>
<a name="l00168"></a>00168 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_BRD     0x0100</span>
<a name="l00169"></a>00169 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_FLAGS   0x0200</span>
<a name="l00170"></a>00170 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_IFNAME  0x0400</span>
<a name="l00171"></a>00171 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_IFINDEX 0x0800</span>
<a name="l00172"></a>00172 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_FAMILY  0x1000</span>
<a name="l00173"></a>00173 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_ARPTYPE 0x2000</span>
<a name="l00174"></a>00174 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_STATS   0x4000</span>
<a name="l00175"></a>00175 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_CHANGE  0x8000</span>
<a name="l00176"></a>00176 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_OPERSTATE 0x10000</span>
<a name="l00177"></a>00177 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_LINKMODE  0x20000</span>
<a name="l00178"></a>00178 <span class="preprocessor"></span><span class="preprocessor">#define LINK_ATTR_LINKINFO  0x40000</span>
<a name="l00179"></a>00179 <span class="preprocessor"></span>
<a name="l00180"></a>00180 <span class="keyword">static</span> <span class="keyword">struct </span><a class="code" href="structnl__cache__ops.html" title="Cache Operations.">nl_cache_ops</a> rtnl_link_ops;
<a name="l00181"></a>00181 <span class="keyword">static</span> <span class="keyword">struct </span><a class="code" href="structnl__object__ops.html" title="Object Operations.">nl_object_ops</a> link_obj_ops;<span class="comment"></span>
<a name="l00182"></a>00182 <span class="comment">/** @endcond */</span>
<a name="l00183"></a>00183 
<a name="l00184"></a>00184 <span class="keyword">static</span> <span class="keywordtype">void</span> release_link_info(<span class="keyword">struct</span> rtnl_link *link)
<a name="l00185"></a>00185 {
<a name="l00186"></a>00186         <span class="keyword">struct </span><a class="code" href="structrtnl__link__info__ops.html" title="Link info operations.">rtnl_link_info_ops</a> *io = link-&gt;l_info_ops;
<a name="l00187"></a>00187 
<a name="l00188"></a>00188         <span class="keywordflow">if</span> (io != NULL) {
<a name="l00189"></a>00189                 io-&gt;<a class="code" href="structrtnl__link__info__ops.html#a6c5d7e6ae5b7e0f0d632ef82aa1ea38b" title="Reference count (internal, do not use)">io_refcnt</a>--;
<a name="l00190"></a>00190                 io-&gt;<a class="code" href="structrtnl__link__info__ops.html#affa25bd9bfeb93b22a56a7d57ffea5a2" title="Called to release all resources previously allocated in either io_alloc() or io_parse().">io_free</a>(link);
<a name="l00191"></a>00191                 link-&gt;l_info_ops = NULL;
<a name="l00192"></a>00192         }
<a name="l00193"></a>00193 }
<a name="l00194"></a>00194 
<a name="l00195"></a>00195 <span class="keyword">static</span> <span class="keywordtype">void</span> link_free_data(<span class="keyword">struct</span> nl_object *c)
<a name="l00196"></a>00196 {
<a name="l00197"></a>00197         <span class="keyword">struct </span>rtnl_link *link = nl_object_priv(c);
<a name="l00198"></a>00198 
<a name="l00199"></a>00199         <span class="keywordflow">if</span> (link) {
<a name="l00200"></a>00200                 <span class="keyword">struct </span><a class="code" href="structrtnl__link__info__ops.html" title="Link info operations.">rtnl_link_info_ops</a> *io;
<a name="l00201"></a>00201 
<a name="l00202"></a>00202                 <span class="keywordflow">if</span> ((io = link-&gt;l_info_ops) != NULL)
<a name="l00203"></a>00203                         release_link_info(link);
<a name="l00204"></a>00204 
<a name="l00205"></a>00205                 nl_addr_put(link-&gt;l_addr);
<a name="l00206"></a>00206                 nl_addr_put(link-&gt;l_bcast);
<a name="l00207"></a>00207         }
<a name="l00208"></a>00208 }
<a name="l00209"></a>00209 
<a name="l00210"></a>00210 <span class="keyword">static</span> <span class="keywordtype">int</span> link_clone(<span class="keyword">struct</span> nl_object *_dst, <span class="keyword">struct</span> nl_object *_src)
<a name="l00211"></a>00211 {
<a name="l00212"></a>00212         <span class="keyword">struct </span>rtnl_link *dst = nl_object_priv(_dst);
<a name="l00213"></a>00213         <span class="keyword">struct </span>rtnl_link *src = nl_object_priv(_src);
<a name="l00214"></a>00214         <span class="keywordtype">int</span> err;
<a name="l00215"></a>00215 
<a name="l00216"></a>00216         <span class="keywordflow">if</span> (src-&gt;l_addr)
<a name="l00217"></a>00217                 <span class="keywordflow">if</span> (!(dst-&gt;l_addr = <a class="code" href="group__addr.html#ga40b37a1ccec7acf84d868e588e516cba" title="Clone existing abstract address object.">nl_addr_clone</a>(src-&gt;l_addr)))
<a name="l00218"></a>00218                         <span class="keywordflow">goto</span> errout;
<a name="l00219"></a>00219 
<a name="l00220"></a>00220         <span class="keywordflow">if</span> (src-&gt;l_bcast)
<a name="l00221"></a>00221                 <span class="keywordflow">if</span> (!(dst-&gt;l_bcast = <a class="code" href="group__addr.html#ga40b37a1ccec7acf84d868e588e516cba" title="Clone existing abstract address object.">nl_addr_clone</a>(src-&gt;l_bcast)))
<a name="l00222"></a>00222                         <span class="keywordflow">goto</span> errout;
<a name="l00223"></a>00223 
<a name="l00224"></a>00224         <span class="keywordflow">if</span> (src-&gt;l_info_ops &amp;&amp; src-&gt;l_info_ops-&gt;io_clone) {
<a name="l00225"></a>00225                 err = src-&gt;l_info_ops-&gt;io_clone(dst, src);
<a name="l00226"></a>00226                 <span class="keywordflow">if</span> (err &lt; 0)
<a name="l00227"></a>00227                         <span class="keywordflow">goto</span> errout;
<a name="l00228"></a>00228         }
<a name="l00229"></a>00229 
<a name="l00230"></a>00230         <span class="keywordflow">return</span> 0;
<a name="l00231"></a>00231 errout:
<a name="l00232"></a>00232         <span class="keywordflow">return</span> nl_get_errno();
<a name="l00233"></a>00233 }
<a name="l00234"></a>00234 
<a name="l00235"></a>00235 <span class="keyword">static</span> <span class="keyword">struct </span><a class="code" href="structnla__policy.html" title="attribute validation policy">nla_policy</a> link_policy[IFLA_MAX+1] = {
<a name="l00236"></a>00236         [IFLA_IFNAME]   = { .<a class="code" href="structnla__policy.html#aaa36c9d1e298fc9e4ee16a8fb553b32a" title="Type of attribute or NLA_UNSPEC.">type</a> = <a class="code" href="group__attr.html#gga06fc87d81c62e9abb8790b6e5713c55ba284d1eafd6d5d99cedaff3cd5f5a8378" title="character string">NLA_STRING</a>,
<a name="l00237"></a>00237                             .maxlen = IFNAMSIZ },
<a name="l00238"></a>00238         [IFLA_MTU]      = { .type = <a class="code" href="group__attr.html#gga06fc87d81c62e9abb8790b6e5713c55babddb836025b456b06b025c293bff6dc8" title="32bit integer">NLA_U32</a> },
<a name="l00239"></a>00239         [IFLA_TXQLEN]   = { .type = <a class="code" href="group__attr.html#gga06fc87d81c62e9abb8790b6e5713c55babddb836025b456b06b025c293bff6dc8" title="32bit integer">NLA_U32</a> },
<a name="l00240"></a>00240         [IFLA_LINK]     = { .type = <a class="code" href="group__attr.html#gga06fc87d81c62e9abb8790b6e5713c55babddb836025b456b06b025c293bff6dc8" title="32bit integer">NLA_U32</a> },
<a name="l00241"></a>00241         [IFLA_WEIGHT]   = { .type = <a class="code" href="group__attr.html#gga06fc87d81c62e9abb8790b6e5713c55babddb836025b456b06b025c293bff6dc8" title="32bit integer">NLA_U32</a> },
<a name="l00242"></a>00242         [IFLA_MASTER]   = { .type = <a class="code" href="group__attr.html#gga06fc87d81c62e9abb8790b6e5713c55babddb836025b456b06b025c293bff6dc8" title="32bit integer">NLA_U32</a> },
<a name="l00243"></a>00243         [IFLA_OPERSTATE]= { .type = <a class="code" href="group__attr.html#gga06fc87d81c62e9abb8790b6e5713c55ba5e9fb615f67cd1b0232f82f978d76b39" title="8bit integer">NLA_U8</a> },
<a name="l00244"></a>00244         [IFLA_LINKMODE] = { .type = <a class="code" href="group__attr.html#gga06fc87d81c62e9abb8790b6e5713c55ba5e9fb615f67cd1b0232f82f978d76b39" title="8bit integer">NLA_U8</a> },
<a name="l00245"></a>00245         [IFLA_LINKINFO] = { .type = <a class="code" href="group__attr.html#gga06fc87d81c62e9abb8790b6e5713c55ba925c06a260a9ffaef80ee4aa13738e19" title="nested attributes">NLA_NESTED</a> },
<a name="l00246"></a>00246         [IFLA_QDISC]    = { .type = <a class="code" href="group__attr.html#gga06fc87d81c62e9abb8790b6e5713c55ba284d1eafd6d5d99cedaff3cd5f5a8378" title="character string">NLA_STRING</a>,
<a name="l00247"></a>00247                             .maxlen = IFQDISCSIZ },
<a name="l00248"></a>00248         [IFLA_STATS]    = { .minlen = <span class="keyword">sizeof</span>(<span class="keyword">struct </span>rtnl_link_stats) },
<a name="l00249"></a>00249         [IFLA_MAP]      = { .minlen = <span class="keyword">sizeof</span>(<span class="keyword">struct </span>rtnl_link_ifmap) },
<a name="l00250"></a>00250 };
<a name="l00251"></a>00251 
<a name="l00252"></a>00252 <span class="keyword">static</span> <span class="keyword">struct </span><a class="code" href="structnla__policy.html" title="attribute validation policy">nla_policy</a> link_info_policy[IFLA_INFO_MAX+1] = {
<a name="l00253"></a>00253         [IFLA_INFO_KIND]        = { .<a class="code" href="structnla__policy.html#aaa36c9d1e298fc9e4ee16a8fb553b32a" title="Type of attribute or NLA_UNSPEC.">type</a> = <a class="code" href="group__attr.html#gga06fc87d81c62e9abb8790b6e5713c55ba284d1eafd6d5d99cedaff3cd5f5a8378" title="character string">NLA_STRING</a> },
<a name="l00254"></a>00254         [IFLA_INFO_DATA]        = { .type = <a class="code" href="group__attr.html#gga06fc87d81c62e9abb8790b6e5713c55ba925c06a260a9ffaef80ee4aa13738e19" title="nested attributes">NLA_NESTED</a> },
<a name="l00255"></a>00255         [IFLA_INFO_XSTATS]      = { .type = <a class="code" href="group__attr.html#gga06fc87d81c62e9abb8790b6e5713c55ba925c06a260a9ffaef80ee4aa13738e19" title="nested attributes">NLA_NESTED</a> },
<a name="l00256"></a>00256 };
<a name="l00257"></a>00257 
<a name="l00258"></a>00258 <span class="keyword">static</span> <span class="keywordtype">int</span> link_msg_parser(<span class="keyword">struct</span> <a class="code" href="structnl__cache__ops.html" title="Cache Operations.">nl_cache_ops</a> *ops, <span class="keyword">struct</span> <a class="code" href="structsockaddr__nl.html" title="Netlink socket address.">sockaddr_nl</a> *who,
<a name="l00259"></a>00259                            <span class="keyword">struct</span> <a class="code" href="structnlmsghdr.html" title="Netlink message header.">nlmsghdr</a> *n, <span class="keyword">struct</span> <a class="code" href="structnl__parser__param.html">nl_parser_param</a> *pp)
<a name="l00260"></a>00260 {
<a name="l00261"></a>00261         <span class="keyword">struct </span>rtnl_link *link;
<a name="l00262"></a>00262         <span class="keyword">struct </span>ifinfomsg *ifi;
<a name="l00263"></a>00263         <span class="keyword">struct </span>nlattr *tb[IFLA_MAX+1];
<a name="l00264"></a>00264         <span class="keywordtype">int</span> err;
<a name="l00265"></a>00265 
<a name="l00266"></a>00266         link = rtnl_link_alloc();
<a name="l00267"></a>00267         <span class="keywordflow">if</span> (link == NULL) {
<a name="l00268"></a>00268                 err = nl_errno(ENOMEM);
<a name="l00269"></a>00269                 <span class="keywordflow">goto</span> errout;
<a name="l00270"></a>00270         }
<a name="l00271"></a>00271                 
<a name="l00272"></a>00272         link-&gt;ce_msgtype = n-&gt;<a class="code" href="structnlmsghdr.html#a7232c4e6cb513010e64887b7eebf8823" title="Message type (content type)">nlmsg_type</a>;
<a name="l00273"></a>00273 
<a name="l00274"></a>00274         err = <a class="code" href="group__msg.html#ga2671eefe95c3e44dec8ddab51ae57593" title="parse attributes of a netlink message">nlmsg_parse</a>(n, <span class="keyword">sizeof</span>(*ifi), tb, IFLA_MAX, link_policy);
<a name="l00275"></a>00275         <span class="keywordflow">if</span> (err &lt; 0)
<a name="l00276"></a>00276                 <span class="keywordflow">goto</span> errout;
<a name="l00277"></a>00277 
<a name="l00278"></a>00278         <span class="keywordflow">if</span> (tb[IFLA_IFNAME] == NULL) {
<a name="l00279"></a>00279                 err = nl_error(EINVAL, <span class="stringliteral">&quot;Missing link name TLV&quot;</span>);
<a name="l00280"></a>00280                 <span class="keywordflow">goto</span> errout;
<a name="l00281"></a>00281         }
<a name="l00282"></a>00282 
<a name="l00283"></a>00283         <a class="code" href="group__attr.html#gaabddc8018334423d84088d241b4b7830" title="Copy string attribute payload into a sized buffer.">nla_strlcpy</a>(link-&gt;l_name, tb[IFLA_IFNAME], IFNAMSIZ);
<a name="l00284"></a>00284 
<a name="l00285"></a>00285         ifi = <a class="code" href="group__msg.html#gae44a904bb40c8b5f5ff31539c21cfa5a" title="head of message payload">nlmsg_data</a>(n);
<a name="l00286"></a>00286         link-&gt;l_family = ifi-&gt;ifi_family;
<a name="l00287"></a>00287         link-&gt;l_arptype = ifi-&gt;ifi_type;
<a name="l00288"></a>00288         link-&gt;l_index = ifi-&gt;ifi_index;
<a name="l00289"></a>00289         link-&gt;l_flags = ifi-&gt;ifi_flags;
<a name="l00290"></a>00290         link-&gt;l_change = ifi-&gt;ifi_change;
<a name="l00291"></a>00291         link-&gt;ce_mask = (LINK_ATTR_IFNAME | LINK_ATTR_FAMILY |
<a name="l00292"></a>00292                           LINK_ATTR_ARPTYPE| LINK_ATTR_IFINDEX |
<a name="l00293"></a>00293                           LINK_ATTR_FLAGS | LINK_ATTR_CHANGE);
<a name="l00294"></a>00294 
<a name="l00295"></a>00295         <span class="keywordflow">if</span> (tb[IFLA_STATS]) {
<a name="l00296"></a>00296                 <span class="keyword">struct </span>rtnl_link_stats *st = <a class="code" href="group__attr.html#gaf39d6bbd2be1fc2de30b6b7d079a5fce" title="head of payload">nla_data</a>(tb[IFLA_STATS]);
<a name="l00297"></a>00297                 
<a name="l00298"></a>00298                 link-&gt;l_stats[RTNL_LINK_RX_PACKETS]     = st-&gt;rx_packets;
<a name="l00299"></a>00299                 link-&gt;l_stats[RTNL_LINK_RX_BYTES]       = st-&gt;rx_bytes;
<a name="l00300"></a>00300                 link-&gt;l_stats[RTNL_LINK_RX_ERRORS]      = st-&gt;rx_errors;
<a name="l00301"></a>00301                 link-&gt;l_stats[RTNL_LINK_RX_DROPPED]     = st-&gt;rx_dropped;
<a name="l00302"></a>00302                 link-&gt;l_stats[RTNL_LINK_RX_COMPRESSED]  = st-&gt;rx_compressed;
<a name="l00303"></a>00303                 link-&gt;l_stats[RTNL_LINK_RX_FIFO_ERR]    = st-&gt;rx_fifo_errors;
<a name="l00304"></a>00304                 link-&gt;l_stats[RTNL_LINK_TX_PACKETS]     = st-&gt;tx_packets;
<a name="l00305"></a>00305                 link-&gt;l_stats[RTNL_LINK_TX_BYTES]       = st-&gt;tx_bytes;
<a name="l00306"></a>00306                 link-&gt;l_stats[RTNL_LINK_TX_ERRORS]      = st-&gt;tx_errors;
<a name="l00307"></a>00307                 link-&gt;l_stats[RTNL_LINK_TX_DROPPED]     = st-&gt;tx_dropped;
<a name="l00308"></a>00308                 link-&gt;l_stats[RTNL_LINK_TX_COMPRESSED]  = st-&gt;tx_compressed;
<a name="l00309"></a>00309                 link-&gt;l_stats[RTNL_LINK_TX_FIFO_ERR]    = st-&gt;tx_fifo_errors;
<a name="l00310"></a>00310                 link-&gt;l_stats[RTNL_LINK_RX_LEN_ERR]     = st-&gt;rx_length_errors;
<a name="l00311"></a>00311                 link-&gt;l_stats[RTNL_LINK_RX_OVER_ERR]    = st-&gt;rx_over_errors;
<a name="l00312"></a>00312                 link-&gt;l_stats[RTNL_LINK_RX_CRC_ERR]     = st-&gt;rx_crc_errors;
<a name="l00313"></a>00313                 link-&gt;l_stats[RTNL_LINK_RX_FRAME_ERR]   = st-&gt;rx_frame_errors;
<a name="l00314"></a>00314                 link-&gt;l_stats[RTNL_LINK_RX_MISSED_ERR]  = st-&gt;rx_missed_errors;
<a name="l00315"></a>00315                 link-&gt;l_stats[RTNL_LINK_TX_ABORT_ERR]   = st-&gt;tx_aborted_errors;
<a name="l00316"></a>00316                 link-&gt;l_stats[RTNL_LINK_TX_CARRIER_ERR] = st-&gt;tx_carrier_errors;
<a name="l00317"></a>00317                 link-&gt;l_stats[RTNL_LINK_TX_HBEAT_ERR]   = st-&gt;tx_heartbeat_errors;
<a name="l00318"></a>00318                 link-&gt;l_stats[RTNL_LINK_TX_WIN_ERR]     = st-&gt;tx_window_errors;
<a name="l00319"></a>00319                 link-&gt;l_stats[RTNL_LINK_MULTICAST]      = st-&gt;multicast;
<a name="l00320"></a>00320 
<a name="l00321"></a>00321                 link-&gt;ce_mask |= LINK_ATTR_STATS;
<a name="l00322"></a>00322         }
<a name="l00323"></a>00323 
<a name="l00324"></a>00324         <span class="keywordflow">if</span> (tb[IFLA_TXQLEN]) {
<a name="l00325"></a>00325                 link-&gt;l_txqlen = <a class="code" href="group__attr.html#gabda0290a8b26cc577c2c5cefa814aeac" title="Return payload of u32 attribute.">nla_get_u32</a>(tb[IFLA_TXQLEN]);
<a name="l00326"></a>00326                 link-&gt;ce_mask |= LINK_ATTR_TXQLEN;
<a name="l00327"></a>00327         }
<a name="l00328"></a>00328 
<a name="l00329"></a>00329         <span class="keywordflow">if</span> (tb[IFLA_MTU]) {
<a name="l00330"></a>00330                 link-&gt;l_mtu = <a class="code" href="group__attr.html#gabda0290a8b26cc577c2c5cefa814aeac" title="Return payload of u32 attribute.">nla_get_u32</a>(tb[IFLA_MTU]);
<a name="l00331"></a>00331                 link-&gt;ce_mask |= LINK_ATTR_MTU;
<a name="l00332"></a>00332         }
<a name="l00333"></a>00333 
<a name="l00334"></a>00334         <span class="keywordflow">if</span> (tb[IFLA_ADDRESS]) {
<a name="l00335"></a>00335                 link-&gt;l_addr = <a class="code" href="group__attr.html#ga98a5ac1eefea9266cf46c91b9a9867f3" title="Return payload of address attribute.">nla_get_addr</a>(tb[IFLA_ADDRESS], AF_UNSPEC);
<a name="l00336"></a>00336                 <span class="keywordflow">if</span> (link-&gt;l_addr == NULL)
<a name="l00337"></a>00337                         <span class="keywordflow">goto</span> errout;
<a name="l00338"></a>00338                 nl_addr_set_family(link-&gt;l_addr,
<a name="l00339"></a>00339                                    <a class="code" href="group__addr.html#gaff2e98f656a046a29c561db403a8ec82" title="Guess address family of an abstract address object based on address size.">nl_addr_guess_family</a>(link-&gt;l_addr));
<a name="l00340"></a>00340                 link-&gt;ce_mask |= LINK_ATTR_ADDR;
<a name="l00341"></a>00341         }
<a name="l00342"></a>00342 
<a name="l00343"></a>00343         <span class="keywordflow">if</span> (tb[IFLA_BROADCAST]) {
<a name="l00344"></a>00344                 link-&gt;l_bcast = <a class="code" href="group__attr.html#ga98a5ac1eefea9266cf46c91b9a9867f3" title="Return payload of address attribute.">nla_get_addr</a>(tb[IFLA_BROADCAST], AF_UNSPEC);
<a name="l00345"></a>00345                 <span class="keywordflow">if</span> (link-&gt;l_bcast == NULL)
<a name="l00346"></a>00346                         <span class="keywordflow">goto</span> errout;
<a name="l00347"></a>00347                 nl_addr_set_family(link-&gt;l_bcast,
<a name="l00348"></a>00348                                    <a class="code" href="group__addr.html#gaff2e98f656a046a29c561db403a8ec82" title="Guess address family of an abstract address object based on address size.">nl_addr_guess_family</a>(link-&gt;l_bcast));
<a name="l00349"></a>00349                 link-&gt;ce_mask |= LINK_ATTR_BRD;
<a name="l00350"></a>00350         }
<a name="l00351"></a>00351 
<a name="l00352"></a>00352         <span class="keywordflow">if</span> (tb[IFLA_LINK]) {
<a name="l00353"></a>00353                 link-&gt;l_link = <a class="code" href="group__attr.html#gabda0290a8b26cc577c2c5cefa814aeac" title="Return payload of u32 attribute.">nla_get_u32</a>(tb[IFLA_LINK]);
<a name="l00354"></a>00354                 link-&gt;ce_mask |= LINK_ATTR_LINK;
<a name="l00355"></a>00355         }
<a name="l00356"></a>00356 
<a name="l00357"></a>00357         <span class="keywordflow">if</span> (tb[IFLA_WEIGHT]) {
<a name="l00358"></a>00358                 link-&gt;l_weight = <a class="code" href="group__attr.html#gabda0290a8b26cc577c2c5cefa814aeac" title="Return payload of u32 attribute.">nla_get_u32</a>(tb[IFLA_WEIGHT]);
<a name="l00359"></a>00359                 link-&gt;ce_mask |= LINK_ATTR_WEIGHT;
<a name="l00360"></a>00360         }
<a name="l00361"></a>00361 
<a name="l00362"></a>00362         <span class="keywordflow">if</span> (tb[IFLA_QDISC]) {
<a name="l00363"></a>00363                 <a class="code" href="group__attr.html#gaabddc8018334423d84088d241b4b7830" title="Copy string attribute payload into a sized buffer.">nla_strlcpy</a>(link-&gt;l_qdisc, tb[IFLA_QDISC], IFQDISCSIZ);
<a name="l00364"></a>00364                 link-&gt;ce_mask |= LINK_ATTR_QDISC;
<a name="l00365"></a>00365         }
<a name="l00366"></a>00366 
<a name="l00367"></a>00367         <span class="keywordflow">if</span> (tb[IFLA_MAP]) {
<a name="l00368"></a>00368                 <a class="code" href="group__attr.html#gaf2cdaf473a1054b9c3fc735ca7275403" title="Copy a netlink attribute into another memory area.">nla_memcpy</a>(&amp;link-&gt;l_map, tb[IFLA_MAP], 
<a name="l00369"></a>00369                            <span class="keyword">sizeof</span>(<span class="keyword">struct</span> rtnl_link_ifmap));
<a name="l00370"></a>00370                 link-&gt;ce_mask |= LINK_ATTR_MAP;
<a name="l00371"></a>00371         }
<a name="l00372"></a>00372 
<a name="l00373"></a>00373         <span class="keywordflow">if</span> (tb[IFLA_MASTER]) {
<a name="l00374"></a>00374                 link-&gt;l_master = <a class="code" href="group__attr.html#gabda0290a8b26cc577c2c5cefa814aeac" title="Return payload of u32 attribute.">nla_get_u32</a>(tb[IFLA_MASTER]);
<a name="l00375"></a>00375                 link-&gt;ce_mask |= LINK_ATTR_MASTER;
<a name="l00376"></a>00376         }
<a name="l00377"></a>00377 
<a name="l00378"></a>00378         <span class="keywordflow">if</span> (tb[IFLA_OPERSTATE]) {
<a name="l00379"></a>00379                 link-&gt;l_operstate = <a class="code" href="group__attr.html#ga9ca4618a38f1567b1e42b1f21be887c9" title="Return payload of u8 attribute.">nla_get_u8</a>(tb[IFLA_OPERSTATE]);
<a name="l00380"></a>00380                 link-&gt;ce_mask |= LINK_ATTR_OPERSTATE;
<a name="l00381"></a>00381         }
<a name="l00382"></a>00382 
<a name="l00383"></a>00383         <span class="keywordflow">if</span> (tb[IFLA_LINKMODE]) {
<a name="l00384"></a>00384                 link-&gt;l_linkmode = <a class="code" href="group__attr.html#ga9ca4618a38f1567b1e42b1f21be887c9" title="Return payload of u8 attribute.">nla_get_u8</a>(tb[IFLA_LINKMODE]);
<a name="l00385"></a>00385                 link-&gt;ce_mask |= LINK_ATTR_LINKMODE;
<a name="l00386"></a>00386         }
<a name="l00387"></a>00387 
<a name="l00388"></a>00388         <span class="keywordflow">if</span> (tb[IFLA_LINKINFO]) {
<a name="l00389"></a>00389                 <span class="keyword">struct </span>nlattr *li[IFLA_INFO_MAX+1];
<a name="l00390"></a>00390 
<a name="l00391"></a>00391                 err = <a class="code" href="group__attr.html#ga974ec0720b2d863a5c65da868bcb7a6e" title="parse nested attributes">nla_parse_nested</a>(li, IFLA_INFO_MAX, tb[IFLA_LINKINFO],
<a name="l00392"></a>00392                                        link_info_policy);
<a name="l00393"></a>00393                 <span class="keywordflow">if</span> (err &lt; 0)
<a name="l00394"></a>00394                         <span class="keywordflow">goto</span> errout;
<a name="l00395"></a>00395 
<a name="l00396"></a>00396                 <span class="keywordflow">if</span> (li[IFLA_INFO_KIND] &amp;&amp;
<a name="l00397"></a>00397                     (li[IFLA_INFO_DATA] || li[IFLA_INFO_XSTATS])) {
<a name="l00398"></a>00398                         <span class="keyword">struct </span><a class="code" href="structrtnl__link__info__ops.html" title="Link info operations.">rtnl_link_info_ops</a> *ops;
<a name="l00399"></a>00399                         <span class="keywordtype">char</span> *kind;
<a name="l00400"></a>00400 
<a name="l00401"></a>00401                         kind = <a class="code" href="group__attr.html#ga99baaa7c85d04eaece8f5eea34d8e2e9" title="return payload of string attribute">nla_get_string</a>(li[IFLA_INFO_KIND]);
<a name="l00402"></a>00402                         ops = rtnl_link_info_ops_lookup(kind);
<a name="l00403"></a>00403                         <span class="keywordflow">if</span> (ops != NULL) {
<a name="l00404"></a>00404                                 ops-&gt;<a class="code" href="structrtnl__link__info__ops.html#a6c5d7e6ae5b7e0f0d632ef82aa1ea38b" title="Reference count (internal, do not use)">io_refcnt</a>++;
<a name="l00405"></a>00405                                 link-&gt;l_info_ops = ops;
<a name="l00406"></a>00406                                 err = ops-&gt;<a class="code" href="structrtnl__link__info__ops.html#a715f8a89c4acb5ece999bbeff4594cfb" title="Called to parse the link info attribute.">io_parse</a>(link, li[IFLA_INFO_DATA],
<a name="l00407"></a>00407                                                     li[IFLA_INFO_XSTATS]);
<a name="l00408"></a>00408                                 <span class="keywordflow">if</span> (err &lt; 0)
<a name="l00409"></a>00409                                         <span class="keywordflow">goto</span> errout;
<a name="l00410"></a>00410                         } <span class="keywordflow">else</span> {
<a name="l00411"></a>00411                                 <span class="comment">/* XXX: Warn about unparsed info? */</span>
<a name="l00412"></a>00412                         }
<a name="l00413"></a>00413                 }
<a name="l00414"></a>00414         }
<a name="l00415"></a>00415 
<a name="l00416"></a>00416         err = pp-&gt;pp_cb((<span class="keyword">struct</span> nl_object *) link, pp);
<a name="l00417"></a>00417         <span class="keywordflow">if</span> (err &lt; 0)
<a name="l00418"></a>00418                 <span class="keywordflow">goto</span> errout;
<a name="l00419"></a>00419 
<a name="l00420"></a>00420         err = P_ACCEPT;
<a name="l00421"></a>00421 
<a name="l00422"></a>00422 errout:
<a name="l00423"></a>00423         rtnl_link_put(link);
<a name="l00424"></a>00424         <span class="keywordflow">return</span> err;
<a name="l00425"></a>00425 }
<a name="l00426"></a>00426 
<a name="l00427"></a>00427 <span class="keyword">static</span> <span class="keywordtype">int</span> link_request_update(<span class="keyword">struct</span> nl_cache *c, <span class="keyword">struct</span> nl_handle *h)
<a name="l00428"></a>00428 {
<a name="l00429"></a>00429         <span class="keywordflow">return</span> <a class="code" href="group__rtnl.html#ga1fcd1a88d7f810c50849f13d97b5fe10" title="Send routing netlink request message.">nl_rtgen_request</a>(h, RTM_GETLINK, AF_UNSPEC, <a class="code" href="group__msg.html#ga8d4fb2458c013decb6673f41c52c07b1" title="Dump all entries.">NLM_F_DUMP</a>);
<a name="l00430"></a>00430 }
<a name="l00431"></a>00431 
<a name="l00432"></a>00432 <span class="keyword">static</span> <span class="keywordtype">int</span> link_dump_brief(<span class="keyword">struct</span> nl_object *obj, <span class="keyword">struct</span> <a class="code" href="structnl__dump__params.html" title="Dumping parameters.">nl_dump_params</a> *p)
<a name="l00433"></a>00433 {
<a name="l00434"></a>00434         <span class="keywordtype">char</span> buf[128];
<a name="l00435"></a>00435         <span class="keyword">struct </span>nl_cache *cache = dp_cache(obj);
<a name="l00436"></a>00436         <span class="keyword">struct </span>rtnl_link *link = (<span class="keyword">struct </span>rtnl_link *) obj;
<a name="l00437"></a>00437         <span class="keywordtype">int</span> line = 1;
<a name="l00438"></a>00438 
<a name="l00439"></a>00439         dp_dump(p, <span class="stringliteral">&quot;%s %s &quot;</span>, link-&gt;l_name,
<a name="l00440"></a>00440                              nl_llproto2str(link-&gt;l_arptype, buf, <span class="keyword">sizeof</span>(buf)));
<a name="l00441"></a>00441 
<a name="l00442"></a>00442         <span class="keywordflow">if</span> (link-&gt;l_addr &amp;&amp; !<a class="code" href="group__addr.html#ga5ca21cacd97bd78ac00319a181f4b628" title="Returns true if the address consists of all zeros.">nl_addr_iszero</a>(link-&gt;l_addr))
<a name="l00443"></a>00443                 dp_dump(p, <span class="stringliteral">&quot;%s &quot;</span>, <a class="code" href="group__addr.html#ga6471f04b9fa8ef1d4af1bf2b87b49529" title="Convert abstract address object to character string.">nl_addr2str</a>(link-&gt;l_addr, buf, <span class="keyword">sizeof</span>(buf)));
<a name="l00444"></a>00444 
<a name="l00445"></a>00445         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_MASTER) {
<a name="l00446"></a>00446                 <span class="keyword">struct </span>rtnl_link *master = <a class="code" href="group__link.html#ga2a3657b69c47c9e3ab809cac73bf0986" title="Look up link by interface index in the provided cache.">rtnl_link_get</a>(cache, link-&gt;l_master);
<a name="l00447"></a>00447                 dp_dump(p, <span class="stringliteral">&quot;master %s &quot;</span>, master ? master-&gt;l_name : <span class="stringliteral">&quot;inv&quot;</span>);
<a name="l00448"></a>00448                 <span class="keywordflow">if</span> (master)
<a name="l00449"></a>00449                         rtnl_link_put(master);
<a name="l00450"></a>00450         }
<a name="l00451"></a>00451 
<a name="l00452"></a>00452         rtnl_link_flags2str(link-&gt;l_flags, buf, <span class="keyword">sizeof</span>(buf));
<a name="l00453"></a>00453         <span class="keywordflow">if</span> (buf[0])
<a name="l00454"></a>00454                 dp_dump(p, <span class="stringliteral">&quot;&lt;%s&gt; &quot;</span>, buf);
<a name="l00455"></a>00455 
<a name="l00456"></a>00456         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_LINK) {
<a name="l00457"></a>00457                 <span class="keyword">struct </span>rtnl_link *ll = <a class="code" href="group__link.html#ga2a3657b69c47c9e3ab809cac73bf0986" title="Look up link by interface index in the provided cache.">rtnl_link_get</a>(cache, link-&gt;l_link);
<a name="l00458"></a>00458                 dp_dump(p, <span class="stringliteral">&quot;slave-of %s &quot;</span>, ll ? ll-&gt;l_name : <span class="stringliteral">&quot;NONE&quot;</span>);
<a name="l00459"></a>00459                 <span class="keywordflow">if</span> (ll)
<a name="l00460"></a>00460                         rtnl_link_put(ll);
<a name="l00461"></a>00461         }
<a name="l00462"></a>00462 
<a name="l00463"></a>00463         <span class="keywordflow">if</span> (link-&gt;l_info_ops &amp;&amp; link-&gt;l_info_ops-&gt;io_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9a5597887c080d5ecae358b6065a4048fd" title="Dump object in a brief one-liner.">NL_DUMP_BRIEF</a>])
<a name="l00464"></a>00464                 line = link-&gt;l_info_ops-&gt;io_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9a5597887c080d5ecae358b6065a4048fd" title="Dump object in a brief one-liner.">NL_DUMP_BRIEF</a>](link, p, line);
<a name="l00465"></a>00465 
<a name="l00466"></a>00466         dp_dump(p, <span class="stringliteral">&quot;\n&quot;</span>);
<a name="l00467"></a>00467 
<a name="l00468"></a>00468         <span class="keywordflow">return</span> line;
<a name="l00469"></a>00469 }
<a name="l00470"></a>00470 
<a name="l00471"></a>00471 <span class="keyword">static</span> <span class="keywordtype">int</span> link_dump_full(<span class="keyword">struct</span> nl_object *obj, <span class="keyword">struct</span> <a class="code" href="structnl__dump__params.html" title="Dumping parameters.">nl_dump_params</a> *p)
<a name="l00472"></a>00472 {
<a name="l00473"></a>00473         <span class="keyword">struct </span>rtnl_link *link = (<span class="keyword">struct </span>rtnl_link *) obj;
<a name="l00474"></a>00474         <span class="keywordtype">char</span> buf[64];
<a name="l00475"></a>00475         <span class="keywordtype">int</span> line;
<a name="l00476"></a>00476 
<a name="l00477"></a>00477         line = link_dump_brief(obj, p);
<a name="l00478"></a>00478         dp_new_line(p, line++);
<a name="l00479"></a>00479 
<a name="l00480"></a>00480         dp_dump(p, <span class="stringliteral">&quot;    mtu %u &quot;</span>, link-&gt;l_mtu);
<a name="l00481"></a>00481         dp_dump(p, <span class="stringliteral">&quot;txqlen %u weight %u &quot;</span>, link-&gt;l_txqlen, link-&gt;l_weight);
<a name="l00482"></a>00482 
<a name="l00483"></a>00483         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_QDISC)
<a name="l00484"></a>00484                 dp_dump(p, <span class="stringliteral">&quot;qdisc %s &quot;</span>, link-&gt;l_qdisc);
<a name="l00485"></a>00485 
<a name="l00486"></a>00486         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_MAP &amp;&amp; link-&gt;l_map.lm_irq)
<a name="l00487"></a>00487                 dp_dump(p, <span class="stringliteral">&quot;irq %u &quot;</span>, link-&gt;l_map.lm_irq);
<a name="l00488"></a>00488 
<a name="l00489"></a>00489         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_IFINDEX)
<a name="l00490"></a>00490                 dp_dump(p, <span class="stringliteral">&quot;index %u &quot;</span>, link-&gt;l_index);
<a name="l00491"></a>00491 
<a name="l00492"></a>00492 
<a name="l00493"></a>00493         dp_dump(p, <span class="stringliteral">&quot;\n&quot;</span>);
<a name="l00494"></a>00494         dp_new_line(p, line++);
<a name="l00495"></a>00495 
<a name="l00496"></a>00496         dp_dump(p, <span class="stringliteral">&quot;    &quot;</span>);
<a name="l00497"></a>00497 
<a name="l00498"></a>00498         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_BRD)
<a name="l00499"></a>00499                 dp_dump(p, <span class="stringliteral">&quot;brd %s &quot;</span>, <a class="code" href="group__addr.html#ga6471f04b9fa8ef1d4af1bf2b87b49529" title="Convert abstract address object to character string.">nl_addr2str</a>(link-&gt;l_bcast, buf,
<a name="l00500"></a>00500                                                    <span class="keyword">sizeof</span>(buf)));
<a name="l00501"></a>00501 
<a name="l00502"></a>00502         <span class="keywordflow">if</span> ((link-&gt;ce_mask &amp; LINK_ATTR_OPERSTATE) &amp;&amp;
<a name="l00503"></a>00503             link-&gt;l_operstate != IF_OPER_UNKNOWN) {
<a name="l00504"></a>00504                 rtnl_link_operstate2str(link-&gt;l_operstate, buf, <span class="keyword">sizeof</span>(buf));
<a name="l00505"></a>00505                 dp_dump(p, <span class="stringliteral">&quot;state %s &quot;</span>, buf);
<a name="l00506"></a>00506         }
<a name="l00507"></a>00507 
<a name="l00508"></a>00508         dp_dump(p, <span class="stringliteral">&quot;mode %s\n&quot;</span>,
<a name="l00509"></a>00509                 rtnl_link_mode2str(link-&gt;l_linkmode, buf, <span class="keyword">sizeof</span>(buf)));
<a name="l00510"></a>00510 
<a name="l00511"></a>00511         <span class="keywordflow">if</span> (link-&gt;l_info_ops &amp;&amp; link-&gt;l_info_ops-&gt;io_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9a1445106c7af529b2c99ee289fbcd3179" title="Dump all attributes but no statistics.">NL_DUMP_FULL</a>])
<a name="l00512"></a>00512                 line = link-&gt;l_info_ops-&gt;io_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9a1445106c7af529b2c99ee289fbcd3179" title="Dump all attributes but no statistics.">NL_DUMP_FULL</a>](link, p, line);
<a name="l00513"></a>00513 
<a name="l00514"></a>00514         <span class="keywordflow">return</span> line;
<a name="l00515"></a>00515 }
<a name="l00516"></a>00516 
<a name="l00517"></a>00517 <span class="keyword">static</span> <span class="keywordtype">int</span> link_dump_stats(<span class="keyword">struct</span> nl_object *obj, <span class="keyword">struct</span> <a class="code" href="structnl__dump__params.html" title="Dumping parameters.">nl_dump_params</a> *p)
<a name="l00518"></a>00518 {
<a name="l00519"></a>00519         <span class="keyword">struct </span>rtnl_link *link = (<span class="keyword">struct </span>rtnl_link *) obj;
<a name="l00520"></a>00520         <span class="keywordtype">char</span> *unit, fmt[64];
<a name="l00521"></a>00521         <span class="keywordtype">float</span> res;
<a name="l00522"></a>00522         <span class="keywordtype">int</span> line;
<a name="l00523"></a>00523         
<a name="l00524"></a>00524         line = link_dump_full(obj, p);
<a name="l00525"></a>00525 
<a name="l00526"></a>00526         dp_dump_line(p, line++, <span class="stringliteral">&quot;    Stats:    bytes    packets     errors &quot;</span>
<a name="l00527"></a>00527                                 <span class="stringliteral">&quot;   dropped   fifo-err compressed\n&quot;</span>);
<a name="l00528"></a>00528 
<a name="l00529"></a>00529         res = <a class="code" href="group__utils.html#ga5a280448ae9e17ff5dc7e822b9f47b11" title="Cancel down a byte counter.">nl_cancel_down_bytes</a>(link-&gt;l_stats[RTNL_LINK_RX_BYTES], &amp;unit);
<a name="l00530"></a>00530 
<a name="l00531"></a>00531         strcpy(fmt, <span class="stringliteral">&quot;    RX  %X.2f %s %10llu %10llu %10llu %10llu %10llu\n&quot;</span>);
<a name="l00532"></a>00532         fmt[9] = *unit == <span class="charliteral">&#39;B&#39;</span> ? <span class="charliteral">&#39;9&#39;</span> : <span class="charliteral">&#39;7&#39;</span>;
<a name="l00533"></a>00533         
<a name="l00534"></a>00534         dp_dump_line(p, line++, fmt,
<a name="l00535"></a>00535                 res, unit,
<a name="l00536"></a>00536                 link-&gt;l_stats[RTNL_LINK_RX_PACKETS],
<a name="l00537"></a>00537                 link-&gt;l_stats[RTNL_LINK_RX_ERRORS],
<a name="l00538"></a>00538                 link-&gt;l_stats[RTNL_LINK_RX_DROPPED],
<a name="l00539"></a>00539                 link-&gt;l_stats[RTNL_LINK_RX_FIFO_ERR],
<a name="l00540"></a>00540                 link-&gt;l_stats[RTNL_LINK_RX_COMPRESSED]);
<a name="l00541"></a>00541 
<a name="l00542"></a>00542         res = <a class="code" href="group__utils.html#ga5a280448ae9e17ff5dc7e822b9f47b11" title="Cancel down a byte counter.">nl_cancel_down_bytes</a>(link-&gt;l_stats[RTNL_LINK_TX_BYTES], &amp;unit);
<a name="l00543"></a>00543 
<a name="l00544"></a>00544         strcpy(fmt, <span class="stringliteral">&quot;    TX  %X.2f %s %10llu %10llu %10llu %10llu %10llu\n&quot;</span>);
<a name="l00545"></a>00545         fmt[9] = *unit == <span class="charliteral">&#39;B&#39;</span> ? <span class="charliteral">&#39;9&#39;</span> : <span class="charliteral">&#39;7&#39;</span>;
<a name="l00546"></a>00546         
<a name="l00547"></a>00547         dp_dump_line(p, line++, fmt,
<a name="l00548"></a>00548                 res, unit,
<a name="l00549"></a>00549                 link-&gt;l_stats[RTNL_LINK_TX_PACKETS],
<a name="l00550"></a>00550                 link-&gt;l_stats[RTNL_LINK_TX_ERRORS],
<a name="l00551"></a>00551                 link-&gt;l_stats[RTNL_LINK_TX_DROPPED],
<a name="l00552"></a>00552                 link-&gt;l_stats[RTNL_LINK_TX_FIFO_ERR],
<a name="l00553"></a>00553                 link-&gt;l_stats[RTNL_LINK_TX_COMPRESSED]);
<a name="l00554"></a>00554 
<a name="l00555"></a>00555         dp_dump_line(p, line++, <span class="stringliteral">&quot;    Errors:  length       over        crc &quot;</span>
<a name="l00556"></a>00556                                 <span class="stringliteral">&quot;     frame     missed  multicast\n&quot;</span>);
<a name="l00557"></a>00557 
<a name="l00558"></a>00558         dp_dump_line(p, line++, <span class="stringliteral">&quot;    RX   %10&quot;</span> PRIu64 <span class="stringliteral">&quot; %10&quot;</span> PRIu64 <span class="stringliteral">&quot; %10&quot;</span>
<a name="l00559"></a>00559                                 PRIu64 <span class="stringliteral">&quot; %10&quot;</span> PRIu64 <span class="stringliteral">&quot; %10&quot;</span> PRIu64 <span class="stringliteral">&quot; %10&quot;</span>
<a name="l00560"></a>00560                                 PRIu64 <span class="stringliteral">&quot;\n&quot;</span>,
<a name="l00561"></a>00561                 link-&gt;l_stats[RTNL_LINK_RX_LEN_ERR],
<a name="l00562"></a>00562                 link-&gt;l_stats[RTNL_LINK_RX_OVER_ERR],
<a name="l00563"></a>00563                 link-&gt;l_stats[RTNL_LINK_RX_CRC_ERR],
<a name="l00564"></a>00564                 link-&gt;l_stats[RTNL_LINK_RX_FRAME_ERR],
<a name="l00565"></a>00565                 link-&gt;l_stats[RTNL_LINK_RX_MISSED_ERR],
<a name="l00566"></a>00566                 link-&gt;l_stats[RTNL_LINK_MULTICAST]);
<a name="l00567"></a>00567 
<a name="l00568"></a>00568         dp_dump_line(p, line++, <span class="stringliteral">&quot;    Errors: aborted    carrier  heartbeat &quot;</span>
<a name="l00569"></a>00569                                 <span class="stringliteral">&quot;    window  collision\n&quot;</span>);
<a name="l00570"></a>00570         
<a name="l00571"></a>00571         dp_dump_line(p, line++, <span class="stringliteral">&quot;    TX   %10&quot;</span> PRIu64 <span class="stringliteral">&quot; %10&quot;</span> PRIu64 <span class="stringliteral">&quot; %10&quot;</span>
<a name="l00572"></a>00572                                 PRIu64 <span class="stringliteral">&quot; %10&quot;</span> PRIu64 <span class="stringliteral">&quot; %10&quot;</span> PRIu64 <span class="stringliteral">&quot;\n&quot;</span>,
<a name="l00573"></a>00573                 link-&gt;l_stats[RTNL_LINK_TX_ABORT_ERR],
<a name="l00574"></a>00574                 link-&gt;l_stats[RTNL_LINK_TX_CARRIER_ERR],
<a name="l00575"></a>00575                 link-&gt;l_stats[RTNL_LINK_TX_HBEAT_ERR],
<a name="l00576"></a>00576                 link-&gt;l_stats[RTNL_LINK_TX_WIN_ERR],
<a name="l00577"></a>00577                 link-&gt;l_stats[RTNL_LINK_TX_COLLISIONS]);
<a name="l00578"></a>00578 
<a name="l00579"></a>00579         <span class="keywordflow">if</span> (link-&gt;l_info_ops &amp;&amp; link-&gt;l_info_ops-&gt;io_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9a8ebedc55094df6175b84fb1230047a65" title="Dump all attributes including statistics.">NL_DUMP_STATS</a>])
<a name="l00580"></a>00580                 line = link-&gt;l_info_ops-&gt;io_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9a8ebedc55094df6175b84fb1230047a65" title="Dump all attributes including statistics.">NL_DUMP_STATS</a>](link, p, line);
<a name="l00581"></a>00581 
<a name="l00582"></a>00582         <span class="keywordflow">return</span> line;
<a name="l00583"></a>00583 }
<a name="l00584"></a>00584 
<a name="l00585"></a>00585 <span class="keyword">static</span> <span class="keywordtype">int</span> link_dump_xml(<span class="keyword">struct</span> nl_object *obj, <span class="keyword">struct</span> <a class="code" href="structnl__dump__params.html" title="Dumping parameters.">nl_dump_params</a> *p)
<a name="l00586"></a>00586 {
<a name="l00587"></a>00587         <span class="keyword">struct </span>rtnl_link *link = (<span class="keyword">struct </span>rtnl_link *) obj;
<a name="l00588"></a>00588         <span class="keyword">struct </span>nl_cache *cache = dp_cache(obj);
<a name="l00589"></a>00589         <span class="keywordtype">char</span> buf[128];
<a name="l00590"></a>00590         <span class="keywordtype">int</span> i, line = 0;
<a name="l00591"></a>00591 
<a name="l00592"></a>00592         dp_dump_line(p, line++, <span class="stringliteral">&quot;&lt;link name=\&quot;%s\&quot; index=\&quot;%u\&quot;&gt;\n&quot;</span>,
<a name="l00593"></a>00593                      link-&gt;l_name, link-&gt;l_index);
<a name="l00594"></a>00594         dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;family&gt;%s&lt;/family&gt;\n&quot;</span>,
<a name="l00595"></a>00595                      nl_af2str(link-&gt;l_family, buf, <span class="keyword">sizeof</span>(buf)));
<a name="l00596"></a>00596         dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;arptype&gt;%s&lt;/arptype&gt;\n&quot;</span>,
<a name="l00597"></a>00597                      nl_llproto2str(link-&gt;l_arptype, buf, <span class="keyword">sizeof</span>(buf)));
<a name="l00598"></a>00598         dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;address&gt;%s&lt;/address&gt;\n&quot;</span>,
<a name="l00599"></a>00599                      <a class="code" href="group__addr.html#ga6471f04b9fa8ef1d4af1bf2b87b49529" title="Convert abstract address object to character string.">nl_addr2str</a>(link-&gt;l_addr, buf, <span class="keyword">sizeof</span>(buf)));
<a name="l00600"></a>00600         dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;mtu&gt;%u&lt;/mtu&gt;\n&quot;</span>, link-&gt;l_mtu);
<a name="l00601"></a>00601         dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;txqlen&gt;%u&lt;/txqlen&gt;\n&quot;</span>, link-&gt;l_txqlen);
<a name="l00602"></a>00602         dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;weight&gt;%u&lt;/weight&gt;\n&quot;</span>, link-&gt;l_weight);
<a name="l00603"></a>00603 
<a name="l00604"></a>00604         rtnl_link_flags2str(link-&gt;l_flags, buf, <span class="keyword">sizeof</span>(buf));
<a name="l00605"></a>00605         <span class="keywordflow">if</span> (buf[0])
<a name="l00606"></a>00606                 dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;flags&gt;%s&lt;/flags&gt;\n&quot;</span>, buf);
<a name="l00607"></a>00607 
<a name="l00608"></a>00608         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_QDISC)
<a name="l00609"></a>00609                 dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;qdisc&gt;%s&lt;/qdisc&gt;\n&quot;</span>, link-&gt;l_qdisc);
<a name="l00610"></a>00610 
<a name="l00611"></a>00611         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_LINK) {
<a name="l00612"></a>00612                 <span class="keyword">struct </span>rtnl_link *ll = <a class="code" href="group__link.html#ga2a3657b69c47c9e3ab809cac73bf0986" title="Look up link by interface index in the provided cache.">rtnl_link_get</a>(cache, link-&gt;l_link);
<a name="l00613"></a>00613                 dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;link&gt;%s&lt;/link&gt;\n&quot;</span>,
<a name="l00614"></a>00614                              ll ? ll-&gt;l_name : <span class="stringliteral">&quot;none&quot;</span>);
<a name="l00615"></a>00615                 <span class="keywordflow">if</span> (ll)
<a name="l00616"></a>00616                         rtnl_link_put(ll);
<a name="l00617"></a>00617         }
<a name="l00618"></a>00618 
<a name="l00619"></a>00619         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_MASTER) {
<a name="l00620"></a>00620                 <span class="keyword">struct </span>rtnl_link *master = <a class="code" href="group__link.html#ga2a3657b69c47c9e3ab809cac73bf0986" title="Look up link by interface index in the provided cache.">rtnl_link_get</a>(cache, link-&gt;l_master);
<a name="l00621"></a>00621                 dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;master&gt;%s&lt;/master&gt;\n&quot;</span>,
<a name="l00622"></a>00622                              master ? master-&gt;l_name : <span class="stringliteral">&quot;none&quot;</span>);
<a name="l00623"></a>00623                 <span class="keywordflow">if</span> (master)
<a name="l00624"></a>00624                         rtnl_link_put(master);
<a name="l00625"></a>00625         }
<a name="l00626"></a>00626 
<a name="l00627"></a>00627         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_BRD)
<a name="l00628"></a>00628                 dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;broadcast&gt;%s&lt;/broadcast&gt;\n&quot;</span>,
<a name="l00629"></a>00629                              <a class="code" href="group__addr.html#ga6471f04b9fa8ef1d4af1bf2b87b49529" title="Convert abstract address object to character string.">nl_addr2str</a>(link-&gt;l_bcast, buf, <span class="keyword">sizeof</span>(buf)));
<a name="l00630"></a>00630 
<a name="l00631"></a>00631         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_STATS) {
<a name="l00632"></a>00632                 dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;stats&gt;\n&quot;</span>);
<a name="l00633"></a>00633                 <span class="keywordflow">for</span> (i = 0; i &lt;= RTNL_LINK_STATS_MAX; i++) {
<a name="l00634"></a>00634                         rtnl_link_stat2str(i, buf, <span class="keyword">sizeof</span>(buf));
<a name="l00635"></a>00635                         dp_dump_line(p, line++,
<a name="l00636"></a>00636                                      <span class="stringliteral">&quot;    &lt;%s&gt;%&quot;</span> PRIu64 <span class="stringliteral">&quot;&lt;/%s&gt;\n&quot;</span>,
<a name="l00637"></a>00637                                      buf, link-&gt;l_stats[i], buf);
<a name="l00638"></a>00638                 }
<a name="l00639"></a>00639                 dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;/stats&gt;\n&quot;</span>);
<a name="l00640"></a>00640         }
<a name="l00641"></a>00641 
<a name="l00642"></a>00642         <span class="keywordflow">if</span> (link-&gt;l_info_ops &amp;&amp; link-&gt;l_info_ops-&gt;io_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9aa5b83654e99e53423c39b0d6e835d768" title="Dump all attribtes in XML format.">NL_DUMP_XML</a>]) {
<a name="l00643"></a>00643                 dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;info&gt;\n&quot;</span>);
<a name="l00644"></a>00644                 line = link-&gt;l_info_ops-&gt;io_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9aa5b83654e99e53423c39b0d6e835d768" title="Dump all attribtes in XML format.">NL_DUMP_XML</a>](link, p, line);
<a name="l00645"></a>00645                 dp_dump_line(p, line++, <span class="stringliteral">&quot;  &lt;/info&gt;\n&quot;</span>);
<a name="l00646"></a>00646         }
<a name="l00647"></a>00647 
<a name="l00648"></a>00648         dp_dump_line(p, line++, <span class="stringliteral">&quot;&lt;/link&gt;\n&quot;</span>);
<a name="l00649"></a>00649 
<a name="l00650"></a>00650 <span class="preprocessor">#if 0</span>
<a name="l00651"></a>00651 <span class="preprocessor"></span>        uint32_t        l_change;       <span class="comment">/**&lt; Change mask */</span>
<a name="l00652"></a>00652         <span class="keyword">struct </span>rtnl_lifmap l_map;       <span class="comment">/**&lt; Interface device mapping */</span>
<a name="l00653"></a>00653 <span class="preprocessor">#endif</span>
<a name="l00654"></a>00654 <span class="preprocessor"></span>
<a name="l00655"></a>00655         <span class="keywordflow">return</span> line;
<a name="l00656"></a>00656 }
<a name="l00657"></a>00657 
<a name="l00658"></a>00658 <span class="keyword">static</span> <span class="keywordtype">int</span> link_dump_env(<span class="keyword">struct</span> nl_object *obj, <span class="keyword">struct</span> <a class="code" href="structnl__dump__params.html" title="Dumping parameters.">nl_dump_params</a> *p)
<a name="l00659"></a>00659 {
<a name="l00660"></a>00660         <span class="keyword">struct </span>rtnl_link *link = (<span class="keyword">struct </span>rtnl_link *) obj;
<a name="l00661"></a>00661         <span class="keyword">struct </span>nl_cache *cache = dp_cache(obj);
<a name="l00662"></a>00662         <span class="keywordtype">char</span> buf[128];
<a name="l00663"></a>00663         <span class="keywordtype">int</span> i, line = 0;
<a name="l00664"></a>00664 
<a name="l00665"></a>00665         dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_NAME=%s\n&quot;</span>, link-&gt;l_name);
<a name="l00666"></a>00666         dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_IFINDEX=%u\n&quot;</span>, link-&gt;l_index);
<a name="l00667"></a>00667         dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_FAMILY=%s\n&quot;</span>,
<a name="l00668"></a>00668                      nl_af2str(link-&gt;l_family, buf, <span class="keyword">sizeof</span>(buf)));
<a name="l00669"></a>00669         dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_TYPE=%s\n&quot;</span>,
<a name="l00670"></a>00670                      nl_llproto2str(link-&gt;l_arptype, buf, <span class="keyword">sizeof</span>(buf)));
<a name="l00671"></a>00671         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_ADDR)
<a name="l00672"></a>00672                 dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_ADDRESS=%s\n&quot;</span>,
<a name="l00673"></a>00673                              <a class="code" href="group__addr.html#ga6471f04b9fa8ef1d4af1bf2b87b49529" title="Convert abstract address object to character string.">nl_addr2str</a>(link-&gt;l_addr, buf, <span class="keyword">sizeof</span>(buf)));
<a name="l00674"></a>00674         dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_MTU=%u\n&quot;</span>, link-&gt;l_mtu);
<a name="l00675"></a>00675         dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_TXQUEUELEN=%u\n&quot;</span>, link-&gt;l_txqlen);
<a name="l00676"></a>00676         dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_WEIGHT=%u\n&quot;</span>, link-&gt;l_weight);
<a name="l00677"></a>00677 
<a name="l00678"></a>00678         rtnl_link_flags2str(link-&gt;l_flags &amp; ~IFF_RUNNING, buf, <span class="keyword">sizeof</span>(buf));
<a name="l00679"></a>00679         <span class="keywordflow">if</span> (buf[0])
<a name="l00680"></a>00680                 dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_FLAGS=%s\n&quot;</span>, buf);
<a name="l00681"></a>00681 
<a name="l00682"></a>00682         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_QDISC)
<a name="l00683"></a>00683                 dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_QDISC=%s\n&quot;</span>, link-&gt;l_qdisc);
<a name="l00684"></a>00684 
<a name="l00685"></a>00685         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_LINK) {
<a name="l00686"></a>00686                 <span class="keyword">struct </span>rtnl_link *ll = <a class="code" href="group__link.html#ga2a3657b69c47c9e3ab809cac73bf0986" title="Look up link by interface index in the provided cache.">rtnl_link_get</a>(cache, link-&gt;l_link);
<a name="l00687"></a>00687 
<a name="l00688"></a>00688                 dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_LINK_IFINDEX=%d\n&quot;</span>, link-&gt;l_link);
<a name="l00689"></a>00689                 <span class="keywordflow">if</span> (ll) {
<a name="l00690"></a>00690                         dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_LINK_IFNAME=%s\n&quot;</span>,
<a name="l00691"></a>00691                                      ll-&gt;l_name);
<a name="l00692"></a>00692                         rtnl_link_put(ll);
<a name="l00693"></a>00693                 }
<a name="l00694"></a>00694         }
<a name="l00695"></a>00695 
<a name="l00696"></a>00696         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_MASTER) {
<a name="l00697"></a>00697                 <span class="keyword">struct </span>rtnl_link *master = <a class="code" href="group__link.html#ga2a3657b69c47c9e3ab809cac73bf0986" title="Look up link by interface index in the provided cache.">rtnl_link_get</a>(cache, link-&gt;l_master);
<a name="l00698"></a>00698                 dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_MASTER=%s\n&quot;</span>,
<a name="l00699"></a>00699                              master ? master-&gt;l_name : <span class="stringliteral">&quot;none&quot;</span>);
<a name="l00700"></a>00700                 <span class="keywordflow">if</span> (master)
<a name="l00701"></a>00701                         rtnl_link_put(master);
<a name="l00702"></a>00702         }
<a name="l00703"></a>00703 
<a name="l00704"></a>00704         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_BRD)
<a name="l00705"></a>00705                 dp_dump_line(p, line++, <span class="stringliteral">&quot;LINK_BROADCAST=%s\n&quot;</span>,
<a name="l00706"></a>00706                              <a class="code" href="group__addr.html#ga6471f04b9fa8ef1d4af1bf2b87b49529" title="Convert abstract address object to character string.">nl_addr2str</a>(link-&gt;l_bcast, buf, <span class="keyword">sizeof</span>(buf)));
<a name="l00707"></a>00707 
<a name="l00708"></a>00708         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_STATS) {
<a name="l00709"></a>00709                 <span class="keywordflow">for</span> (i = 0; i &lt;= RTNL_LINK_STATS_MAX; i++) {
<a name="l00710"></a>00710                         <span class="keywordtype">char</span> *c = buf;
<a name="l00711"></a>00711 
<a name="l00712"></a>00712                         sprintf(buf, <span class="stringliteral">&quot;LINK_&quot;</span>);
<a name="l00713"></a>00713                         rtnl_link_stat2str(i, buf + 5, <span class="keyword">sizeof</span>(buf) - 5);
<a name="l00714"></a>00714                         <span class="keywordflow">while</span> (*c) {
<a name="l00715"></a>00715                                 *c = toupper(*c);
<a name="l00716"></a>00716                                 c++;
<a name="l00717"></a>00717                         }
<a name="l00718"></a>00718                         dp_dump_line(p, line++,
<a name="l00719"></a>00719                                      <span class="stringliteral">&quot;%s=%&quot;</span> PRIu64 <span class="stringliteral">&quot;\n&quot;</span>, buf, link-&gt;l_stats[i]);
<a name="l00720"></a>00720                 }
<a name="l00721"></a>00721         }
<a name="l00722"></a>00722 
<a name="l00723"></a>00723         <span class="keywordflow">if</span> (link-&gt;l_info_ops &amp;&amp; link-&gt;l_info_ops-&gt;io_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9a7178b29f7f68857970540f2d1dabbaf1" title="Dump all attribtues as env variables.">NL_DUMP_ENV</a>])
<a name="l00724"></a>00724                 line = link-&gt;l_info_ops-&gt;io_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9a7178b29f7f68857970540f2d1dabbaf1" title="Dump all attribtues as env variables.">NL_DUMP_ENV</a>](link, p, line);
<a name="l00725"></a>00725 
<a name="l00726"></a>00726         <span class="keywordflow">return</span> line;
<a name="l00727"></a>00727 }
<a name="l00728"></a>00728 
<a name="l00729"></a>00729 <span class="preprocessor">#if 0</span>
<a name="l00730"></a>00730 <span class="preprocessor"></span><span class="keyword">static</span> <span class="keywordtype">int</span> link_handle_event(<span class="keyword">struct</span> nl_object *a, <span class="keyword">struct</span> rtnl_link_event_cb *cb)
<a name="l00731"></a>00731 {
<a name="l00732"></a>00732         <span class="keyword">struct </span>rtnl_link *l = (<span class="keyword">struct </span>rtnl_link *) a;
<a name="l00733"></a>00733         <span class="keyword">struct </span>nl_cache *c = dp_cache(a);
<a name="l00734"></a>00734         <span class="keywordtype">int</span> nevents = 0;
<a name="l00735"></a>00735 
<a name="l00736"></a>00736         <span class="keywordflow">if</span> (l-&gt;l_change == ~0U) {
<a name="l00737"></a>00737                 <span class="keywordflow">if</span> (l-&gt;ce_msgtype == RTM_NEWLINK)
<a name="l00738"></a>00738                         cb-&gt;le_register(l);
<a name="l00739"></a>00739                 <span class="keywordflow">else</span>
<a name="l00740"></a>00740                         cb-&gt;le_unregister(l);
<a name="l00741"></a>00741 
<a name="l00742"></a>00742                 <span class="keywordflow">return</span> 1;
<a name="l00743"></a>00743         }
<a name="l00744"></a>00744 
<a name="l00745"></a>00745         <span class="keywordflow">if</span> (l-&gt;l_change &amp; IFF_SLAVE) {
<a name="l00746"></a>00746                 <span class="keywordflow">if</span> (l-&gt;l_flags &amp; IFF_SLAVE) {
<a name="l00747"></a>00747                         <span class="keyword">struct </span>rtnl_link *m = <a class="code" href="group__link.html#ga2a3657b69c47c9e3ab809cac73bf0986" title="Look up link by interface index in the provided cache.">rtnl_link_get</a>(c, l-&gt;l_master);
<a name="l00748"></a>00748                         cb-&gt;le_new_bonding(l, m);
<a name="l00749"></a>00749                         <span class="keywordflow">if</span> (m)
<a name="l00750"></a>00750                                 rtnl_link_put(m);
<a name="l00751"></a>00751                 } <span class="keywordflow">else</span>
<a name="l00752"></a>00752                         cb-&gt;le_cancel_bonding(l);
<a name="l00753"></a>00753         }
<a name="l00754"></a>00754 
<a name="l00755"></a>00755 <span class="preprocessor">#if 0</span>
<a name="l00756"></a>00756 <span class="preprocessor"></span>        <span class="keywordflow">if</span> (l-&gt;l_change &amp; IFF_UP &amp;&amp; l-&gt;l_change &amp; IFF_RUNNING)
<a name="l00757"></a>00757                 dp_dump_line(p, line++, <span class="stringliteral">&quot;link %s changed state to %s.\n&quot;</span>,
<a name="l00758"></a>00758                         l-&gt;l_name, l-&gt;l_flags &amp; IFF_UP ? <span class="stringliteral">&quot;up&quot;</span> : <span class="stringliteral">&quot;down&quot;</span>);
<a name="l00759"></a>00759 
<a name="l00760"></a>00760         <span class="keywordflow">if</span> (l-&gt;l_change &amp; IFF_PROMISC) {
<a name="l00761"></a>00761                 dp_new_line(p, line++);
<a name="l00762"></a>00762                 dp_dump(p, <span class="stringliteral">&quot;link %s %s promiscuous mode.\n&quot;</span>,
<a name="l00763"></a>00763                     l-&gt;l_name, l-&gt;l_flags &amp; IFF_PROMISC ? <span class="stringliteral">&quot;entered&quot;</span> : <span class="stringliteral">&quot;left&quot;</span>);
<a name="l00764"></a>00764         }
<a name="l00765"></a>00765 
<a name="l00766"></a>00766         <span class="keywordflow">if</span> (line == 0)
<a name="l00767"></a>00767                 dp_dump_line(p, line++, <span class="stringliteral">&quot;link %s sent unknown event.\n&quot;</span>,
<a name="l00768"></a>00768                              l-&gt;l_name);
<a name="l00769"></a>00769 <span class="preprocessor">#endif</span>
<a name="l00770"></a>00770 <span class="preprocessor"></span>
<a name="l00771"></a>00771         <span class="keywordflow">return</span> nevents;
<a name="l00772"></a>00772 }
<a name="l00773"></a>00773 <span class="preprocessor">#endif</span>
<a name="l00774"></a>00774 <span class="preprocessor"></span>
<a name="l00775"></a>00775 <span class="keyword">static</span> <span class="keywordtype">int</span> link_compare(<span class="keyword">struct</span> nl_object *_a, <span class="keyword">struct</span> nl_object *_b,
<a name="l00776"></a>00776                         uint32_t attrs, <span class="keywordtype">int</span> flags)
<a name="l00777"></a>00777 {
<a name="l00778"></a>00778         <span class="keyword">struct </span>rtnl_link *a = (<span class="keyword">struct </span>rtnl_link *) _a;
<a name="l00779"></a>00779         <span class="keyword">struct </span>rtnl_link *b = (<span class="keyword">struct </span>rtnl_link *) _b;
<a name="l00780"></a>00780         <span class="keywordtype">int</span> diff = 0;
<a name="l00781"></a>00781 
<a name="l00782"></a>00782 <span class="preprocessor">#define LINK_DIFF(ATTR, EXPR) ATTR_DIFF(attrs, LINK_ATTR_##ATTR, a, b, EXPR)</span>
<a name="l00783"></a>00783 <span class="preprocessor"></span>
<a name="l00784"></a>00784         diff |= LINK_DIFF(IFINDEX,      a-&gt;l_index != b-&gt;l_index);
<a name="l00785"></a>00785         diff |= LINK_DIFF(MTU,          a-&gt;l_mtu != b-&gt;l_mtu);
<a name="l00786"></a>00786         diff |= LINK_DIFF(LINK,         a-&gt;l_link != b-&gt;l_link);
<a name="l00787"></a>00787         diff |= LINK_DIFF(TXQLEN,       a-&gt;l_txqlen != b-&gt;l_txqlen);
<a name="l00788"></a>00788         diff |= LINK_DIFF(WEIGHT,       a-&gt;l_weight != b-&gt;l_weight);
<a name="l00789"></a>00789         diff |= LINK_DIFF(MASTER,       a-&gt;l_master != b-&gt;l_master);
<a name="l00790"></a>00790         diff |= LINK_DIFF(FAMILY,       a-&gt;l_family != b-&gt;l_family);
<a name="l00791"></a>00791         diff |= LINK_DIFF(OPERSTATE,    a-&gt;l_operstate != b-&gt;l_operstate);
<a name="l00792"></a>00792         diff |= LINK_DIFF(LINKMODE,     a-&gt;l_linkmode != b-&gt;l_linkmode);
<a name="l00793"></a>00793         diff |= LINK_DIFF(QDISC,        strcmp(a-&gt;l_qdisc, b-&gt;l_qdisc));
<a name="l00794"></a>00794         diff |= LINK_DIFF(IFNAME,       strcmp(a-&gt;l_name, b-&gt;l_name));
<a name="l00795"></a>00795         diff |= LINK_DIFF(ADDR,         <a class="code" href="group__addr.html#ga3b85d180a4f6d2df86be1dc8798a7d9a" title="Compares two abstract address objects.">nl_addr_cmp</a>(a-&gt;l_addr, b-&gt;l_addr));
<a name="l00796"></a>00796         diff |= LINK_DIFF(BRD,          <a class="code" href="group__addr.html#ga3b85d180a4f6d2df86be1dc8798a7d9a" title="Compares two abstract address objects.">nl_addr_cmp</a>(a-&gt;l_bcast, b-&gt;l_bcast));
<a name="l00797"></a>00797 
<a name="l00798"></a>00798         <span class="keywordflow">if</span> (flags &amp; LOOSE_FLAG_COMPARISON)
<a name="l00799"></a>00799                 diff |= LINK_DIFF(FLAGS,
<a name="l00800"></a>00800                                   (a-&gt;l_flags ^ b-&gt;l_flags) &amp; b-&gt;l_flag_mask);
<a name="l00801"></a>00801         <span class="keywordflow">else</span>
<a name="l00802"></a>00802                 diff |= LINK_DIFF(FLAGS, a-&gt;l_flags != b-&gt;l_flags);
<a name="l00803"></a>00803 
<a name="l00804"></a>00804 <span class="preprocessor">#undef LINK_DIFF</span>
<a name="l00805"></a>00805 <span class="preprocessor"></span>
<a name="l00806"></a>00806         <span class="keywordflow">return</span> diff;
<a name="l00807"></a>00807 }
<a name="l00808"></a>00808 
<a name="l00809"></a>00809 <span class="keyword">static</span> <span class="keyword">struct </span>trans_tbl link_attrs[] = {
<a name="l00810"></a>00810         __ADD(LINK_ATTR_MTU, mtu)
<a name="l00811"></a>00811         __ADD(LINK_ATTR_LINK, link)
<a name="l00812"></a>00812         __ADD(LINK_ATTR_TXQLEN, txqlen)
<a name="l00813"></a>00813         __ADD(LINK_ATTR_WEIGHT, weight)
<a name="l00814"></a>00814         __ADD(LINK_ATTR_MASTER, master)
<a name="l00815"></a>00815         __ADD(LINK_ATTR_QDISC, qdisc)
<a name="l00816"></a>00816         __ADD(LINK_ATTR_MAP, map)
<a name="l00817"></a>00817         __ADD(LINK_ATTR_ADDR, address)
<a name="l00818"></a>00818         __ADD(LINK_ATTR_BRD, broadcast)
<a name="l00819"></a>00819         __ADD(LINK_ATTR_FLAGS, flags)
<a name="l00820"></a>00820         __ADD(LINK_ATTR_IFNAME, name)
<a name="l00821"></a>00821         __ADD(LINK_ATTR_IFINDEX, ifindex)
<a name="l00822"></a>00822         __ADD(LINK_ATTR_FAMILY, family)
<a name="l00823"></a>00823         __ADD(LINK_ATTR_ARPTYPE, arptype)
<a name="l00824"></a>00824         __ADD(LINK_ATTR_STATS, stats)
<a name="l00825"></a>00825         __ADD(LINK_ATTR_CHANGE, change)
<a name="l00826"></a>00826         __ADD(LINK_ATTR_OPERSTATE, operstate)
<a name="l00827"></a>00827         __ADD(LINK_ATTR_LINKMODE, linkmode)
<a name="l00828"></a>00828 };
<a name="l00829"></a>00829 
<a name="l00830"></a>00830 static <span class="keywordtype">char</span> *link_attrs2str(<span class="keywordtype">int</span> attrs, <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> len)
<a name="l00831"></a>00831 {
<a name="l00832"></a>00832         <span class="keywordflow">return</span> __flags2str(attrs, buf, len, link_attrs,
<a name="l00833"></a>00833                            ARRAY_SIZE(link_attrs));
<a name="l00834"></a>00834 }
<a name="l00835"></a>00835 <span class="comment"></span>
<a name="l00836"></a>00836 <span class="comment">/**</span>
<a name="l00837"></a>00837 <span class="comment"> * @name Allocation/Freeing</span>
<a name="l00838"></a>00838 <span class="comment"> * @{</span>
<a name="l00839"></a>00839 <span class="comment"> */</span>
<a name="l00840"></a>00840 
<a name="l00841"></a>00841 <span class="keyword">struct </span>rtnl_link *rtnl_link_alloc(<span class="keywordtype">void</span>)
<a name="l00842"></a>00842 {
<a name="l00843"></a>00843         <span class="keywordflow">return</span> (<span class="keyword">struct</span> rtnl_link *) <a class="code" href="group__object.html#ga9c1f2fd887d8325839f452879cdf982a" title="Allocate a new object of kind specified by the operations handle.">nl_object_alloc</a>(&amp;link_obj_ops);
<a name="l00844"></a>00844 }
<a name="l00845"></a>00845 
<a name="l00846"></a>00846 <span class="keywordtype">void</span> rtnl_link_put(<span class="keyword">struct</span> rtnl_link *link)
<a name="l00847"></a>00847 {
<a name="l00848"></a>00848         <a class="code" href="group__object.html#ga9905da094bf4c03cf4ac78aeaa86a12b" title="Release a reference from an object.">nl_object_put</a>((<span class="keyword">struct</span> nl_object *) link);
<a name="l00849"></a>00849 }
<a name="l00850"></a>00850 <span class="comment"></span>
<a name="l00851"></a>00851 <span class="comment">/** @} */</span>
<a name="l00852"></a>00852 <span class="comment"></span>
<a name="l00853"></a>00853 <span class="comment">/**</span>
<a name="l00854"></a>00854 <span class="comment"> * @name Cache Management</span>
<a name="l00855"></a>00855 <span class="comment"> * @{</span>
<a name="l00856"></a>00856 <span class="comment"> */</span>
<a name="l00857"></a>00857 
<a name="l00858"></a>00858 <span class="comment"></span>
<a name="l00859"></a>00859 <span class="comment">/**</span>
<a name="l00860"></a>00860 <span class="comment"> * Allocate link cache and fill in all configured links.</span>
<a name="l00861"></a>00861 <span class="comment"> * @arg handle          Netlink handle.</span>
<a name="l00862"></a>00862 <span class="comment"> *</span>
<a name="l00863"></a>00863 <span class="comment"> * Allocates a new link cache, initializes it properly and updates it</span>
<a name="l00864"></a>00864 <span class="comment"> * to include all links currently configured in the kernel.</span>
<a name="l00865"></a>00865 <span class="comment"> *</span>
<a name="l00866"></a>00866 <span class="comment"> * @note Free the memory after usage.</span>
<a name="l00867"></a>00867 <span class="comment"> * @return Newly allocated cache or NULL if an error occured.</span>
<a name="l00868"></a>00868 <span class="comment"> */</span>
<a name="l00869"></a><a class="code" href="group__link.html#gaf0d952cc3ca4e787b51f38b2fedfee24">00869</a> <span class="keyword">struct </span>nl_cache *<a class="code" href="group__link.html#gaf0d952cc3ca4e787b51f38b2fedfee24" title="Allocate link cache and fill in all configured links.">rtnl_link_alloc_cache</a>(<span class="keyword">struct</span> nl_handle *handle)
<a name="l00870"></a>00870 {
<a name="l00871"></a>00871         <span class="keyword">struct </span>nl_cache * cache;
<a name="l00872"></a>00872         
<a name="l00873"></a>00873         cache = <a class="code" href="group__cache.html#ga9520ae0f2158db3c081f34c851d92252" title="Allocate an empty cache.">nl_cache_alloc</a>(&amp;rtnl_link_ops);
<a name="l00874"></a>00874         <span class="keywordflow">if</span> (cache == NULL)
<a name="l00875"></a>00875                 <span class="keywordflow">return</span> NULL;
<a name="l00876"></a>00876         
<a name="l00877"></a>00877         <span class="keywordflow">if</span> (handle &amp;&amp; <a class="code" href="group__cache.html#gaf5bd584017847e6ef69ec36739a6aaf0" title="(Re)fill a cache with the contents in the kernel.">nl_cache_refill</a>(handle, cache) &lt; 0) {
<a name="l00878"></a>00878                 <a class="code" href="group__cache.html#ga530c896db26d72001d011114b1e6cfaa" title="Free a cache.">nl_cache_free</a>(cache);
<a name="l00879"></a>00879                 <span class="keywordflow">return</span> NULL;
<a name="l00880"></a>00880         }
<a name="l00881"></a>00881 
<a name="l00882"></a>00882         <span class="keywordflow">return</span> cache;
<a name="l00883"></a>00883 }
<a name="l00884"></a>00884 <span class="comment"></span>
<a name="l00885"></a>00885 <span class="comment">/**</span>
<a name="l00886"></a>00886 <span class="comment"> * Look up link by interface index in the provided cache</span>
<a name="l00887"></a>00887 <span class="comment"> * @arg cache           link cache</span>
<a name="l00888"></a>00888 <span class="comment"> * @arg ifindex         link interface index</span>
<a name="l00889"></a>00889 <span class="comment"> *</span>
<a name="l00890"></a>00890 <span class="comment"> * The caller owns a reference on the returned object and</span>
<a name="l00891"></a>00891 <span class="comment"> * must give the object back via rtnl_link_put().</span>
<a name="l00892"></a>00892 <span class="comment"> *</span>
<a name="l00893"></a>00893 <span class="comment"> * @return pointer to link inside the cache or NULL if no match was found.</span>
<a name="l00894"></a>00894 <span class="comment"> */</span>
<a name="l00895"></a><a class="code" href="group__link.html#ga2a3657b69c47c9e3ab809cac73bf0986">00895</a> <span class="keyword">struct </span>rtnl_link *<a class="code" href="group__link.html#ga2a3657b69c47c9e3ab809cac73bf0986" title="Look up link by interface index in the provided cache.">rtnl_link_get</a>(<span class="keyword">struct</span> nl_cache *cache, <span class="keywordtype">int</span> ifindex)
<a name="l00896"></a>00896 {
<a name="l00897"></a>00897         <span class="keyword">struct </span>rtnl_link *link;
<a name="l00898"></a>00898 
<a name="l00899"></a>00899         <span class="keywordflow">if</span> (cache-&gt;c_ops != &amp;rtnl_link_ops)
<a name="l00900"></a>00900                 <span class="keywordflow">return</span> NULL;
<a name="l00901"></a>00901 
<a name="l00902"></a>00902         nl_list_for_each_entry(link, &amp;cache-&gt;c_items, ce_list) {
<a name="l00903"></a>00903                 <span class="keywordflow">if</span> (link-&gt;l_index == ifindex) {
<a name="l00904"></a>00904                         <a class="code" href="group__object.html#gabd5767ac47ec6f09d1ac643f44eb8bfd" title="Acquire a reference on a object.">nl_object_get</a>((<span class="keyword">struct</span> nl_object *) link);
<a name="l00905"></a>00905                         <span class="keywordflow">return</span> link;
<a name="l00906"></a>00906                 }
<a name="l00907"></a>00907         }
<a name="l00908"></a>00908 
<a name="l00909"></a>00909         <span class="keywordflow">return</span> NULL;
<a name="l00910"></a>00910 }
<a name="l00911"></a>00911 <span class="comment"></span>
<a name="l00912"></a>00912 <span class="comment">/**</span>
<a name="l00913"></a>00913 <span class="comment"> * Look up link by link name in the provided cache</span>
<a name="l00914"></a>00914 <span class="comment"> * @arg cache           link cache</span>
<a name="l00915"></a>00915 <span class="comment"> * @arg name            link name</span>
<a name="l00916"></a>00916 <span class="comment"> *</span>
<a name="l00917"></a>00917 <span class="comment"> * The caller owns a reference on the returned object and</span>
<a name="l00918"></a>00918 <span class="comment"> * must give the object back via rtnl_link_put().</span>
<a name="l00919"></a>00919 <span class="comment"> *</span>
<a name="l00920"></a>00920 <span class="comment"> * @return pointer to link inside the cache or NULL if no match was found.</span>
<a name="l00921"></a>00921 <span class="comment"> */</span>
<a name="l00922"></a><a class="code" href="group__link.html#ga1d583e4f0b43c89d854e5e681a529fad">00922</a> <span class="keyword">struct </span>rtnl_link *<a class="code" href="group__link.html#ga1d583e4f0b43c89d854e5e681a529fad" title="Look up link by link name in the provided cache.">rtnl_link_get_by_name</a>(<span class="keyword">struct</span> nl_cache *cache,
<a name="l00923"></a>00923                                          <span class="keyword">const</span> <span class="keywordtype">char</span> *name)
<a name="l00924"></a>00924 {
<a name="l00925"></a>00925         <span class="keyword">struct </span>rtnl_link *link;
<a name="l00926"></a>00926 
<a name="l00927"></a>00927         <span class="keywordflow">if</span> (cache-&gt;c_ops != &amp;rtnl_link_ops)
<a name="l00928"></a>00928                 <span class="keywordflow">return</span> NULL;
<a name="l00929"></a>00929 
<a name="l00930"></a>00930         nl_list_for_each_entry(link, &amp;cache-&gt;c_items, ce_list) {
<a name="l00931"></a>00931                 <span class="keywordflow">if</span> (!strcmp(name, link-&gt;l_name)) {
<a name="l00932"></a>00932                         <a class="code" href="group__object.html#gabd5767ac47ec6f09d1ac643f44eb8bfd" title="Acquire a reference on a object.">nl_object_get</a>((<span class="keyword">struct</span> nl_object *) link);
<a name="l00933"></a>00933                         <span class="keywordflow">return</span> link;
<a name="l00934"></a>00934                 }
<a name="l00935"></a>00935         }
<a name="l00936"></a>00936 
<a name="l00937"></a>00937         <span class="keywordflow">return</span> NULL;
<a name="l00938"></a>00938 }
<a name="l00939"></a>00939 <span class="comment"></span>
<a name="l00940"></a>00940 <span class="comment">/** @} */</span>
<a name="l00941"></a>00941 <span class="comment"></span>
<a name="l00942"></a>00942 <span class="comment">/**</span>
<a name="l00943"></a>00943 <span class="comment"> * @name Link Modifications</span>
<a name="l00944"></a>00944 <span class="comment"> * @{</span>
<a name="l00945"></a>00945 <span class="comment"> */</span>
<a name="l00946"></a>00946 <span class="comment"></span>
<a name="l00947"></a>00947 <span class="comment">/**</span>
<a name="l00948"></a>00948 <span class="comment"> * Builds a netlink change request message to change link attributes</span>
<a name="l00949"></a>00949 <span class="comment"> * @arg old             link to be changed</span>
<a name="l00950"></a>00950 <span class="comment"> * @arg tmpl            template with requested changes</span>
<a name="l00951"></a>00951 <span class="comment"> * @arg flags           additional netlink message flags</span>
<a name="l00952"></a>00952 <span class="comment"> *</span>
<a name="l00953"></a>00953 <span class="comment"> * Builds a new netlink message requesting a change of link attributes.</span>
<a name="l00954"></a>00954 <span class="comment"> * The netlink message header isn&#39;t fully equipped with all relevant</span>
<a name="l00955"></a>00955 <span class="comment"> * fields and must be sent out via nl_send_auto_complete() or</span>
<a name="l00956"></a>00956 <span class="comment"> * supplemented as needed.</span>
<a name="l00957"></a>00957 <span class="comment"> * \a old must point to a link currently configured in the kernel</span>
<a name="l00958"></a>00958 <span class="comment"> * and \a tmpl must contain the attributes to be changed set via</span>
<a name="l00959"></a>00959 <span class="comment"> * \c rtnl_link_set_* functions.</span>
<a name="l00960"></a>00960 <span class="comment"> *</span>
<a name="l00961"></a>00961 <span class="comment"> * @return New netlink message</span>
<a name="l00962"></a>00962 <span class="comment"> * @note Not all attributes can be changed, see</span>
<a name="l00963"></a>00963 <span class="comment"> *       \ref link_changeable &quot;Changeable Attributes&quot; for more details.</span>
<a name="l00964"></a>00964 <span class="comment"> */</span>
<a name="l00965"></a><a class="code" href="group__link.html#gadb36ec872a4469a3e30a94394f0bad3e">00965</a> <span class="keyword">struct </span>nl_msg * <a class="code" href="group__link.html#gadb36ec872a4469a3e30a94394f0bad3e" title="Builds a netlink change request message to change link attributes.">rtnl_link_build_change_request</a>(<span class="keyword">struct</span> rtnl_link *old,
<a name="l00966"></a>00966                                                <span class="keyword">struct</span> rtnl_link *tmpl,
<a name="l00967"></a>00967                                                <span class="keywordtype">int</span> flags)
<a name="l00968"></a>00968 {
<a name="l00969"></a>00969         <span class="keyword">struct </span>nl_msg *msg;
<a name="l00970"></a>00970         <span class="keyword">struct </span>ifinfomsg ifi = {
<a name="l00971"></a>00971                 .ifi_family = old-&gt;l_family,
<a name="l00972"></a>00972                 .ifi_index = old-&gt;l_index,
<a name="l00973"></a>00973         };
<a name="l00974"></a>00974 
<a name="l00975"></a>00975         <span class="keywordflow">if</span> (tmpl-&gt;ce_mask &amp; LINK_ATTR_FLAGS) {
<a name="l00976"></a>00976                 ifi.ifi_flags = old-&gt;l_flags &amp; ~tmpl-&gt;l_flag_mask;
<a name="l00977"></a>00977                 ifi.ifi_flags |= tmpl-&gt;l_flags;
<a name="l00978"></a>00978         }
<a name="l00979"></a>00979 
<a name="l00980"></a>00980         msg = <a class="code" href="group__msg.html#ga580d8697d19050c55060bc10ab4eae9f" title="Allocate a new netlink message.">nlmsg_alloc_simple</a>(RTM_SETLINK, flags);
<a name="l00981"></a>00981         <span class="keywordflow">if</span> (!msg)
<a name="l00982"></a>00982                 <span class="keywordflow">goto</span> nla_put_failure;
<a name="l00983"></a>00983 
<a name="l00984"></a>00984         <span class="keywordflow">if</span> (<a class="code" href="group__msg.html#gacc5e5ade5675d041f86c7c8693f7088d" title="Append data to tail of a netlink message.">nlmsg_append</a>(msg, &amp;ifi, <span class="keyword">sizeof</span>(ifi), NLMSG_ALIGNTO) &lt; 0)
<a name="l00985"></a>00985                 <span class="keywordflow">goto</span> nla_put_failure;
<a name="l00986"></a>00986 
<a name="l00987"></a>00987         <span class="keywordflow">if</span> (tmpl-&gt;ce_mask &amp; LINK_ATTR_ADDR)
<a name="l00988"></a>00988                 <a class="code" href="group__attr.html#ga34038d75b33942a151a0e91791629a76" title="Add a address attribute to a netlink message.">NLA_PUT_ADDR</a>(msg, IFLA_ADDRESS, tmpl-&gt;l_addr);
<a name="l00989"></a>00989 
<a name="l00990"></a>00990         <span class="keywordflow">if</span> (tmpl-&gt;ce_mask &amp; LINK_ATTR_BRD)
<a name="l00991"></a>00991                 <a class="code" href="group__attr.html#ga34038d75b33942a151a0e91791629a76" title="Add a address attribute to a netlink message.">NLA_PUT_ADDR</a>(msg, IFLA_BROADCAST, tmpl-&gt;l_bcast);
<a name="l00992"></a>00992 
<a name="l00993"></a>00993         <span class="keywordflow">if</span> (tmpl-&gt;ce_mask &amp; LINK_ATTR_MTU)
<a name="l00994"></a>00994                 <a class="code" href="group__attr.html#ga61c87db4b2aa6c7b31e733d1ec684efb" title="Add a u32 netlink attribute to a netlink message.">NLA_PUT_U32</a>(msg, IFLA_MTU, tmpl-&gt;l_mtu);
<a name="l00995"></a>00995 
<a name="l00996"></a>00996         <span class="keywordflow">if</span> (tmpl-&gt;ce_mask &amp; LINK_ATTR_TXQLEN)
<a name="l00997"></a>00997                 <a class="code" href="group__attr.html#ga61c87db4b2aa6c7b31e733d1ec684efb" title="Add a u32 netlink attribute to a netlink message.">NLA_PUT_U32</a>(msg, IFLA_TXQLEN, tmpl-&gt;l_txqlen);
<a name="l00998"></a>00998 
<a name="l00999"></a>00999         <span class="keywordflow">if</span> (tmpl-&gt;ce_mask &amp; LINK_ATTR_WEIGHT)
<a name="l01000"></a>01000                 <a class="code" href="group__attr.html#ga61c87db4b2aa6c7b31e733d1ec684efb" title="Add a u32 netlink attribute to a netlink message.">NLA_PUT_U32</a>(msg, IFLA_WEIGHT, tmpl-&gt;l_weight);
<a name="l01001"></a>01001 
<a name="l01002"></a>01002         <span class="keywordflow">if</span> (tmpl-&gt;ce_mask &amp; LINK_ATTR_IFNAME)
<a name="l01003"></a>01003                 <a class="code" href="group__attr.html#ga7f2397f226e4561d195611572021b714" title="Add a character string netlink attribute to a netlink message.">NLA_PUT_STRING</a>(msg, IFLA_IFNAME, tmpl-&gt;l_name);
<a name="l01004"></a>01004 
<a name="l01005"></a>01005         <span class="keywordflow">if</span> (tmpl-&gt;ce_mask &amp; LINK_ATTR_OPERSTATE)
<a name="l01006"></a>01006                 <a class="code" href="group__attr.html#ga9df4c7be2d17ef301e5218b622bd984d" title="Add a u8 netlink attribute to a netlink message.">NLA_PUT_U8</a>(msg, IFLA_OPERSTATE, tmpl-&gt;l_operstate);
<a name="l01007"></a>01007 
<a name="l01008"></a>01008         <span class="keywordflow">if</span> (tmpl-&gt;ce_mask &amp; LINK_ATTR_LINKMODE)
<a name="l01009"></a>01009                 <a class="code" href="group__attr.html#ga9df4c7be2d17ef301e5218b622bd984d" title="Add a u8 netlink attribute to a netlink message.">NLA_PUT_U8</a>(msg, IFLA_LINKMODE, tmpl-&gt;l_linkmode);
<a name="l01010"></a>01010 
<a name="l01011"></a>01011         <span class="keywordflow">if</span> ((tmpl-&gt;ce_mask &amp; LINK_ATTR_LINKINFO) &amp;&amp; tmpl-&gt;l_info_ops &amp;&amp;
<a name="l01012"></a>01012             tmpl-&gt;l_info_ops-&gt;io_put_attrs) {
<a name="l01013"></a>01013                 <span class="keyword">struct </span>nlattr *info;
<a name="l01014"></a>01014 
<a name="l01015"></a>01015                 <span class="keywordflow">if</span> (!(info = <a class="code" href="group__attr.html#ga18640b6320b8959bb586fa2ca456130c" title="Start a new level of nested attributes.">nla_nest_start</a>(msg, IFLA_LINKINFO)))
<a name="l01016"></a>01016                         <span class="keywordflow">goto</span> nla_put_failure;
<a name="l01017"></a>01017 
<a name="l01018"></a>01018                 <a class="code" href="group__attr.html#ga7f2397f226e4561d195611572021b714" title="Add a character string netlink attribute to a netlink message.">NLA_PUT_STRING</a>(msg, IFLA_INFO_KIND, tmpl-&gt;l_info_ops-&gt;io_name);
<a name="l01019"></a>01019 
<a name="l01020"></a>01020                 <span class="keywordflow">if</span> (tmpl-&gt;l_info_ops-&gt;io_put_attrs(msg, tmpl) &lt; 0)
<a name="l01021"></a>01021                         <span class="keywordflow">goto</span> nla_put_failure;
<a name="l01022"></a>01022 
<a name="l01023"></a>01023                 <a class="code" href="group__attr.html#ga067f9ada74902c02d97c725a47f590b7" title="Finalize nesting of attributes.">nla_nest_end</a>(msg, info);
<a name="l01024"></a>01024         }
<a name="l01025"></a>01025 
<a name="l01026"></a>01026         <span class="keywordflow">return</span> msg;
<a name="l01027"></a>01027 
<a name="l01028"></a>01028 nla_put_failure:
<a name="l01029"></a>01029         <a class="code" href="group__msg.html#ga138ba9bee70553f9fbe7143deacad48c" title="Free a netlink message.">nlmsg_free</a>(msg);
<a name="l01030"></a>01030         <span class="keywordflow">return</span> NULL;
<a name="l01031"></a>01031 }
<a name="l01032"></a>01032 <span class="comment"></span>
<a name="l01033"></a>01033 <span class="comment">/**</span>
<a name="l01034"></a>01034 <span class="comment"> * Change link attributes</span>
<a name="l01035"></a>01035 <span class="comment"> * @arg handle          netlink handle</span>
<a name="l01036"></a>01036 <span class="comment"> * @arg old             link to be changed</span>
<a name="l01037"></a>01037 <span class="comment"> * @arg tmpl            template with requested changes</span>
<a name="l01038"></a>01038 <span class="comment"> * @arg flags           additional netlink message flags</span>
<a name="l01039"></a>01039 <span class="comment"> *</span>
<a name="l01040"></a>01040 <span class="comment"> * Builds a new netlink message by calling rtnl_link_build_change_request(),</span>
<a name="l01041"></a>01041 <span class="comment"> * sends the request to the kernel and waits for the next ACK to be</span>
<a name="l01042"></a>01042 <span class="comment"> * received, i.e. blocks until the request has been processed.</span>
<a name="l01043"></a>01043 <span class="comment"> *</span>
<a name="l01044"></a>01044 <span class="comment"> * @return 0 on success or a negative error code</span>
<a name="l01045"></a>01045 <span class="comment"> * @note Not all attributes can be changed, see</span>
<a name="l01046"></a>01046 <span class="comment"> *       \ref link_changeable &quot;Changeable Attributes&quot; for more details.</span>
<a name="l01047"></a>01047 <span class="comment"> */</span>
<a name="l01048"></a><a class="code" href="group__link.html#ga9ea11f67fcc1d3c75fdac1fcf860fa64">01048</a> <span class="keywordtype">int</span> <a class="code" href="group__link.html#ga9ea11f67fcc1d3c75fdac1fcf860fa64" title="Change link attributes.">rtnl_link_change</a>(<span class="keyword">struct</span> nl_handle *handle, <span class="keyword">struct</span> rtnl_link *old,
<a name="l01049"></a>01049                      <span class="keyword">struct</span> rtnl_link *tmpl, <span class="keywordtype">int</span> flags)
<a name="l01050"></a>01050 {
<a name="l01051"></a>01051         <span class="keywordtype">int</span> err;
<a name="l01052"></a>01052         <span class="keyword">struct </span>nl_msg *msg;
<a name="l01053"></a>01053         
<a name="l01054"></a>01054         msg = <a class="code" href="group__link.html#gadb36ec872a4469a3e30a94394f0bad3e" title="Builds a netlink change request message to change link attributes.">rtnl_link_build_change_request</a>(old, tmpl, flags);
<a name="l01055"></a>01055         <span class="keywordflow">if</span> (!msg)
<a name="l01056"></a>01056                 <span class="keywordflow">return</span> nl_errno(ENOMEM);
<a name="l01057"></a>01057         
<a name="l01058"></a>01058         err = <a class="code" href="group__nl.html#ga01a2aad82350f867e704d5c696438b60" title="Send netlink message and check &amp;amp; extend header values as needed.">nl_send_auto_complete</a>(handle, msg);
<a name="l01059"></a>01059         <span class="keywordflow">if</span> (err &lt; 0)
<a name="l01060"></a>01060                 <span class="keywordflow">return</span> err;
<a name="l01061"></a>01061 
<a name="l01062"></a>01062         <a class="code" href="group__msg.html#ga138ba9bee70553f9fbe7143deacad48c" title="Free a netlink message.">nlmsg_free</a>(msg);
<a name="l01063"></a>01063         <span class="keywordflow">return</span> <a class="code" href="group__nl.html#gaa65fec588e0a0a2de1881fb8366ccd79" title="Wait for ACK.">nl_wait_for_ack</a>(handle);
<a name="l01064"></a>01064 }
<a name="l01065"></a>01065 <span class="comment"></span>
<a name="l01066"></a>01066 <span class="comment">/** @} */</span>
<a name="l01067"></a>01067 <span class="comment"></span>
<a name="l01068"></a>01068 <span class="comment">/**</span>
<a name="l01069"></a>01069 <span class="comment"> * @name Name &lt;-&gt; Index Translations</span>
<a name="l01070"></a>01070 <span class="comment"> * @{</span>
<a name="l01071"></a>01071 <span class="comment"> */</span>
<a name="l01072"></a>01072 <span class="comment"></span>
<a name="l01073"></a>01073 <span class="comment">/**</span>
<a name="l01074"></a>01074 <span class="comment"> * Translate an interface index to the corresponding link name</span>
<a name="l01075"></a>01075 <span class="comment"> * @arg cache           link cache</span>
<a name="l01076"></a>01076 <span class="comment"> * @arg ifindex         link interface index</span>
<a name="l01077"></a>01077 <span class="comment"> * @arg dst             destination buffer</span>
<a name="l01078"></a>01078 <span class="comment"> * @arg len             length of destination buffer</span>
<a name="l01079"></a>01079 <span class="comment"> *</span>
<a name="l01080"></a>01080 <span class="comment"> * Translates the specified interface index to the corresponding</span>
<a name="l01081"></a>01081 <span class="comment"> * link name and stores the name in the destination buffer.</span>
<a name="l01082"></a>01082 <span class="comment"> *</span>
<a name="l01083"></a>01083 <span class="comment"> * @return link name or NULL if no match was found.</span>
<a name="l01084"></a>01084 <span class="comment"> */</span>
<a name="l01085"></a><a class="code" href="group__link.html#ga66328cb096fb4d21499775e75089109d">01085</a> <span class="keywordtype">char</span> * <a class="code" href="group__link.html#ga66328cb096fb4d21499775e75089109d" title="Translate an interface index to the corresponding link name.">rtnl_link_i2name</a>(<span class="keyword">struct</span> nl_cache *cache, <span class="keywordtype">int</span> ifindex, <span class="keywordtype">char</span> *dst,
<a name="l01086"></a>01086                         <span class="keywordtype">size_t</span> len)
<a name="l01087"></a>01087 {
<a name="l01088"></a>01088         <span class="keyword">struct </span>rtnl_link *link = <a class="code" href="group__link.html#ga2a3657b69c47c9e3ab809cac73bf0986" title="Look up link by interface index in the provided cache.">rtnl_link_get</a>(cache, ifindex);
<a name="l01089"></a>01089 
<a name="l01090"></a>01090         <span class="keywordflow">if</span> (link) {
<a name="l01091"></a>01091                 strncpy(dst, link-&gt;l_name, len - 1);
<a name="l01092"></a>01092                 rtnl_link_put(link);
<a name="l01093"></a>01093                 <span class="keywordflow">return</span> dst;
<a name="l01094"></a>01094         }
<a name="l01095"></a>01095 
<a name="l01096"></a>01096         <span class="keywordflow">return</span> NULL;
<a name="l01097"></a>01097 }
<a name="l01098"></a>01098 <span class="comment"></span>
<a name="l01099"></a>01099 <span class="comment">/**</span>
<a name="l01100"></a>01100 <span class="comment"> * Translate a link name to the corresponding interface index</span>
<a name="l01101"></a>01101 <span class="comment"> * @arg cache           link cache</span>
<a name="l01102"></a>01102 <span class="comment"> * @arg name            link name</span>
<a name="l01103"></a>01103 <span class="comment"> *</span>
<a name="l01104"></a>01104 <span class="comment"> * @return interface index or RTNL_LINK_NOT_FOUND if no match was found.</span>
<a name="l01105"></a>01105 <span class="comment"> */</span>
<a name="l01106"></a><a class="code" href="group__link.html#ga8de66ce556b6d23f045fbc6079d547ed">01106</a> <span class="keywordtype">int</span> <a class="code" href="group__link.html#ga8de66ce556b6d23f045fbc6079d547ed" title="Translate a link name to the corresponding interface index.">rtnl_link_name2i</a>(<span class="keyword">struct</span> nl_cache *cache, <span class="keyword">const</span> <span class="keywordtype">char</span> *name)
<a name="l01107"></a>01107 {
<a name="l01108"></a>01108         <span class="keywordtype">int</span> ifindex = <a class="code" href="group__link.html#ga774720bec7d14a6e314238c42122ec78" title="Special interface index stating the link was not found.">RTNL_LINK_NOT_FOUND</a>;
<a name="l01109"></a>01109         <span class="keyword">struct </span>rtnl_link *link;
<a name="l01110"></a>01110         
<a name="l01111"></a>01111         link = <a class="code" href="group__link.html#ga1d583e4f0b43c89d854e5e681a529fad" title="Look up link by link name in the provided cache.">rtnl_link_get_by_name</a>(cache, name);
<a name="l01112"></a>01112         <span class="keywordflow">if</span> (link) {
<a name="l01113"></a>01113                 ifindex = link-&gt;l_index;
<a name="l01114"></a>01114                 rtnl_link_put(link);
<a name="l01115"></a>01115         }
<a name="l01116"></a>01116 
<a name="l01117"></a>01117         <span class="keywordflow">return</span> ifindex;
<a name="l01118"></a>01118 }
<a name="l01119"></a>01119 <span class="comment"></span>
<a name="l01120"></a>01120 <span class="comment">/** @} */</span>
<a name="l01121"></a>01121 <span class="comment"></span>
<a name="l01122"></a>01122 <span class="comment">/**</span>
<a name="l01123"></a>01123 <span class="comment"> * @name Link Flags Translations</span>
<a name="l01124"></a>01124 <span class="comment"> * @{</span>
<a name="l01125"></a>01125 <span class="comment"> */</span>
<a name="l01126"></a>01126 
<a name="l01127"></a>01127 <span class="keyword">static</span> <span class="keyword">struct </span>trans_tbl link_flags[] = {
<a name="l01128"></a>01128         __ADD(IFF_LOOPBACK, loopback)
<a name="l01129"></a>01129         __ADD(IFF_BROADCAST, broadcast)
<a name="l01130"></a>01130         __ADD(IFF_POINTOPOINT, pointopoint)
<a name="l01131"></a>01131         __ADD(IFF_MULTICAST, multicast)
<a name="l01132"></a>01132         __ADD(IFF_NOARP, noarp)
<a name="l01133"></a>01133         __ADD(IFF_ALLMULTI, allmulti)
<a name="l01134"></a>01134         __ADD(IFF_PROMISC, promisc)
<a name="l01135"></a>01135         __ADD(IFF_MASTER, master)
<a name="l01136"></a>01136         __ADD(IFF_SLAVE, slave)
<a name="l01137"></a>01137         __ADD(IFF_DEBUG, debug)
<a name="l01138"></a>01138         __ADD(IFF_DYNAMIC, dynamic)
<a name="l01139"></a>01139         __ADD(IFF_AUTOMEDIA, automedia)
<a name="l01140"></a>01140         __ADD(IFF_PORTSEL, portsel)
<a name="l01141"></a>01141         __ADD(IFF_NOTRAILERS, notrailers)
<a name="l01142"></a>01142         __ADD(IFF_UP, up)
<a name="l01143"></a>01143         __ADD(IFF_RUNNING, running)
<a name="l01144"></a>01144         __ADD(IFF_LOWER_UP, lowerup)
<a name="l01145"></a>01145         __ADD(IFF_DORMANT, dormant)
<a name="l01146"></a>01146         __ADD(IFF_ECHO, echo)
<a name="l01147"></a>01147 };
<a name="l01148"></a>01148 
<a name="l01149"></a>01149 <span class="keywordtype">char</span> * rtnl_link_flags2str(<span class="keywordtype">int</span> flags, <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> len)
<a name="l01150"></a>01150 {
<a name="l01151"></a>01151         <span class="keywordflow">return</span> __flags2str(flags, buf, len, link_flags,
<a name="l01152"></a>01152                            ARRAY_SIZE(link_flags));
<a name="l01153"></a>01153 }
<a name="l01154"></a>01154 
<a name="l01155"></a>01155 <span class="keywordtype">int</span> rtnl_link_str2flags(<span class="keyword">const</span> <span class="keywordtype">char</span> *name)
<a name="l01156"></a>01156 {
<a name="l01157"></a>01157         <span class="keywordflow">return</span> __str2flags(name, link_flags, ARRAY_SIZE(link_flags));
<a name="l01158"></a>01158 }
<a name="l01159"></a>01159 <span class="comment"></span>
<a name="l01160"></a>01160 <span class="comment">/** @} */</span>
<a name="l01161"></a>01161 <span class="comment"></span>
<a name="l01162"></a>01162 <span class="comment">/**</span>
<a name="l01163"></a>01163 <span class="comment"> * @name Link Statistics Translations</span>
<a name="l01164"></a>01164 <span class="comment"> * @{</span>
<a name="l01165"></a>01165 <span class="comment"> */</span>
<a name="l01166"></a>01166 
<a name="l01167"></a>01167 <span class="keyword">static</span> <span class="keyword">struct </span>trans_tbl link_stats[] = {
<a name="l01168"></a>01168         __ADD(RTNL_LINK_RX_PACKETS, rx_packets)
<a name="l01169"></a>01169         __ADD(RTNL_LINK_TX_PACKETS, tx_packets)
<a name="l01170"></a>01170         __ADD(RTNL_LINK_RX_BYTES, rx_bytes)
<a name="l01171"></a>01171         __ADD(RTNL_LINK_TX_BYTES, tx_bytes)
<a name="l01172"></a>01172         __ADD(RTNL_LINK_RX_ERRORS, rx_errors)
<a name="l01173"></a>01173         __ADD(RTNL_LINK_TX_ERRORS, tx_errors)
<a name="l01174"></a>01174         __ADD(RTNL_LINK_RX_DROPPED, rx_dropped)
<a name="l01175"></a>01175         __ADD(RTNL_LINK_TX_DROPPED, tx_dropped)
<a name="l01176"></a>01176         __ADD(RTNL_LINK_RX_COMPRESSED, rx_compressed)
<a name="l01177"></a>01177         __ADD(RTNL_LINK_TX_COMPRESSED, tx_compressed)
<a name="l01178"></a>01178         __ADD(RTNL_LINK_RX_FIFO_ERR, rx_fifo_err)
<a name="l01179"></a>01179         __ADD(RTNL_LINK_TX_FIFO_ERR, tx_fifo_err)
<a name="l01180"></a>01180         __ADD(RTNL_LINK_RX_LEN_ERR, rx_len_err)
<a name="l01181"></a>01181         __ADD(RTNL_LINK_RX_OVER_ERR, rx_over_err)
<a name="l01182"></a>01182         __ADD(RTNL_LINK_RX_CRC_ERR, rx_crc_err)
<a name="l01183"></a>01183         __ADD(RTNL_LINK_RX_FRAME_ERR, rx_frame_err)
<a name="l01184"></a>01184         __ADD(RTNL_LINK_RX_MISSED_ERR, rx_missed_err)
<a name="l01185"></a>01185         __ADD(RTNL_LINK_TX_ABORT_ERR, tx_abort_err)
<a name="l01186"></a>01186         __ADD(RTNL_LINK_TX_CARRIER_ERR, tx_carrier_err)
<a name="l01187"></a>01187         __ADD(RTNL_LINK_TX_HBEAT_ERR, tx_hbeat_err)
<a name="l01188"></a>01188         __ADD(RTNL_LINK_TX_WIN_ERR, tx_win_err)
<a name="l01189"></a>01189         __ADD(RTNL_LINK_TX_COLLISIONS, tx_collision)
<a name="l01190"></a>01190         __ADD(RTNL_LINK_MULTICAST, multicast)
<a name="l01191"></a>01191 };
<a name="l01192"></a>01192 
<a name="l01193"></a>01193 <span class="keywordtype">char</span> *rtnl_link_stat2str(<span class="keywordtype">int</span> st, <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> len)
<a name="l01194"></a>01194 {
<a name="l01195"></a>01195         <span class="keywordflow">return</span> __type2str(st, buf, len, link_stats, ARRAY_SIZE(link_stats));
<a name="l01196"></a>01196 }
<a name="l01197"></a>01197 
<a name="l01198"></a>01198 <span class="keywordtype">int</span> rtnl_link_str2stat(<span class="keyword">const</span> <span class="keywordtype">char</span> *name)
<a name="l01199"></a>01199 {
<a name="l01200"></a>01200         <span class="keywordflow">return</span> __str2type(name, link_stats, ARRAY_SIZE(link_stats));
<a name="l01201"></a>01201 }
<a name="l01202"></a>01202 <span class="comment"></span>
<a name="l01203"></a>01203 <span class="comment">/** @} */</span>
<a name="l01204"></a>01204 <span class="comment"></span>
<a name="l01205"></a>01205 <span class="comment">/**</span>
<a name="l01206"></a>01206 <span class="comment"> * @name Link Operstate Translations</span>
<a name="l01207"></a>01207 <span class="comment"> * @{</span>
<a name="l01208"></a>01208 <span class="comment"> */</span>
<a name="l01209"></a>01209 
<a name="l01210"></a>01210 <span class="keyword">static</span> <span class="keyword">struct </span>trans_tbl link_operstates[] = {
<a name="l01211"></a>01211         __ADD(IF_OPER_UNKNOWN, unknown)
<a name="l01212"></a>01212         __ADD(IF_OPER_NOTPRESENT, notpresent)
<a name="l01213"></a>01213         __ADD(IF_OPER_DOWN, down)
<a name="l01214"></a>01214         __ADD(IF_OPER_LOWERLAYERDOWN, lowerlayerdown)
<a name="l01215"></a>01215         __ADD(IF_OPER_TESTING, testing)
<a name="l01216"></a>01216         __ADD(IF_OPER_DORMANT, dormant)
<a name="l01217"></a>01217         __ADD(IF_OPER_UP, up)
<a name="l01218"></a>01218 };
<a name="l01219"></a>01219 
<a name="l01220"></a>01220 <span class="keywordtype">char</span> *rtnl_link_operstate2str(<span class="keywordtype">int</span> st, <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> len)
<a name="l01221"></a>01221 {
<a name="l01222"></a>01222         <span class="keywordflow">return</span> __type2str(st, buf, len, link_operstates,
<a name="l01223"></a>01223                           ARRAY_SIZE(link_operstates));
<a name="l01224"></a>01224 }
<a name="l01225"></a>01225 
<a name="l01226"></a>01226 <span class="keywordtype">int</span> rtnl_link_str2operstate(<span class="keyword">const</span> <span class="keywordtype">char</span> *name)
<a name="l01227"></a>01227 {
<a name="l01228"></a>01228         <span class="keywordflow">return</span> __str2type(name, link_operstates,
<a name="l01229"></a>01229                           ARRAY_SIZE(link_operstates));
<a name="l01230"></a>01230 }
<a name="l01231"></a>01231 <span class="comment"></span>
<a name="l01232"></a>01232 <span class="comment">/** @} */</span>
<a name="l01233"></a>01233 <span class="comment"></span>
<a name="l01234"></a>01234 <span class="comment">/**</span>
<a name="l01235"></a>01235 <span class="comment"> * @name Link Mode Translations</span>
<a name="l01236"></a>01236 <span class="comment"> * @{</span>
<a name="l01237"></a>01237 <span class="comment"> */</span>
<a name="l01238"></a>01238 
<a name="l01239"></a>01239 <span class="keyword">static</span> <span class="keyword">struct </span>trans_tbl link_modes[] = {
<a name="l01240"></a>01240         __ADD(IF_LINK_MODE_DEFAULT, <span class="keywordflow">default</span>)
<a name="l01241"></a>01241         __ADD(IF_LINK_MODE_DORMANT, dormant)
<a name="l01242"></a>01242 };
<a name="l01243"></a>01243 
<a name="l01244"></a>01244 <span class="keywordtype">char</span> *rtnl_link_mode2str(<span class="keywordtype">int</span> st, <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> len)
<a name="l01245"></a>01245 {
<a name="l01246"></a>01246         <span class="keywordflow">return</span> __type2str(st, buf, len, link_modes, ARRAY_SIZE(link_modes));
<a name="l01247"></a>01247 }
<a name="l01248"></a>01248 
<a name="l01249"></a>01249 <span class="keywordtype">int</span> rtnl_link_str2mode(<span class="keyword">const</span> <span class="keywordtype">char</span> *name)
<a name="l01250"></a>01250 {
<a name="l01251"></a>01251         <span class="keywordflow">return</span> __str2type(name, link_modes, ARRAY_SIZE(link_modes));
<a name="l01252"></a>01252 }
<a name="l01253"></a>01253 <span class="comment"></span>
<a name="l01254"></a>01254 <span class="comment">/** @} */</span>
<a name="l01255"></a>01255 <span class="comment"></span>
<a name="l01256"></a>01256 <span class="comment">/**</span>
<a name="l01257"></a>01257 <span class="comment"> * @name Attributes</span>
<a name="l01258"></a>01258 <span class="comment"> * @{</span>
<a name="l01259"></a>01259 <span class="comment"> */</span>
<a name="l01260"></a>01260 
<a name="l01261"></a>01261 <span class="keywordtype">void</span> rtnl_link_set_qdisc(<span class="keyword">struct</span> rtnl_link *link, <span class="keyword">const</span> <span class="keywordtype">char</span> *qdisc)
<a name="l01262"></a>01262 {
<a name="l01263"></a>01263         strncpy(link-&gt;l_qdisc, qdisc, <span class="keyword">sizeof</span>(link-&gt;l_qdisc) - 1);
<a name="l01264"></a>01264         link-&gt;ce_mask |= LINK_ATTR_QDISC;
<a name="l01265"></a>01265 }
<a name="l01266"></a>01266 
<a name="l01267"></a>01267 <span class="keywordtype">char</span> *rtnl_link_get_qdisc(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01268"></a>01268 {
<a name="l01269"></a>01269         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_QDISC)
<a name="l01270"></a>01270                 <span class="keywordflow">return</span> link-&gt;l_qdisc;
<a name="l01271"></a>01271         <span class="keywordflow">else</span>
<a name="l01272"></a>01272                 <span class="keywordflow">return</span> NULL;
<a name="l01273"></a>01273 }
<a name="l01274"></a>01274 
<a name="l01275"></a>01275 <span class="keywordtype">void</span> rtnl_link_set_name(<span class="keyword">struct</span> rtnl_link *link, <span class="keyword">const</span> <span class="keywordtype">char</span> *name)
<a name="l01276"></a>01276 {
<a name="l01277"></a>01277         strncpy(link-&gt;l_name, name, <span class="keyword">sizeof</span>(link-&gt;l_name) - 1);
<a name="l01278"></a>01278         link-&gt;ce_mask |= LINK_ATTR_IFNAME;
<a name="l01279"></a>01279 }
<a name="l01280"></a>01280 
<a name="l01281"></a>01281 <span class="keywordtype">char</span> *rtnl_link_get_name(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01282"></a>01282 {
<a name="l01283"></a>01283         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_IFNAME)
<a name="l01284"></a>01284                 <span class="keywordflow">return</span> link-&gt;l_name;
<a name="l01285"></a>01285         <span class="keywordflow">else</span>
<a name="l01286"></a>01286                 <span class="keywordflow">return</span> NULL;
<a name="l01287"></a>01287 }
<a name="l01288"></a>01288 
<a name="l01289"></a>01289 <span class="keyword">static</span> <span class="keyword">inline</span> <span class="keywordtype">void</span> __assign_addr(<span class="keyword">struct</span> rtnl_link *link, <span class="keyword">struct</span> nl_addr **pos,
<a name="l01290"></a>01290                                  <span class="keyword">struct</span> nl_addr *<span class="keyword">new</span>, <span class="keywordtype">int</span> flag)
<a name="l01291"></a>01291 {
<a name="l01292"></a>01292         <span class="keywordflow">if</span> (*pos)
<a name="l01293"></a>01293                 nl_addr_put(*pos);
<a name="l01294"></a>01294 
<a name="l01295"></a>01295         nl_addr_get(<span class="keyword">new</span>);
<a name="l01296"></a>01296         *pos = <span class="keyword">new</span>;
<a name="l01297"></a>01297 
<a name="l01298"></a>01298         link-&gt;ce_mask |= flag;
<a name="l01299"></a>01299 }
<a name="l01300"></a>01300 
<a name="l01301"></a>01301 <span class="keywordtype">void</span> rtnl_link_set_addr(<span class="keyword">struct</span> rtnl_link *link, <span class="keyword">struct</span> nl_addr *addr)
<a name="l01302"></a>01302 {
<a name="l01303"></a>01303         __assign_addr(link, &amp;link-&gt;l_addr, addr, LINK_ATTR_ADDR);
<a name="l01304"></a>01304 }
<a name="l01305"></a>01305 
<a name="l01306"></a>01306 <span class="keyword">struct </span>nl_addr *rtnl_link_get_addr(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01307"></a>01307 {
<a name="l01308"></a>01308         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_ADDR)
<a name="l01309"></a>01309                 <span class="keywordflow">return</span> link-&gt;l_addr;
<a name="l01310"></a>01310         <span class="keywordflow">else</span>
<a name="l01311"></a>01311                 <span class="keywordflow">return</span> NULL;
<a name="l01312"></a>01312 }
<a name="l01313"></a>01313 
<a name="l01314"></a>01314 <span class="keywordtype">void</span> rtnl_link_set_broadcast(<span class="keyword">struct</span> rtnl_link *link, <span class="keyword">struct</span> nl_addr *brd)
<a name="l01315"></a>01315 {
<a name="l01316"></a>01316         __assign_addr(link, &amp;link-&gt;l_bcast, brd, LINK_ATTR_BRD);
<a name="l01317"></a>01317 }
<a name="l01318"></a>01318 
<a name="l01319"></a>01319 <span class="keyword">struct </span>nl_addr *rtnl_link_get_broadcast(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01320"></a>01320 {
<a name="l01321"></a>01321         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_BRD)
<a name="l01322"></a>01322                 <span class="keywordflow">return</span> link-&gt;l_bcast;
<a name="l01323"></a>01323         <span class="keywordflow">else</span>
<a name="l01324"></a>01324                 <span class="keywordflow">return</span> NULL;
<a name="l01325"></a>01325 }
<a name="l01326"></a>01326 
<a name="l01327"></a>01327 <span class="keywordtype">void</span> rtnl_link_set_flags(<span class="keyword">struct</span> rtnl_link *link, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> flags)
<a name="l01328"></a>01328 {
<a name="l01329"></a>01329         link-&gt;l_flag_mask |= flags;
<a name="l01330"></a>01330         link-&gt;l_flags |= flags;
<a name="l01331"></a>01331         link-&gt;ce_mask |= LINK_ATTR_FLAGS;
<a name="l01332"></a>01332 }
<a name="l01333"></a>01333 
<a name="l01334"></a>01334 <span class="keywordtype">void</span> rtnl_link_unset_flags(<span class="keyword">struct</span> rtnl_link *link, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> flags)
<a name="l01335"></a>01335 {
<a name="l01336"></a>01336         link-&gt;l_flag_mask |= flags;
<a name="l01337"></a>01337         link-&gt;l_flags &amp;= ~flags;
<a name="l01338"></a>01338         link-&gt;ce_mask |= LINK_ATTR_FLAGS;
<a name="l01339"></a>01339 }
<a name="l01340"></a>01340 
<a name="l01341"></a>01341 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> rtnl_link_get_flags(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01342"></a>01342 {
<a name="l01343"></a>01343         <span class="keywordflow">return</span> link-&gt;l_flags;
<a name="l01344"></a>01344 }
<a name="l01345"></a>01345 
<a name="l01346"></a>01346 <span class="keywordtype">void</span> rtnl_link_set_family(<span class="keyword">struct</span> rtnl_link *link, <span class="keywordtype">int</span> family)
<a name="l01347"></a>01347 {
<a name="l01348"></a>01348         link-&gt;l_family = family;
<a name="l01349"></a>01349         link-&gt;ce_mask |= LINK_ATTR_FAMILY;
<a name="l01350"></a>01350 }
<a name="l01351"></a>01351 
<a name="l01352"></a>01352 <span class="keywordtype">int</span> rtnl_link_get_family(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01353"></a>01353 {
<a name="l01354"></a>01354         <span class="keywordflow">if</span> (link-&gt;l_family &amp; LINK_ATTR_FAMILY)
<a name="l01355"></a>01355                 <span class="keywordflow">return</span> link-&gt;l_family;
<a name="l01356"></a>01356         <span class="keywordflow">else</span>
<a name="l01357"></a>01357                 <span class="keywordflow">return</span> AF_UNSPEC;
<a name="l01358"></a>01358 }
<a name="l01359"></a>01359 
<a name="l01360"></a>01360 <span class="keywordtype">void</span> rtnl_link_set_arptype(<span class="keyword">struct</span> rtnl_link *link, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> arptype)
<a name="l01361"></a>01361 {
<a name="l01362"></a>01362         link-&gt;l_arptype = arptype;
<a name="l01363"></a>01363 }
<a name="l01364"></a>01364 
<a name="l01365"></a>01365 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> rtnl_link_get_arptype(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01366"></a>01366 {
<a name="l01367"></a>01367         <span class="keywordflow">return</span> link-&gt;l_arptype;
<a name="l01368"></a>01368 }
<a name="l01369"></a>01369 
<a name="l01370"></a>01370 <span class="keywordtype">void</span> rtnl_link_set_ifindex(<span class="keyword">struct</span> rtnl_link *link, <span class="keywordtype">int</span> ifindex)
<a name="l01371"></a>01371 {
<a name="l01372"></a>01372         link-&gt;l_index = ifindex;
<a name="l01373"></a>01373         link-&gt;ce_mask |= LINK_ATTR_IFINDEX;
<a name="l01374"></a>01374 }
<a name="l01375"></a>01375 
<a name="l01376"></a>01376 <span class="keywordtype">int</span> rtnl_link_get_ifindex(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01377"></a>01377 {
<a name="l01378"></a>01378         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_IFINDEX)
<a name="l01379"></a>01379                 <span class="keywordflow">return</span> link-&gt;l_index;
<a name="l01380"></a>01380         <span class="keywordflow">else</span>
<a name="l01381"></a>01381                 <span class="keywordflow">return</span> <a class="code" href="group__link.html#ga774720bec7d14a6e314238c42122ec78" title="Special interface index stating the link was not found.">RTNL_LINK_NOT_FOUND</a>;
<a name="l01382"></a>01382 }
<a name="l01383"></a>01383 
<a name="l01384"></a>01384 <span class="keywordtype">void</span> rtnl_link_set_mtu(<span class="keyword">struct</span> rtnl_link *link, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> mtu)
<a name="l01385"></a>01385 {
<a name="l01386"></a>01386         link-&gt;l_mtu = mtu;
<a name="l01387"></a>01387         link-&gt;ce_mask |= LINK_ATTR_MTU;
<a name="l01388"></a>01388 }
<a name="l01389"></a>01389 
<a name="l01390"></a>01390 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> rtnl_link_get_mtu(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01391"></a>01391 {
<a name="l01392"></a>01392         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_MTU)
<a name="l01393"></a>01393                 <span class="keywordflow">return</span> link-&gt;l_mtu;
<a name="l01394"></a>01394         <span class="keywordflow">else</span>
<a name="l01395"></a>01395                 <span class="keywordflow">return</span> 0;
<a name="l01396"></a>01396 }
<a name="l01397"></a>01397 
<a name="l01398"></a>01398 <span class="keywordtype">void</span> rtnl_link_set_txqlen(<span class="keyword">struct</span> rtnl_link *link, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> txqlen)
<a name="l01399"></a>01399 {
<a name="l01400"></a>01400         link-&gt;l_txqlen = txqlen;
<a name="l01401"></a>01401         link-&gt;ce_mask |= LINK_ATTR_TXQLEN;
<a name="l01402"></a>01402 }
<a name="l01403"></a>01403 
<a name="l01404"></a>01404 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> rtnl_link_get_txqlen(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01405"></a>01405 {
<a name="l01406"></a>01406         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_TXQLEN)
<a name="l01407"></a>01407                 <span class="keywordflow">return</span> link-&gt;l_txqlen;
<a name="l01408"></a>01408         <span class="keywordflow">else</span>
<a name="l01409"></a>01409                 <span class="keywordflow">return</span> UINT_MAX;
<a name="l01410"></a>01410 }
<a name="l01411"></a>01411 
<a name="l01412"></a>01412 <span class="keywordtype">void</span> rtnl_link_set_weight(<span class="keyword">struct</span> rtnl_link *link, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> weight)
<a name="l01413"></a>01413 {
<a name="l01414"></a>01414         link-&gt;l_weight = weight;
<a name="l01415"></a>01415         link-&gt;ce_mask |= LINK_ATTR_WEIGHT;
<a name="l01416"></a>01416 }
<a name="l01417"></a>01417 
<a name="l01418"></a>01418 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> rtnl_link_get_weight(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01419"></a>01419 {
<a name="l01420"></a>01420         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_WEIGHT)
<a name="l01421"></a>01421                 <span class="keywordflow">return</span> link-&gt;l_weight;
<a name="l01422"></a>01422         <span class="keywordflow">else</span>
<a name="l01423"></a>01423                 <span class="keywordflow">return</span> UINT_MAX;
<a name="l01424"></a>01424 }
<a name="l01425"></a>01425 
<a name="l01426"></a>01426 <span class="keywordtype">void</span> rtnl_link_set_link(<span class="keyword">struct</span> rtnl_link *link, <span class="keywordtype">int</span> ifindex)
<a name="l01427"></a>01427 {
<a name="l01428"></a>01428         link-&gt;l_link = ifindex;
<a name="l01429"></a>01429         link-&gt;ce_mask |= LINK_ATTR_LINK;
<a name="l01430"></a>01430 }
<a name="l01431"></a>01431 
<a name="l01432"></a>01432 <span class="keywordtype">int</span> rtnl_link_get_link(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01433"></a>01433 {
<a name="l01434"></a>01434         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_LINK)
<a name="l01435"></a>01435                 <span class="keywordflow">return</span> link-&gt;l_link;
<a name="l01436"></a>01436         <span class="keywordflow">else</span>
<a name="l01437"></a>01437                 <span class="keywordflow">return</span> <a class="code" href="group__link.html#ga774720bec7d14a6e314238c42122ec78" title="Special interface index stating the link was not found.">RTNL_LINK_NOT_FOUND</a>;
<a name="l01438"></a>01438 }
<a name="l01439"></a>01439 
<a name="l01440"></a>01440 <span class="keywordtype">void</span> rtnl_link_set_master(<span class="keyword">struct</span> rtnl_link *link, <span class="keywordtype">int</span> ifindex)
<a name="l01441"></a>01441 {
<a name="l01442"></a>01442         link-&gt;l_master = ifindex;
<a name="l01443"></a>01443         link-&gt;ce_mask |= LINK_ATTR_MASTER;
<a name="l01444"></a>01444 }
<a name="l01445"></a>01445 
<a name="l01446"></a>01446 <span class="keywordtype">int</span> rtnl_link_get_master(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01447"></a>01447 {
<a name="l01448"></a>01448         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_MASTER)
<a name="l01449"></a>01449                 <span class="keywordflow">return</span> link-&gt;l_master;
<a name="l01450"></a>01450         <span class="keywordflow">else</span>
<a name="l01451"></a>01451                 <span class="keywordflow">return</span> <a class="code" href="group__link.html#ga774720bec7d14a6e314238c42122ec78" title="Special interface index stating the link was not found.">RTNL_LINK_NOT_FOUND</a>;
<a name="l01452"></a>01452 }
<a name="l01453"></a>01453 
<a name="l01454"></a>01454 <span class="keywordtype">void</span> rtnl_link_set_operstate(<span class="keyword">struct</span> rtnl_link *link, uint8_t operstate)
<a name="l01455"></a>01455 {
<a name="l01456"></a>01456         link-&gt;l_operstate = operstate;
<a name="l01457"></a>01457         link-&gt;ce_mask |= LINK_ATTR_OPERSTATE;
<a name="l01458"></a>01458 }
<a name="l01459"></a>01459 
<a name="l01460"></a>01460 uint8_t rtnl_link_get_operstate(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01461"></a>01461 {
<a name="l01462"></a>01462         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_OPERSTATE)
<a name="l01463"></a>01463                 <span class="keywordflow">return</span> link-&gt;l_operstate;
<a name="l01464"></a>01464         <span class="keywordflow">else</span>
<a name="l01465"></a>01465                 <span class="keywordflow">return</span> IF_OPER_UNKNOWN;
<a name="l01466"></a>01466 }
<a name="l01467"></a>01467 
<a name="l01468"></a>01468 <span class="keywordtype">void</span> rtnl_link_set_linkmode(<span class="keyword">struct</span> rtnl_link *link, uint8_t linkmode)
<a name="l01469"></a>01469 {
<a name="l01470"></a>01470         link-&gt;l_linkmode = linkmode;
<a name="l01471"></a>01471         link-&gt;ce_mask |= LINK_ATTR_LINKMODE;
<a name="l01472"></a>01472 }
<a name="l01473"></a>01473 
<a name="l01474"></a>01474 uint8_t rtnl_link_get_linkmode(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01475"></a>01475 {
<a name="l01476"></a>01476         <span class="keywordflow">if</span> (link-&gt;ce_mask &amp; LINK_ATTR_LINKMODE)
<a name="l01477"></a>01477                 <span class="keywordflow">return</span> link-&gt;l_linkmode;
<a name="l01478"></a>01478         <span class="keywordflow">else</span>
<a name="l01479"></a>01479                 <span class="keywordflow">return</span> IF_LINK_MODE_DEFAULT;
<a name="l01480"></a>01480 }
<a name="l01481"></a>01481 
<a name="l01482"></a>01482 uint64_t rtnl_link_get_stat(<span class="keyword">struct</span> rtnl_link *link, <span class="keywordtype">int</span> <span class="keywordtype">id</span>)
<a name="l01483"></a>01483 {
<a name="l01484"></a>01484         <span class="keywordflow">if</span> (id &lt; 0 || id &gt; RTNL_LINK_STATS_MAX)
<a name="l01485"></a>01485                 <span class="keywordflow">return</span> 0;
<a name="l01486"></a>01486 
<a name="l01487"></a>01487         <span class="keywordflow">return</span> link-&gt;l_stats[id];
<a name="l01488"></a>01488 }
<a name="l01489"></a>01489 <span class="comment"></span>
<a name="l01490"></a>01490 <span class="comment">/**</span>
<a name="l01491"></a>01491 <span class="comment"> * Specify the info type of a link</span>
<a name="l01492"></a>01492 <span class="comment"> * @arg link    link object</span>
<a name="l01493"></a>01493 <span class="comment"> * @arg type    info type</span>
<a name="l01494"></a>01494 <span class="comment"> *</span>
<a name="l01495"></a>01495 <span class="comment"> * Looks up the info type and prepares the link to store info type</span>
<a name="l01496"></a>01496 <span class="comment"> * specific attributes. If an info type has been assigned already</span>
<a name="l01497"></a>01497 <span class="comment"> * it will be released with all changes lost.</span>
<a name="l01498"></a>01498 <span class="comment"> *</span>
<a name="l01499"></a>01499 <span class="comment"> * @return 0 on success or a negative errror code.</span>
<a name="l01500"></a>01500 <span class="comment"> */</span>
<a name="l01501"></a><a class="code" href="group__link.html#gadddd34902ec52fa8674f66a2cd99fa9f">01501</a> <span class="keywordtype">int</span> <a class="code" href="group__link.html#gadddd34902ec52fa8674f66a2cd99fa9f" title="Specify the info type of a link.">rtnl_link_set_info_type</a>(<span class="keyword">struct</span> rtnl_link *link, <span class="keyword">const</span> <span class="keywordtype">char</span> *type)
<a name="l01502"></a>01502 {
<a name="l01503"></a>01503         <span class="keyword">struct </span><a class="code" href="structrtnl__link__info__ops.html" title="Link info operations.">rtnl_link_info_ops</a> *io;
<a name="l01504"></a>01504         <span class="keywordtype">int</span> err;
<a name="l01505"></a>01505 
<a name="l01506"></a>01506         <span class="keywordflow">if</span> ((io = rtnl_link_info_ops_lookup(type)) == NULL)
<a name="l01507"></a>01507                 <span class="keywordflow">return</span> nl_error(ENOENT, <span class="stringliteral">&quot;No such link info type exists&quot;</span>);
<a name="l01508"></a>01508 
<a name="l01509"></a>01509         <span class="keywordflow">if</span> (link-&gt;l_info_ops)
<a name="l01510"></a>01510                 release_link_info(link);
<a name="l01511"></a>01511 
<a name="l01512"></a>01512         <span class="keywordflow">if</span> ((err = io-&gt;<a class="code" href="structrtnl__link__info__ops.html#a0dcac57de49a6d9ebca60fec11f222f5" title="Called to assign an info type to a link.">io_alloc</a>(link)) &lt; 0)
<a name="l01513"></a>01513                 <span class="keywordflow">return</span> err;
<a name="l01514"></a>01514 
<a name="l01515"></a>01515         link-&gt;l_info_ops = io;
<a name="l01516"></a>01516 
<a name="l01517"></a>01517         <span class="keywordflow">return</span> 0;
<a name="l01518"></a>01518 }
<a name="l01519"></a>01519 <span class="comment"></span>
<a name="l01520"></a>01520 <span class="comment">/**</span>
<a name="l01521"></a>01521 <span class="comment"> * Return info type of a link</span>
<a name="l01522"></a>01522 <span class="comment"> * @arg link    link object</span>
<a name="l01523"></a>01523 <span class="comment"> *</span>
<a name="l01524"></a>01524 <span class="comment"> * @note The returned pointer is only valid as long as the link exists</span>
<a name="l01525"></a>01525 <span class="comment"> * @return Info type name or NULL if unknown.</span>
<a name="l01526"></a>01526 <span class="comment"> */</span>
<a name="l01527"></a><a class="code" href="group__link.html#gaae3e6282f5a38076e05ba596a12b4280">01527</a> <span class="keywordtype">char</span> *<a class="code" href="group__link.html#gaae3e6282f5a38076e05ba596a12b4280" title="Return info type of a link.">rtnl_link_get_info_type</a>(<span class="keyword">struct</span> rtnl_link *link)
<a name="l01528"></a>01528 {
<a name="l01529"></a>01529         <span class="keywordflow">if</span> (link-&gt;l_info_ops)
<a name="l01530"></a>01530                 <span class="keywordflow">return</span> link-&gt;l_info_ops-&gt;io_name;
<a name="l01531"></a>01531         <span class="keywordflow">else</span>
<a name="l01532"></a>01532                 <span class="keywordflow">return</span> NULL;
<a name="l01533"></a>01533 }
<a name="l01534"></a>01534 <span class="comment"></span>
<a name="l01535"></a>01535 <span class="comment">/** @} */</span>
<a name="l01536"></a>01536 
<a name="l01537"></a>01537 <span class="keyword">static</span> <span class="keyword">struct </span><a class="code" href="structnl__object__ops.html" title="Object Operations.">nl_object_ops</a> link_obj_ops = {
<a name="l01538"></a>01538         .<a class="code" href="structnl__object__ops.html#a5225584343fe711642303e000b036ee9" title="Unique name of object type.">oo_name</a>                = <span class="stringliteral">&quot;route/link&quot;</span>,
<a name="l01539"></a>01539         .oo_size                = <span class="keyword">sizeof</span>(<span class="keyword">struct </span>rtnl_link),
<a name="l01540"></a>01540         .oo_free_data           = link_free_data,
<a name="l01541"></a>01541         .oo_clone               = link_clone,
<a name="l01542"></a>01542         .oo_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9a5597887c080d5ecae358b6065a4048fd" title="Dump object in a brief one-liner.">NL_DUMP_BRIEF</a>] = link_dump_brief,
<a name="l01543"></a>01543         .oo_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9a1445106c7af529b2c99ee289fbcd3179" title="Dump all attributes but no statistics.">NL_DUMP_FULL</a>]  = link_dump_full,
<a name="l01544"></a>01544         .oo_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9a8ebedc55094df6175b84fb1230047a65" title="Dump all attributes including statistics.">NL_DUMP_STATS</a>] = link_dump_stats,
<a name="l01545"></a>01545         .oo_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9aa5b83654e99e53423c39b0d6e835d768" title="Dump all attribtes in XML format.">NL_DUMP_XML</a>]   = link_dump_xml,
<a name="l01546"></a>01546         .oo_dump[<a class="code" href="group__utils.html#ggacfb5566c73f0965c5241d7d49bc717e9a7178b29f7f68857970540f2d1dabbaf1" title="Dump all attribtues as env variables.">NL_DUMP_ENV</a>]   = link_dump_env,
<a name="l01547"></a>01547         .oo_compare             = link_compare,
<a name="l01548"></a>01548         .oo_attrs2str           = link_attrs2str,
<a name="l01549"></a>01549         .oo_id_attrs            = LINK_ATTR_IFINDEX,
<a name="l01550"></a>01550 };
<a name="l01551"></a>01551 
<a name="l01552"></a>01552 <span class="keyword">static</span> <span class="keyword">struct </span><a class="code" href="structnl__af__group.html" title="Address family to netlink group association.">nl_af_group</a> link_groups[] = {
<a name="l01553"></a>01553         { AF_UNSPEC,    RTNLGRP_LINK },
<a name="l01554"></a>01554         { END_OF_GROUP_LIST },
<a name="l01555"></a>01555 };
<a name="l01556"></a>01556 
<a name="l01557"></a>01557 <span class="keyword">static</span> <span class="keyword">struct </span><a class="code" href="structnl__cache__ops.html" title="Cache Operations.">nl_cache_ops</a> rtnl_link_ops = {
<a name="l01558"></a>01558         .co_name                = <span class="stringliteral">&quot;route/link&quot;</span>,
<a name="l01559"></a>01559         .co_hdrsize             = <span class="keyword">sizeof</span>(<span class="keyword">struct </span>ifinfomsg),
<a name="l01560"></a>01560         .co_msgtypes            = {
<a name="l01561"></a>01561                                         { RTM_NEWLINK, NL_ACT_NEW, <span class="stringliteral">&quot;new&quot;</span> },
<a name="l01562"></a>01562                                         { RTM_DELLINK, NL_ACT_DEL, <span class="stringliteral">&quot;del&quot;</span> },
<a name="l01563"></a>01563                                         { RTM_GETLINK, NL_ACT_GET, <span class="stringliteral">&quot;get&quot;</span> },
<a name="l01564"></a>01564                                         END_OF_MSGTYPES_LIST,
<a name="l01565"></a>01565                                   },
<a name="l01566"></a>01566         .co_protocol            = NETLINK_ROUTE,
<a name="l01567"></a>01567         .co_groups              = link_groups,
<a name="l01568"></a>01568         .co_request_update      = link_request_update,
<a name="l01569"></a>01569         .co_msg_parser          = link_msg_parser,
<a name="l01570"></a>01570         .co_obj_ops             = &amp;link_obj_ops,
<a name="l01571"></a>01571 };
<a name="l01572"></a>01572 
<a name="l01573"></a>01573 <span class="keyword">static</span> <span class="keywordtype">void</span> __init link_init(<span class="keywordtype">void</span>)
<a name="l01574"></a>01574 {
<a name="l01575"></a>01575         <a class="code" href="group__cache__mngt.html#ga390eeb1fa61634cf1c216792c6df63c3" title="Register a set of cache operations.">nl_cache_mngt_register</a>(&amp;rtnl_link_ops);
<a name="l01576"></a>01576 }
<a name="l01577"></a>01577 
<a name="l01578"></a>01578 <span class="keyword">static</span> <span class="keywordtype">void</span> __exit link_exit(<span class="keywordtype">void</span>)
<a name="l01579"></a>01579 {
<a name="l01580"></a>01580         <a class="code" href="group__cache__mngt.html#ga09f56b767b3868b7e0cf8559863dde77" title="Unregister a set of cache operations.">nl_cache_mngt_unregister</a>(&amp;rtnl_link_ops);
<a name="l01581"></a>01581 }
<a name="l01582"></a>01582 <span class="comment"></span>
<a name="l01583"></a>01583 <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>