source: networking/netprogs/ncftp.xml@ 668c07b

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

ncftp: fix FTBFS with gcc-10. Thanks to Joe Locash for reporting.

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

  • Property mode set to 100644
File size: 9.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 ncftp-download-http " ">
8 <!ENTITY ncftp-download-ftp "ftp://ftp.ncftp.com/ncftp/ncftp-&ncftp-version;-src.tar.xz">
9 <!ENTITY ncftp-md5sum "42d0f896d69a4d603ec097546444245f">
10 <!ENTITY ncftp-size "412 KB">
11 <!ENTITY ncftp-buildsize "6.6 MB">
12 <!ENTITY ncftp-time "0.2 SBU">
13]>
14
15<sect1 id="ncftp" xreflabel="NcFTP-&ncftp-version;">
16 <?dbhtml filename="ncftp.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23<title>NcFTP-&ncftp-version;</title>
24
25 <indexterm zone="ncftp">
26 <primary sortas="a-NcFTP">NcFTP</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to NcFTP</title>
31
32 <para>
33 The <application>NcFTP</application> package contains
34 a powerful and flexible interface to the Internet standard File Transfer
35 Protocol. It is intended to replace or supplement the stock
36 <command>ftp</command> program.
37 </para>
38
39 &lfs91_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&ncftp-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&ncftp-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &ncftp-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &ncftp-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &ncftp-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &ncftp-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">NcFTP Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Optional</bridgehead>
78 <para role="optional">
79 <xref linkend="llvm"/> (with Clang, used by default if installed)
80 </para>
81
82 <para condition="html" role="usernotes">User Notes:
83 <ulink url="&blfs-wiki;/ncftp"/></para>
84
85 </sect2>
86
87 <sect2 role="installation">
88 <title>Installation of NcFTP</title>
89
90 <para>
91 There are two ways to build <application>NcFTP</application>. The first
92 (and optimal) way builds most of the functionality as a shared library
93 and then builds and installs the program linked against this library.
94 The second method simply links all of the functionality into the binary
95 statically. This doesn't make the dynamic library available for linking
96 by other applications. You need to choose which method best suits you.
97 Note that the second method does <emphasis>not</emphasis> create an
98 entirely statically linked binary; only the <filename
99 class="libraryfile">libncftp</filename> parts are statically linked in,
100 in this case. Be aware that building and using the shared library is
101 covered by the Clarified Artistic License; however, developing
102 applications that utilize the shared library is subject to a different
103 license.
104 </para>
105
106 <para>
107 First, fix an issue caused by a change in behavior in GCC-10:
108 </para>
109
110<screen><userinput remap="pre">sed -i 's/^Bookmark/extern Bookmark/' sh_util/gpshare.c</userinput></screen>
111
112 <para>
113 To install <application>NcFTP</application> using the
114 first (and optimal) method, run the following commands:
115 </para>
116
117<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
118make -C libncftp shared &amp;&amp;
119make</userinput></screen>
120
121 <para>
122 This package does not come with a test suite.
123 </para>
124
125 <para>
126 Now, as the <systemitem class="username">root</systemitem> user:
127 </para>
128
129<screen role='root'><userinput>make -C libncftp soinstall &amp;&amp;
130make install</userinput></screen>
131
132 <para>
133 To install <application>NcFTP</application> using the
134 second method (with the <filename class="libraryfile">libncftp</filename>
135 functionality linked in statically) run the following commands:
136 </para>
137
138<screen role="nodump"><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
139make</userinput></screen>
140
141 <para>
142 This package does not come with a test suite.
143 </para>
144
145 <para>
146 Now, as the <systemitem class="username">root</systemitem> user:
147 </para>
148
149<screen role="nodump"><userinput>make install</userinput></screen>
150
151 </sect2>
152
153 <sect2 role="commands">
154 <title>Command Explanations</title>
155
156 <para>
157 <command>make -C ... &amp;&amp; make -C ...</command>:
158 These commands make and install the dynamic library <filename
159 class="libraryfile">libncftp</filename> which is then used to link
160 against when compiling the main program.
161 </para>
162
163 </sect2>
164
165 <sect2 role="configuration">
166 <title>Configuring NcFTP</title>
167
168 <sect3 id="ncftp-config">
169 <title>Config Files</title>
170
171 <para>
172 <filename>/etc/ncftp.*</filename> and
173 <filename>~/.ncftp/*</filename>; especially
174 <filename>/etc/ncftp.prefs_v3</filename> and
175 <filename>~/.ncftp/prefs_v3</filename>
176 </para>
177
178 <indexterm zone="ncftp ncftp-config">
179 <primary sortas="e-AA.ncftp/*">~/.ncftp/*</primary>
180 </indexterm>
181
182 <indexterm zone="ncftp ncftp-config">
183 <primary sortas="e-etc-ncftp.*">/etc/ncftp.*</primary>
184 </indexterm>
185
186 </sect3>
187
188 <sect3>
189 <title>Configuration Information</title>
190
191 <para>
192 Most <application>NcFTP</application> configuration is done while in
193 the program, and the configuration files are dealt with automatically.
194 One exception to this is <filename>~/.ncftp/prefs_v3</filename>. There
195 are various options to alter in there, including:
196 </para>
197
198<screen><literal>yes-i-know-about-NcFTPd=yes</literal></screen>
199
200 <para>
201 This disables the splash screen advertising the
202 <application>NcFTPd</application> server.
203 </para>
204
205 <para>
206 There are other options in the <filename>prefs_v3</filename> file.
207 Most of these are self-explanatory. Global defaults can be set in
208 <filename>/etc/ncftp.prefs_v3</filename>.
209 </para>
210
211 </sect3>
212
213 </sect2>
214
215 <sect2 role="content">
216 <title>Contents</title>
217
218 <segmentedlist>
219 <segtitle>Installed Programs</segtitle>
220 <segtitle>Installed Library</segtitle>
221 <segtitle>Installed Directories</segtitle>
222
223 <seglistitem>
224 <seg>ncftp, ncftpbatch, ncftpbookmarks, ncftpget,
225 ncftpls, ncftpput, and ncftpspooler</seg>
226 <seg>libncftp.so</seg>
227 <seg>None</seg>
228 </seglistitem>
229 </segmentedlist>
230
231 <variablelist>
232 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
233 <?dbfo list-presentation="list"?>
234 <?dbhtml list-presentation="table"?>
235
236 <varlistentry id="ncftp-prog">
237 <term><command>ncftp</command></term>
238 <listitem>
239 <para>
240 is a browser program for File Transfer Protocol.
241 </para>
242 <indexterm zone="ncftp ncftp-prog">
243 <primary sortas="b-ncftp">ncftp</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
248 <varlistentry id="ncftpbatch">
249 <term><command>ncftpbatch</command></term>
250 <listitem>
251 <para>
252 is an individual batch FTP job processor.
253 </para>
254 <indexterm zone="ncftp ncftpbatch">
255 <primary sortas="b-ncftpbatch">ncftpbatch</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259
260 <varlistentry id="ncftpbookmarks">
261 <term><command>ncftpbookmarks</command></term>
262 <listitem>
263 <para>
264 is the <application>NcFTP</application> Bookmark Editor
265 (<application>NCurses</application>-based).
266 </para>
267 <indexterm zone="ncftp ncftpbookmarks">
268 <primary sortas="b-ncftpbookmarks">ncftpbookmarks</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <varlistentry id="ncftpget">
274 <term><command>ncftpget</command></term>
275 <listitem>
276 <para>
277 is an internet file transfer program for scripts used to
278 retrieve files.
279 </para>
280 <indexterm zone="ncftp ncftpget">
281 <primary sortas="b-ncftpget">ncftpget</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="ncftpls">
287 <term><command>ncftpls</command></term>
288 <listitem>
289 <para>
290 is an internet file transfer program for scripts used to
291 list files.
292 </para>
293 <indexterm zone="ncftp ncftpls">
294 <primary sortas="b-ncftpls">ncftpls</primary>
295 </indexterm>
296 </listitem>
297 </varlistentry>
298
299 <varlistentry id="ncftpput">
300 <term><command>ncftpput</command></term>
301 <listitem>
302 <para>
303 is an internet file transfer program for scripts used to
304 transfer files.
305 </para>
306 <indexterm zone="ncftp ncftpput">
307 <primary sortas="b-ncftpput">ncftpput</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 <varlistentry id="ncftpspooler">
313 <term><command>ncftpspooler</command></term>
314 <listitem>
315 <para>
316 is a global batch FTP job processor daemon.
317 </para>
318 <indexterm zone="ncftp ncftpspooler">
319 <primary sortas="b-ncftpspooler">ncftpspooler</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 </variablelist>
325
326 </sect2>
327
328</sect1>
Note: See TracBrowser for help on using the repository browser.