source: general/genlib/apr.xml@ 9d154616

11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 9d154616 was 9d154616, checked in by Bruce Dubbs <bdubbs@…>, 17 months ago

Tag apr for -rc3 and clarify sed.

  • Property mode set to 100644
File size: 5.1 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 apr-download-http
8 "https://archive.apache.org/dist/apr/apr-&apr-version;.tar.bz2">
9 <!ENTITY apr-download-ftp
10 "ftp://ftp.mirrorservice.org/sites/ftp.apache.org/apr/apr-&apr-version;.tar.bz2">
11 <!ENTITY apr-md5sum "7a14a83d664e87599ea25ff4432e48a7">
12 <!ENTITY apr-size "852 KB">
13 <!ENTITY apr-buildsize "11 MB (additional 4 MB for the tests)">
14 <!ENTITY apr-time "0.2 SBU (add 1.7 SBU for tests)">
15]>
16
17<sect1 id="apr" xreflabel="Apr-&apr-version;">
18 <?dbhtml filename="apr.html"?>
19
20 <sect1info>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Apr-&apr-version;</title>
25
26 <indexterm zone="apr">
27 <primary sortas="a-apr">Apr</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Apr</title>
32
33 <para>
34 The Apache Portable Runtime (APR) is a supporting library for the
35 Apache web server. It provides a set of application programming interfaces
36 (APIs) that map to the underlying Operating System (OS). Where the OS
37 doesn't support a particular function, APR will provide an emulation. Thus
38 programmers can use the APR to make a program portable across different
39 platforms.
40 </para>
41
42 &lfs110a_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>
48 Download (HTTP): <ulink url="&apr-download-http;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download (FTP): <ulink url="&apr-download-ftp;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download MD5 sum: &apr-md5sum;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download size: &apr-size;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated disk space required: &apr-buildsize;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated build time: &apr-time;
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <para condition="html" role="usernotes">
79 User Notes: <ulink url="&blfs-wiki;/apr"/>
80 </para>
81 </sect2>
82
83 <sect2 role="installation">
84 <title>Installation of Apr</title>
85
86 <para>
87 First, fix a security issue:
88 </para>
89<!--
90<screen><userinput>sed '/{306/a \
91\
92 if (xt-&gt;tm_mon &lt; 0 || xt-&gt;tm_mon &gt;= 12) \
93 return APR_EBADDATE;' -i time/unix/time.c</userinput></screen>
94-->
95<screen><userinput>sed -e "/shift/i \
96\ if (xt-&gt;tm_mon &lt; 0 || xt-&gt;tm_mon &gt;= 12) return APR_EBADDATE;"
97 -i time/unix/time.c</userinput></screen>
98
99 <para>
100 Install <application>Apr</application> by running the following commands:
101 </para>
102
103<screen><userinput>./configure --prefix=/usr \
104 --disable-static \
105 --with-installbuilddir=/usr/share/apr-1/build &amp;&amp;
106make</userinput></screen>
107
108 <para>
109 To test the results, issue: <command>make test</command>. <!-- teststr is
110 known to hang on some systems. - WORKS AS OF 1.6.5 (renodr) -->
111 </para>
112
113 <para>
114 Now, as the <systemitem class="username">root</systemitem> user:
115 </para>
116
117<screen role="root"><userinput>make install</userinput></screen>
118 </sect2>
119
120 <sect2 role="commands">
121 <title>Command Explanations</title>
122
123 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
124 href="../../xincludes/static-libraries.xml"/>
125
126 </sect2>
127
128 <sect2 role="content">
129 <title>Contents</title>
130
131 <segmentedlist>
132 <segtitle>Installed Program</segtitle>
133 <segtitle>Installed Library</segtitle>
134 <segtitle>Installed Directories</segtitle>
135
136 <seglistitem>
137 <seg>
138 apr-1-config
139 </seg>
140 <seg>
141 libapr-1.so
142 </seg>
143 <seg>
144 /usr/include/apr-1 and
145 /usr/share/apr-1
146 </seg>
147 </seglistitem>
148 </segmentedlist>
149
150 <variablelist>
151 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
152 <?dbfo list-presentation="list"?>
153 <?dbhtml list-presentation="table"?>
154
155 <varlistentry id="apr-1-config">
156 <term><command>apr-1-config</command></term>
157 <listitem>
158 <para>
159 is a shell script used to retrieve information about the apr
160 library in the system. It is typically used to compile and link
161 against the library
162 </para>
163 <indexterm zone="apr apr-1-config">
164 <primary sortas="b-apr-1-config">apr-1-config</primary>
165 </indexterm>
166 </listitem>
167 </varlistentry>
168
169 <varlistentry id="libapr-1">
170 <term><filename class="libraryfile">libapr-1.so</filename></term>
171 <listitem>
172 <para>
173 is the Apache Portable Runtime library
174 </para>
175 <indexterm zone="apr libapr-1">
176 <primary sortas="c-libapr-1">libapr-1.so</primary>
177 </indexterm>
178 </listitem>
179 </varlistentry>
180 </variablelist>
181
182 </sect2>
183
184</sect1>
Note: See TracBrowser for help on using the repository browser.