mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-01-24 15:12:11 +08:00
e615d9bfbf
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4650 af4574ff-66df-0310-9fd7-8a98e5e911e0
250 lines
8.5 KiB
XML
250 lines
8.5 KiB
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../../general.ent">
|
|
%general-entities;
|
|
|
|
<!ENTITY ncftp-download-http "http://gd.tuwien.ac.at/infosys/clients/ftp/ncftp/ncftp-&ncftp-version;-src.tar.bz2">
|
|
<!-- <!ENTITY ncftp-download-ftp "ftp://ftp.ncftp.com/ncftp/ncftp-&ncftp-version;-src.tar.bz2"> -->
|
|
<!ENTITY ncftp-download-ftp "ftp://ftp.ncftp.com/ncftp/ncftp-&ncftp-version;-src.tar.bz2">
|
|
<!ENTITY ncftp-md5sum "66cf8dacec848eb11a70632fe9f21807">
|
|
<!ENTITY ncftp-size "401 KB">
|
|
<!ENTITY ncftp-buildsize "9.9 MB">
|
|
<!ENTITY ncftp-time "0.3 SBU">
|
|
]>
|
|
|
|
<sect1 id="ncftp" xreflabel="NcFTP-&ncftp-version;">
|
|
<?dbhtml filename="ncftp.html"?>
|
|
|
|
<sect1info>
|
|
<othername>$LastChangedBy$</othername>
|
|
<date>$Date$</date>
|
|
</sect1info>
|
|
|
|
<title>NcFTP-&ncftp-version;</title>
|
|
|
|
<indexterm zone="ncftp">
|
|
<primary sortas="a-NcFTP">NcFTP</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title>Introduction to NcFTP</title>
|
|
|
|
<para>The <application>NcFTP</application> package contains
|
|
a powerful and flexible interface to the Internet standard File Transfer
|
|
Protocol. It is intended to replace or supplement the stock
|
|
<command>ftp</command> program.</para>
|
|
|
|
<bridgehead renderas="sect3">Package Information</bridgehead>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>Download (HTTP): <ulink url="&ncftp-download-http;"/></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Download (FTP): <ulink url="&ncftp-download-ftp;"/></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Download MD5 sum: &ncftp-md5sum;</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Download size: &ncftp-size;</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Estimated disk space required: &ncftp-buildsize;</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Estimated build time: &ncftp-time;</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of NcFTP</title>
|
|
|
|
<para>There are two ways to build <application>NcFTP</application>.
|
|
The first (and optimal) way builds most of the functionality as a shared library
|
|
and then builds and installs the program linked against this library. The
|
|
second method simply links all of the functionality into the binary statically.
|
|
This doesn't make the dynamic library available for linking by other applications.
|
|
You need to choose which method best suits you. Note that the second method
|
|
does <emphasis>not</emphasis> create an entirely statically linked binary;
|
|
only the <filename class="libraryfile">libncftp</filename> parts are statically
|
|
linked in, in this case. Be aware that building and using the shared library is
|
|
covered by the Clarified Artistic License; however, developing applications that
|
|
utilize the shared library is subject to a different license.</para>
|
|
|
|
<para>To install <application>NcFTP</application> using the
|
|
first (and optimal) method, run the following commands:</para>
|
|
|
|
<screen><userinput>./configure --prefix=/usr &&
|
|
make -C libncftp shared</userinput></screen>
|
|
|
|
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
|
|
|
|
<screen role='root'><userinput>make -C libncftp soinstall</userinput></screen>
|
|
|
|
<para>Again, as an unprivileged user:</para>
|
|
|
|
<screen><userinput>make</userinput></screen>
|
|
|
|
<para>Again, as the <systemitem class="username">root</systemitem> user:</para>
|
|
|
|
<screen role='root'><userinput>make install</userinput></screen>
|
|
|
|
<para>To install <application>NcFTP</application> using the
|
|
second method (with the <filename class="libraryfile">libncftp</filename>
|
|
functionality linked in statically) run the following commands:</para>
|
|
|
|
<screen><userinput>./configure --prefix=/usr &&
|
|
make</userinput></screen>
|
|
|
|
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
|
|
|
|
<screen role='root'><userinput>make install</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="commands">
|
|
<title>Command Explanations</title>
|
|
|
|
<para><command>make -C ... && make -C ...</command>:
|
|
These commands make and install the dynamic library <filename
|
|
class="libraryfile">libncftp</filename> which is then used to link
|
|
against when compiling the main program.</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="configuration">
|
|
<title>Configuring NcFTP</title>
|
|
|
|
<sect3 id="ncftp-config">
|
|
<title>Config Files</title>
|
|
|
|
<para><filename>~/.ncftp/*</filename>; especially
|
|
<filename>~/.ncftp/prefs_v3</filename></para>
|
|
|
|
<indexterm zone="ncftp ncftp-config">
|
|
<primary sortas="e-AA.ncftp/*">~/.ncftp/*</primary>
|
|
</indexterm>
|
|
|
|
</sect3>
|
|
|
|
<sect3>
|
|
<title>Configuration Information</title>
|
|
|
|
<para>Most <application>NcFTP</application> configuration
|
|
is done while in the program, and the configuration files are dealt with
|
|
automatically. One exception to this is <filename>~/.ncftp/prefs_v3</filename>.
|
|
There are various options to alter in there, including:</para>
|
|
|
|
<screen><literal>yes-i-know-about-NcFTPd=yes</literal></screen>
|
|
|
|
<para>This disables the splash screen advertising the
|
|
<application>NcFTPd</application> server.</para>
|
|
|
|
<para>There are other options in the <filename>prefs_v3</filename> file. Most
|
|
of these are self-explanatory.</para>
|
|
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="content">
|
|
<title>Contents</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed Programs</segtitle>
|
|
<segtitle>Installed Library</segtitle>
|
|
<segtitle>Installed Directories</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>ncftp, ncftpbatch, ncftpbookmarks, ncftpget,
|
|
ncftpls, ncftpput, and ncftpspooler</seg>
|
|
<seg>libncftp.so</seg>
|
|
<seg>None</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="ncftp-prog">
|
|
<term><command>ncftp</command></term>
|
|
<listitem>
|
|
<para>a browser program for File Transfer Protocol.</para>
|
|
<indexterm zone="ncftp ncftp-prog">
|
|
<primary sortas="b-ncftp">ncftp</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="ncftpbatch">
|
|
<term><command>ncftpbatch</command></term>
|
|
<listitem>
|
|
<para>individual batch FTP job processor.</para>
|
|
<indexterm zone="ncftp ncftpbatch">
|
|
<primary sortas="b-ncftpbatch">ncftpbatch</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="ncftpbookmarks">
|
|
<term><command>ncftpbookmarks</command></term>
|
|
<listitem>
|
|
<para><application>NcFTP</application> Bookmark Editor
|
|
(<application>NCurses</application>-based).</para>
|
|
<indexterm zone="ncftp ncftpbookmarks">
|
|
<primary sortas="b-ncftpbookmarks">ncftpbookmarks</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="ncftpget">
|
|
<term><command>ncftpget</command></term>
|
|
<listitem>
|
|
<para>internet file transfer program for scripts.</para>
|
|
<indexterm zone="ncftp ncftpget">
|
|
<primary sortas="b-ncftpget">ncftpget</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="ncftpls">
|
|
<term><command>ncftpls</command></term>
|
|
<listitem>
|
|
<para>internet file transfer program for scripts.</para>
|
|
<indexterm zone="ncftp ncftpls">
|
|
<primary sortas="b-ncftpls">ncftpls</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="ncftpput">
|
|
<term><command>ncftpput</command></term>
|
|
<listitem>
|
|
<para>internet file transfer program for scripts.</para>
|
|
<indexterm zone="ncftp ncftpput">
|
|
<primary sortas="b-ncftpput">ncftpput</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="ncftpspooler">
|
|
<term><command>ncftpspooler</command></term>
|
|
<listitem>
|
|
<para>global batch FTP job processor daemon.</para>
|
|
<indexterm zone="ncftp ncftpspooler">
|
|
<primary sortas="b-ncftpspooler">ncftpspooler</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|