source: chapter05/check.xml@ 2027144

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 7.10 7.10-rc1 7.5 7.5-rc1 7.6 7.6-rc1 7.7 7.7-rc1 7.8 7.8-rc1 7.9 7.9-rc1 7.9-rc2 8.0 8.0-rc1 8.1 8.1-rc1 8.1-rc2 8.2 8.2-rc1 8.3 8.3-rc1 8.3-rc2 8.4 8.4-rc1 9.0 9.0-rc1 9.1 9.1-rc1 BOOK.old arm cross-chap5 hybrid ml-11.0 multilib nosym old-trunk trunk xry111/clfs-ng xry111/git-transition xry111/glibc-2.34 xry111/lfs-next xry111/tester-nohack xry111/usr-move
Last change on this file since 2027144 was 2027144, checked in by Bruce Dubbs <bdubbs@…>, 9 years ago

Disable pkg-config lookups in the Chapter 5 check program that
may cause unwanted host system libraries to be linked into check.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@10369 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 3.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
8<sect1 id="ch-tools-check" role="wrap">
9 <?dbhtml filename="check.html"?>
10
11 <sect1info condition="script">
12 <productname>check</productname>
13 <productnumber>&check-version;</productnumber>
14 <address>&check-url;</address>
15 </sect1info>
16
17 <title>Check-&check-version;</title>
18
19 <indexterm zone="ch-tools-check">
20 <primary sortas="a-Check">Check</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>Check is a unit testing framework for C.</para>
27
28 <segmentedlist>
29 <segtitle>&buildtime;</segtitle>
30 <segtitle>&diskspace;</segtitle>
31
32 <seglistitem>
33 <seg>&check-ch5-sbu;</seg>
34 <seg>&check-ch5-du;</seg>
35 </seglistitem>
36 </segmentedlist>
37
38 </sect2>
39
40 <sect2 role="installation">
41 <title>Installation of Check</title>
42
43 <para>Prepare Check for compilation:</para>
44
45<screen><userinput remap="configure">PKG_CONFIG= ./configure --prefix=/tools</userinput></screen>
46
47 <variablelist>
48 <title>The meaning of the configure parameter:</title>
49
50 <varlistentry>
51 <term><parameter>PKG_CONFIG=</parameter></term>
52 <listitem>
53 <para>This tells the configure script to ignore any
54 pkg-config options that may cause the system to try to link
55 with libraries not in the <filename class="directory">/tools</filename>
56 directory.</para>
57 </listitem>
58 </varlistentry>
59 </variablelist>
60
61 <para>Build the package:</para>
62
63<screen><userinput remap="make">make</userinput></screen>
64
65 <para>Compilation is now complete. As discussed earlier, running the test
66 suite is not mandatory for the temporary tools here in this chapter. To run
67 the Check test suite anyway, issue the following command:</para>
68
69<screen><userinput remap="test">make check</userinput></screen>
70
71 <para>Note that the Check test suite may take a relatively long
72 (up to 4 SBU) time.</para>
73
74 <para>Install the package:</para>
75
76<screen><userinput remap="install">make install</userinput></screen>
77
78 </sect2>
79
80 <sect2 id="contents-check" role="content">
81 <title>Contents of Check</title>
82
83 <segmentedlist>
84 <segtitle>Installed program</segtitle>
85 <segtitle>Installed library</segtitle>
86
87 <seglistitem>
88 <seg>checkmk</seg>
89 <seg>libcheck.{a,so}</seg>
90 </seglistitem>
91 </segmentedlist>
92
93 <variablelist>
94 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
95 <?dbfo list-presentation="list"?>
96 <?dbhtml list-presentation="table"?>
97
98 <varlistentry id="checkmk">
99 <term><command>checkmk</command></term>
100 <listitem>
101 <para>Awk script for generating C unit tests for use with the Check
102 unit testing framework</para>
103 <indexterm zone="ch-tools-check checkmk">
104 <primary sortas="b-checmk">checkmk</primary>
105 </indexterm>
106 </listitem>
107 </varlistentry>
108
109 <varlistentry id="libcheck">
110 <term><filename class="libraryfile">libcheck.{a,so}</filename></term>
111 <listitem>
112 <para>Contains functions that allow Check to be called from a test
113 program</para>
114 <indexterm zone="ch-tools-check libcheck">
115 <primary sortas="c-libcheck">libcheck</primary>
116 </indexterm>
117 </listitem>
118 </varlistentry>
119
120 </variablelist>
121
122 </sect2>
123
124</sect1>
Note: See TracBrowser for help on using the repository browser.