source: basicnet/netprogs/ncftp.xml@ ef3ec45

<?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.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/ncftp-&ncftp-version;-src.tar.bz2">
  <!ENTITY ncftp-md5sum        "2a310a3c9ca126e6b409d0d1d1ccda75">
  <!ENTITY ncftp-size          "389 KB">
  <!ENTITY ncftp-buildsize     "5.2 MB">
  <!ENTITY ncftp-time          "0.38 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 &amp;&amp;
make -C libncftp soinstall &amp;&amp;
make &amp;&amp;
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 &amp;&amp;
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</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>