source: networking/netlibs/libnl.xml@ 90765ccf

10.0 10.1 11.0 9.0 9.1 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 90765ccf was 90765ccf, checked in by Douglas R. Reno <renodr@…>, 2 years ago

Pre-reboot tags
wpa_supplicant: Reference the right configuration file on systemd

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21984 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 11.3 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY libnl-download-http "https://github.com/thom311/libnl/releases/download/libnl&libnl-dl-version;/libnl-&libnl-version;.tar.gz">
8 <!ENTITY libnl-download-ftp " ">
9 <!ENTITY libnl-md5sum "8f71910c03db363b41e2ea62057a4311">
10 <!ENTITY libnl-size "912 KB">
11 <!ENTITY libnl-buildsize "29 MB (with tests and API documentation)">
12 <!ENTITY libnl-time "0.4 SBU (with tests and API documentation)">
13
14
15 <!ENTITY libnl-doc-download-http "https://github.com/thom311/libnl/releases/download/libnl&libnl-dl-version;/libnl-doc-&libnl-version;.tar.gz">
16 <!ENTITY libnl-doc-download-ftp " ">
17 <!ENTITY libnl-doc-md5sum "2255846ccf58875529f84898df325dea">
18 <!ENTITY libnl-doc-size "11 MB">
19]>
20
21<sect1 id="libnl" xreflabel="libnl-&libnl-version;">
22 <?dbhtml filename="libnl.html"?>
23
24 <sect1info>
25 <othername>$LastChangedBy$</othername>
26 <date>$Date$</date>
27 </sect1info>
28
29 <title>libnl-&libnl-version;</title>
30
31 <indexterm zone="libnl">
32 <primary sortas="a-libnl">libnl</primary>
33 </indexterm>
34
35 <sect2 role="package">
36 <title>Introduction to libnl</title>
37
38 <para>
39 The <application>libnl</application> suite is a collection of libraries
40 providing APIs to netlink protocol based Linux kernel interfaces.
41 </para>
42
43 &lfs90_checked;
44
45 <bridgehead renderas="sect3">Package Information</bridgehead>
46 <itemizedlist spacing="compact">
47 <listitem>
48 <para>
49 Download (HTTP): <ulink url="&libnl-download-http;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download (FTP): <ulink url="&libnl-download-ftp;"/>
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download MD5 sum: &libnl-md5sum;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Download size: &libnl-size;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated disk space required: &libnl-buildsize;
70 </para>
71 </listitem>
72 <listitem>
73 <para>
74 Estimated build time: &libnl-time;
75 </para>
76 </listitem>
77 </itemizedlist>
78
79 <bridgehead renderas="sect3">Optional Download</bridgehead>
80 <itemizedlist spacing="compact">
81 <listitem>
82 <para>
83 Download (HTTP): <ulink url="&libnl-doc-download-http;"/>
84 </para>
85 </listitem>
86 <listitem>
87 <para>
88 Download (FTP): <ulink url="&libnl-doc-download-ftp;"/>
89 </para>
90 </listitem>
91 <listitem>
92 <para>
93 Download MD5 sum: &libnl-doc-md5sum;
94 </para>
95 </listitem>
96 <listitem>
97 <para>
98 Download size: &libnl-doc-size;
99 </para>
100 </listitem>
101 </itemizedlist>
102<!--
103 <bridgehead renderas="sect3">libnl Dependencies</bridgehead>
104
105 <bridgehead renderas="sect4">Optional</bridgehead>
106 <para role="optional">
107 <xref linkend="check"/> (for tests)
108 </para>
109-->
110 <para condition="html" role="usernotes">User Notes:
111 <ulink url="&blfs-wiki;/libnl"/>
112 </para>
113 </sect2>
114
115 <sect2 role="installation">
116 <title>Installation of libnl</title>
117
118 <para>
119 Install <application>libnl</application> by running the following
120 commands:
121 </para>
122
123<screen><userinput>./configure --prefix=/usr \
124 --sysconfdir=/etc \
125 --disable-static &amp;&amp;
126make</userinput></screen>
127
128 <para>
129 To test the results, issue: <command>make check</command>.
130 </para>
131
132 <para>
133 Now, as the <systemitem class="username">root</systemitem> user:
134 </para>
135
136<screen role="root"><userinput>make install</userinput></screen>
137
138 <para>
139 If you wish to install the API documentation, as the
140 <systemitem class="username">root</systemitem> user:
141 </para>
142
143<screen role="root"><userinput>mkdir -vp /usr/share/doc/libnl-&libnl-version; &amp;&amp;
144tar -xf ../libnl-doc-&libnl-version;.tar.gz --strip-components=1 --no-same-owner \
145 -C /usr/share/doc/libnl-&libnl-version;</userinput></screen>
146
147 </sect2>
148
149 <sect2 role="commands">
150 <title>Command Explanations</title>
151
152 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
153 href="../../xincludes/static-libraries.xml"/>
154
155 <para>
156 <option>--disable-cli</option>: Use this parameter if you
157 don't want to install cli tools provided by the package.
158 </para>
159
160 </sect2>
161
162 <sect2 role="content">
163 <title>Contents</title>
164
165 <segmentedlist>
166 <segtitle>Installed Programs</segtitle>
167 <segtitle>Installed Libraries</segtitle>
168 <segtitle>Installed Directories</segtitle>
169
170 <seglistitem>
171 <seg>
172 genl-ctrl-list,
173 idiag-socket-details,
174 nl-class-add,
175 nl-class-delete,
176 nl-classid-lookup,
177 nl-class-list,
178 nl-cls-add,
179 nl-cls-delete,
180 nl-cls-list,
181 nl-link-list,
182 nl-pktloc-lookup,
183 nl-qdisc-add,
184 nl-qdisc-delete,
185 nl-qdisc-list, and 32 other helper programs with nl- and nf- prefixes
186 </seg>
187 <seg>
188 libnl-3.so,
189 libnl-cli-3.so,
190 libnl-genl-3.so,
191 libnl-idiag-3.so,
192 libnl-nf-3.so,
193 libnl-route-3.so,
194 libnl-xfrm-3.so, and
195 cli modules under /usr/lib/libnl/cli tree
196 </seg>
197 <seg>
198 /etc/libnl,
199 /usr/include/libnl3,
200 /usr/lib/libnl, and
201 /usr/share/doc/libnl-&libnl-version;
202 </seg>
203 </seglistitem>
204 </segmentedlist>
205
206 <variablelist>
207 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
208 <?dbfo list-presentation="list"?>
209 <?dbhtml list-presentation="table"?>
210
211 <varlistentry id="genl-ctrl-list">
212 <term><command>genl-ctrl-list</command></term>
213 <listitem>
214 <para>
215 queries the Generic Netlink controller in the kernel and prints
216 a list of all registered Generic Netlink families including
217 the version of the interface that has been registered.
218 </para>
219 <indexterm zone="libnl genl-ctrl-list">
220 <primary sortas="b-genl-ctrl-list">genl-ctrl-list</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="nl-class-add">
226 <term><command>nl-class-add</command></term>
227 <listitem>
228 <para>
229 adds, updates, or replaces Traffic Classes
230 </para>
231 <indexterm zone="libnl nl-class-add">
232 <primary sortas="b-nl-class-add">nl-class-add</primary>
233 </indexterm>
234 </listitem>
235 </varlistentry>
236
237 <varlistentry id="nl-class-delete">
238 <term><command>nl-class-delete</command></term>
239 <listitem>
240 <para>
241 deletes Traffic Classes
242 </para>
243 <indexterm zone="libnl nl-class-delete">
244 <primary sortas="b-nl-class-delete">nl-class-delete</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="nl-classid-lookup">
250 <term><command>nl-classid-lookup</command></term>
251 <listitem>
252 <para>
253 is used to resolve qdisc/class names to classid values and vice
254 versa.
255 </para>
256 <indexterm zone="libnl nl-classid-lookup">
257 <primary sortas="b-nl-classid-lookup">nl-classid-lookup</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="nl-class-list">
263 <term><command>nl-class-list</command></term>
264 <listitem>
265 <para>
266 lists Traffic Classes.
267 </para>
268 <indexterm zone="libnl nl-class-list">
269 <primary sortas="b-nl-class-list">nl-class-list</primary>
270 </indexterm>
271 </listitem>
272 </varlistentry>
273
274 <varlistentry id="nl-cls-add">
275 <term><command>nl-cls-add</command></term>
276 <listitem>
277 <para>
278 adds a classifier.
279 </para>
280 <indexterm zone="libnl nl-cls-add">
281 <primary sortas="b-nl-cls-add">nl-cls-add</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="nl-cls-delete">
287 <term><command>nl-cls-delete</command></term>
288 <listitem>
289 <para>
290 deletes a classifier.
291 </para>
292 <indexterm zone="libnl nl-cls-delete">
293 <primary sortas="b-nl-cls-delete">nl-cls-delete</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry id="nl-cls-list">
299 <term><command>nl-cls-list</command></term>
300 <listitem>
301 <para>
302 lists classifiers.
303 </para>
304 <indexterm zone="libnl nl-cls-list">
305 <primary sortas="b-nl-cls-list">nl-cls-list</primary>
306 </indexterm>
307 </listitem>
308 </varlistentry>
309
310 <varlistentry id="nl-link-list">
311 <term><command>nl-link-list</command></term>
312 <listitem>
313 <para>
314 dumps link attributes.
315 </para>
316 <indexterm zone="libnl nl-link-list">
317 <primary sortas="b-nl-link-list">nl-link-list</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="nl-pktloc-lookup">
323 <term><command>nl-pktloc-lookup</command></term>
324 <listitem>
325 <para>
326 allows the lookup of packet location definitions.
327 </para>
328 <indexterm zone="libnl nl-pktloc-lookup">
329 <primary sortas="b-nl-pktloc-lookup">nl-pktloc-lookup</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 <varlistentry id="nl-qdisc-add">
335 <term><command>nl-qdisc-add</command></term>
336 <listitem>
337 <para>
338 adds queueing disciplines (qdiscs) in the kernel.
339 </para>
340 <indexterm zone="libnl nl-qdisc-add">
341 <primary sortas="b-nl-qdisc-add">nl-qdisc-add</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="nl-qdisc-delete">
347 <term><command>nl-qdisc-delete</command></term>
348 <listitem>
349 <para>
350 deletes queueing disciplines (qdiscs) in the kernel.
351 </para>
352 <indexterm zone="libnl nl-qdisc-delete">
353 <primary sortas="b-nl-qdisc-delete">nl-qdisc-delete</primary>
354 </indexterm>
355 </listitem>
356 </varlistentry>
357
358 <varlistentry id="nl-qdisc-list">
359 <term><command>nl-qdisc-list</command></term>
360 <listitem>
361 <para>
362 lists queueing disciplines (qdiscs) in the kernel.
363 </para>
364 <indexterm zone="libnl nl-qdisc-list">
365 <primary sortas="b-nl-qdisc-list">nl-qdisc-list</primary>
366 </indexterm>
367 </listitem>
368 </varlistentry>
369
370 <varlistentry id="libnl-lib">
371 <term><filename class="libraryfile">libnl*-3.so</filename></term>
372 <listitem>
373 <para>
374 These libraries contain API functions used to access Netlink
375 interfaces in Linux kernel.
376 </para>
377 <indexterm zone="libnl libnl-lib">
378 <primary sortas="c-libnl">libnl*-3.so</primary>
379 </indexterm>
380 </listitem>
381 </varlistentry>
382
383 </variablelist>
384
385 </sect2>
386
387</sect1>
Note: See TracBrowser for help on using the repository browser.