# gFTP Manual &manrevision;

## Introduction

The &gftp; is a graphical file transfer manager. It can be used for downloading files from remote FTP servers, uploading files to an FTP server, or transferring files between two remote servers. &gftp; provides the following features:

- Support for FTP, HTTP and SSH (both SSH1 and SSH2) protocols

- Support for fxp file transfers (transferring files between two remote servers via ftp)

- Multithreaded to allow for simultaneous downloads

- File transfer queues to allow for downloading multiple files

- Bookmarks menu to allow you to quickly connect to remote sites

- Support for resuming interrupted file transfers

- Drag-N-Drop support

- FTP and HTTP proxy server support

- Allows for passive and non-passive file transfers

- Supports UNIX, EPLF, Novell, MacOS, and NT (DOS) style directory listings

## Basic Usage

This section describes basic usage of &gftp; and its graphical interface (buttons, menus, etc).

### Starting And Quitting &gftp;

To start &gftp; open the Main Menu, then choose Programs Internet gFTP .

You can also start &gftp; from the command line. To do so, type `gftp` or `gftp `ftp://ftp.myhostname.com/pub`` and press Return. Here `ftp://ftp.myhostname.com/pub` is the address (URL) of the site you want to connect to. See gftp-connect-url for examples of admissible URLs.

To quit &gftp; choose FTP Quit .

There are two versions of &gftp;: graphical and text. Command &gftp; will start graphical version in graphical environment (i.e., when X Window System is running) and text version otherwise. (For advanced users: &gftp; checks whether environment variable DISPLAY is set to determine whether graphical environment is present.) You can also explicitly start graphical version by using command `gftp-gtk` and text version by using command `gftp-text`. This manual only describes graphical version.

### &gftp; Main Window And Controls

After starting, &gftp; opens the main window shown in gftp-mainwin-fig.

#### gFTP Main Window

Shows &gftp; main window.

This window contains the following areas and controls:

Connection information: hostname, port, User, Pass, Protocol type (FTP, HTTP, SSH)

- These fields contain information about currently active connection (User and Pass stand for username and password respectively). You can also use them to open a new connection: enter the connection information in these fields and click on Connect button.

Connect button

- When not connected, enter connection settings (hostname, protocol, etc) and click on this button to connect to a remote computer. When connected to a remote computer, click on this button to disconnect.

Stop button

- Click on this button to stop connection attempts or a file transfer.

File list panels

- These tow panels show the contents of current directory on local (left panel) and remote (right panel) computers. They can also be used for navigation: double-clicking on a directory takes you to that directory. See gftp-viewing for more information.

Transfer buttons

- Click on one of this buttons to transfer selected files between local and remote computers. The arrow shows direction of transfer: top button transfers from the local computer to the remote one (upload), the bottom button transfers from the remote computer to the local one (download)

Transfer progress window

- This window shows file transfer progress.

Log window

- This window shows all the messages exchanged by the local computer and the remote one. Mostly useful for troubleshooting and diagnostic purposes.

### Connecting and Transferring Files

To connect to a remote computer, enter the computer address (hostname) on the toolbar and select the protocol type (by default, FTP). If using anonymous FTP or HTTP connection, leave fields User and Pass blank; otherwise, enter your username and password. After entering this information, click on Connect button. For detailed instructions and other ways to establish connection, see gftp-connect.

To transfer files between local and remote computers, double-click on the file you want to transfer. If you need to transfer several files or whole directories, click on them while holding down Ctrl key to select. After selecting, click on the appropriate Transfer button located between file list panels. For detailed instructions, see gftp-transfer.

## Connecting To a Remote Site

The first step in transferring files is establishing a connection to the remote site. &gftp; provides several ways to connect to a remote site, described below. These descriptions assume that you are already connected to the Internet. Please note that If you are behind a firewall and use HTTP or FTP proxy, you will need to configure &gftp; before connecting as described in gftp-configuring. Configuration changes are also likely to be required when connecting to an SSH site; see gftp-ssh.

To disconnect from a remote site, click on Connect button or choose Remote Disconnect.

### Connecting Using the Toolbar

To connect to a remote site, enter the connection information in the appropriate fields in the toolbar.

Host

- Enter the remote site hostname (e.g., `ftp.gnome.org`). Do not include `ftp://` prefix or the directory (e.g., `/pub`). You can select one of recently visited sites by clicking on the down arrow and selecting it from the drop-down list. You can also drag the URL from any GNOME application to the Connect button.

Port

- Unless you know that the server uses non-standard port, leave this field blank

User and Pass

- If you have an account on the server you are connecting to and want to use this account, enter your username and password. If connecting to an anonymous FTP site (i.e., one that allows connection to everyone, without requiring an account), leave these fields blank.

  #### NOTE

  Most anonymous FTP servers ask that you enter `anonymous` for username and your e-mail address for password. Most of them only use the e-mail address for statistics. However, there is a potential risk that some less scrupulous FTP sites will use your e-mail to send you spam. To avoid this, &gftp; uses fake addresses (that is, strings that look like a valid e-mail address) as passwords.

Protocol

- Select the protocol to use (by default, `FTP`). Possible protocols include FTP (File Transfer Protocol), HTTP and SSH (Secure Shell, a protocol for encrypted communications, described in gftp-ssh).

  #### SECURITY WARNING

  Using non-anonymous FTP connection is a serious security risk, as your username and password are transmitted unencrypted over the Internet and can be easily intercepted by a third party. It is recommended that you only use FTP for anonymous sites. When username and password is required, use SSH instead.

After entering this information, click on Connect button (see gftp-mainwin-fig). &gftp; will try to connect to the server. If successful, the files on the remote server will be shown in the right file view pane. If there was an error when connecting, the error message will be shown in the lower part of &gftp; window.

### Connecting Using URL

An equivalent way of connecting to a remote site is by choosing Remote Open URL ( Ctrl U). This will prompt you for a URL to connect to. The following are examples of valid URL's:

- ftp://ftp.myhostname.com/pub (anonymous FTP connection)
- ftp://user@ftp.myhostname.com/pub (non-anonymous FTP connection with given username. You will be prompted for a password)
- ftp://user:pass@ftp.myhostname.com/pub (non-anonymous FTP connection, with given username and password)
- ssh://user:pass@myhostname.com (SSH connection, with given username and password)

### Connecting Using the Bookmarks

You can also use &gftp; bookmarks for connecting to frequently used sites, as described in gftp-bookmarks.

## Viewing Files and Directories

### File List Panel

After connecting, the right file list panel will show the files on the remote computer (see gftp-fileview-fig. Similarly, the left file view panel shows the files on the local computer.

At the top of file view panel there is the location field which shows the path to current directory. Immediately below it, there is the status line which shows remote computer name, file selection filter (see below), and protocol.

FILE LIST - NEEDS WORK

You can refresh file list panel by choosing Remote Refresh

### Navigating Directories

To see the contents of a subdirectory, double-click on this directory name in the file list window. To go up one level in the directory tree, double-click on `..` (usually the first item in the list). By a common Unix convention, `..` stands for parent directory.

### Viewing and Editing Individual Files

To view an individual file, select this file in the file view window and choose Remote View... (for files on the remote computer) or Local View... (for files on the local computer). Alternatively, you can select the file, then right-click on it and choose View from the context menu.

To edit an individual file, select this file in the file view window and choose Local/Remote Edit.... Alternatively, you can select the file, then right-click on it and choose Edit... from the context menu.

Advanced users may configure which applications should be used for opening files of different types by manually editing &gftp; configuration file as described in gftp-configuring-advanced.

### File Filter

You can configure &gftp; so that the file list window only shows files matching a given pattern. To do so, choose Remote Change Filespec... (for files on the remote computer) or Local Change Filespec... (for files on the local computer) and enter the pattern in Change Filespec... dialog. The pattern may use wildcards * (matches any string) and ? (matches any single symbol). For example, pattern `*` matches all files, while `*.tar*` matches all files with extension `tar`, possibly followed by any sequence of symbols, for example `filename.tar.gz`. Please note that filenames in Unix are case-sensitive, so the pattern `*.jpeg` will not match files with extension `.JPEG`.

Once you have selected a filter, the file list window will be updated to show only files matching the pattern. To remind you of that, this pattern will be shown under the location field.

To clear the filter and show all files, choose Remote Change Filespec... and enter `*` as the pattern.

### Customizing File View

## Transferring Files

This section describes how one transfers files between local and remote computer. It assumes that you have already established the connection with the remote computer as described in gftp-connect.

### Transferring a Single File

To transfer a single file, double-click on the file in the file list window, or drag the file from one file list window to another using the mouse.

### Transferring Multiple Files

To transfer multiple files in the same directory, you need to select files to transfer. To do so, click on each of the files and directories you want to select while holding down Ctrl. To select a continuous block of files from the list, click on the first file, then hold down Shift key and click on the last file of the block. All files between them will be selected.

You can also select all files and subdirectories in the current directory by choosing Local Select All (respectively, Remote Select All ). You can also choose Local Select All Files which selects all files but not subdirectories.

To transfer selected files between the local and remote computers, click on the appropriate transfer buttons, located between the file list windows. The arrow on the button shows the direction of the transfer, so the top button will transfer files from the local computer to the remote one, and the bottom button will transfer files from the remote computer to the local one. NEEDS WORK: TRANSFER MENU

Once the transfer has started, its progress will be shown in Transfer progress window. NEEDS WORK

### Transfer Options

By default, &gftp; preserves file permissions and follows symbolic links. It also starts transfers immediately after you click on transfer` button and does one transfer at a time, i.e. it only starts transferring the next file after completing transfer of the previous file. These and many other options can be modified as described in gftp-configuring.

In addition, you can select whether the files should be transferred in binary or text mode. In binary mode, the file is transferred as is, without any changes. This is the default mode, and in most cases, you should use it.

In text (ascii) mode, &gftp; will also make necessary conversion of end-of-line symbol. DOS and Microsoft Windows systems use different way of denoting end-of-line than Unix and Linux systems, which can lead to minor inconveniences if text files are transferred between Windows and Unix/Linux systems as is. Therefore, when transferring text files between Windows and Unix/Linux systems it is recommended that you use text (ascii) mode.

You can switch between binary and ascii modes using FTP menu.

### Transfer Queue

By default, &gftp; starts the transfer immediately after you click on transfer button or double-click on a file. You can configure it so that instead, it just adds the filename to the list of files to be transferred but does not start the actual transfer until you choose Transfers Start transfer . This mode is especially convenient if you need to transfer a number of files in different directories.

To switch to this mode, open Options dialog by choosing FTP Options (Ctrl O) and unselect Start file transfers option in General tab.

### Overwriting Existing Files

If some of the files being transferred already exist in the target directory, &gftp; will open ?? dialog shown in gftp-overwrite-fig.

This dialog allows you to choose for each file one of the following options:

- Overwrite: transfer the file overwriting the existing file.

- Skip: do not transfer the file

- Resume: this option should only be used if the existing file in the target directory is a result of interrupted file transfer. This option will resume the transfer from the place it was interrupted (provided that the remote computer supports this functionality; most FTP servers do). This is faster than starting the transfer form the beginning.

  #### WARNING

  Resume option should only be used if the file in the target directory is the result of interrupted transfer. Selecting this option in any other situation - for example, if the file in the target directory is a complete copy of an older or newer version of the file being transferred - will result in corrupted file.

To choose one of these options, select the file in the dialog and click on the appropriate button (Overwrite, Skip, Resume) at the bottom. After selecting the appropriate options for each of the files in the dialog, click OK.

By default, &gftp; uses Resume option. You can change this using Options dialog, as described in gftp-configuring.

### Resuming Interrupted Transfer

If file transfer was interrupted for some reason (e.g., a server overload or network or dialup problems), you do not have to start the transfer again form the beginning. Instead, &gftp; allows you to resume the transfer from the point where it stopped. This requires that the remote computer supports resume function of FTP protocol; most FTP servers do.

To resume transfer manually, reconnect to the same server, select again the files you want to transfer and start transferring them. &gftp; will recognize partially downloaded file in the local directory and then ask you whether to resume the download or overwrite the partially downloaded file and to start all over (see gftp-overwrite). Choose Resume and click OK.

You can also configure &gftp; so that if connection closes for some reason during file transfer, &gftp; will try to reconnect again and continue with the file transfer where it left off. You can also specify how many times to reconnect and how long to wait for connection. All these options can be set using Options dialog described in gftp-configuring.

In order to specify reasonable reconnect options you need to understand some of the things that can go wrong with a download.

The most common cause of download problems is an overloaded FTP server. When a server becomes overloaded there will be times when the server just can't get around to passing gFTP the next block of data. In the gFTP progress window you will get a message that the transfer is stalled. If the transfer is stalled for over 30 seconds gFTP will time out the transfer and disconnect. (Don't mess with the Read timeout Option unless you know what you are doing. You can get timeouts for a lot of other reasons that an overloaded server.) gFTP then waits the time interval specified in Options and then reconnects.

Some servers recognize when they are overloaded and begin deliberately disconnecting clients until they get back down to the maximum number of downloads that they can reasonably serve. If gFTP gets disconnected it waits the time interval specified in Options and then reconnects. These servers sometimes remember who they have just bounced off and if you try to reconnect immediately they tell gFTP to stop trying to automatically reconnect. So in the Options (Ftp->Options->Network->Retry sleep time) you want to wait just long enough that the busy server will have forgotten you and then reconnect. The gFTP default is 15 seconds.

The other reconnect Option that you are interested in is Connect retries (Ftp->Options->Network->Connect retries). Connect retries is the number of time that gFTP will reconnect before giving up altogether. There two ways to approach this option.

If gFTP has to keep reconnecting to a remote server then the download can be very slow. You might want to switch another remote server which is faster. If the file name on the new server is exactly the same as the file name on the first server then you can resume the download at whatever point you got to on the first server. In this case set Connect retries to 3, which is the default.

If you want to keep chugging away at the download until it finishes, no matter what, then set Connect retries to 0. (Incidentally, I once had a download shut down after 100 reconnects. gFTP and that remote site just weren't getting along and I was in bed asleep)

## Other File Operations

### Deleting, Renaming, Editing and Viewing Files

To delete files or directories on local computer, select them (see gftp-transfer-multiple for information about selecting multiple files) and choose Local Delete . Similarly, to delete files or directories on remote computer, select themand choose Remote Delete . Alternatively, after selecting the files you can right-click in the corresponding file list panel and choose Delete from the context menu.

To rename, view, or edit file, select this file in the list and choose corresponding command form Local or Remote menu (or right-click and choose the command from the context menu). You can only rename, view, or edit a single file; if you have selected more than ne file, &gftp; will give an error message.

&gftp; will use the programs specified in Options dialog (see gftp-configuring) for viewing and editing files. It is also possible to configure &gftp; to use different programs for different file types by manually editing configuration file (see gftp-configuring-advanced).

### Changing File Permissions

To change permissions of a file or directory, select it and choose Local/Remote Chmod... or right-click and choose Chmod... from the context menu. You can only change permisions of one file at a time.

As usual, you can set three types of permissions: read, write, and execute, independently for file owner, group of users owning the file, and everyone else. If you are not fmailair with Unix notion of file permission, read info page for GNU fileutils package (if you are using Linux), or any introductory book or document on Unix, such as If you are new to Linux/UNIX, included in GNOME desktop environment.

### Creating Directories

To create a subdirectory in the current directory, choose Local/Remote Make Directory... or right-click and choose Make Directory... from the context menu. &gftp; will prompt you for directory name.

### Comparing Directories

&gftp; allows you to compare the directories on local and remote computer, showing the files that are different in them. This feature is very convenient for synchronizing you local directory with the remotre one, as it shows the files that were added or updated since your last synchronization. To compare current directories on local and remote computer, choose Tools Compare windows. &gftp; will show and select in each window the files that are different from the files in the other window. That is, it will select all files that are not present in directory but not the other and those files that are present in both directories but have differnt sizes or modification dates.

#### TIP

If you maintain on your local computer a copy of a directory on the remote computer, you can easily update your local directory as follows. First, choose Tools Compare windows (this will select in the remote directory all files that were added or changed since your last update). Next, click on lower transfer button (the one that transfers from remote computer to local one). This will automatically transfer all selected files from the remote computer to the local computer. For the files that were changed, &gftp; will ask you whether it should overwrite existing files in local directory or resume transfer (see gftp-overwrite). Select Overwrite and click OK.

## Bookmarks

&gftp; allows you to create bookmarks for quick access to frequently used sites. Each bookmark contains the information about a connection:

- Host name, port, username and password (for non-anonymous connection)

  Storing your username and password in bookmarks is a potential security risk! &gftp; stores this information unencrypted in the configuration file. Thus, anyone who has access to your account (including any hacker who managed to break into your account) will be able to read these usernames and passwords.

- Protocol (FTP, HTTP, SSH)

- Directories on the local and remote systems

To use one of bookmarked connections, choose the connection name from Bookmarks menu.

To add current connection to the list of bookmarks, choose Bookmarks Add Bookmark (Ctrl A).

To delete, rename, or edit a bookmark, choose Bookmarks Edit Bookmarks . This will open Edit Bookmarks dialog described below.

### Edit Bookmarks Dialog

This dialog allows you to create, delete, edit, and rename bookmarks.

To delete a bookmark, click on it to select, then right-click and choose Delete from the context menu.

To create a new bookmark, right-click in the list of bookmarks and choose New Item from the context menu. &gftp; will prompt you for the bookmark name. After creating the bookmark, you should edit it as described below to enter the required information.

To edit a bookmark, double-click on it. You can also click on it to select, then right-click and choose Properties from the context menu. This will open Edit Entry dialog. In this dialog, you can enter bookmark name and connection information: hostname, port, protocol, directories on local and remote computer. If using anonymous connection, select Log in as ANONYMOUS. Otherwise, unselect this option and enter your username and password (see gftp-connect). In addition, for SSH connections you can also enter path to `sftp` command (see gftp-ssh). If unsure, leave this field blank.

## Using SSH Protocol

This section contains some information about SSH (Secure Shell_ protocol. Normally, you do not need to read this section to use &gftp;. However, if you have problems with configuring or troubleshooting SSH connection, you will find here information you need to fix it.

### What Is SSH?

SSH (Secure Shell) is a protocol for connecting to a remote computer encrypting all communications (including username and password). It was originally designed as a secure replacement for telnet command. Later versions of SSH also allow file transfers over the SSH connection.

As with all communications programs, to connect to a remote computer using SSH it is necessary to have communication programs supporting SSH protocol both on your local computer (ssh client) and on the remote one (ssh ser`ver). There are many applications supporting this protocol; the most popular ones for Linux include SSH and OpenSSH.

### What Is the Difference Between SSH And SSH2?

There are two versions of SSH protocol, SSH1 and SSH2. SSH1 is outdated, so you should use SSH2 whenever possible. If you select SSH as the protocol, then &gftp; (and most other SSH applications) will try to use SSH2; if it is not available, then it will try SSH1. If you select SSH2, then &gftp; will only try to use SSH2 and produce an error message if SSH2 is not available.

### File Transfer Over SSH

SSH1 had no built-in mechanism for transferring files. However, there is an add-on program, called sftp, which allows transferring files over SSH1 connection. this program is available from http://www.xbill.org/sftp. To transfer files over SSH1 connection, this program must be installed on the remote computer. &gftp; requires version 0.7 or later of sftp.

SSH2 has built-in means of transferring files (so-called sftp subsystem). So if you are using SSH2, there is no need to install any additional programs.

There are two options for transferring files using SSH2 protocol:

Using sftp subsystem

- This is the right way to transfer files. The downside of this method is that it is not enough to enter the password in Pass field; ssh will ask you for the password independently. It also requires that you have utility ssh-askpass, used by ssh for asking hte password, installed on your system. You can test whether this utility is installed by entering command `ssh-askpass` on the command line. If you get an error message, it means that ssh-askpass is not installed. If you are using OpenSSH, you should install one of the packages openssh-askpass or openssh-askpass-gnome.

  To use this method, open Options dialog and make sure that in the SSH tab the option Use SSH2 sftp subsys is selected. In most cases, you will also need to select Need SSH User/Pass and Use ssh-askpass util. FIXME: I do not quite understand what these options do. In my experiments, I was able to connect to SSH2 server (requiring password) whether or not these options were selected.

Calling sftp-exec directly

- Using this method, &gftp; calls the sftp-exec directly rather than through ssh command. This method does not require ssh-askpass utility; all you need is to enter the password in Pass field. However, it requires that the the executable file sftp-exec on remote computer be in PATH, i.e. in one of the standard locations where the system looks for executables. If it is not in PATH, you will need to explicitly specify its location in SSH tab of Options dialog.

  To check whether sftp-exec is in PATH on the remote computer, connect to remote computer via ssh as described in gftp-ssh-test and enter comamnd `sft-exec` on remote computer. If you get an error message, this means that sftp-exec is not in PATH. In this case, you should ask the system administartor of the remote computer for help. You can also try one of standard locations (e.g., for OpenSSH server as packaged for Red Hat Linux, sftp-exec is in `/usr/libexec/openssh`).

  To use this method, open Options dialog and make sure that in the SSH tab the option Use SSH2 sftp subsys is unselected. If sftp-exec is not in PATH, you will also need to enter its location in SSH2 sftp-server path.

### Testing SSH Connection

If you have problems transferring files using SSH, you can test your SSH connection. To do so, open a terminal window and type `ssh `username@hostname.domain``. If you get no reply, it can mean that something is wrong with your internet connection, or that the remote computer is down, or that the remote computer is configured not to allow connections from your computer.

If you are connecting to the remote computer for the first time, you should see a message like this:

    The authenticity of host 'hostname (###.###.###.###)' can't be established.
    RSA key fingerprint is xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx.
    Are you sure you want to continue connecting (yes/no)?

This is normal; unless you are paranoid about security or have reasons to expect foul play (in which case you should consult an expert), answer `yes`. You only need to do it once; this message should not appear for the subsequent connections to the same computer.

After this, remote computer should ask you for the password. After confirming the password, you should be logged to the remote computer.

## Configuring &gftp;

To configure &gftp; choose FTP Options (Ctrl O). This will open Options dialog, shown in gftp-options-fig. This dialog contains several tabs described in detail below. After making your selections in these tabs, click OK to save the changes and close the dialog. You can also click Apply to save the changes without closing the dialog, or Cancel to close the dialog discarding the changes.

### General Configuration Tab

This tab contains most general &gftp; options which are common for all protocols (FTP, HTTP, SSH).

Email address

View Program

- The default command to use for viewing files (when you select Local/Remote View). If this field is left blank, &gftp; will use built-in text viewer.

  You can specify different view programs for different file types as described in gftp-configuring-advanced.

Edit Program

- The default command to use for editing files (when you select Local/Remote Edit)

  You can specify different edit programs for different file types as described in gftp-configuring-advanced.

Startup Directory

- The directory on local computer to show in the file list when starting &gftp;.

Log File

- In this field, you can enter the location of the log file (see gftp-logging. Default location is `~/.gftp/gftp.log`, where `~` is your home directory.

`

Max Log Window Size

- This is the number of lines you can scroll back in the Log Window.

Append File Transfers

Confirm Delete

- If this option is selected, &gftp; will ask for confirmation before deleting files or directories.

Overwrite by Default

- This option controls behavior of &gftp; if the file being transferred is already present in the target directory. As described in gftp-overwrite, in such situation &gftp; prompts you to select one of three possible actions: Overwrite, Resume, Skip. If this option is selected, then the default action suggested by &gftp; will be Overwrite. Otherwise, the default action will be Resume.

Preserve permissions

- If this option is selected, transferred files will have the same permissions as the original files. This is the default behavior. Otherwise, transferred files will have the default permissions for newly created files.

Resolve Remote Symlinks

Show hidden files

- if this option is selected, &gftp; will show files and directories with names starting with a dot (.). By a common Unix/Linux conventions, such files are used for system data and applications' settings. Such files rarely contain user data.

Start file transfers

- If this option is selected, &gftp; will start transferring files as soon as you click on File transfer button or double-clicked on the file. This is the default behavior. If this option is unselected, &gftp; will just add the names of files to be transferred to the queue. It will only start the actual transfer when you choose Transfers Start Transfer.

Bring up reconnect dialog

Do one transfer at a time

- If this option is selected (default), &gftp; will do file transfers consecutively, i.e. it will only start transferring the next file after the transfer of the previous file has completed. If this option is not selected, &gftp; will transfer files simultaneously, opening as many connections to the remote computer as necessary.

Passive file transfers

- If this option is selected (default), &gftp; will use passive file transfer; otherwise, it will use active file transfer. For most users, all you need to know about the difference between these two modes is that many firewalls will not let you download a file using active file transfer. Thus, if you are behind a firewall, you should use passive file transfer. On the other hand, not all FTP servers support passive file transfer. Thus, if you get error message when transferring files, try unselecting this option.

Refresh after each file transfer

- If this option is selected, &gftp; will refresh file list after each file transfer. Otherwise, &gftp; will only refresh file list when you choose Local Refresh (or Remote Refresh ).

Save geometry

- If this option is selected, &gftp; will remember window size and position on the screen and will use same size and position when started next time.

Sort directories first

- If this option is selected, file list always shows directories before files. Otherwise, both directories and files will be sorted according to the order you have chosen (see gftp-file-sort).

Use cache

### Network Configuration Tab

### FTP Configuration Tab

### HTTP Configuration Tab

### SSH Configuration Tab

### Local Hosts Configuration Tab

### Advanced Configuration Options

Advanced users can also configure &gftp; by manually editing the configuration file. This file is located at `~/.gftp/gftprc` (where `~` is your home directory). This file stores all the configuration options for &gftp;, including those that can be configured in Options dialog.

In addition, there are some options that can only be configured by manually editing the configuration file. Most importantly, you can configure how &gftp; should treat files of different types. More precisely, for every mime type, you can select:

- The icon to be used in file list window

- Default transfer type (binary or ascii)

- Default view/edit program

Each mime type is described by a line in the configuration file which looks like this:

    	  ext=.xcf:gimp.xpm:B:gimp

The first token, `.xcf`, is the file extension (&gftp; uses file extensions to identify mime types). The next token, `gimp.xpm`, is the default icon to use in the file list windows. You don't have to specify one if you don't have to. By default, &gftp; will search `~/.gftp`, `$(PREFIX)/share/gftp` (where `PREFIX` is your installation prefix), and then `/usr/share/icons` in that order. The files have to be a valid `xpm` file. The next token, `B`, specifies whether &gftp; should use binary (B) or ascii (A) mode for transferring files of this type.If you omit this field, then &gftp; will download the file according to whether ascii or binary is selected in the FTP menu. The final token, `gimp`, specifies the name of the program to run to view or edit a file with that extension. You can omit this as well if you like.

## Frequently Asked Questions

## About &gftp;

&gftp; was written by Brian Masney (masneyb@seul.org). To find more information about &gftp;, please visit the gFTP Web page.

This manual was written by Alexander Kirillov (kirillov@math.sunysb.edu), using previous documentation written by Brian Masney (masneyb@seul.org and ??.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this link, or in the file COPYING included with the source code of this program.