Eclipse CVS-SSH2 plug-in by ymnk@jcraft.com, JCraft,Inc. http://www.jcraft.com/eclipse-cvsssh2/ Last modified: Mon Jan 5 08:17:33 UTC 2004 Description =========== An eclipse plug-in to allow CVS access on SSH2 session. Features ======== * This plug-in requires J2SE 1.4 * This plug-in depends on JSch 0.1.13(http://www.jcraft.com/jsch/) * SSH2 protocol support * This plug-in supports password, public-key and keyboard-interactive authentications. * This plug-in supports HTTP,SOCKS5 proxies to get SSH2 access beyond the firewall. * This plug-in has solved the problem 'Eclipse opens SSH connection for every tiny CVS operation', which is reported at http://dev.eclipse.org/bugs/show_bug.cgi?id=26937#c0 * This plug-in will work on Eclipse 2.1.* and Eclipse 3.0M* * This plug-in is licensed under the terms and conditions of CPL 1.0 * This plug-in has been included in Eclipse 3.0 M6(or later). Installation ============ This archive includes the CVS-SSH2 plug-in for Eclipse 2.1.* and Eclipse 3.0 M5(or previous). If you have Eclipse 3.0M6 or later, you don't have to install this archive, because your Eclipse has already included this plug-in by the default. The following instructions are for Eclipse 2.1.* and Eclipse 3.0 M5(or previous) users. 0) Delete 'com.jcraft.eclipse.cvsssh2_*' and 'org.eclipse.team.cvs.ssh2_0.*' if you have in the 'plugins' directory of your eclipse installation. 1) Unpack the distribution file in the 'plugins' directory of your eclipse installation. 2) Launch eclipse Please note that this archive has included JSch, so you don't have to install it additionally by yourself. Usage ===== CVS Repositories View 1) New -> Repository Location... This will bring up the Add CVS Repository Dialog 2) Choose 'extssh2' for the Connection type. * If '~/.ssh/id_dsa' exists, it will be used. * If '~/.ssh/id_rsa' exists, it will be used. * '~/.ssh/known_hosts' will be used. Preference Page =============== The preference page(Window>Preferences>Team>CVS>SSH2 Connection Method) allows you to customize following settings, * ssh2 home directory, * proxy settings. * key pair generation. Pserver over SSH2 ================= This plug-in supports yet another connection type 'pserverssh2'(Pserver over SSH2), which allows you to enjoy pserver connection to the CVS repository over ssh2 port-forwarding without any external ssh2 programs. To enable this functionality, 1) New -> Repository Location... 2) Choose 'pserverssh2' for the Connection type. 3) Put informations about ssh_user and ssh_host for ssh2 port-forwarding and hostname of remote CVS repository for the Host field in the following format, ssh_user@ssh_host@cvs_host If sshd on ssh_host listens to TCP port 'n', which is not 22, then it should be ssh_user@ssh_host#n@cvs_host For example, CVS repositories on 'cvs.dev.java.net' provide only 'pserver' connection, but they provide ssh port-forwarding service, (https://www.dev.java.net/nonav/docs/ddSSHGuideTerminals.html). You can get the access to their CVS repositories by ssh and cvs commands in the following steps, * ssh -l tunnel -L 2401:localhost:2401 cvs.dev.java.net * cvs -d :pserver:guest@localhost:2401/cvs login In this 'pserverssh2' connection type, you can do the same thing by only setting 'tunnel@cvs.dev.java.net@cvs.dev.java.net' to the Host field on CVS Repository Dialog. Please note that this plug-in will allocate appropriate local TCP port for the port-forwarding, so you can have multiple 'pserverssh2' connections simultaneously without caring for the collision of local TCP ports for the port-forwarding in using external ssh program. CVS Repository ============== The latest source code has been stored in the CVS repository on http://eclipse.org/ and available at http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.team.cvs.ssh2/ Please refer to http://dev.eclipse.org/cvshowto.html to retrieve it. That latest code is for Eclipse 3.0 M6 or later. And also , please note that latest code is for Eclipse 3.0 M6 or later. TODO ====