source: networking/netprogs/ncftp.xml@ b51fe6e

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 b51fe6e was b51fe6e, checked in by Pierre Labastie <pieere@…>, 19 months ago

Format netprogs

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

  • Property mode set to 100644
File size: 9.6 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 To install <application>NcFTP</application> using the
108 first (and optimal) method, run the following commands:
109 </para>
110
111<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
112make -C libncftp shared &amp;&amp;
113make</userinput></screen>
114
115 <para>
116 This package does not come with a test suite.
117 </para>
118
119 <para>
120 Now, as the <systemitem class="username">root</systemitem> user:
121 </para>
122
123<screen role='root'><userinput>make -C libncftp soinstall &amp;&amp;
124make install</userinput></screen>
125
126 <para>
127 To install <application>NcFTP</application> using the
128 second method (with the <filename class="libraryfile">libncftp</filename>
129 functionality linked in statically) run the following commands:
130 </para>
131
132<screen role="nodump"><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
133make</userinput></screen>
134
135 <para>
136 This package does not come with a test suite.
137 </para>
138
139 <para>
140 Now, as the <systemitem class="username">root</systemitem> user:
141 </para>
142
143<screen role="nodump"><userinput>make install</userinput></screen>
144
145 </sect2>
146
147 <sect2 role="commands">
148 <title>Command Explanations</title>
149
150 <para>
151 <command>make -C ... &amp;&amp; make -C ...</command>:
152 These commands make and install the dynamic library <filename
153 class="libraryfile">libncftp</filename> which is then used to link
154 against when compiling the main program.
155 </para>
156
157 </sect2>
158
159 <sect2 role="configuration">
160 <title>Configuring NcFTP</title>
161
162 <sect3 id="ncftp-config">
163 <title>Config Files</title>
164
165 <para>
166 <filename>/etc/ncftp.*</filename> and
167 <filename>~/.ncftp/*</filename>; especially
168 <filename>/etc/ncftp.prefs_v3</filename> and
169 <filename>~/.ncftp/prefs_v3</filename>
170 </para>
171
172 <indexterm zone="ncftp ncftp-config">
173 <primary sortas="e-AA.ncftp/*">~/.ncftp/*</primary>
174 </indexterm>
175
176 <indexterm zone="ncftp ncftp-config">
177 <primary sortas="e-etc-ncftp.*">/etc/ncftp.*</primary>
178 </indexterm>
179
180 </sect3>
181
182 <sect3>
183 <title>Configuration Information</title>
184
185 <para>
186 Most <application>NcFTP</application> configuration is done while in
187 the program, and the configuration files are dealt with automatically.
188 One exception to this is <filename>~/.ncftp/prefs_v3</filename>. There
189 are various options to alter in there, including:
190 </para>
191
192<screen><literal>yes-i-know-about-NcFTPd=yes</literal></screen>
193
194 <para>
195 This disables the splash screen advertising the
196 <application>NcFTPd</application> server.
197 </para>
198
199 <para>
200 There are other options in the <filename>prefs_v3</filename> file.
201 Most of these are self-explanatory. Global defaults can be set in
202 <filename>/etc/ncftp.prefs_v3</filename>.
203 </para>
204
205 </sect3>
206
207 </sect2>
208
209 <sect2 role="content">
210 <title>Contents</title>
211
212 <segmentedlist>
213 <segtitle>Installed Programs</segtitle>
214 <segtitle>Installed Library</segtitle>
215 <segtitle>Installed Directories</segtitle>
216
217 <seglistitem>
218 <seg>ncftp, ncftpbatch, ncftpbookmarks, ncftpget,
219 ncftpls, ncftpput, and ncftpspooler</seg>
220 <seg>libncftp.so</seg>
221 <seg>None</seg>
222 </seglistitem>
223 </segmentedlist>
224
225 <variablelist>
226 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
227 <?dbfo list-presentation="list"?>
228 <?dbhtml list-presentation="table"?>
229
230 <varlistentry id="ncftp-prog">
231 <term><command>ncftp</command></term>
232 <listitem>
233 <para>
234 is a browser program for File Transfer Protocol.
235 </para>
236 <indexterm zone="ncftp ncftp-prog">
237 <primary sortas="b-ncftp">ncftp</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="ncftpbatch">
243 <term><command>ncftpbatch</command></term>
244 <listitem>
245 <para>
246 is an individual batch FTP job processor.
247 </para>
248 <indexterm zone="ncftp ncftpbatch">
249 <primary sortas="b-ncftpbatch">ncftpbatch</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="ncftpbookmarks">
255 <term><command>ncftpbookmarks</command></term>
256 <listitem>
257 <para>
258 is the <application>NcFTP</application> Bookmark Editor
259 (<application>NCurses</application>-based).
260 </para>
261 <indexterm zone="ncftp ncftpbookmarks">
262 <primary sortas="b-ncftpbookmarks">ncftpbookmarks</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 <varlistentry id="ncftpget">
268 <term><command>ncftpget</command></term>
269 <listitem>
270 <para>
271 is an internet file transfer program for scripts used to
272 retrieve files.
273 </para>
274 <indexterm zone="ncftp ncftpget">
275 <primary sortas="b-ncftpget">ncftpget</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="ncftpls">
281 <term><command>ncftpls</command></term>
282 <listitem>
283 <para>
284 is an internet file transfer program for scripts used to
285 list files.
286 </para>
287 <indexterm zone="ncftp ncftpls">
288 <primary sortas="b-ncftpls">ncftpls</primary>
289 </indexterm>
290 </listitem>
291 </varlistentry>
292
293 <varlistentry id="ncftpput">
294 <term><command>ncftpput</command></term>
295 <listitem>
296 <para>
297 is an internet file transfer program for scripts used to
298 transfer files.
299 </para>
300 <indexterm zone="ncftp ncftpput">
301 <primary sortas="b-ncftpput">ncftpput</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="ncftpspooler">
307 <term><command>ncftpspooler</command></term>
308 <listitem>
309 <para>
310 is a global batch FTP job processor daemon.
311 </para>
312 <indexterm zone="ncftp ncftpspooler">
313 <primary sortas="b-ncftpspooler">ncftpspooler</primary>
314 </indexterm>
315 </listitem>
316 </varlistentry>
317
318 </variablelist>
319
320 </sect2>
321
322</sect1>
Note: See TracBrowser for help on using the repository browser.