     [file version.texi not included]

     START-INFO-DIR-ENTRY
     * cftp: (cftp).             Comfortable FTP.
     END-INFO-DIR-ENTRY

This file documents cftp VERSION

Copyright 1996, 1997 Dieter Baron, Thomas Klausner

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Free Software Foundation.

cftp
****

This file documents CFTP, a fullscreen ftp client running on ASCII-terminals or terminal emulations (like xterm).  This edition documents version VERSION.

Introduction
************

CFTP is used to transfer files from one computer to another via the FTP protocol.  It's advantages over most standard ftp clients is its fullscreen representation of the remote directory tree, providing a compact overview of the remote server's contents.

Invoking CFTP
*************

There are two ways to specify the destination:

  * cftp [-u USER] [-p PORT] {HOST|ALIAS} DIRECTORY

  * cftp URL

Where URL has the form

     ftp://[USER[PASSWORD]@]HOST[:PORT][/DIR][/]

Navigating the Remote Directory Tree
************************************

CFTP understands the basic motion keys for both vi/less and GNU Emacs, as well as cursor keys.

cursor key           vi/less     GNU Emacs   command
cursor up      k     ^p    up
cursor down    j     ^n    down
cursor left    h     ^b    leave
cursor right   l     ^f    enter/get
page up        b                 page-up
page down      spc               page-down

Customizability
***************

.cftprc
=======

On startup CFTP reads the file .cftprc (in your home directory) if it exists.  It contains CFTP functions invocations (optionally with arguments), just as in the bind function.  Put CFTP commands in it you want to be executed every time CFTP starts.  Not all functions are allowed in .cftprc, however.

alias
-----

  * Synopsis: alias SHORT {URL | HOST [DIR]}

.cftp example
-------------

Here is an example .cftprc file:

     alias cftp-dist ftp://ftp.giga.or.at/pub/nih/cftp
     set sort date
     bind p set beep toggle

.netrc
======

In addition to its own config file .cftprc, see cftprc, CFTP scans your .netrc file for this information:

  * host or default lines for login and password

  * macdef init definition for cd commands (used as initial directory)

An entry for a specific host:

     machine HOST login USER password PASSWD
     macdef init
     cd STARTDIR

The default entry (used for all hosts not matched by a specific entry):

     default login USER password PASSWD
     macdef init
     cd STARTDIR

The macdef init must be terminated by a blank line. password and macdef init may be ommited.

     [file functions.texi not included]

     [file options.texi not included]