source: general/prog/gc.xml@ 4de23175

10.0 10.1 11.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 4de23175 was 4de23175, checked in by Douglas R. Reno <renodr@…>, 20 months ago

A few tags

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

  • Property mode set to 100644
File size: 5.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 gc-download-http "http://www.hboehm.info/gc/gc_source/gc-&gc-version;.tar.gz">
8 <!ENTITY gc-download-ftp " ">
9 <!ENTITY gc-md5sum "67a5093e2f9f381bd550aa891d00b54b">
10 <!ENTITY gc-size "1.1 MB">
11 <!ENTITY gc-buildsize "11 MB (with tests)">
12 <!ENTITY gc-time "0.2 SBU (with tests)">
13]>
14
15<sect1 id="gc" xreflabel="GC-&gc-version;">
16 <?dbhtml filename="gc.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>GC-&gc-version;</title>
24
25 <indexterm zone="gc">
26 <primary sortas="a-GC">GC</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to GC</title>
31
32 <para>
33 The <application>GC</application> package contains the Boehm-Demers-Weiser
34 conservative garbage collector, which can be used as a garbage collecting
35 replacement for the C malloc function or C++ new operator. It allows you
36 to allocate memory basically as you normally would, without explicitly
37 deallocating memory that is no longer useful. The collector automatically
38 recycles memory when it determines that it can no longer be otherwise
39 accessed. The collector is also used by a number of programming language
40 implementations that either use C as intermediate code, want to facilitate
41 easier interoperation with C libraries, or just prefer the simple
42 collector interface. Alternatively, the garbage collector may be used as a
43 leak detector for C or C++ programs, though that is not its primary goal.
44 </para>
45
46 &lfs91_checked;
47
48 <bridgehead renderas="sect3">Package Information</bridgehead>
49 <itemizedlist spacing="compact">
50 <listitem>
51 <para>
52 Download (HTTP): <ulink url="&gc-download-http;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download (FTP): <ulink url="&gc-download-ftp;"/>
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download MD5 sum: &gc-md5sum;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download size: &gc-size;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated disk space required: &gc-buildsize;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Estimated build time: &gc-time;
78 </para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect4">Required</bridgehead>
83 <para role="required">
84 <xref linkend="libatomic_ops"/>
85 </para>
86
87 <para condition="html" role="usernotes">
88 User Notes: <ulink url="&blfs-wiki;/gc"/>
89 </para>
90 </sect2>
91
92 <sect2 role="installation">
93 <title>Installation of GC</title>
94
95 <para>
96 Install <application>GC</application> by running the following commands:
97 </para>
98
99<screen><userinput>./configure --prefix=/usr \
100 --enable-cplusplus \
101 --disable-static \
102 --docdir=/usr/share/doc/gc-&gc-version; &amp;&amp;
103make</userinput></screen>
104
105 <para>
106 To test the results, issue: <command>make check</command>.
107 </para>
108
109 <para>
110 Now, as the <systemitem class="username">root</systemitem> user:
111 </para>
112
113<screen role="root"><userinput>make install &amp;&amp;
114install -v -m644 doc/gc.man /usr/share/man/man3/gc_malloc.3</userinput></screen>
115 </sect2>
116
117 <sect2 role="commands">
118 <title>Command Explanations</title>
119
120 <para>
121 <parameter>--docdir=/usr/share/doc/gc-&gc-version;</parameter>:
122 This option is used so the package will install the
123 documentation in a versioned directory.
124 </para>
125
126 <para>
127 <parameter>--enable-cplusplus</parameter>: This parameter enables the
128 building and installing of the C++ library along with the standard
129 C library.
130 </para>
131
132 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
133 href="../../xincludes/static-libraries.xml"/>
134
135 </sect2>
136
137 <sect2 role="content">
138 <title>Contents</title>
139
140 <segmentedlist>
141 <segtitle>Installed Programs</segtitle>
142 <segtitle>Installed Libraries</segtitle>
143 <segtitle>Installed Directories</segtitle>
144
145 <seglistitem>
146 <seg>
147 None
148 </seg>
149 <seg>
150 libcord.so,
151 libgc.so, and
152 libgccpp.so
153 </seg>
154 <seg>
155 /usr/include/gc and
156 /usr/share/doc/gc-&gc-version;
157 </seg>
158 </seglistitem>
159 </segmentedlist>
160
161 <variablelist>
162 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
163 <?dbfo list-presentation="list"?>
164 <?dbhtml list-presentation="table"?>
165
166 <varlistentry id="libgc">
167 <term><filename class="libraryfile">libgc.so</filename></term>
168 <listitem>
169 <para>
170 contains a C interface to the conservative garbage collector,
171 primarily designed to replace the C malloc function.
172 </para>
173 <indexterm zone="gc libgc">
174 <primary sortas="c-libgc">libgc.so</primary>
175 </indexterm>
176 </listitem>
177 </varlistentry>
178
179 <varlistentry id="libgccpp">
180 <term><filename class="libraryfile">libgccpp.so</filename></term>
181 <listitem>
182 <para>
183 contains a C++ interface to the conservative garbage collector.
184 </para>
185 <indexterm zone="gc libgccpp">
186 <primary sortas="c-libgccpp">libgccpp.so</primary>
187 </indexterm>
188 </listitem>
189 </varlistentry>
190
191 </variablelist>
192
193 </sect2>
194
195</sect1>
Note: See TracBrowser for help on using the repository browser.