source: general/prog/python2.xml@ 292ff45

11.0 qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 292ff45 was 292ff45, checked in by Ken Moffat <ken@…>, 6 months ago

Patch Python-2.7.18 for vulnerabilities.

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

  • Property mode set to 100644
File size: 11.8 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 python2-download-http
8 "https://www.python.org/ftp/python/&python2-version;/Python-&python2-version;.tar.xz">
9 <!ENTITY python2-download-ftp " ">
10 <!ENTITY python2-md5sum "fd6cc8ec0a78c44036f825e739f36e5a">
11 <!ENTITY python2-size "12.2 MB">
12 <!ENTITY python2-buildsize "228 MB (add 17 MB for tests)">
13 <!ENTITY python2-time "0.5 SBU (Using parallelism=4; add 5.9 SBU for tests)">
14
15 <!ENTITY python2htmldoc-download-http
16 "https://docs.python.org/ftp/python/doc/&python2-version;/python-&python2-version;-docs-html.tar.bz2">
17]>
18
19<sect1 id="python2" xreflabel="Python-&python2-version;">
20 <?dbhtml filename="python2.html" ?>
21
22 <sect1info>
23 <othername>$LastChangedBy$</othername>
24 <date>$Date$</date>
25 </sect1info>
26
27 <title>Python-&python2-version;</title>
28
29 <indexterm zone="python2">
30 <primary sortas="a-Python2">Python2</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to Python 2</title>
35
36 <para>
37 The <application>Python 2</application> package contains the
38 <application>Python</application> development environment. It is useful
39 for object-oriented programming, writing scripts, prototyping large
40 programs or developing entire applications. This version is for backward
41 compatibility with other dependent packages.
42 </para>
43
44 <note>
45 <para>
46 Python2 has been deprecated by the upstream developers.
47 Support for Python2 was discontinued on January 1st, 2020.
48 </para>
49
50 <para>
51 BLFS is attempting to use Python3 as much as possible, but some
52 packages have not been updated to support Python3.
53 </para>
54 </note>
55
56 &lfs101_checked;
57
58 <bridgehead renderas="sect3">Package Information</bridgehead>
59 <itemizedlist spacing="compact">
60 <listitem>
61 <para>
62 Download (HTTP): <ulink url="&python2-download-http;"/>
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download (FTP): <ulink url="&python2-download-ftp;"/>
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Download MD5 sum: &python2-md5sum;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Download size: &python2-size;
78 </para>
79 </listitem>
80 <listitem>
81 <para>
82 Estimated disk space required: &python2-buildsize;
83 </para>
84 </listitem>
85 <listitem>
86 <para>
87 Estimated build time: &python2-time;
88 </para>
89 </listitem>
90 </itemizedlist>
91
92 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
93
94 <itemizedlist spacing="compact">
95 <listitem>
96 <para>
97 Required patch:
98 <ulink url="&patch-root;/Python-&python2-version;-security_fixes-1.patch"/>
99 </para>
100 </listitem>
101 <listitem>
102 <para>
103 Optional HTML Documentation: <ulink url="&python2htmldoc-download-http;"/>
104 </para>
105 </listitem>
106 </itemizedlist>
107
108
109 <bridgehead renderas="sect3">Python 2 Dependencies</bridgehead>
110<!--
111 <bridgehead renderas="sect4">Recommended</bridgehead>
112 <para role="recommended">
113 <xref linkend="libffi"/>
114 </para>
115-->
116 <bridgehead renderas="sect4">Optional</bridgehead>
117 <para role="optional">
118 <xref linkend="bluez"/> and
119 <xref linkend="valgrind"/>
120 </para>
121
122 <bridgehead renderas="sect4">Optional (For Additional Modules)</bridgehead>
123 <para role="optional">
124 <xref linkend="sqlite"/> and
125 <xref linkend="tk"/>
126 </para>
127
128 <para condition="html" role="usernotes">
129 User Notes: <ulink url="&blfs-wiki;/Python"/>
130 </para>
131 </sect2>
132
133 <sect2 role="installation">
134 <title>Installation of Python 2</title>
135<!--
136 <caution>
137 <para>
138 After installing this package or
139 updating <application>pip2</application> with the command
140 <command>pip2 install - -upgrade pip</command>, it will remove
141 <application>pip3</application> installed in LFS. To reset
142 <application>pip</application> and <application>pip3</application>,
143 run, as the <systemitem class="username">root</systemitem> user:
144 </para>
145
146<screen role="nodump"><userinput>python3 -m pip install - -force pip</userinput></screen>
147 </caution>
148-->
149 <para>
150 First, disable the installation of a script that overwrites a more
151 recent script:
152 </para>
153
154<screen><userinput>sed -i '/2to3/d' ./setup.py</userinput></screen>
155
156 <para>
157 Install <application>Python 2</application> by running the following
158 commands:
159 </para>
160
161<screen><userinput>
162patch -Np1 -i ../Python-&python2-version;-security_fixes-1.patch &amp;&amp;
163./configure --prefix=/usr \
164 --enable-shared \
165 --with-system-expat \
166 --with-system-ffi \
167 --enable-unicode=ucs4 &amp;&amp;
168make</userinput></screen>
169
170 <para>
171 If you invoke the tests, they will run through twice.
172 To test the results, issue: <command>make -k test</command>.
173 </para>
174
175 <para>
176 Now, as the <systemitem class="username">root</systemitem> user:
177 </para>
178
179<screen role="root"><userinput>make altinstall &amp;&amp;
180ln -s python2.7 /usr/bin/python2 &amp;&amp;
181ln -s python2.7-config /usr/bin/python2-config &amp;&amp;
182chmod -v 755 /usr/lib/libpython&python2-majorver;.so.1.0</userinput></screen>
183
184 <para>
185 Since <application>Python 2</application> is in maintenance mode, and
186 <application>Python 3</application> is recommended by upstream for
187 development, you probably do not need to install the documentation.
188 However, if you still want to install documentation for both
189 <application>Python</application> versions, be sure to define the
190 <envar>PYTHONDOCS</envar>
191 variable for the version you want to use, each time you need to consult
192 the documentation. If you have downloaded the preformatted documentation
193 from <ulink url="http://docs.python.org/download.html"/>, install it
194 as the <systemitem class="username">root</systemitem> user:
195 </para>
196
197<screen role="root"><userinput>install -v -dm755 /usr/share/doc/python-&python2-version; &amp;&amp;
198
199tar --strip-components=1 \
200 --no-same-owner \
201 --directory /usr/share/doc/python-&python2-version; \
202 -xvf ../python-&python2-version;-docs-html.tar.bz2 &amp;&amp;
203
204find /usr/share/doc/python-&python2-version; -type d -exec chmod 0755 {} \; &amp;&amp;
205find /usr/share/doc/python-&python2-version; -type f -exec chmod 0644 {} \;</userinput></screen>
206 </sect2>
207
208 <sect2 role="commands">
209 <title>Command Explanations</title>
210
211 <para>
212 <parameter>--with-system-expat</parameter>: This switch enables linking
213 against system version of <application>Expat</application>.
214 </para>
215
216 <para>
217 <parameter>--with-system-ffi</parameter>: This switch enables linking
218 against system version of <application>libffi</application>.
219 </para>
220
221 <para>
222 <parameter>--enable-unicode=ucs4</parameter>: This switch enables
223 32bit Unicode support in <application>Python</application>.
224 </para>
225
226 <para>
227 <option>--with-ensurepip=yes</option> : This switch enables building
228 <command>pip</command> and <command>setuptools</command> packaging programs.
229 <command>setuptools</command> is needed for building some Python modules.
230 This switch is not recommended because this version of Python is being phased out.
231 </para>
232
233 <para>
234 <option>--with-dbmliborder=bdb:gdbm:ndbm</option>: Use this switch
235 if you want to build <application>Python</application> DBM Module
236 against <application>Berkeley DB</application> instead of
237 <application>GDBM</application>.
238 </para>
239
240 <para>
241 <command>make altinstall</command>: This make target omits some default
242 symbolic links that may interfere with Python 3.
243 </para>
244
245 <para>
246 <command>chmod ...</command>: Fix permissions for libraries to be
247 consistent with other libraries.
248 </para>
249
250 </sect2>
251
252 <sect2 role="configuration">
253 <title>Configuring Python 2</title>
254
255 <para>
256 In order for <command>python</command> to find the installed
257 documentation, you must add the following environment variable to
258 individual user's or the system's profile:
259 </para>
260
261<screen role="root"><userinput>export PYTHONDOCS=/usr/share/doc/python-&python2-version;</userinput></screen>
262
263 </sect2>
264
265 <sect2 role="content">
266 <title>Contents</title>
267
268 <segmentedlist>
269 <segtitle>Installed Programs</segtitle>
270 <segtitle>Installed Library</segtitle>
271 <segtitle>Installed Directories</segtitle>
272
273 <seglistitem>
274 <seg>
275 pydoc,
276 python2 (symlink),
277 python2-config (symlink),
278 python&python2-majorver;,
279 python&python2-majorver;-config,
280 smtpd.py, and
281 idle
282 </seg>
283 <seg>
284 libpython&python2-majorver;.so
285 </seg>
286 <seg>
287 /usr/{include,lib}/python&python2-majorver; and
288 /usr/share/doc/python-&python2-version;
289 </seg>
290 </seglistitem>
291 </segmentedlist>
292
293 <variablelist>
294 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
295 <?dbfo list-presentation="list"?>
296 <?dbhtml list-presentation="table"?>
297
298 <varlistentry id="idle">
299 <term><command>idle</command></term>
300 <listitem>
301 <para>
302 is a wrapper script that opens a <application>Python</application>
303 aware GUI editor. For this script to run, you must have installed
304 <application>Tk</application> before Python so that the Tkinter
305 Python module is built
306 </para>
307 <indexterm zone="python2 idle">
308 <primary sortas="b-idle">idle</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="pydoc2">
314 <term><command>pydoc</command></term>
315 <listitem>
316 <para>
317 is the <application>Python</application> documentation tool
318 </para>
319 <indexterm zone="python2 pydoc2">
320 <primary sortas="b-pydoc2">pydoc</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324
325 <varlistentry id="python">
326 <term><command>python2</command></term>
327 <listitem>
328 <para>
329 is an interpreted, interactive, object-oriented programming
330 language
331 </para>
332 <indexterm zone="python2 python">
333 <primary sortas="b-python2">python</primary>
334 </indexterm>
335 </listitem>
336 </varlistentry>
337
338 <varlistentry id="python2-ver">
339 <term><command>python&python2-majorver;</command></term>
340 <listitem>
341 <para>
342 is a version-specific name for the <command>python</command>
343 program
344 </para>
345 <indexterm zone="python2 python2-ver">
346 <primary sortas="b-python&python2-majorver;">python&python2-majorver;</primary>
347 </indexterm>
348 </listitem>
349 </varlistentry>
350
351 <varlistentry id="smtpd.py">
352 <term><command>smtpd.py</command></term>
353 <listitem>
354 <para>
355 is an SMTP proxy implemented in <application>Python</application>
356 </para>
357 <indexterm zone="python2 smtpd.py">
358 <primary sortas="b-smtpd.py">smtpd.py</primary>
359 </indexterm>
360 </listitem>
361 </varlistentry>
362
363 </variablelist>
364
365 </sect2>
366
367</sect1>
Note: See TracBrowser for help on using the repository browser.