source: chapter06/ncurses.xml@ 0253841d

12.1 12.1-rc1 multilib trunk xry111/arm64 xry111/clfs-ng xry111/loongarch xry111/loongarch-12.1 xry111/mips64el xry111/update-glibc
Last change on this file since 0253841d was 943f225, checked in by Xi Ruoyao <xry111@…>, 3 months ago

ncurses: Use symlinks instead of linker scripts

The effect will not change, but with symlinks ld can save some time
invoking open(), read(), etc. syscalls and parsing the linker scripts.

Note that I've also removed "libcursesw" symlink because this library
has never existed. Instead libcurses.so is created as a symlink
direct to libncursesw.so.
  • Property mode set to 100644
File size: 7.5 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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-ncurses" role="wrap">
9 <?dbhtml filename="ncurses.html"?>
10
11 <sect1info condition="script">
12 <productname>ncurses</productname>
13 <productnumber>&ncurses-version;</productnumber>
14 <address>&ncurses-url;</address>
15 </sect1info>
16
17 <title>Ncurses-&ncurses-version;</title>
18
19 <indexterm zone="ch-tools-ncurses">
20 <primary sortas="a-Ncurses">Ncurses</primary>
21 <secondary>tools</secondary>
22 </indexterm>
23
24 <sect2 role="package">
25 <title/>
26
27 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
28 href="../chapter08/ncurses.xml"
29 xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
30
31 <segmentedlist>
32 <segtitle>&buildtime;</segtitle>
33 <segtitle>&diskspace;</segtitle>
34
35 <seglistitem>
36 <seg>&ncurses-tmp-sbu;</seg>
37 <seg>&ncurses-tmp-du;</seg>
38 </seglistitem>
39 </segmentedlist>
40
41 </sect2>
42
43 <sect2 role="installation">
44 <title>Installation of Ncurses</title>
45
46 <para>First, ensure that <command>gawk</command> is found first during configuration:</para>
47
48<screen><userinput remap="pre">sed -i s/mawk// configure</userinput></screen>
49
50 <para>Then, run the following commands to build the <quote>tic</quote>
51 program on the build host:</para>
52
53<screen><userinput remap="pre">mkdir build
54pushd build
55 ../configure
56 make -C include
57 make -C progs tic
58popd</userinput></screen>
59
60 <para>Prepare Ncurses for compilation:</para>
61
62<screen><userinput remap="configure">./configure --prefix=/usr \
63 --host=$LFS_TGT \
64 --build=$(./config.guess) \
65 --mandir=/usr/share/man \
66 --with-manpage-format=normal \
67 --with-shared \
68 --without-normal \
69 --with-cxx-shared \
70 --without-debug \
71 --without-ada \
72 --disable-stripping \
73 --enable-widec</userinput></screen>
74
75 <variablelist>
76 <title>The meaning of the new configure options:</title>
77
78 <varlistentry>
79 <term><parameter>--with-manpage-format=normal</parameter></term>
80 <listitem>
81 <para>This prevents Ncurses from installing compressed manual
82 pages, which may happen if the host distribution itself
83 has compressed manual pages.</para>
84 </listitem>
85 </varlistentry>
86
87 <varlistentry>
88 <term><parameter>--with-shared</parameter></term>
89 <listitem>
90 <para>This makes Ncurses build and install shared C libraries.</para>
91 </listitem>
92 </varlistentry>
93
94 <varlistentry>
95 <term><parameter>--without-normal</parameter></term>
96 <listitem>
97 <para>This prevents Ncurses from building and installing static C
98 libraries.</para>
99 </listitem>
100 </varlistentry>
101
102 <varlistentry>
103 <term><parameter>--without-debug</parameter></term>
104 <listitem>
105 <para>This prevents Ncurses from building and installing debug
106 libraries.</para>
107 </listitem>
108 </varlistentry>
109
110 <varlistentry>
111 <term><parameter>--with-cxx-shared</parameter></term>
112 <listitem>
113 <para>This makes Ncurses build and install shared C++ bindings. It
114 also prevents it building and installing static C++ bindings.</para>
115 </listitem>
116 </varlistentry>
117
118 <varlistentry>
119 <term><parameter>--without-ada</parameter></term>
120 <listitem>
121 <para>This ensures that Ncurses does not build support for the Ada
122 compiler, which may be present on the host but will not be available
123 once we enter the <command>chroot</command> environment.</para>
124 </listitem>
125 </varlistentry>
126
127 <varlistentry>
128 <term><parameter>--disable-stripping</parameter></term>
129 <listitem>
130 <para>This switch prevents the building system from
131 using the <command>strip</command> program from the host.
132 Using host tools on cross-compiled programs can cause failure.</para>
133 </listitem>
134 </varlistentry>
135
136 <varlistentry>
137 <term><parameter>--enable-widec</parameter></term>
138 <listitem>
139 <para>This switch causes wide-character libraries (e.g., <filename
140 class="libraryfile">libncursesw.so.&ncurses-version;</filename>)
141 to be built instead of normal ones (e.g., <filename
142 class="libraryfile">libncurses.so.&ncurses-version;</filename>).
143 These wide-character libraries are usable in both multibyte and
144 traditional 8-bit locales, while normal libraries work properly
145 only in 8-bit locales. Wide-character and normal libraries are
146 source-compatible, but not binary-compatible.</para>
147 </listitem>
148 </varlistentry>
149
150 </variablelist>
151
152 <para>Compile the package:</para>
153
154<screen><userinput remap="make">make</userinput></screen>
155
156 <para>Install the package:</para>
157
158<screen><userinput remap="install">make DESTDIR=$LFS TIC_PATH=$(pwd)/build/progs/tic install
159ln -sv libncursesw.so $LFS/usr/lib/libncurses.so
160sed -e 's/^#if.*XOPEN.*$/#if 1/' \
161 -i $LFS/usr/include/curses.h</userinput></screen>
162<!--
163 <para>Remove an unneeded static library not handled by
164 <command>configure</command>:</para>
165
166<screen><userinput remap="install">rm -v $LFS/usr/lib/libncurses++w.a</userinput></screen>
167-->
168 <variablelist>
169 <title>The meaning of the install options:</title>
170
171 <varlistentry>
172 <term><parameter>TIC_PATH=$(pwd)/build/progs/tic</parameter></term>
173 <listitem>
174 <para>We need to pass the path of the newly built
175 <command>tic</command> program that runs on the building machine, so
176 the terminal database can be created without errors.</para>
177 </listitem>
178 </varlistentry>
179
180 <varlistentry>
181 <term><command>ln -sv libncursesw.so $LFS/usr/lib/libncurses.so</command></term>
182 <listitem>
183 <para>The <filename>libncurses.so</filename> library is needed by
184 a few packages we will build soon. We create this symlink to use
185 <filename>libncursesw.so</filename> as a replacement.</para>
186 </listitem>
187 </varlistentry>
188
189 <varlistentry>
190 <term><command>sed -e 's/^#if.*XOPEN.*$/#if 1/' ...</command></term>
191 <listitem>
192 <para>The header file <filename>curses.h</filename> contains
193 the definition of various Ncurses data structures. With different
194 preprocessor macro definitions two different sets of the data
195 structure definition may be used: the 8-bit definition is
196 compatible with <filename>libncurses.so</filename> and the
197 wide-character definition is compatible with
198 <filename>libncursesw.so</filename>. Since we are using
199 <filename>libncursesw.so</filename> as a replacement of
200 <filename>libncurses.so</filename>, edit the header file so it
201 will always use the wide-character data structure definition
202 compatible with <filename>libncursesw.so</filename>.</para>
203 </listitem>
204 </varlistentry>
205
206 </variablelist>
207
208 </sect2>
209
210 <sect2 role="content">
211 <title/>
212
213 <para>Details on this package are located in
214 <xref linkend="contents-ncurses" role="."/></para>
215
216 </sect2>
217
218</sect1>
Note: See TracBrowser for help on using the repository browser.