source: networking/netlibs/ldns.xml@ 22c3cdd7

10.0 10.1 11.0 11.1 11.2 9.0 9.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 22c3cdd7 was 22c3cdd7, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tag remaining netwroking paclages

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

  • Property mode set to 100644
File size: 6.7 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 ldns-download-http "http://www.nlnetlabs.nl/downloads/ldns/ldns-&ldns-version;.tar.gz">
8 <!ENTITY ldns-download-ftp " ">
9 <!ENTITY ldns-md5sum "166262a46995d9972aba417fd091acd5">
10 <!ENTITY ldns-size "1.2 MB">
11 <!ENTITY ldns-buildsize "28 MB (with docs)">
12 <!ENTITY ldns-time "0.2 SBU (with docs)">
13]>
14
15<sect1 id="ldns" xreflabel="ldns-&ldns-version;">
16 <?dbhtml filename="ldns.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>ldns-&ldns-version;</title>
24
25 <indexterm zone="ldns">
26 <primary sortas="a-ldns">ldns</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to ldns</title>
31
32 <para>
33 <application>ldns</application> is a fast DNS library with the goal to
34 simplify DNS programming and to allow developers to easily create software
35 conforming to current RFCs and Internet drafts. This packages also
36 includes the <command>drill</command> tool.
37 </para>
38
39 &lfs90_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&ldns-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&ldns-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &ldns-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &ldns-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &ldns-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &ldns-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">ldns Dependencies</bridgehead>
76<!--
77 <bridgehead renderas="sect4">Recommended</bridgehead>
78 <para role="recommended">
79 <xref linkend="openssl"/>
80 </para>
81-->
82 <bridgehead renderas="sect4">Optional</bridgehead>
83 <para role="optional">
84 <xref linkend="make-ca"/> and
85 <xref linkend="libpcap"/> (for example programs),
86 <xref linkend="python2"/> and
87 <xref linkend="swig"/> (for Python bindings), and
88 <xref linkend="doxygen"/> (for html documentation)
89 </para>
90
91 <para condition="html" role="usernotes">User Notes:
92 <ulink url="&blfs-wiki;/ldns"/>
93 </para>
94 </sect2>
95
96 <sect2 role="installation">
97 <title>Installation of ldns</title>
98
99 <para>
100 Install <application>ldns</application> by running the following
101 commands:
102 </para>
103
104<screen><userinput>./configure --prefix=/usr \
105 --sysconfdir=/etc \
106 --disable-static \
107 --with-drill &amp;&amp;
108make</userinput></screen>
109
110 <para>
111 If you have <xref linkend="doxygen"/> installed and want to build
112 html documentation, run the following command:
113 </para>
114
115<screen remap="doc"><userinput>make doc</userinput></screen>
116
117 <para>
118 This package does not come with a working test suite.
119 </para>
120
121 <para>
122 Now, as the <systemitem class="username">root</systemitem> user:
123 </para>
124
125<screen role="root"><userinput>make install</userinput></screen>
126
127 <para>
128 If you built html documentation, install it by running the following
129 commands as the <systemitem class="username">root</systemitem> user:
130 </para>
131
132<screen role="root"
133 remap="doc"><userinput>install -v -m755 -d /usr/share/doc/ldns-&ldns-version; &amp;&amp;
134install -v -m644 doc/html/* /usr/share/doc/ldns-&ldns-version;</userinput></screen>
135
136 </sect2>
137
138 <sect2 role="commands">
139 <title>Command Explanations</title>
140
141 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
142 href="../../xincludes/static-libraries.xml"/>
143
144 <para>
145 <parameter>--with-drill</parameter>: This option enables building of the
146 <command>drill</command> tool (used for obtaining debug information
147 from DNS(SEC))
148 </para>
149
150 <para>
151 <option>--disable-dane-ta-usage</option>: This option disables DANE-TA
152 (DNS-Based Authentication of Named Entities) support. It is only needed
153 if OpenSSL-1.1.0 or later is not installed.
154 </para>
155
156 <para>
157 <option>--with-examples</option>: This option enables building of the
158 example programs.
159 </para>
160
161 <para>
162 <option>--with-pyldns</option>: This option enables building of the Python
163 bindings.
164 </para>
165
166 </sect2>
167
168 <sect2 role="content">
169 <title>Contents</title>
170
171 <segmentedlist>
172 <segtitle>Installed Programs</segtitle>
173 <segtitle>Installed Library</segtitle>
174 <segtitle>Installed Directories</segtitle>
175
176 <seglistitem>
177 <seg>
178 drill and ldns-config
179 </seg>
180 <seg>
181 libldns.so and
182 /usr/lib/python&python2-majorver;/site-packages/_ldns.so
183 </seg>
184 <seg>
185 /usr/include/ldns and /usr/share/doc/ldns-&ldns-version;
186 </seg>
187 </seglistitem>
188 </segmentedlist>
189
190 <variablelist>
191 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
192 <?dbfo list-presentation="list"?>
193 <?dbhtml list-presentation="table"?>
194
195 <varlistentry id="drill">
196 <term><command>drill</command></term>
197 <listitem>
198 <para>
199 is a tool like <command>dig</command> from
200 <xref linkend="bind-utils"/> designed to get all sorts of
201 information out of the DNS.
202 </para>
203 <indexterm zone="ldns drill">
204 <primary sortas="b-drill">drill</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
209 <varlistentry id="ldns-config">
210 <term><command>ldns-config</command></term>
211 <listitem>
212 <para>
213 shows compiler and linker flags for ldns usage.
214 </para>
215 <indexterm zone="ldns ldns-config">
216 <primary sortas="b-ldns-config">ldns-config</primary>
217 </indexterm>
218 </listitem>
219 </varlistentry>
220
221 <varlistentry id="libldns">
222 <term><filename class="libraryfile">libldns.so</filename></term>
223 <listitem>
224 <para>
225 provides the <application>ldns</application> API functions to
226 programs.
227 </para>
228 <indexterm zone="ldns libldns">
229 <primary sortas="c-libldns">libldns.so</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 </variablelist>
235
236 </sect2>
237
238</sect1>
Note: See TracBrowser for help on using the repository browser.