
    Welcome to PSPSSH - 1.0.2

Original Author of DropBear

  Matt Johnston (see http://matt.ucc.asn.au/dropbear/dropbear.html)

Author of the PSP port version 

  Ludovic.Jacomme also known as Zx-81 (zx81.zx81@gmail.com)


1. INTRODUCTION
   ------------

  Dropbear is a small SSH2 Server and Client running on a variety of 
  POSIX-based platforms. It has been mainly developped by Matt Johnston 
  (see http://matt.ucc.asn.au/dropbear/dropbear.html).

  PSPSSH is a port on PSP of the version 0.48.1. The terminal Vt100 emulation
  part of PSPSSH is based on the work of Danzel for his Telnet client for PSP.

  Many thanks to Matt Johnston for this nice SSH client, thanks to Danzel for 
  his Virtual kerboard and his Vt100 stuff, and to all PSPSDK developpers.

  This software is distributed under several open-source/free software
  licenses, such as MIT/X Consortium License, and some other part are
  distributed under GNU V2 License. 

  See LICENSE.txt file for all details and information about it.

2. INSTALLATION
   ------------

  Unzip the zip file, and copy the content of the directory fw2.x or fw1.5
  (depending of the version of your firmware) on the psp/game, or psp/game150
  if you use custom firmware.

  It has been developped on linux using Firmware 3.03-OE.

  For any comments or questions on this version, please visit 
  http://zx81.zx81.free.fr, http://www.dcemu.co.uk, or 
  http://pspupdates.qj.net

3. CONTROL
   ------------

  In the console window, press Start to open/close the 
  On-Screen keyboard

  The On-Screen Keyboard of "Danzel" and "Jeff Chen"

  Use Analog stick to choose one of the 9 squares, and
  use Triangle, Square, Cross and Circle to choose one
  of the 4 letters of the highlighted square.


4. HOW DOES-IT WORK ?
   ------------

  After choosing your wifi access point in the "Wifi connection" 
  menu, you will then have to enter ssh connection parameters :

4.1 - Create a connection with user/password :
 
  Host : The name of the host you want to connect to
  User / Password : The login and password for this connection
  Port : By default it's set to 22, which is the standard SSH port
  but you can change it.

  All those parameters can be easily entered using the Virtual 
  Keyboard (Press Start to display the keyboard)

  You can save your parameters in a binary encoded file if you
  want using the "Save" menu.
  
4.2 - Create a connection with rsa key pairs :

  If you prefer to use RSA keys/pair authentication, 
  you can put your binary rsa key file id_rsa (generated 
  by the dropbear tool called dropbearkey for exampel), in 
  the ssh directory of PSPSSH. Then you have to add the 
  public ascii key in the authorized_keys file on the 
  server side. (please have a look to the dropbear, or any 
  ssh clients for details).

  Enter the host, user and password (using a rubbish password if
  you want, because it won't be used, but it can't be empty).

  Then enable the option "Local id_rsa key". You will then
  able to connect to host using your id_rsa key file.

4.3 - Connect to the server

  Then you can connect to the host you've specified using the
  "Connect" menu.

  If everything is going right, you should see a console with
  a shell prompt few seconds after.

4.4 - Enter commands in the console window

  In the console window you can use the Virtual Keyboard to
  enter unix command. 

  Using LTrigger and RTrigger you can scroll the console window.
  Using the start button you can use the Virtual keyboard.

  Press the Select key to enter in the Console menu. You will
  then be able to choose unix commands in a list. Use the 
  Virtual Keyboard to specify the first letter of the command.

  All those commands are written in a file command.txt than
  can be edited using your favorite ASCII-text editor, and
  you can add your own custom commands.

  (NOTE) All commands should be alphabetically sorted !

5. COMPILATION
   ------------

  It has been developped under Linux using gcc with PSPSDK. 
  To rebuild the homebrew run the Makefile in the src archive.

