gFTP Manual &manrevision;

+ + + + gFTP Manual &manrevision; + + + 2002 + Alexander Kirillov + + + 2002 + Brian Masney + + + + + + GNOME Documentation Project + + + &legal; + + + + Alexander + Kirillov + + GNOME Documentation Project +

kirillov@math.sunysb.edu

+ + + + Brian + Masney + + +

masneyb@seul.org

+ + + + + + This manual describes version &appversion; of &gftp;. + + + + + gFTP + + + gFTP + + + File Transfer + + + + + + + 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 + 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 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 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 . + + + 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 . + + + + + + + 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 . Configuration changes are also likely to + be required when connecting to an SSH site; see . + + + To disconnect from a remote site, click on + Connect button or choose + Remote + Disconnect. + + + + + + + + + Connecting Using URL + + An equivalent way of connecting to a remote site is by + choosing Remote + Open URL ( + CtrlU). 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 . + + + + + + Viewing Files and Directories + + + + File List Panel + + After connecting, the right file list panel will show the files + on the remote computer (see . 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 . + + + + + + 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 . + + + + + 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 . + + + 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 . + + + 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 . + + + + + + 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 ). 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 . + + + 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 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 ) 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 ). + + + + + 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 + ). 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 ). In addition, for SSH + connections you can also enter path to sftp + command (see ). 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 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 . 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 . + + + + + + 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 . + + + + + + + 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 . 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 , 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 ). + + + + + + 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. + + +

I'm having problems with installing the RPMs off of your website.

What systems is gFTP known to run on?

I'm having problems getting SSH2 transfers to work. I keep getting the error: Error: Message size 1644196712 too big from server

What is the difference between the SSH and SSH2 protocols?

How do I force running the text or gtk+ version of gftp?

Is there a way for gftp to download a bunch of files/directories and then exit when it's completed?

In the GTK+ version of gFTP, do I have to enter a port, username and password to connect to a ftp server?

How do I set up my HTTP Proxy server?

When gFTP tries to get the remote directory listing, it sends LIST -L, but the remote server sends an error back

When gFTP tries to get the remote directory listing, I get an error that says: Cannot create a data connection: Connection refused

When I try to compile gFTP, I get some errors. One of them is undefined symbol LC_ALL

How do I report bugs in gFTP?

I downloaded a binary off the internet and everytime I run gFTP I get an +error saying: undefined symbol :__register_frame_info

I upgraded to a newer version of gFTP and now I am getting some warnings about some config file lines not having enough arguments, and it cannot find html.xpm.

Where does gFTP store it's options?

I am trying to compile your program and I get some parse errors before +GdkDragContext. What's wrong?

I am having a hard time using the drag and drop in gFTP. How do I use it?

I have a libc 5 based machine and everytime I run gFTP it instantly crashes. +I get an error something like: Gdk-ERROR **: an x io error occurred +What's wrong?

$_

Requirements

Download gFTP

Mailing Lists

Installation instructions for gFTP