source: postlfs/security/nss.xml@ 2beaab8

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 12.2 7.10 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gimp3 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 2beaab8 was 2beaab8, checked in by Fernando de Oliveira <fernando@…>, 9 years ago
  • mercurial-3.7: try to improve the text and minor reformats.
  • Update to nss-3.22.
  • Update to iso-codes-3.65.

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

  • Property mode set to 100644
File size: 9.2 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 -->
8 <!ENTITY nss-url "ftp.mozilla.org/pub/mozilla.org/security/nss/releases">
9
10<!-- <!ENTITY nss-download-http "https://&nss-url;/NSS_3_&nss-minor-version;_&nss-micro-version;_RTM/src/nss-&nss-version;.tar.gz">-->
11<!-- <!ENTITY nss-download-ftp "ftp://&nss-url;/NSS_3_&nss-minor-version;_&nss-micro-version;_RTM/src/nss-&nss-version;.tar.gz">-->
12<!ENTITY nss-download-ftp " ">
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<!--<!ENTITY nss-download-ftp "ftp://&nss-url;/NSS_3_&nss-minor-version;_RTM/src/nss-&nss-version;.tar.gz"> -->
16
17 <!ENTITY nss-md5sum "07dfe5bed80cf44caa9a06e8eb043742">
18 <!ENTITY nss-size "6.7 MB">
19 <!ENTITY nss-buildsize "91 MB">
20 <!ENTITY nss-time "0.9 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 &lfs78_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"/>
106 </para>
107
108 <para condition="html" role="usernotes">
109 User Notes: <ulink url="&blfs-wiki;/nss"/>
110 </para>
111 </sect2>
112
113 <sect2 role="installation">
114 <title>Installation of NSS</title>
115
116 <note>
117 <para>
118 This package does not support parallel build.
119 </para>
120 </note>
121
122 <para>
123 Install <application>NSS</application> by running the following commands:
124 </para>
125
126<screen><userinput>patch -Np1 -i ../nss-&nss-version;-standalone-1.patch &amp;&amp;
127
128cd nss &amp;&amp;
129
130make -j1 BUILD_OPT=1 \
131 NSPR_INCLUDE_DIR=/usr/include/nspr \
132 USE_SYSTEM_ZLIB=1 \
133 ZLIB_LIBS=-lz \
134 $([ $(uname -m) = x86_64 ] &amp;&amp; echo USE_64=1) \
135 $([ -f /usr/include/sqlite3.h ] &amp;&amp; echo NSS_USE_SYSTEM_SQLITE=1)</userinput></screen>
136
137 <para>
138 This package does not come with a test suite.
139 </para>
140
141 <para>
142 Now, as the <systemitem class="username">root</systemitem> user:
143 </para>
144
145<screen role="root"><userinput>cd ../dist &amp;&amp;
146
147install -v -m755 Linux*/lib/*.so /usr/lib &amp;&amp;
148install -v -m644 Linux*/lib/{*.chk,libcrmf.a} /usr/lib &amp;&amp;
149
150install -v -m755 -d /usr/include/nss &amp;&amp;
151cp -v -RL {public,private}/nss/* /usr/include/nss &amp;&amp;
152chmod -v 644 /usr/include/nss/* &amp;&amp;
153
154install -v -m755 Linux*/bin/{certutil,nss-config,pk12util} /usr/bin &amp;&amp;
155
156install -v -m644 Linux*/lib/pkgconfig/nss.pc /usr/lib/pkgconfig
157</userinput></screen>
158
159 </sect2>
160
161 <sect2 role="commands">
162 <title>Command Explanations</title>
163
164 <para>
165 <parameter>BUILD_OPT=1</parameter>: This option is passed to
166 <command>make</command> so that the build is performed with no debugging
167 symbols built into the binaries and the default compiler optimizations are
168 used.
169 </para>
170
171 <para>
172 <parameter>NSPR_INCLUDE_DIR=/usr/include/nspr</parameter>: This option
173 sets the location of the nspr headers.
174 </para>
175
176 <para>
177 <parameter>USE_SYSTEM_ZLIB=1</parameter>: This option is passed to
178 <command>make</command> to ensure that the
179 <filename class="libraryfile">libssl3.so</filename> library is linked to
180 the system installed <application>zlib</application> instead of the
181 in-tree version.
182 </para>
183
184 <para>
185 <parameter>ZLIB_LIBS=-lz</parameter>: This option provides the
186 linker flags needed to link to the system <application>zlib</application>.
187 </para>
188
189 <para>
190 <command>$([ $(uname -m) = x86_64 ] &amp;&amp; echo USE_64=1)</command>:
191 The <parameter>USE_64=1</parameter> option is <emphasis>required on
192 x86_64</emphasis>, otherwise <command>make</command> will try (and fail)
193 to create 32-bit objects. The [ $(uname -m) = x86_64 ] test ensures it
194 has no effect on a 32 bit system.
195 </para>
196
197 <para>
198 <command>([ -f /usr/include/sqlite3.h ] &amp;&amp; echo
199 NSS_USE_SYSTEM_SQLITE=1)</command>: This tests if
200 <application>sqlite</application> is installed and if so it
201 <command>echo</command>s the option NSS_USE_SYSTEM_SQLITE=1 to
202 <command>make</command> so that
203 <filename class="libraryfile">libsoftokn3.so</filename> will link against
204 the system version of sqlite.
205 </para>
206
207 </sect2>
208
209 <sect2 role="content">
210 <title>Contents</title>
211
212 <segmentedlist>
213 <segtitle>Installed Programs</segtitle>
214 <segtitle>Installed Libraries</segtitle>
215 <segtitle>Installed Directories</segtitle>
216
217 <seglistitem>
218 <seg>
219 certutil, nss-config, and pk12util
220 </seg>
221 <seg>
222 libcrmf.a, libfreebl3.so, libgtest1.so, libnss3.so,
223 libnssckbi.so, libnssdbm3.so, libnsssysinit.so,
224 libnssutil3.so, libsmime3.so, libsoftokn3.so, and libssl3.so
225 </seg>
226 <seg>
227 /usr/include/nss
228 </seg>
229 </seglistitem>
230 </segmentedlist>
231
232 <variablelist>
233 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
234 <?dbfo list-presentation="list"?>
235 <?dbhtml list-presentation="table"?>
236
237 <varlistentry id="certutil">
238 <term><command>certutil</command></term>
239 <listitem>
240 <para>
241 is the Mozilla Certificate Database Tool. It is a command-line
242 utility that can create and modify the Netscape Communicator
243 cert8.db and key3.db database files. It can also list, generate,
244 modify, or delete certificates within the cert8.db file and create
245 or change the password, generate new public and private key pairs,
246 display the contents of the key database, or delete key pairs within
247 the key3.db file.
248 </para>
249 <indexterm zone="nss certutil">
250 <primary sortas="b-certutil">certutil</primary>
251 </indexterm>
252 </listitem>
253 </varlistentry>
254
255 <varlistentry id="nss-config">
256 <term><command>nss-config</command></term>
257 <listitem>
258 <para>
259 is used to determine the NSS library settings of the installed NSS
260 libraries.
261 </para>
262 <indexterm zone="nss nss-config">
263 <primary sortas="b-nss-config">nss-config</primary>
264 </indexterm>
265 </listitem>
266 </varlistentry>
267
268 <varlistentry id="pk12util">
269 <term><command>pk12util</command></term>
270 <listitem>
271 <para>
272 is a tool for importing certificates and keys from pkcs #12 files
273 into NSS or exporting them. It can also list certificates and keys
274 in such files.
275 </para>
276 <indexterm zone="nss pk12util">
277 <primary sortas="b-pk12util">pk12util</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
281
282 </variablelist>
283
284 </sect2>
285
286</sect1>
Note: See TracBrowser for help on using the repository browser.