For using LinCVS with ssh, there are several ways to go:


A: Use with an ssh agent (Unix):

   1.)
   create keys on local machine:
   > ssh-keygen

   2.)
   copy the .ssh/identity.pub to .ssh/authorized_keys in his/her home dir
   on the remote machine

   3.)
   Select from Menu:
   Directory/Properties.../Setup/Ssh client settings
   Make shure the 'use own ssh agent' checkbox is checked.

   4.)
   If you want to use an already running ssh agent, you need to
   check 'use running ssh agent'. In this case LinCVS
   checks for a running agent, and if none is found, it starts its
   own.

   Thats all. almost.

   you need:
   -ssh of course
   -ssh-keygen ;-)
   -ssh-agent
   -ssh-add
   -rsa authentication must be enabled in ssh_config


B: Use with an ssh agent (Windows):

   1.)
   create and save keys on local machine (rsa2 is recommended):
   > puttygen
   
   2.)
   copy the public key to .ssh/authorized_keys in his/her home dir
   on the remote machine
   Note:
   Copy the key _without_ comment as a single line into the authorized_keys
   file. Prepend ssh-rsa (or ssh-dsa) and append user@host. Your line should
   look like this one:
   
   ssh-rsa AAAA...aB7= user@host
   
   3.)
   Select from Menu:
   Directory/Properties.../Setup/Ssh client settings
   Make shure the 'use own ssh agent' checkbox is checked.

   4.)
   If you want to use an already running ssh agent, you need to
   check 'use running ssh agent'. In this case LinCVS
   checks for a running agent, and if none is found, it starts its
   own.

   5.)
   Adapt the start-ssh-agent.bat file (resides in LinCVS/Tools) to your
   environment.
   
   6.)
   Create a session using putty. Choose ssh as protocol of course.
   Note:
   You must use a host address user@host!
   
   Thats all. almost.
   
   you need:
   -pageant (as ssh agent)
   -puttygen (for generating keys)
   -putty   


C: Use without ssh agent (Unix):

   Openssh uses a graphical login if not called from a tty and $DISPLAY is set.
   If you want to use a graphical login even if LinCVS was run from a console,
   for example on KDE, you must follow step 1 to 4, otherwise the ssh passwd
   request appears in the console.
   For standard ssh usage, you only need to enter ssh in:
   Options/Settings/External Programs/Remote Shell
   and adapt the ssh settings in:
   Directory/Properties.../Setup/Ssh client settings
   with selecting the 'use ssh' entry. This requires ssh, ssh-add and ssh-askpass.

   1.)
   In the LinCVS/contrib dir, there s a file readpass.c. Download openssh,
   replace readpass.c with the file from the contrib dir and compile as
   described in the INSTALL file.

   2.)
   Adapt the start-ssh.sh script int the LinCVS/Tools dir to your local
   installation, according to the instructions placed in the head of the file.

   3.)
   Select from Menu:
   Options/Settings/External Programs/Remote Shell, this needs to point at start-ssh.sh.

   4.)
   Select from Menu:
   Directory/Properties.../Setup/Ssh client settings
   Make shure the 'use ssh' entrie is selected.

   On use with ssh, the ssh-askpass dialog should show up, where you need to enter the
   required password/passphrase. Due to security reasons, LinCVS will not keep
   track of the password. If you want to prevent having to reenter the password/passphrase
   again and again, try using a ssh agent.


D: Use without ssh agent (Windows):

   1.)
   You need plink.exe for ssh support. Plink can be downloaded from the putty homepage.
   Either search for putty with your favourite search engine (www.google.com;-), or get
   it directly from http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html (as of
   this writing).

   2.)
   You need to adapt the start-ssh.bat script int the LinCVS/Tools dir to your local
   installation, according to the instructions placed in the head of the file.

   3.)
   Select from Menu:
   Options/Settings/External Programs/Remote Shell, this needs to point at start-ssh.bat.

   4.)
   Select from Menu:
   Directory/Properties.../Setup/Ssh client settings
   Make shure the 'use ssh' entrie is selected.

   On use with ssh, there will be a password dialog for every cvs call. There you need to
   enter the required password/passphrase. Due to security reasons, LinCVS will not keep
   track of the password. If you want to prevent having to reenter the password/passphrase
   again and again, try using a ssh agent.

E: If you happen to work on a system without ssh-askpass (mac uses openssh without ssh-askpass),
   there is a qt-based ssh-askpass tool included with LinCVS. After the install procedure, copy
   LinCVS/tools/ssh-askpass to the standard location, ssh will look for it (probably this can
   be taken from the error-message given when the ssh-askpass is not found).
   If you want to use a different ssh and maybe a different ssh-askpass tool with LinCVS, you
   need to adapt the start-ssh.sh script in the LinCVS/Tools dir (after make install) and set
   up 'Options/Settings/External Programs/Remote Shell' to point to LinCVS/Tools/start-ssh.sh

F: Windows only: On your very first login, ssh might require some user interaction, to allow
   storing a new host-key. This request cannot be caught and moved to a graphic window. So it
   might be necessary to once login from the commandline. After this primary login, all future
   interaction will be handled by LinCVS

If you happen to run into problems using ssh, please contact the lincvs-users mailing list
and report bugs to the public. This gives us the best chance to solve problems and collect
problems for the different platforms.