source: basicnet/netprogs/ncftp.xml@ 9e4bed20

<?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 &amp;&amp;
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 &amp;&amp;
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 ... &amp;&amp; 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>