X-Git-Url: https://notaz.gp2x.de/cgi-bin/gitweb.cgi?p=ginge.git;a=blobdiff_plain;f=readme.txt;h=18f3ee0f7b05dec701f4db4633efae03e40b0371;hp=8f2671e2eb5e4de0af2e51de9974b46ed26ca52d;hb=db9191ed7ea2e1c190b4445bf3c576b206c88b36;hpb=6ca083930098ee075c8f61cf2c04d616349959c3 diff --git a/readme.txt b/readme.txt index 8f2671e..18f3ee0 100644 --- a/readme.txt +++ b/readme.txt @@ -1,74 +1,80 @@ - -GINGE - Ginge Is Not GP2X Emulator - -(C) notaz, 2010 -http://notaz.gp2x.de/ - - -About ------ - -Ginge is an application that can run many GP2X F100/F200 games on other ARM -Linux platforms, which currently includes Wiz. It is not a full hardware -emulator like MAME, PicoDrive or similar, it does not emulate the CPU. It can -be considered as compatibility layer similar to Wine on PC Linux, however it -does emulate small portion of MMSP2 system-on-chip. It operates by hooking -certain system calls and using realtime patching of code that accesses memory -mapped hardware directly. - - -Usage ------ - -Ginge comes with a launcher that is started when you run Ginge. The launcher -can then be used to start GP2X software, which will either run if it's -compatible, or just return back to the menu if it is not. In some cases it -might hang though. - - -Structure ---------- - -Ginge actually consists of 4 independent executables and a few scripts: - -+ ginge_sloader - loader of static executables -+ ginge_dyn - dynamic executable handler -+ ginge_prep - .gpe parser that selects the right handler from above -+ gp2xmenu - the launcher/menu program -+ ginge_dyn.sh - environment setup script for ginge_dyn -+ ginge.sh/gpe - menu launcher script - -The menu is optional and can be replaced or bypassed completely. The only thing -it does is running ginge_prep on GP2X .gpe program, ginge_prep handles the rest. - - -License -------- - -gp2xmenu is based on GPH GPL source (http://www.gnu.org/licenses/gpl.html). -Source is available at - -Remaining portion is released under custom closed source license. It is not -derived from gp2xmenu and is completely standalone, the menu is only included -for user's convenience. - -Redistribution and use of program's binaries and helper scripts, with or without -modification, is permitted provided that the following conditions are met: - * This readme is included in unmodified form. - * The program in any of it's forms is not sold or used as part of any - commercial package, including pre-installed or included in any kind of - portable device. - * It is not bundled or distributed with any GP2X program without respective - program's author's permission. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND -ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED -WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE -DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY -DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES -(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; -LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND -ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS -SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - + +GINGE - Ginge Is Not GP2X Emulator +release 1 + +(C) notaz, 2010 +http://notaz.gp2x.de/ + + +About +----- + +Ginge is an application that can run many GP2X F100/F200 games on other ARM +Linux platforms, which currently includes Wiz. It is not a full hardware +emulator like MAME, PicoDrive or similar, it does not emulate the CPU. It can +be considered as compatibility layer similar to Wine on PC Linux, however it +does emulate small portion of MMSP2 system-on-chip. It operates by hooking +certain system calls and using realtime patching of code that accesses memory +mapped hardware directly. + + +Usage +----- + +Ginge comes with a launcher that is started when you run Ginge. The launcher +can then be used to start GP2X software, which will either run if it's +compatible, or just return back to the menu if it is not. In some cases it +might hang though. + + +Structure +--------- + +Ginge actually consists of 4 independent executables and a few scripts: + ++ ginge_sloader - loader of static executables ++ ginge_dyn - dynamic executable handler ++ ginge_prep - .gpe parser that selects the right handler from above ++ gp2xmenu - the launcher/menu program ++ ginge_dyn.sh - environment setup script for ginge_dyn ++ ginge.sh/gpe - menu launcher script + +The menu is optional and can be replaced or bypassed completely. The only thing +it does is running ginge_prep on GP2X .gpe program, ginge_prep handles the rest. + + +License +------- + +gp2xmenu is based on GPH GPL source (http://www.gnu.org/licenses/gpl.html). +Source is available at http://notaz.gp2x.de/releases/ginge/gp2xmenu.tar.bz2 + +Ginge may come with some libraries. Those libraries are unmodified copies +of ones found in root filesystems in GP2X and Wiz and are included to more +accurately reproduce environment on GP2X. Their source code may or may not be +available, I do not have it nor did I use it. + +Remaining portion is released under custom closed source license. It is not +derived from gp2xmenu and is completely standalone, the menu is only included +for user's convenience. + +Redistribution and use of program's binaries and helper scripts, with or without +modification, is permitted provided that the following conditions are met: + * This readme is included in unmodified form. + * The program in any of it's forms is not sold or used as part of any + commercial package, including pre-installed or included in any kind of + portable device. + * It is not bundled or distributed with any GP2X program without respective + program's author's permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY +DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +