Legal Notice
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
any later version published by the Free Software Foundation; with no
"Invariant Sections", "Front-Cover Texts" or
"Back-Cover Texts", each as defined in the license. A copy of
the license can be found in the file COPYING.DOC.txt
included with jEdit.
Table of Contents
Table of Contents
The FTP plugin lets you browse directories and edit files on remote servers using FTP, the File Transfer Protocol. Note that FTP is insecure since it sends everything (including passwords) as clear-text over the network. If you can, consider using SFTP, documented in the next section.
To connect to an FTP server, either select Connect to FTP Server from the file system browser's Plugins menu, or use the Open from FTP Server and Save to FTP Server commands in the Plugins>FTP menu.
Since an FTP server does not allow execution of arbitrary shell commands, the plugin sends the "SITE CHMOD" FTP command to set a file's mode. This command is reasonably standard, but not all FTP servers support it.
If you notice that file permissions are not preserved after saving a file to an FTP server, check Utilities>Troubleshooting>Activity Log for messages like the following, which indicate your FTP server does not support this command:
[debug] FtpClient: Thread[jEdit I/O #3,4,jEdit I/O]: sending command: SITE CHMOD 644 /home/swenv [debug] FtpClient: Thread[jEdit I/O #3,4,jEdit I/O]: received response: 502 SITE command not implemented.
A workaround is to disable two-stage save in the General pane of the Utilities>Global Options dialog box.
The FTP plugin also supports the SSH File Transfer Protocol, or SFTP. SFTP is much more secure than FTP because it encrypts all network traffic. However not all FTP servers support SFTP. SFTP support requires Java 1.4.
To connect to an SFTP server, either select Connect to Secure FTP Server from the file system browser's Plugins menu, or use the Open from Secure FTP Server and Save to Secure FTP Server commands in the Plugins>FTP menu.
SFTP support is provided using the JSch library, licensed under a BSD style license.
The FTP plugin includes a number of time-saving and performance-improving features:
Remote directory listings are cached. Changing files from within jEdit will automatically update the cache as necessary. However, if changes are made from another program, you will need to clear the cache manually using the Clear Remote Directory Cache command in the Plugins>FTP menu.
Passwords are remembered while jEdit is running so you don't have to re-type them. Passwords are not saved to disk and therefore are forgotten when jEdit exits. To force jEdit to forget all passwords while it is running, use the Forget Remote Passwords command in the Plugins>FTP menu.
FTP and SFTP connections are kept open for 2 minutes before being closed. Performing another operation while a connection is still open resets the 2 minute timer. This improves performance by reducing network traffic.
You can close unused connections at any other time using the Close Unused Connections command in the Plugins>FTP menu.
Version 0.9.4 Requires java 1.5 and jEdit 4.3pre12.
New option: to use proxy for regular ftp logins. (# 1735335 - Voituk Vadim)
Fixed: No way to reinput incorrect password (# 1885830 - Voituk Vadim)
Little code refactoring & cleanup
Version 0.9.3 Requires java 1.5 and jEdit 4.3pre5.
Updated jsch lib to 0.1.37 (ezust)
New option: to use proxy for secure logins. (# 1873628 - Voituk Vadim)
Remove spaces from hostname (1744059 - kpouer)
Version 0.9.2 Requires java 1.5 and jEdit 4.3pre5
Refactored to make its secure connections reusable from the SshConsole plugin (ezust).
Added BROWSE_CAP to the FtpVFS.
Version 0.9.1 Requires jEdit 4.3pre4 (Nicholas O'leary)
Bugfix: unparented dialogs are now parented.
Bugfix: asking for passphrase more than once per session.
Remote symlinks work.
Version 0.9 Requires jEdit 4.3pre4
Ported to the JSch library, away from the SSHTools library.
Removed dependency on JakartaCommons
Version 0.7.9 Requires jEdit 4.3pre4 and JakartaCommons 0.3.
Removed dependency to gnu.regex; updated to use java.util.regex
Fixed 1489889 - read only warnings in FTP protocol
Version 0.7.7 requires jEdit 4.3pre4 and JakartaCommons 0.3.
Added an option to save passwords to disk, eclipse-style.
Version 0.7.6 requires jEdit 4.3pre4 and JakartaCommons 0.3.
patch 1445269 "readonly error"/chmod exceptionBugs. This requires jedit 4.3pre4.
Bug 1229449 + small UI fixes
Version 0.7.3 requires jEdit 4.2pre6 and JakartaCommons 0.3.
Added support for public/private key authentication.
Version 0.7.2 requires jEdit 4.2pre6 and JakartaCommons 0.3.
Updated to SSHTools 0.2.7.
Changed order that regexps are matched in to fix the problem with file listings containing numeric user IDs or group IDs.
Fix a problem with servers whose PWD command would return a relative path name.
Version 0.7.1 requires jEdit 4.2pre6 and JakartaCommons 0.3.
Updated to SSHTools 0.2.6 beta..
Fixed file listing on servers that don't output a file owner and group - again.
For non-existent files, the FTP file system would always report that they are directories. This made it impossible to Save as to a new file.
More fixes for VMS servers.
Fixed a problem that could cause "connection timeout" errors and failed operations.
Version 0.7 requires jEdit 4.2pre3 and JakartaCommons 0.3.
Updated to SSHTools 0.2.5 beta.
Fixed file listing on VMS FTP servers.
Fixed file listing on Solaris servers with ACLs enabled (Brion Vibber).
Fixed file listing on servers that don't output a file owner and group.
Version 0.6 requires jEdit 4.2pre2 and JakartaCommons 0.3.
Updated to SSHTools 0.1.7 beta.
Permissions are now preserved on SFTP servers.
Incomplete support for VMS FTP servers.
Support for AS/400 FTP servers (Nagy Gabor).
Moved Log4J to JakartaCommons plugin.
Version 0.5 requires jEdit 4.1pre8.
Connections to servers using the SSH File Transfer Protocol (SFTP) are now supported. This uses the sshtools library, version 0.0.5, and requires Java 2 version 1.4.
Fixed various problems in the connection pooling code.
Fixed problem with FTP servers localized for non-English languages.
Fixed problem with AIX FTP servers.
Permissions were not preserved properly (Brian Hardy).
Login dialog box host and user name fields now remember previously entered values.
Using the Save a Copy As command to save a buffer located on a non-FTP filesystem would result in an exception being thrown (but the file is still saved).