readme.txt

   1
   2 GINGE - Ginge Is Not GP2X Emulator
   3
   4 (C) notaz, 2010
   5 http://notaz.gp2x.de/
   6
   7
   8 About
   9 -----
  10
  11 Ginge is an application that can run many GP2X F100/F200 games on other ARM
  12 Linux platforms, which currently includes Wiz. It is not a full hardware
  13 emulator like MAME, PicoDrive or similar, it does not emulate the CPU. It can
  14 be considered as compatibility layer similar to Wine on PC Linux, however it
  15 does emulate small portion of MMSP2 system-on-chip. It operates by hooking
  16 certain system calls and using realtime patching of code that accesses memory
  17 mapped hardware directly.
  18
  19
  20 Usage
  21 -----
  22
  23 Ginge comes with a launcher that is started when you run Ginge. The launcher
  24 can then be used to start GP2X software, which will either run if it's
  25 compatible, or just return back to the menu if it is not. In some cases it
  26 might hang though.
  27
  28
  29 Structure
  30 ---------
  31
  32 Ginge actually consists of 4 independent executables and a few scripts:
  33
  34 + ginge_sloader - loader of static executables
  35 + ginge_dyn     - dynamic executable handler
  36 + ginge_prep    - .gpe parser that selects the right handler from above
  37 + gp2xmenu      - the launcher/menu program
  38 + ginge_dyn.sh  - environment setup script for ginge_dyn
  39 + ginge.sh/gpe  - menu launcher script
  40
  41 The menu is optional and can be replaced or bypassed completely. The only thing
  42 it does is running ginge_prep on GP2X .gpe program, ginge_prep handles the rest.
  43
  44
  45 License
  46 -------
  47
  48 gp2xmenu is based on GPH GPL source (http://www.gnu.org/licenses/gpl.html).
  49 Source is available at
  50
  51 Remaining portion is released under custom closed source license. It is not
  52 derived from gp2xmenu and is completely standalone, the menu is only included
  53 for user's convenience.
  54
  55 Redistribution and use of program's binaries and helper scripts, with or without
  56 modification, is permitted provided that the following conditions are met:
  57   * This readme is included in unmodified form.
  58   * The program in any of it's forms is not sold or used as part of any
  59     commercial package, including pre-installed or included in any kind of
  60     portable device.
  61   * It is not bundled or distributed with any GP2X program without respective
  62     program's author's permission.
  63
  64 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
  65 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  66 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  67 DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER BE LIABLE FOR ANY
  68 DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  69 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  70 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  71 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  72 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  73 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  74