Gp2xOpenSSH 1.0 by Bitcoder
===========================

Hi, nice to see you reading the manual ;) its a very basic and direct one so feel free to proceed.
My name is Sergio Freire and this is one of first of public releases of "ports" for the GP2x console.
This is a very first public port/derivated work of OpenSSH 4.3p2 for the GP2x.
Is has a small minor set of patches against the public release of OpenSSH 4.3p2 which can be 
found in the patches subfolder.


Installing:
===========
Extract this zip into the root folder of your SD card (I assume it to be FAT formated).
Browse to the "/mnt/sd/openssh" folder and run "./install_just_run_me_once.gpu"


Running:
========
To run the server, browse to the "/mnt/sd/openssh" folder and run "./sshd_start.gpu". 
To stop the server, browse to the "/mnt/sd/openssh" folder and run "./sshd_stop.gpu". 
To run the client run the normal "ssh" command which can be found in "/mnt/sd/openssh/bin/ssh".


Building (for developers only):
===============================
In my environment I have a RedHat AS4 PC with the publick SDK for linux from GPH.
I created a directory called "/mnt/sd" which I used to test the makefiles 
(normally the "make install" process).

** Steps to build this package:
a) extract OpenSSH 4.3p2 to some directory and run something similar to:
   # ./configure --host=arm-linux-gnu --libdir=/root/openssl-0.9.8b --with-ssl-dir=/root/openssl-0.9.8b --prefix=/mnt/sd/openssh
b) apply the patches provided in ./patches subfolder using:
   # 
c) run "make"
d) run "make install"

PS: as you saw, you need to have openssl library compiled and for that you do need to do something like:
	# tar zxvf openssl-0.9.8b.tar.gz; cd openssl-0.9.8b 
	# ./Configure  gcc
	# make
I did this in my root directory, you can do it wherever you'd like to.


SOURCE CODE:
============
The patches are included in this package.
For the original OpenSSH distribution please check their oficial web site availabe 
at http://www.openssh.com/portable.html or ftp://ftp.openbsd.org/pub/OpenBSD/OpenSSH/portable/ .


LICENSE (or licence):
=====================
Please read the LICENCE file which comes with this package.
I hope Im not violating nothing but if you think so, please tell so I can act
accordingly.


Other stuff:
============
Feel free to contact me for sugestions, critics and discussion of matters related with the GP2x.
I use Greg Allen's nice utility gp2xole (https://webspace.utexas.edu/gallen/gp2xole/).
Surelly I must forgot something but if so tell me and I will update this.

================================================================================
Sergio Freire (aka bitcoder)

email: etfreire@ua.pt (use subject "gp2x" or it will be classified as spam)
jabber: sergio@im.ptinovacao.pt
blog: http://darktelecom.spaces.live.com
gp2x wiki page: http://wiki.gp2x.org/wiki/User:Bitcoder 
================================================================================
