source: postlfs/security/nss.xml@ 32dfda12

elogind
Last change on this file since 32dfda12 was 32dfda12, checked in by DJ Lucas <dj@…>, 6 years ago

Merge from HEAD at 20830

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

  • Property mode set to 100644
File size: 10.5 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<!-- for when .0 is not part of the new tarball name, but always referenced -->
8 <!ENTITY nss-url "archive.mozilla.org/pub/security/nss/releases">
9
10<!-- micro versions -->
11<!ENTITY nss-download-http "https://&nss-url;/NSS_3_&nss-minor-version;_&nss-micro-version;_RTM/src/nss-&nss-version;.tar.gz">
12
13<!-- no micro versions -->
14<!-- <!ENTITY nss-download-http "https://&nss-url;/NSS_3_&nss-minor-version;_RTM/src/nss-&nss-version;.tar.gz"> -->
15
16 <!ENTITY nss-download-ftp " ">
17 <!ENTITY nss-md5sum "589ab784db168e876bd9ae4eef294728">
18 <!ENTITY nss-size "23 MB">
19 <!ENTITY nss-buildsize "138 MB">
20 <!ENTITY nss-time "2.2 SBU">
21]>
22
23<sect1 id="nss" xreflabel="NSS-&nss-version;">
24 <?dbhtml filename="nss.html"?>
25
26 <sect1info>
27 <othername>$LastChangedBy$</othername>
28 <date>$Date$</date>
29 </sect1info>
30
31 <title>NSS-&nss-version;</title>
32
33 <indexterm zone="nss">
34 <primary sortas="a-NSS">NSS</primary>
35 </indexterm>
36
37 <sect2 role="package">
38 <title>Introduction to NSS</title>
39
40 <para>
41 The Network Security Services (<application>NSS</application>) package is
42 a set of libraries designed to support cross-platform development of
43 security-enabled client and server applications. Applications built with
44 NSS can support SSL v2 and v3, TLS, PKCS #5, PKCS #7, PKCS #11, PKCS #12,
45 S/MIME, X.509 v3 certificates, and other security standards. This is
46 useful for implementing SSL and S/MIME or other Internet security
47 standards into an application.
48 </para>
49
50 &lfs83_checked;
51
52 <bridgehead renderas="sect3">Package Information</bridgehead>
53 <itemizedlist spacing="compact">
54 <listitem>
55 <para>
56 Download (HTTP): <ulink url="&nss-download-http;"/>
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download (FTP): <ulink url="&nss-download-ftp;"/>
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Download MD5 sum: &nss-md5sum;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Download size: &nss-size;
72 </para>
73 </listitem>
74 <listitem>
75 <para>
76 Estimated disk space required: &nss-buildsize;
77 </para>
78 </listitem>
79 <listitem>
80 <para>
81 Estimated build time: &nss-time;
82 </para>
83 </listitem>
84 </itemizedlist>
85
86 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
87 <itemizedlist spacing="compact">
88 <listitem>
89 <para>
90 Required patch:
91 <ulink url="&patch-root;/nss-&nss-version;-standalone-1.patch"/>
92 </para>
93 </listitem>
94 </itemizedlist>
95
96 <bridgehead renderas="sect3">NSS Dependencies</bridgehead>
97
98 <bridgehead renderas="sect4">Required</bridgehead>
99 <para role="required">
100 <xref linkend="nspr"/>
101 </para>
102
103 <bridgehead renderas="sect4">Recommended</bridgehead>
104 <para role="recommended">
105 <xref linkend="sqlite"/> and
106 <xref role="runtime" linkend="p11-kit"/> (runtime)
107 </para>
108
109 <para condition="html" role="usernotes">
110 User Notes: <ulink url="&blfs-wiki;/nss"/>
111 </para>
112 </sect2>
113
114 <sect2 role="installation">
115 <title>Installation of NSS</title>
116
117 <note>
118 <para>
119 This package does not support parallel build.
120 </para>
121 </note>
122
123 <para>
124 Install <application>NSS</application> by running the following commands:
125 </para>
126
127<screen><userinput>patch -Np1 -i ../nss-&nss-version;-standalone-1.patch &amp;&amp;
128
129cd nss &amp;&amp;
130
131make -j1 BUILD_OPT=1 \
132 NSPR_INCLUDE_DIR=/usr/include/nspr \
133 USE_SYSTEM_ZLIB=1 \
134 ZLIB_LIBS=-lz \
135 NSS_ENABLE_WERROR=0 \
136 $([ $(uname -m) = x86_64 ] &amp;&amp; echo USE_64=1) \
137 $([ -f /usr/include/sqlite3.h ] &amp;&amp; echo NSS_USE_SYSTEM_SQLITE=1)</userinput></screen>
138
139 <para>
140 The testsuite is designed for testing changes to nss or nspr and is
141 not particularly useful for checking a released version (e.g. it needs
142 to be run on a non-optimized build with both nss and nspr directories
143 existing alongside each other). For further details, see the User Notes.
144 </para>
145
146 <para>
147 Now, as the <systemitem class="username">root</systemitem> user:
148 </para>
149
150<screen role="root"><userinput>cd ../dist &amp;&amp;
151
152install -v -m755 Linux*/lib/*.so /usr/lib &amp;&amp;
153install -v -m644 Linux*/lib/{*.chk,libcrmf.a} /usr/lib &amp;&amp;
154
155install -v -m755 -d /usr/include/nss &amp;&amp;
156cp -v -RL {public,private}/nss/* /usr/include/nss &amp;&amp;
157chmod -v 644 /usr/include/nss/* &amp;&amp;
158
159install -v -m755 Linux*/bin/{certutil,nss-config,pk12util} /usr/bin &amp;&amp;
160
161install -v -m644 Linux*/lib/pkgconfig/nss.pc /usr/lib/pkgconfig</userinput></screen>
162
163 </sect2>
164
165 <sect2 role="commands">
166 <title>Command Explanations</title>
167
168 <para>
169 <parameter>BUILD_OPT=1</parameter>: This option is passed to
170 <command>make</command> so that the build is performed with no debugging
171 symbols built into the binaries and the default compiler optimizations are
172 used.
173 </para>
174
175 <para>
176 <parameter>NSPR_INCLUDE_DIR=/usr/include/nspr</parameter>: This option
177 sets the location of the nspr headers.
178 </para>
179
180 <para>
181 <parameter>USE_SYSTEM_ZLIB=1</parameter>: This option is passed to
182 <command>make</command> to ensure that the
183 <filename class="libraryfile">libssl3.so</filename> library is linked to
184 the system installed <application>zlib</application> instead of the
185 in-tree version.
186 </para>
187
188 <para>
189 <parameter>ZLIB_LIBS=-lz</parameter>: This option provides the
190 linker flags needed to link to the system <application>zlib</application>.
191 </para>
192
193 <para>
194 <command>$([ $(uname -m) = x86_64 ] &amp;&amp; echo USE_64=1)</command>:
195 The <parameter>USE_64=1</parameter> option is <emphasis>required on
196 x86_64</emphasis>, otherwise <command>make</command> will try (and fail)
197 to create 32-bit objects. The [ $(uname -m) = x86_64 ] test ensures it
198 has no effect on a 32 bit system.
199 </para>
200
201 <para>
202 <command>([ -f /usr/include/sqlite3.h ] &amp;&amp; echo
203 NSS_USE_SYSTEM_SQLITE=1)</command>: This tests if
204 <application>sqlite</application> is installed and if so it
205 <command>echo</command>s the option NSS_USE_SYSTEM_SQLITE=1 to
206 <command>make</command> so that
207 <filename class="libraryfile">libsoftokn3.so</filename> will link against
208 the system version of sqlite.
209 </para>
210
211 </sect2>
212
213 <sect2 role="configuration">
214 <title>Configuring NSS</title>
215
216 <para>If <xref linkend="p11-kit"/> is installed, the
217 <application>p11-kit</application> trust module
218 (<filename>/usr/lib/pkcs11/p11-kit-trust.so</filename>) can be used as a
219 drop-in replacement for <filename>/usr/lib/libnssckbi.so</filename> to
220 transparently make the system CAs available to
221 <application>NSS</application> aware applications, rather than the static
222 list provided by <filename>/usr/lib/libnssckbi.so</filename>. As the
223 <systemitem class="username">root</systemitem> user, execute the following
224 commands:</para>
225
226<screen role="root"><userinput>if [ -e /usr/lib/libp11-kit.so ]; then
227 readlink /usr/lib/libnssckbi.so ||
228 rm -v /usr/lib/libnssckbi.so &amp;&amp;
229 ln -sfv ./pkcs11/p11-kit-trust.so /usr/lib/libnssckbi.so
230fi</userinput></screen>
231
232 <para>Additionally, for dependent applications that do not use the internal
233 database (<filename>/usr/lib/libnssckbi.so</filename>), the
234 <filename>/usr/sbin/make-ca</filename> script, included on the
235 <xref linkend="make-ca"/> page, will generate a system wide NSS DB.</para>
236
237 </sect2>
238
239 <sect2 role="content">
240 <title>Contents</title>
241
242 <segmentedlist>
243 <segtitle>Installed Programs</segtitle>
244 <segtitle>Installed Libraries</segtitle>
245 <segtitle>Installed Directories</segtitle>
246
247 <seglistitem>
248 <seg>
249 certutil, nss-config, and pk12util
250 </seg>
251 <seg>
252 libcrmf.a, libfreebl3.so, libfreeblpriv3.so, libgtest1.so, libnss3.so,
253 libnssckbi.so, libnssdbm3.so, libnsssysinit.so,
254 libnssutil3.so, libsmime3.so, libsoftokn3.so, and libssl3.so
255 </seg>
256 <seg>
257 /usr/include/nss
258 </seg>
259 </seglistitem>
260 </segmentedlist>
261
262 <variablelist>
263 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
264 <?dbfo list-presentation="list"?>
265 <?dbhtml list-presentation="table"?>
266
267 <varlistentry id="certutil">
268 <term><command>certutil</command></term>
269 <listitem>
270 <para>
271 is the Mozilla Certificate Database Tool. It is a command-line
272 utility that can create and modify the Netscape Communicator
273 cert8.db and key3.db database files. It can also list, generate,
274 modify, or delete certificates within the cert8.db file and create
275 or change the password, generate new public and private key pairs,
276 display the contents of the key database, or delete key pairs within
277 the key3.db file.
278 </para>
279 <indexterm zone="nss certutil">
280 <primary sortas="b-certutil">certutil</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="nss-config">
286 <term><command>nss-config</command></term>
287 <listitem>
288 <para>
289 is used to determine the NSS library settings of the installed NSS
290 libraries.
291 </para>
292 <indexterm zone="nss nss-config">
293 <primary sortas="b-nss-config">nss-config</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry id="pk12util">
299 <term><command>pk12util</command></term>
300 <listitem>
301 <para>
302 is a tool for importing certificates and keys from pkcs #12 files
303 into NSS or exporting them. It can also list certificates and keys
304 in such files.
305 </para>
306 <indexterm zone="nss pk12util">
307 <primary sortas="b-pk12util">pk12util</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 </variablelist>
313
314 </sect2>
315
316</sect1>
Note: See TracBrowser for help on using the repository browser.