source: networking/netlibs/ldns.xml@ 81076bb6

10.0 10.1 11.0 8.4 9.0 9.1 qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 81076bb6 was 81076bb6, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tags for networking and postscript.
Archive two unused files.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21198 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 "74b75c9ba69fb3af2a0c26244ecfd9f6">
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 &lfs84_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><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"><userinput>install -v -m755 -d /usr/share/doc/ldns-&ldns-version; &amp;&amp;
133install -v -m644 doc/html/* /usr/share/doc/ldns-&ldns-version;</userinput></screen>
134
135 </sect2>
136
137 <sect2 role="commands">
138 <title>Command Explanations</title>
139
140 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
141 href="../../xincludes/static-libraries.xml"/>
142
143 <para>
144 <parameter>--with-drill</parameter>: This option enables building of the
145 <command>drill</command> tool (used for obtaining debug information
146 from DNS(SEC))
147 </para>
148
149 <para>
150 <option>--disable-dane-ta-usage</option>: This option disables DANE-TA
151 (DNS-Based Authentication of Named Entities) support. It is only needed
152 if OpenSSL-1.1.0 or later is not installed.
153 </para>
154
155 <para>
156 <option>--with-examples</option>: This option enables building of the
157 example programs.
158 </para>
159
160 <para>
161 <option>--with-pyldns</option>: This option enables building of the Python
162 bindings.
163 </para>
164
165 </sect2>
166
167 <sect2 role="content">
168 <title>Contents</title>
169
170 <segmentedlist>
171 <segtitle>Installed Programs</segtitle>
172 <segtitle>Installed Library</segtitle>
173 <segtitle>Installed Directories</segtitle>
174
175 <seglistitem>
176 <seg>
177 drill and ldns-config
178 </seg>
179 <seg>
180 libldns.so and
181 /usr/lib/python&python2-majorver;/site-packages/_ldns.so
182 </seg>
183 <seg>
184 /usr/include/ldns and /usr/share/doc/ldns-&ldns-version;
185 </seg>
186 </seglistitem>
187 </segmentedlist>
188
189 <variablelist>
190 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
191 <?dbfo list-presentation="list"?>
192 <?dbhtml list-presentation="table"?>
193
194 <varlistentry id="drill">
195 <term><command>drill</command></term>
196 <listitem>
197 <para>
198 is a tool like <command>dig</command> from
199 <xref linkend="bind-utils"/> designed to get all sorts of
200 information out of the DNS.
201 </para>
202 <indexterm zone="ldns drill">
203 <primary sortas="b-drill">drill</primary>
204 </indexterm>
205 </listitem>
206 </varlistentry>
207
208 <varlistentry id="ldns-config">
209 <term><command>ldns-config</command></term>
210 <listitem>
211 <para>
212 shows compiler and linker flags for ldns usage.
213 </para>
214 <indexterm zone="ldns ldns-config">
215 <primary sortas="b-ldns-config">ldns-config</primary>
216 </indexterm>
217 </listitem>
218 </varlistentry>
219
220 <varlistentry id="libldns">
221 <term><filename class="libraryfile">libldns.so</filename></term>
222 <listitem>
223 <para>
224 provides the <application>ldns</application> API functions to
225 programs.
226 </para>
227 <indexterm zone="ldns libldns">
228 <primary sortas="c-libldns">libldns.so</primary>
229 </indexterm>
230 </listitem>
231 </varlistentry>
232
233 </variablelist>
234
235 </sect2>
236
237</sect1>
Note: See TracBrowser for help on using the repository browser.